⚡ PulseMsg

Timed broadcast & advertisement plugin — clickable links, hex colors, priority overrides, and a smart flood guard.

EliminationPlus

📖 What is PulseMsg?

PulseMsg is a lightweight but powerful broadcast plugin that lets server owners schedule timed advertisement messages with full color control, clickable links, hover tooltips, and a smart flood guard so players never get spammed.

Each message runs on its own independent timer — no more messages colliding or overflowing chat at the same time.

✨ Features

Feature	Description
⏱ Per-message timers	Each message has its own `interval-seconds` — completely independent
🔗 Clickable links	Open URLs, suggest commands, run commands, or copy text to clipboard
🎨 Full color support	Legacy `&x` codes and hex `&#RRGGBB` both supported on every line
🚨 Priority messages	Mark a message as `priority: true` to always fire, even alongside others
🛡 Flood guard	At most one non-priority message per scheduler tick — no chat spam
🔒 Permission gating	Send specific messages only to players with a given permission node
🔀 Random or sequential	Send messages in order or shuffle them with `random-order: true`
👥 Minimum players	Skip broadcasts when fewer than N players are online
♻ Hot reload	`/pm reload` applies all config changes with zero server restart

EliminationPlus

📋 Commands

All commands require the pulsemsg.admin permission (default: OP).
Aliases: /pulsemsg, /pm, /pulse

Command	Description
`/pm reload`	Reload config and restart the scheduler
`/pm list`	List all messages with enabled/disabled status
`/pm send <id>`	Manually fire a message immediately
`/pm info <id>`	Show details and next-fire countdown for a message
`/pm toggle`	Pause or resume all broadcasts
`/pm help`	Show the help menu

🔑 Permissions

Node	Default	Description
`pulsemsg.admin`	OP	Full access to all PulseMsg commands
`pulsemsg.bypass`	false	Player will never receive any broadcasts

⚙ Configuration

PulseMsg generates a fully documented config.yml on first run. Here's a taste:

global-interval-seconds: 60
global-prefix: '&#5865f2&l[PulseMsg]&r '
random-order: false
minimum-players: 0

messages:

  discord-ad:
    enabled: true
    title: '&#7289da&l⚡ Join Our Discord ⚡'
    body:
      - '&7Stay connected with the community!'
      - '&7Get support, updates, and giveaways.'
      - ' '
      - '&#7289da&l&nJoin Now&r &7— discord.gg/example'
    interval-seconds: 300
    priority: true                  # always fires even alongside other messages
    prefix: '&#7289da[Discord]&r '  # overrides the global prefix
    click:
      action: OPEN_URL
      value: 'https://discord.gg/example'
      hover: '&9Click to join our Discord!'

  store-ad:
    enabled: true
    title: '&#f1c40f&l★ Support The Server ★'
    body:
      - '&7Ranks, cosmetics and more at our store!'
    interval-seconds: 1200
    priority: false
    click:
      action: OPEN_URL
      value: 'https://store.example.com'
      hover: '&eClick to open the store!'

Click actions

Action	Effect
`OPEN_URL`	Opens a URL in the player's browser
`SUGGEST_CMD`	Puts text into the player's chat box
`RUN_CMD`	Runs a command as the player
`COPY_TEXT`	Copies text to the player's clipboard

How scheduling works

PulseMsg ticks every global-interval-seconds. Each tick it counts down every message's own timer independently. When a message is due:

Priority messages always fire — even if another message is also due that tick.
Non-priority messages are flood-guarded — only one fires per tick. If multiple are due simultaneously, the others simply wait for their next natural interval.

🖥 Requirements

Minecraft: 1.20+
Server: Spigot or Paper
Java: 17 or newer

Made with care by rradajbi — open an issue on GitHub for bugs or feature requests.

PulseMsg

📖About PulseMsg