Announcer

Announcer

Simple, flexible announcements plugin for Bukkit-based servers. Broadcast to chat, action bar, title, or boss bar using MiniMessage. Templates, schedules, per-type permissions, PlaceholderAPI integration, and config-driven targeting.

Platforms

• Paper, Spigot, Bukkit, Purpur

Features

• Announcement types: chat, actionbar, title, bossbar
• MiniMessage support plus custom <centered> tag
• Configurable templates per type
• /announce command to broadcast custom messages
• /announcer reload to reload config and reschedule tasks
• Scheduled announcements via config.yml with per-entry intervals
• Targeting by worlds and permission groups
• Per-type permission nodes for granular access
• PlaceholderAPI integration (optional) per-player
• Legacy fallbacks for 1.8 (degrades to chat where APIs are unavailable)

Compatibility

• Built for modern Bukkit API (e.g., Paper 1.21.x; Java 21)
• Works on older servers with graceful fallbacks; for strict 1.8 parity, consider a dedicated legacy build

Installation

• Place Announcer-<version>.jar in your server plugins folder
• Restart the server
• Optional: install PlaceholderAPI for %placeholders% support

Commands

• /announce <chat|actionbar|title|bossbar> <message...>
• /announce <message> uses settings.default_type (defaults to chat)
• /announcer reload reloads config.yml and reschedules tasks

Permissions

• announcer.command — use /announce (default: op)
• announcer.reload — use /announcer reload (default: op)
• announcer.chat — send chat announcements
• announcer.actionbar — send action bar announcements
• announcer.title — send title announcements
• announcer.bossbar — send boss bar announcements

Configuration

• templates.chat — MiniMessage template for chat
• templates.actionbar — template for action bar
• templates.title — title, subtitle, fade_in, stay, fade_out
• templates.bossbar — message, color, overlay
• settings.default_type — default type for /announce <message>
• targets.<name> — worlds and permission filters (e.g., all, staff)
• schedule[] entries:
  • type: chat|actionbar|title|bossbar
  • message: MiniMessage string
  • interval_seconds: repeat interval
  • target: target group name
  • bossbar_duration_seconds: optional duration for boss bar visibility

Schedule example

schedule:
  - type: chat
    message: "<gold>Remember to join our Discord!</gold>"
    interval_seconds: 300
    target: "all"
  - type: bossbar
    message: "<red>Server restarting soon</red>"
    interval_seconds: 600
    target: "all"
    bossbar_duration_seconds: 10

MiniMessage

• Fully supports MiniMessage formatting (e.g., <gold>, <bold>, <gradient:red:gold>)
• Custom tag: <centered:Your text> inserts centered text into the output