BattleRoyalePlugin

BattleRoyale Plugin

BattleRoyale is a lightweight, fully automated mini-game plugin designed to turn your dedicated server instance into a competitive PvP battleground. It handles the entire game lifecycle—from map generation to team assignment and the final showdown—without requiring any administrator intervention.

✨ Key Features

• 🌎 Automated World Generation: Every time the server starts, a fresh world (arena_world) is generated with a random seed. No two games are the same!
• ⚔️ Solo & Duo Teams: The plugin automatically shuffles players and assigns them to teams upon game start.
• ⭕ The Danger Zone: A shrinking WorldBorder forces combatants closer together. Includes custom logic to damage players caught outside the safe zone.
• 💰 Economy System: Built-in coin tracking. Players earn currency for kills and winning the match.
• 📊 Immersive UI: Features a dynamic Scoreboard, Action Bar messages, and Titles to keep players informed of the countdown, border state, and team status.
• 🌐 Multi-Language Support: Comes out-of-the-box with support for English, German, and Russian. Language files are fully customizable.
• 🔄 Auto-Reset Cycle: Once a winner is declared, the server automatically shuts down/restarts to reset the map and state for the next round.

🎮 Gameplay Loop

1. Lobby Phase: Players join and are teleported to a glass waiting platform high in the sky. The game waits for the minimum player count.
2. The Drop: Players are scattered randomly across the map and their inventories are cleared.
3. Preparation: A "Freeze" timer allows players to orient themselves before PvP is enabled.
4. Survival: Players gather resources and fight.
5. Sudden Death: After a configurable time, the border begins to shrink rapidly to a small area (default 50x50).
6. Victory: The last team standing wins the prize pool.

⚙️ Configuration

The plugin creates a config.yml where you can tweak almost every aspect of the game logic:

lang: en # switch to 'de' or 'ru'
timers:
  lobby-countdown: 300
  freeze-time: 30
  border-shrink-start: 600 # Time in seconds before border moves
  border-shrink-duration: 300
economy:
  kill-reward: 10
  win-reward: 100
world:
  name: arena_world
  lobby-size: 50
  arena-size: 1000
  final-size: 50

🌍 Localization

The plugin includes a langs folder. You can switch the language in the config or edit the files directly to change messages.

• langs/en.yml (English)
• langs/de.yml (German)
• langs/ru.yml (Russian)

⚠️ Installation Note

This plugin is designed for Dedicated Game Servers. Because the plugin automatically unloads worlds and shuts down the server to reset the game state, it should not be installed on a main Survival or Hub server. It is best used on a separate server instance connected via BungeeCord or Velocity.