Ultimate Broadcast 2.4.0 — the rescue release

This update fixes the two reasons 2.1.0–2.3.0 lost most of their downloads: a broken default config that could stop the plugin from starting, and missing Minecraft version tags that hid the newest builds from 1.21.5+ servers. It also adds the features players and server owners actually asked for.

🔥 Critical fixes

The plugin could fail to start on a fresh install

config.yml shipped in 2.1.0–2.3.0 had gui.title indented with three spaces while its siblings used two. Bukkit refuses to parse that file, so the plugin could disable itself on first start — which is why 2.1.0 only ever reached a handful of downloads while 2.0.2 kept being downloaded.

2.4.0:

ships a valid configuration,
detects the exact broken layout on existing installs,
writes a timestamped backup (config.backup-<date>.yml),
repairs the indentation in place,
and starts normally.

Your comments and custom values are preserved — the file is fixed, not replaced.

The newest builds were invisible on modern Minecraft

2.3.0 was published with game_versions ending at 1.21.4, even though 2.0.2 supported up to 1.21.11. Servers on 1.21.5–26.3 could not install the newer version at all.

2.4.0 is listed for every version from 1.21 through 26.3, verified on Paper 1.21.4, Paper 26.3 and Folia 26.3.

🛠 Other bugs fixed

Bug	Impact	Fix
`Sound.valueOf(...)` used at runtime	On 1.21.4+ `Sound` became an interface, so the call throws `NoSuchMethodError` and sounds break	Registry-based resolver with enum fallback and a per-name cache
MySQL schema used `AUTOINCREMENT` and SQLite-only `ON CONFLICT`	"MySQL support" could never create its tables	Dialect-aware DDL, portable upserts, epoch-millis timestamps
SQLite driver class pointed at a relocated package	Database could silently stay uninitialised	Storage rewritten without shading/relocation, verified on startup
GUI listener cancelled every inventory click on the server	Players could not use any other plugin's GUI	Clicks are only handled when our own `InventoryHolder` is open
GUI item names were `Component.toString()` dumps	Menus displayed `TextComponentImpl{...}` garbage	Real Adventure components for titles, names and lore
Scheduled entries were loaded from config and database	Every reload duplicated announcements	Config is the single source of truth
`random-messages.interval-minutes` and per-message `weight` ignored	Random pool fired on the scheduler interval and picked uniformly	Dedicated weighted rotation on its own interval
PlaceholderAPI only applied when a sender existed	`%player%`/PAPI placeholders were never resolved in scheduled messages	Rendered per recipient, for every source
Countdown/actionbar required a player sender	Console could not start a countdown	Works from console
Titles used legacy strings	Hex gradients turned into `§x` gibberish	Adventure `Title` with full RGB
Network relay re-broadcast its own messages	Duplicate announcements across servers	Message IDs with a dedupe window
SQL ran on the server thread	TPS spikes when history/preferences were written	Single background writer thread

✨ New features

🔔 Player subscription centre

/broadcast toggle — master opt-out.
/broadcast toggle events — per-category opt-out.
/broadcast settings — GUI with a toggle per category.
Configurable categories with display names, descriptions, default state and permission.
Preferences stored in SQLite/MySQL and loaded asynchronously on join.
Filtering happens before rendering, so opted-out players cost nothing.

💬 Discord mirroring (no bot required)

Webhook-based, runs on its own daemon thread.
Rate-limit aware, retries transient failures, respects 429.
Choose which events mirror: manual, scheduled, random, countdown.
Configurable username, avatar, colour, footer and optional @everyone for manual broadcasts.
/broadcast discord test verifies the setup.

🎛 Five delivery channels

/broadcast send <chat|actionbar|title|subtitle|bossbar> <message> — plus the legacy /broadcast title, /broadcast actionbar shortcuts.

🧵 True Folia support

Runtime Folia detection.
Global region scheduler for timers, async scheduler for storage, per-entity scheduler for player messages.
Verified on Folia 26.3: timers fire on the region scheduler and messages are dispatched per player.

🧠 Delivery guard

Duplicate window (proxy echo protection).
Hard per-second cap.
TPS-aware effects (chat still sends, sounds/particles pause).
Minimum-player rule.
Per-player cooldowns for scheduled entries.

⚙️ Operations

/broadcast stats — totals, players reached, duplicate drops, storage backend, Discord health, live TPS.
/broadcast history — last 20 announcements from the database.
/broadcast list — next run time for every scheduled entry.
settings.debug: true logs exactly why an announcement was skipped.
Safe /broadcast reload that restarts schedulers without duplicating tasks.

🔌 PlaceholderAPI

New placeholders, all served from memory:

%ultimatebroadcast_total%, %ultimatebroadcast_scheduled%, %ultimatebroadcast_delivered%, %ultimatebroadcast_duplicates%, %ultimatebroadcast_enabled%, %ultimatebroadcast_cooldown%, %ultimatebroadcast_subscribed_<category>%.

⚡ Performance & reliability

No SQL on the server thread. History, stats and preferences are queued to a single daemon writer; SQLite runs in WAL mode with a single writer, eliminating database is locked under load.
Messages without placeholders are parsed once per broadcast, not once per player.
One 1-second ticker replaces one Bukkit task per scheduled entry; intervals no longer drift and /reload cannot pile up duplicate tasks.
Sound and particle lookups are cached after the first resolve.
Effects back off automatically below your TPS threshold.
History is pruned automatically to settings.history-limit.

🧩 Compatibility


Minecraft	1.21, 1.21.1–1.21.11, 26.1, 26.1.1, 26.1.2, 26.2, 26.3
Platforms	Paper, Purpur, Folia
Java	21+ (26.x servers require Java 25, as always)
Optional	PlaceholderAPI

Verified during this release: Paper 1.21.4 (Java 21), Paper 26.3 (Java 25), Folia 26.3 (Java 25) — plugin enabled, all five channels delivered, scheduler fired, database writes confirmed.

Spigot/Bukkit are no longer listed. The plugin uses Adventure components for hex colours and titles, which Spigot does not provide; the 2.x Spigot listing could not actually enable. Listing only Paper/Purpur/Folia keeps the download button honest.

⬆️ Upgrading from 2.x

Drop the new jar in plugins/ and restart.
Your config is migrated automatically:
- invalid YAML is repaired (with a backup),
- settings.database / countdown.database move to the new top-level database section in memory,
- settings.bungeecord-support and settings.cross-server-channel map to the new network section.
The old minecraft.db SQLite file is renamed to broadcast.db — data is preserved.
Permission change: ultimatebroadcast.use now defaults to op (2.x defaulted to true, letting any player broadcast). Grant it explicitly to staff or VIP ranks if needed.
/broadcast enable|disable is now a runtime switch and no longer rewrites config.yml.

No config keys were removed. Old gui.items, scheduler.broadcasts, template, countdown and default-* sections keep working.

📦 Technical details

Build: Java 21 target, Paper API 1.21, shaded SQLite + MySQL drivers, no external plugin dependencies.
Storage tables: broadcast_history, broadcast_stats, broadcast_preferences.
All three tables are created automatically on both SQLite and MySQL.

If 2.1–2.3 broke your server: sorry. 2.4.0 is the version that should have shipped. Please open an issue with your log if anything still misbehaves.

Ultimate Broadcast

Links

Tags

Creators

Details

2.4.0

Compatibility

Changes