⚔️ BATTLE ROYAL

Last player standing wins. Simple and brutal.

🎮 What is Battle Royal?

Battle Royal is a multiplayer game mode where everyone fights for themselves. On a massive, freshly generated map, players start with nothing — they must gather resources, craft weapons and tools, and survive an ever-shrinking zone. The last player alive wins.

🖥️ Compatibility

The plugin works on every version of Paper/Spigot 1.21.x, including:

• Paper 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.8, 1.21.11 and newer
• Requires Java 21 or newer
• Requires Vault plugin (money rewards)
• Optional: DecentHolograms (leaderboard), LuckPerms (permission ranks)

🗺️ World & Map

Each game automatically generates a brand new world — new seed, new map, new challenge. After the match ends, the world is deleted from disk. Players spawn at Y=120 with Slow Falling for 60 seconds so they safely descend to the terrain. The map has a fixed time of day (noon) and weather cycle disabled.

🔵 The Zone

The zone runs on Minecraft World Border. Every 30 seconds (configurable) the zone shrinks by 25 blocks. When the zone starts shrinking:

• All players hear a siren alarm composed of escalating sounds
• An animated title appears on screen with the new zone radius
• Players outside the zone lose health every second
• The action bar shows live distance from the center and zone edge

The zone shrinks down to a radius of 20 blocks (configurable).

🧭 Zone Compass

Every player entering the arena receives a compass pointing to the map center (coordinates 0,0) — where the zone converges. The action bar shows live:

• Distance from center (green when safe, orange near edge, red outside zone)
• Distance to zone edge

⏱️ Game Flow

1. Lobby — players type /br join and wait. When the minimum player count is reached (default 2) a 60-second countdown begins. During the last 10 seconds the screen title changes color every second with a ticking sound.

2. Arena Generation — the plugin creates a fresh world. Players are teleported to random spawns distributed in a circle around the map center.

3. Grace Period — for the first 30 seconds (configurable) PvP is disabled. Players can freely gather resources — chop trees, mine ores, craft tools and weapons. The grace period countdown is shown on screen.

4. PvP — after the grace period a sound plays and a "PVP ENABLED" title appears. The zone begins shrinking. Players fight to the last.

5. End — the last player alive wins the prize. A podium of the top 3 players by kill count is shown with medals 🥇🥈🥉. All players are teleported to the server spawn.

💰 Reward System

The reward automatically scales with the number of players in the game:

Values between tiers are linearly interpolated — e.g. 15 players gives ~$20,000. All tiers are fully configurable in config.yml. Rewards are paid automatically via Vault.

🎒 Inventory Safety

The plugin saves the player's full inventory when they type /br join. On the arena, players start empty-handed. After the match ends — whether they won, lost, or disconnected — the inventory is 100% restored. Players return to their configured spawn coordinates.

The system has three layers of protection:

• Players are eliminated without a death screen (full HP, zero drops)
• Inventory is restored only once the player is confirmed to be on spawn
• On server crash — inventory is automatically restored on next login

👥 Duos Mode

Admins enable duo mode via /br mode duos. Players can invite partners:

• /br invite <name> — send an invitation
• /br accept — accept the invitation
• /br deny — decline the invitation

The duo spawns close together. Last duo standing wins — prize split in half. When a partner dies, the player gets a notification and continues fighting solo.

📊 Stats & Leaderboard

The plugin tracks each player's statistics:

• Number of wins
• Number of games played
• Number of kills
• Winrate (%)

Data persists through server restarts. Available via /br stats and /br top.

Optionally — a top 10 hologram leaderboard on spawn via DecentHolograms. Set with /br hologram set, refreshed every 5 minutes and after each game.

🔒 In-Game Restrictions

During Battle Royal the following are blocked:

• Commands: /warp, /home, /spawn, /tp, /fly, /feed, /back, /rtp and others
• Nether and End portals
• Teleportation to other worlds via external plugins
• Flying (fly) — restored after the match if the player had that ability

Admins with the battleroyal.admin permission have access to everything.

🛡️ Plugin Integration

The plugin works with popular plugins:

• Vault — money reward payouts
• LuckPerms — permission system
• DecentHolograms — hologram leaderboard
• PvPManager — BR arena is excluded from combat tag
• Vulcan — anticheat bypass during teleports
• WorldGuard — respects region flags
• Multiverse-Core — proper arena world management

🌍 Available Languages

The plugin supports 11 languages. Change via /br lang <code> or in config.yml:

Language files are copied to plugins/BattleRoyal/lang/ and can be edited manually. You can also add a custom language by creating a new .yml file in that folder.

📋 Full Command List

Player Commands:

Admin Commands (permission battleroyal.admin):

⚙️ Configuration

Everything is fully configurable in plugins/BattleRoyal/config.yml:

• Minimum and maximum player count
• Lobby countdown duration
• Grace period duration
• Reward tiers for each player count
• Zone size and shrink speed
• Zone damage amount
• Generated world size
• Blocked commands during game
• Spawn coordinates after match
• Plugin language

After changes just run /br reload — no server restart needed.

Works on Paper/Spigot 1.21.x (including 1.21.11) | Requires Java 21+