🏆 Battle Royale

A complete Battle Royale minigame for Paper servers, ready to play: Solo, Duo and Squad matches with a skydive deploy, a shrinking (and moving) zone, loot and airdrops, a gulag for a second chance, knockdowns, events with their own leaderboard, and a setup made almost entirely from in-game menus.

Every arena is an independent match with its own mode, lobby and settings, so several matches can run at the same time on the same server. Each match is played on a fresh copy of the map.

📖 Full wiki — installation, setup, every command, permission and placeholder.

---

✨ Features

🎮 Matches

• Solo / Duo / Squad, set per arena, with parties that queue together
• Knockdown & revive in Duo/Squad
• Skydive deploy Fortnite-style, with several launch points and players split between them (teams stay together) — or fixed spawn points
• Geysers that launch you back into the air
• Building per map, with temporary blocks and cobwebs that crack and disappear after a while
• End-of-match titles per player (victory / defeat / match over) and a match summary: placement, kills, damage, time survived, revives, reward
• Rejoin within a grace time after a disconnection

🌀 Zone

• Configurable phases, damage and boss bar, with a particle wall
• Moving zone (the centre drifts between phases) and an anti-stall final collapse

⚔️ Gulag

• Eliminated players fight a 1v1 duel to get back into the match
• Parallel duel arenas, a fast mode when the queue grows, configurable kits
• Anti-AFK: whoever never leaves their spawn area loses the duel, the active player wins
• The gulag arena is always protected: no breaking, building, explosions or fire

📦 Loot

• Loot tables by rarity (custom names, lore, enchantments, potions), per arena
• Chests scaled to the players and spread over the map, refills
• A sound near chests that still have loot
• Airdrops during the match

🏆 Events

• Tournaments of several matches in a row, only for registered players, with an event lobby
• Map rotation on a timer, or a random map draw shown to everyone as a spinning reel
• Separate points leaderboard, prizes, history, automatic schedule
• Custom rules per event, players per match, undo of a match that must be replayed
• Placeholders for holograms (live and last-event standings)

👀 Spectators

• Fortnite-style camera: watch the living players, Shift = next, auto-follow the killer
• Spectators appear where they died, with their own chat

🛠️ Setup without touching files

• /br setup opens the list of arenas; the setup GUI covers zone, phases, spawns, launch points, loot, chest sound, airdrops, geysers, match rules, knockdown, gulag (spots, rules, kits)
• Markers in the map while editing: every chest, airdrop, spawn and gulag spot glows with a label
• A step-by-step chat guide for the first arena
• Every setting is global or per arena (Shift+click = back to global)

🖥️ Server integration

• Hub items, an arena menu split by Solo / Duo / Squad, NPCs (Citizens) and join signs
• Separate chats only for the Battle Royale (BR spawn, each match, spectators, event lobby) — the rest of your server's chat is left untouched
• Scoreboards drawn by the plugin, different in hub, lobby, match, gulag, spectating and end screen
• Unique colours for every player in Solo (hex marker and tab name), team colours and teammate glow in Duo/Squad
• Commands only under /br (or /battleroyale): no conflicts with your other plugins
• Fine-grained permissions for every area

📈 Progression

• Stats: wins, kills, deaths, K/D, games, damage, gulag wins, winstreak, best placement
• XP, levels and coins, a cosmetics shop (glider trails, kill and victory effects), leaderboards
• SQLite (zero setup) or MySQL; safe full stats reset with automatic backup

🔌 Optional integrations

• PlaceholderAPI — many %brbattle_*% placeholders for TAB, scoreboards and holograms
• ProtocolLib — teammate glow visible only to your team
• Citizens — clickable NPCs with a live hologram
• Multiverse-Core — supported for the map worlds

📦 Requirements

• Paper 1.21.4 – 1.21.11 or 26.1 / 26.2 (and Paper forks like Purpur) — one jar for all
• Java 21+

🚀 Quick start

1. Put the jar in plugins/ and start the server once.
2. Build a map in its own world, then run /br setup (or /br setup guide for the step-by-step guide).
3. Set the hub with /br setlobby — done!

Everything else is in the wiki.

📝 Notes

• Server-side only: players don't need to install anything.
• English and Italian included; every text can be edited.
• When you update, configs and arenas are upgraded automatically without losing your values. Always restart the server after replacing the jar (no hot reload).