The 1.1 will be a final version for now. I prefer to have a reliable plugin without errors than a plugin with multiple methods and errors or lags.

Looking for an easy way to display server tips, rules, Discord links, or announcements? BroadcastSystem provides two independent auto-broadcast systems (Chat + Title), plus join messages, manual commands, `&` colors, placeholders, and a clean JSON configuration.

Features:

✅ Chat broadcasts (multi-line supported)
✅ Title broadcasts (Event Title / “big title” in the middle of the screen)

It also includes:

✅ Manual broadcast commands
✅ Join messages (private message to joiner + public message to everyone)
✅ Minecraft-style & color codes
✅ Placeholders like %player% and %joiner%
✅ Simple JSON configuration (config.json)

Features

1) Two independent broadcast systems

Each system has its own settings:

enabled/disabled
interval in seconds
shuffle mode (random) or round-robin order

So you can run:

Chat every 120s
Title every 300s
Or disable one entirely.

2) Shared announcement pool with per-entry targets

You define announcements once in "announcements" and choose where they go using:

"targets": ["CHAT"]
"targets": ["TITLE"]

Each announcement can contain:

"chat" content (multi-line block)
"title" content
"subtitle" content (optional)

3) Join messages (optional)

Two dedicated join message sections:

joinSelf: only sent to the joining player
joinServer: broadcast to all online players

Both support:

chat and/or title targets
multi-line blocks
placeholders
optional disabling of vanilla join message

4) Text formatting

Legacy color codes

Supports Minecraft-like codes:

Colors: &0 to &9, &a to &f
Formatting: &l (bold), &o (italic), &r (reset)
Works with both & and §

Multi-line blocks

For chat messages (and join chat), you can use:

"chat": "----\nLine 1\nLine 2\n----"

Or simply use \n newlines.

5) Placeholders

%player%
Replaced with the recipient player name (the player who receives the message).
%joiner%
Replaced with the joining player name (only meaningful for join messages).
%world%
Replaced with the recipient player’s current world (best-effort: name/id/uuid depending on API availability).
%players_online%
Replaced with the number of players currently online.
%online% (alias of %players_online%)
Same as above, shorter name.
%server_uptime%
Replaced with the server/plugin uptime (time since plugin boot), formatted like:
12m 05s, 3h 12m 09s, 2d 04h 01m 33s
%time%
Current server local time: HH:mm:ss
Example: 21:43:10
%date%
Current server local date: yyyy-MM-dd
Example: 2026-01-15
%datetime%
Current server local date + time: yyyy-MM-dd HH:mm:ss
Example: 2026-01-15 21:43:10
%day%
Current day of week (uppercase): MONDAY, TUESDAY, etc.
%timezone%
Current server system timezone id (example: Europe/Paris)

Random integer

%random_int:min:max%
Generates a random integer between min and max (inclusive).
Examples:

%random_int:1:100% → 42
%random_int:-5:5% → -1
%random_int:10:10% → 10

Random choice

%random_choice:a|b|c%
Randomly picks ONE option from a | separated list.
Examples:

%random_choice:Read /rules|Join Discord|Use /help%
%random_choice:Hello|Hi|Hey%

✅ Supports placeholders inside options, for example:

%random_choice:Online: %online%|World: %world%|Time: %time%%

Commands

Main command: /hb

`/bs reload`

Reloads config.json and restarts the broadcast schedulers.

`/bs status`

Shows current status:

whether chat/title systems are enabled
intervals
pool sizes
config file path

`/bs` `now [chat|title|both]`

Instantly sends a broadcast from the configured pool.

Examples:

/bs now
/bs now chat
/bs now title

`/bs start [chat|title|both]`

Starts broadcasting.

Examples:

/bs start
/bs start chat

`/bs stop [chat|title|both]`

Stops broadcasting.

Examples:

/bs stop
/bs stop title

`/bs send chat <message...>`

Sends a manual chat announcement to all players.

Example:

/bs send chat &aHello world!

`/bs send title <message...>`

Sends a manual title announcement to all players.
Supports \n to force multi-line title.

Example:

/bs send title &eServer Restart\n&7In 5 minutes

Permissions

Admin permission (full control)

- broadcast_system.admin
Allows:

reload
status
start/stop
now

Send permission (manual broadcasts only)

- broadcast_system.send
Allows:

/hb send chat ...
/hb send title ...

Operator fallback

If your server uses role permissions, the plugin also allows:

role.operator

Configuration

The plugin creates:

mods/Yanisssch_BroadcastSystem/config.json

Key sections:

chat
title
joinSelf
joinServer
announcements

Important notes

If "showSubtitle": false, subtitles will be hidden even if provided.
If subtitle is empty, title.defaultSubtitle is used (when enabled).
If disableDefaultJoinMessage is true for join configs, vanilla join broadcast is disabled.
Do not use colors for Title, this not work….
Do not use BOTH target for announcement (currently fixing an issue with this target)
Be careful when making the config, keep backup in case your making errors, the "," and "{}" are very important and do not use " in the chat or title it can break the config itself ;)
Take time to test the plugin and read all the config file
And, this plugin is the first i made for Hytale, i'm still learning the api so if you see some bugs do not hesitate to tell me on discord "Yanisssch_Sori"

Example Config

