MRTBattleRoyale

🏆 MRT Battle Royale

A complete, ready-to-play Battle Royale minigame for Paper 1.21 servers: shrinking zone, gulag, teams, rarity loot, and a GUI arena editor. Each arena is an independent match with its own mode and lobby, so you can run multiple matches simultaneously on the same server.

✨ Key Features

Game Modes

• Configurable Solo / Duo / Squad modes per arena
• Knockdown & Revive in Duo/Squad: if you get knocked down, a teammate can revive you
• Min/Max players, dedicated lobby, and all settings per arena

Shrinking Zone

• Configurable stages with particle wall and boss bar
• Optional Moving Zone (Fortnite style): the center moves instead of closing always to the center of the map
• Anti-Stalemate: If the final battle lasts too long, the zone closes completely

Gulag (Second Chance)

• Those who die fight a 1v1 to get back into the match
• Parallel Duels: Multiple fight rings to clear the queue quickly
• Automatic Quick Gulag when there are many players waiting

Deploy

• SPAWNS (separate points) or Fortnite-style SKYDIVE (air launch, elytra glide, land anywhere)
• Geyser: Jump on a point to be relaunched into the air

Loot & Supplies

• Crates with rarity loot (common → legendary), fully configurable
• Custom items: names, lore, spells, potions
• Mid-match airdrop with top loot, signaled by fireworks

Arena Setup with GUI

• Visual category editor with status indicators (done/missing)
• No more manual file editing: create and configure everything in-game

Stats & Progression

• Wins, kills, deaths, K/D, matches, damage dealt, gulag wins, winstreaks, best placement
• XP, levels, and coins earned at the end of the match
• Cosmetic Shop: glider trails, kill effects (even Lightning!) and victory effects
• Saving to SQLite (zero config) or MySQL
• In-game Leaderboards (/top)

Quality of Life

• Rejoin: Those who disconnect from a game can rejoin within a grace period
• Anti-escape: Commands like /spawn, /home, /tp are blocked while in a game
• Party: Play as a team with your friends
• Quick-join: /join automatically joins the busiest game
• Shortcuts: /join, /leave, /party, /stats, /top, /shop, /list

🔌 Optional Integrations

• PlaceholderAPI — dozens of %brbattle_*% placeholders for scoreboards/tabs
• Citizens — Clickable NPCs with live holograms (real-time player/status (real)
• ProtocolLib — teammate glow visible only to your team

📦 Requirements

• Paper 1.21 (or fork: Purpur, etc.)
• Java 21+
• (Optional) PlaceholderAPI, Citizens, ProtocolLib

🚀 Installation

1. Place the jar in the server's plugins/ folder and run it once.
2. Build a map in a dedicated world, then create the arena with /br setup gui.
3. Set up the lobby with /br setlobby and you're all set!

📝 Notes

• Server-side plugins: players don't need to install anything.
• All settings are overridden on a per-arena basis.
• When updating, config and arenas will automatically update without losing your settings.