> For the complete documentation index, see [llms.txt](https://27rogi.gitbook.io/server-toolbox/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://27rogi.gitbook.io/server-toolbox/configuration/broadcaster.md).

# Broadcaster

Send global messages to players!

<figure><img src="https://684403984-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LjqKdbFlXK03kz8Il1c%2Fuploads%2FuZXr8Ipv2DhzeP7wtm5J%2Fimage.png?alt=media&amp;token=f07f6784-9c33-4012-9552-3fa7e6cf0990" alt=""><figcaption><p>Example message on server</p></figcaption></figure>

In `broadcaster.conf` you can find two options such as `broadcasts` and `configVersion`, you should only edit **first** one. It should look like this:

```json5
broadcasts {
    <broadcast_name> {
        // List with your messages
        messages=[
            {
                lines=[
                    "<red>My first broadcast?"
                ]
            },
            {
                lines=[
                    "<red>My second broadcast?"
                ]
            }
            // and etc...
        ]
        // This prefix will be applied to all messages sent
        prefix="[server]"
        // Minimum player requirement to send this broadcast
        min-players=1
        // Next time broadcast will be run, be sure NOT to
        // edit this unless you know what you're doing!
        next-date-time="2023-07-18T12:01:26.344175264"
        // Should messages be randomized or follow the order
        randomize=false
        // Only players with permissions will be able to receive broadcast
        requires-permission=false
        // Timeout in seconds between messages
        timeout=45
    }
}
```

I tried to explain everyting using comments above, but I still want to clarify some things about few parameters:

#### requires-permission

Players will receive message **only** if they have special permission which depends on your broadcast name, it looks like this: `server-toolbox.broadcasts.<broadcast_name>.receive`

#### timeout

This value represents timeout between messages in seconds, but please **don't use too short timeouts** (like 5,10,20 seconds) as it can affect the server performance too much!

### Formatting and Placeholders

Broadcasts support formatting and placeholders in prefix and messages, [use this documentation](https://placeholders.pb4.eu/user/general/) to understand how it works.
