Module Messages and Broadcasts

Messages & Broadcasts Module

Config file: modules/messages.yml — current version: 1.0 — view current default on GitHub Enable via config.yml → modules.messages: true

⚠ In an upcoming version, broadcasts.enabled will default to false in the shipped config (the example broadcast texts reference commands like /report that likely don't exist on a fresh server). Check the Releases page — if you're on that version, write your own broadcast text and enable it deliberately.

Features

• Custom join and quit messages, plus a dedicated message shown only on a player's first ever join.
• MOTD: a set of lines shown to players when they join (independent of the server list MOTD).
• Auto-broadcast system: any number of timed chat messages, each with its own independent cooldown/interval — great for rules reminders, ads for other servers/socials, etc.
• No commands — this module is purely passive/event-driven, controlled entirely through config.

Configuration (modules/messages.yml)

messages:
  join: "<bold><gray>[<green>+</green>] <white>%player%</white>"
  first-join: "<gradient:gold:yellow>Welcome!</gradient> <white>%player%</white>"
  quit: "<gray>[<red>-</red>] <white>%player%</white>"

motd:
  enabled: true
  lines:
    - "<gradient:gold:yellow>Welcome to our server!</gradient>"
    - ""

broadcasts:
  enabled: true
  message1:
    text: "<yellow>Report unserious players by using /report</yellow>"
    cooldown: 300 # in seconds
  message2:
    text: "<yellow>Be nice and don't insult anyone in the chat!</yellow>"
    cooldown: 60 # in seconds

• %player% in messages.* is replaced with the joining/leaving player's name.
• Add as many messageN: entries under broadcasts: as you like (message3, message4, ...) — each one runs on its own independent timer (cooldown, in seconds) via a global region scheduler, so it's Folia-safe.
• Setting motd.enabled: false disables the join-MOTD entirely (join/quit messages are unaffected).
• All text supports MiniMessage.