Changelog¶
Full version history: Modrinth versions.
2.1.0 — Events, spectators & much more¶
The biggest update so far. Configs and arenas are upgraded automatically: replace the jar and restart the server (no hot reload). 📖 New wiki with every feature, command, permission and placeholder.
⚠️ Important changes¶
- All commands are now only under
/br(or/battleroyale). The shortcuts/join,/leave,/menu,/stats,/top,/party,/shop(and their aliases) and the/brgamealias were removed, so the plugin never takes commands away from your other plugins. Checkcommands.allowedinconfig.yml: the old entriesjoin,leave,esci,party,pnow allow other plugins' commands in a match — remove them if you don't want that. - Chat: new
chat.scope(defaultbr) — the plugin handles only the Battle Royale chats (BR spawn, each match, spectators, event lobby) and leaves the rest of the server's chat untouched.scope: server= the old behaviour. - Permissions split per area (
br.play,br.stats,br.top,br.party,br.shop,br.spectate,br.event… andbr.admin.setup,br.admin.game,br.admin.match,br.admin.event…).br.playerandbr.admingroups,br.*= everything. Help and tab completion only show what you may use. - Admins playing a match now follow the map's building rule too.
- Config files reorganised:
languages/folder,effects.ymlmerged intogame.yml,stats.ymlintoconfig.yml, hub items intolobby.yml— all moved automatically.
🏆 New: Events¶
- Tournaments of matches in a row for registered players: registration with a clickable [JOIN], boss bar, event lobby from the registration on, own chat and scoreboard.
- Map rotation every N minutes, or random map draw: in the last seconds of the break everyone sees a spinning reel of the maps that stops on the drawn one (only free maps, fitting the players online, never the same twice in a row, less-played maps favoured).
- Points (placement + kills), final standings, podium, prizes (commands and coins), history files.
- Custom rules switch, players per match, late join, entry fee, automatic schedule (date / weekly / daily, timezone, announcements).
/br event undo [confirm|replay]cancels the results of the last match (and can replay the same map).- Editor GUI (
/br event edit), full admin commands, placeholders for holograms (event_top_<n>_…,event_last_…,event_next_…).
👀 New: spectators & end of match¶
- Fortnite-style spectator camera: watch living players, Shift = next, clickable buttons, auto-follow (teammate, then the killer),
/br spectate. - Spectators now appear where they died (no more landing on the waiting-lobby platform).
- End-of-match titles per player (VICTORY / DEFEAT / MATCH OVER) and an end-of-match summary.
📊 New: scoreboards & colours¶
- The plugin draws its own sidebar scoreboard for hub, lobby, countdown, match, gulag, spectating, end screen and events (texts in the language files; works alongside TAB).
- Solo: a unique hex colour for every player — a marker before the name and the tab name in that colour; 16 different base colours for names. Team colours in Duo/Squad.
- New placeholders:
name_color,name_hex,name_color_hex,solo_marker,in_matchand many event ones.
⚔️ Gulag¶
- Anti-AFK: a 3×3 area around each duel spawn — whoever never leaves it during the duel loses, the active player wins; both AFK = both out. Warning in the last seconds; area shown with particles while editing.
- Always protected: nobody can break or build in the gulag arena (also on building maps), explosions and fire can't damage it; players in the gulag can't build at all.
- New setup windows: duel spots, extra rings, waiting points, rules, duel kit and return kit (saved from your inventory), back into the match.
🧱 Building maps¶
- Placed blocks fall apart after a while (
game.placed-blocks.decay-seconds, default 60) with a crack animation; cobwebs have their own time (default 15 s); liquids from buckets too. - On maps with building off, blocks, cobwebs, water/lava buckets and dispensers are always blocked.
- A "BUILDING ON" title while gliding, on maps with building enabled.
🛠️ Setup¶
/br setupopens the list of arenas (click to edit, right click to teleport).- Step-by-step chat guide (
/br setup guide). - Markers in the map while editing (chests, airdrops, geysers, spawns, launch points, gulag spots).
- Several skydive launch points per arena, players split between them, teams together.
- Almost every option of
game.ymlis now in the GUI, per arena: match rules, knockdown, zone phases and movement, launch, loot settings, chest sound (own window), airdrops, geysers. - Arena menu split by Solo / Duo / Squad with quick join.
📦 Loot¶
- Chests scale with the players (
loot.chests: per-player or all, spread over the map), named loot tables per arena,loot.refill-secondsworks. - Chest sound: players near a chest that still has loot hear it (radius, sound, pitch, volume; optional stop when opened).
🧰 Admin tools¶
/br adminmatch tools:info,spectate,revive,eliminate,end,zone pause|resume,skipzone,deathmatch,airdrop,refill,gulag open|close|auto,countdown,team./br resetstats <stats|all>: reset everyone's statistics with a confirmation code and an automatic backup (refused during a match). Permissionbr.admin.resetstats(op only, not inbr.admin)./br debug report: a report file for support (passwords hidden).- Update checker (Modrinth).
messages.command-label: texts show/br, or/battleroyalewhen another plugin owns/br.
🐞 Fixes¶
- Holes (empty chunks) in the match map when the template had just been saved.
- Duo/Squad placements now per team; teams fill evenly and parties stay together.
- Match items left on the cursor or crafting grid no longer come back after the match; safer inventory restore.
- Players disconnecting together can no longer hand an offline player the win.
- Losers no longer see the winner's victory title.
- Deploy teleport blocked by another plugin is retried; no geyser launches in the final showdown; a launch that never lifts off ends after 3 s.
- The closed-zone red ring no longer shows to spectators or when the zone hasn't started.
- Plugin fireworks do no damage; chest sound correct for double chests.
- Setup GUI: no double clicks, kits keep every stack, rename never publishes unsaved edits, incomplete arenas get no game.
- Events: back to the right lobby when leaving, no double fees, summer-time safe schedule, thread-safe placeholders.
- MySQL connect timeout; broken config files are never overwritten.
❌ Removed¶
/br bot(test bots) and the plugin's private messages (/msg,/r).- The top-level command shortcuts (see Important changes).