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

```yaml 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