ВЕРСИИ (5)

## 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](https://giuseppe-marco.github.io/mrtbattleroyale-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 `/brgame` alias were removed, so the plugin never takes commands away from your other plugins. Check `commands.allowed` in `config.yml`: the old entries `join`, `leave`, `esci`, `party`, `p` now allow *other plugins'* commands in a match — remove them if you don't want that. - **Chat:** new `chat.scope` (default `br`) — 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`… and `br.admin.setup`, `br.admin.game`, `br.admin.match`, `br.admin.event`…). `br.player` and `br.admin` groups, `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.yml` merged into `game.yml`, `stats.yml` into `config.yml`, hub items into `lobby.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_match` and 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 setup` opens 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.yml` is 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-seconds` works. - **Chest sound:** players near a chest that still has loot hear it (radius, sound, pitch, volume; optional stop when opened). ### 🧰 Admin tools - `/br admin` match 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). Permission `br.admin.resetstats` (op only, not in `br.admin`). - `/br debug report`: a report file for support (passwords hidden). - Update checker (Modrinth). - `messages.command-label`: texts show `/br`, or `/battleroyale` when 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*).

## 2.0.1 — Bug fixes **Map copies (important for 1.21.x servers)** - Fixed: on Paper 1.21.x the arena map was not copied correctly and matches started on a new vanilla/empty world. The plugin now detects the world layout from the Minecraft version (1.21.x vs 26.x). - Fixed: maps built in void or custom-generator worlds got vanilla terrain in the match copy. The copy now keeps the template's generator and environment (also read from `bukkit.yml` when the template isn't loaded). - Fixed: the copy could fail while the server was saving the template world. - Leftover match copies are now marked, so startup cleanup can never delete a real world named like a copy. Old copies misplaced by the previous bug are cleaned up automatically. - A warning is logged when another plugin cancels the teleport to a spawn point. **Gameplay** - Fixed: in DUO/SQUAD a revived player could die right after the revive (fire, drowning, freezing, wither and poison kept ticking while downed). Revived players also get a short zone-damage grace (`knockdown.revive-zone-grace-seconds`, default 3). - Fixed: falling into the void during a gulag duel no longer wins the duel. - Fixed: a player reconnecting in the rejoin window could stay stuck in the lobby while counted alive. - Fixed: players leaving a match now drop their loot (when `drop-loot-on-death` is on). - Fixed: splash and lingering potions ignored team and spectator rules (friendly fire, debuffing spectators, interfering with gulag duels). Self-buffs and mixed support potions still work. - Fixed: portals could take players out of the match world. - Fixed: spectators falling into the void now get teleported back. - The party leader leaving no longer disbands the party: leadership passes to the next member. **Upgrades, config & storage** - Fixed: upgrading from 1.0.0 could lose custom values (gulag, effects, rewards, stats/MySQL credentials) during the config split. - Fixed: a config file with a YAML syntax error was overwritten with defaults. It is now left untouched and reported in the console. - Servers upgrading from 1.0.0 keep Italian (`language: it`) automatically. - Example arenas are no longer recreated after you delete them. - MySQL: automatic reconnect after idle timeouts; MySQL 8 authentication fixed. - Fixed: after a PlugManX/hot reload, online players' profiles weren't loaded (shop and placeholders broken until relog). - Safer shutdown: one failing step no longer skips saving stats and closing threads. **Other** - `/br top <category>` now shows the value of the chosen category. - Setup: saving/renaming an arena no longer loses data on write errors; match copies can't be used as templates. - Plus many smaller fixes (GUIs, signs, NPCs, chat, enchanted books in loot, compatibility checks for Paper 1.21.4–1.21.11 and 26.1–26.2).

- Modalità Solo / Duo / Squad configurabili per arena - Zona che si restringe a fasi, con opzione **zona mobile** e anti-stallo - **Gulag** con duelli 1v1, duelli paralleli e gulag rapido - **Knockdown & revive** in Duo/Squad - Deploy **SPAWNS** o **SKYDIVE**, geyser - Loot a rarità configurabile (nomi/lore/incantesimi/pozioni), airdrop - **Editor arene con GUI** a categorie - Statistiche complete (SQLite/MySQL), XP/livelli/monete, shop cosmetici, classifiche - Rejoin, anti-fuga comandi, party, quick-join, comandi brevi - Integrazioni: PlaceholderAPI, Citizens, ProtocolLib - **Supporto Paper 1.21.x e 26.x** dallo stesso jar (nuovo sistema mondi 26.x incluso)

First public release of MRT Battle Royale. Includes: - Configurable Solo/Duo/Squad modes per arena - Phased shrinking zone with a **moving zone** and anti-stall option - **Gulag** with 1v1 duels, parallel duels, and quick gulag - **Knockdown & revive** in Duo/Squad - Deploy **SPAWNS** or **SKYDIVE**, geysers - Configurable rarity loot (names/lore/spells/potions), airdrop - **Arena editor with GUI** with categories - Comprehensive statistics (SQLite/MySQL), XP/levels/coins, cosmetic shop, leaderboards - Rejoin, anti-escape commands, party, quick-join, shortcuts - Integrations: PlaceholderAPI, Citizens, ProtocolLib