{
  "_comment": "BroadcastSystem config.json - examples. Colors(only for the chat - not the titles!): &a, &6, &l, &r… Placeholders: %player% = recipient, %joiner% = joining player. '\n' blocks allow multi-line text only for chat, not titles!",
  "_help_targets": "targets for JoinSelf and JoinServer can be: [\"CHAT\"], [\"TITLE\"], and for announcement can be [\"BOTH\"] (or [\"CHAT\",\"TITLE\"]).",

  "chat": {
    "_comment": "Automatic announcements in chat.",
    "enabled": true,
    "intervalSeconds": 120,
    "shuffle": false,
    "prefix": "&6&l[INFO]&r "
  },

  "title": {
    "_comment": "Automatic announcements as center title (EventTitle).",
    "enabled": true,
    "intervalSeconds": 300,
    "shuffle": false,
    "showSubtitle": true,
    "defaultSubtitle": "&eAnnouncement",
    "animate": true
  },

  "joinSelf": {
    "_comment": "Message sent ONLY to the joining player (private).",
    "enabled": true,
    "disableDefaultJoinMessage": true,
    "targets": ["BOTH"],
    "chat": "----\n&aHi &f%player%&a!\n&7Welcome! Please read &f/rules&7 :)\n----",
    "title": "Welcome %player% to ServerName!",
    "subtitle": "Have fun ;)",

    "_example_title": {
      "_comment": "ALTERNATIVE EXAMPLE: show a Title instead of chat",
      "enabled": false,
      "disableDefaultJoinMessage": true,
      "targets": ["TITLE"],
      "title": "WELCOME",
      "subtitle": "&7Rules: &f/rules"
    },

    "_example_chat": {
      "_comment": "ALTERNATIVE EXAMPLE: show a Chat instead of title",
      "enabled": false,
      "disableDefaultJoinMessage": true,
      "targets": ["CHAT"],
      "chat": "----\n&aHi &f%player%&a!\n&7Welcome! Please read &f/rules&7 :)\n----"
    }
  },

  "joinServer": {
    "_comment": "Message sent to EVERYONE when someone joins.",
    "enabled": true,
    "disableDefaultJoinMessage": true,
    "targets": ["CHAT"],
    "chat": "----\n&6&l[JOIN]&r &e%joiner% &ahas joined the server!\n----",

    "_example_both": {
      "_comment": "ALTERNATIVE EXAMPLE: send both CHAT + TITLE at the same time.",
      "enabled": false,
      "disableDefaultJoinMessage": true,
      "targets": ["BOTH"],
      "chat": "----\n&6&l[JOIN]&r &e%joiner% &ahas joined the server!\n----",
      "title": "&aNew player!",
      "subtitle": "&e%joiner%"
    }
  },

  "_comment": "For the announcement, no BOTH for the target (Currently fixing an issue with this part)",
  "announcements": [
    {
      "_comment": "EXAMPLE 1: CHAT multi-line announcement (with ----\n block).",
      "targets": ["CHAT"],
      "chat": "----\n&bWelcome &f%player%&b!\n&7Make sure to read &f/rules&7 :)\n----"
    },

    {
      "_comment": "EXAMPLE 2: TITLE announcement.",
      "targets": ["TITLE"],
      "title": "WELCOME",
      "subtitle": "Have fun!"
    },

    {
      "_comment": "EXAMPLE 3: TITLE without subtitle).",
      "targets": ["TITLE"],
      "title": "Need help?",
      "subtitle": ""
    },

    {
      "_comment": "EXAMPLE 4: CHAT Discord announcement.",
      "targets": ["CHAT"],
      "chat": "----\n&bDiscord: &ddiscord.gg/....\n&7Come say hi!\n----"
    }

  ]
}

Use cases

Server tips / rules reminders
Discord link rotations
Event announcements
Welcome messages

Installation

Download the .jar
Put it in the mods folder in your server files
Restart the server
Check the config file at /mods/Yanisssch_BroadcastSystem
Restart the server or do /hbs reload
And check the result
And voila ;)

SUPPORT

You can contact me on discord only: Yanisssch_Sori (i can take 6 to 12hours to respond)

The 1.1 will be a final version for now. I prefer to have a reliable plugin without errors than a plugin with multiple methods and errors or lags.

Looking for an easy way to display server tips, rules, Discord links, or announcements? BroadcastSystem provides two independent auto-broadcast systems (Chat + Title), plus join messages, manual commands, & colors, placeholders, and a clean JSON configuration.

Features

1) Two independent broadcast systems

2) Shared announcement pool with per-entry targets

3) Join messages (optional)

4) Text formatting

Legacy color codes

Multi-line blocks

5) Placeholders

Random integer

Commands

/bs reload

/bs status

/bs now [chat|title|both]

/bs start [chat|title|both]

/bs stop [chat|title|both]

/bs send chat <message...>

/bs send title <message...>

Permissions

Admin permission (full control)

Send permission (manual broadcasts only)

Operator fallback

Configuration

Important notes

Example Config

Use cases

Installation

SUPPORT

Looking for an easy way to display server tips, rules, Discord links, or announcements? BroadcastSystem provides two independent auto-broadcast systems (Chat + Title), plus join messages, manual commands, `&` colors, placeholders, and a clean JSON configuration.

`/bs reload`

`/bs status`

`/bs` `now [chat|title|both]`

`/bs start [chat|title|both]`

`/bs stop [chat|title|both]`

`/bs send chat <message...>`

`/bs send title <message...>`