Simple Broadcast

Simple Minecraft plugin for Paper/Spigot that sends automatic messages to the server chat

❇️​ This plugin belongs to the Simple Plugins collection, check out other similar and compatible plugins here

Features

• All configuration is read from config.yml
• Configurable prefix for broadcast messages (prefix)
• Configurable interval in seconds (interval)
• Sequential or random sending (random-send)
• Minecraft color codes supported using &
• Safe handling when the message list is empty
• All plugin messages are configurable in config.yml, including the plugin name prefix

Commands

• /sb reload Reloads the plugin configuration
• /sb toggle Pauses or resumes automatic message broadcasting

Permissions

• reload: requires permission sp.reload (default: op)
• toggle: requires permission sp.toggle (default: op)

Configuration

prefix: "&7[&a!&7]"
interval: 60
random-send: false
messages:
  - "&aThis is the &lfirst &r&a example message."
  - "&bThis is the &lsecond &r&b example message."

plugin-messages:
  prefix: "&7[&aSimpleBroadcast&7]"
  reload-success: "&aConfiguration reloaded successfully."
  reload-no-permission: "&cYou do not have permission to run this command. (sp.reload)"
  toggle-resumed: "&aMessage broadcasting resumed."
  toggle-paused: "&eMessage broadcasting paused."
  toggle-no-permission: "&cYou do not have permission to run this command. (sp.toggle)"
  usage: "&7Usage: &f/<command> <reload|toggle>"

• prefix: Prefix added at the start of each broadcast message
• interval: Interval in seconds between each message
• random-send:
  • false: Messages are sent in order; when the list ends, it starts again from the beginning
  • true: A random message is chosen, avoiding repeating the last one
• messages: List of messages to broadcast.
• plugin-messages: Messages shown by the plugin for commands. Use & for color codes. in usage is replaced with the command used (/simplebroadcast or /sb).

Requirements

• Java 21 (LTS)
• Paper or Spigot server on the latest supported version

Internal behaviour

• The plugin schedules a repeating task using Bukkit's scheduler
• On enable (onEnable), it saves the default config, loads it, and starts the task
• On disable (onDisable), it cancels the task
• Each run of the task:
  • Reads the message list from the configuration.
  • If it is empty, it does nothing and returns silently
  • Applies & color codes via ChatColor.translateAlternateColorCodes
  • Broadcasts the message to the whole server with the configured prefix