Audiences

Each message pool sets an audience.

Audience	Behavior
`PLAYER`	Sends the greeting only to the joining player.
`BROADCAST`	Sends it to all online players except the joining player.
`BOTH`	Sends it to every online player, including the joining player.

Practical notes

First-time greetings often use PLAYER so new arrivals receive a private welcome.
Returning greetings can use BROADCAST or BOTH when you want the community to notice a return.
Simulation honors the configured audience after the configured delay.
Preview always sends only to the administrator who ran the command, regardless of audience.

Example: player-only first-time pool

"firstJoin": {
  "enabled": true,
  "audience": "PLAYER",
  "messages": [
    {
      "id": "first_welcome",
      "weight": 1.0,
      "lines": [
        "<gold>Welcome to {server}, {player}!</gold>"
      ]
    }
  ]
}

Example: broadcast returning pool

"returningJoin": {
  "enabled": true,
  "audience": "BROADCAST",
  "messages": [
    {
      "id": "return_announce",
      "weight": 1.0,
      "lines": [
        "<yellow>{player} has returned to {server}!</yellow>"
      ]
    }
  ]
}

Audiences

Practical notes

Example: player-only first-time pool

Example: broadcast returning pool

On this page