Battle Royale by HeWo

[!WARNING]

🚧 PROJECT IS STILL IN DEVELOPMENT

This project is NOT feature-complete yet! Some features described below may be missing, incomplete, unstable, or subject to change. The project is currently under active development and is not considered production-ready.

⚔️ Minecraft Battle Royale

Turn your Minecraft world into an intense Battle Royale arena!

Players are spread across the map, gather equipment during a protected preparation phase, and once PvP is enabled, the WorldBorder begins to shrink relentlessly.

Be the last player standing to win the game.

---

✨ Features

• 🌍 Random & Safe Spawning – Players are distributed fairly across the map with a configurable minimum distance between them
• 🛡️ Protected Preparation Phase – PvP is disabled at the beginning, giving players time to gather loot and prepare
• ⚔️ Automatic PvP Activation – PvP is reliably enabled server-side when the preparation phase ends
• 🔻 Shrinking WorldBorder – A multi-stage, fully configurable border system gradually forces players closer together
• ☠️ Elimination System – Eliminated players cannot respawn and are automatically switched to Spectator Mode
• 🏆 Automatic Winner Detection – The round ends automatically when only one player remains alive
• 📊 Live Game UI – Bossbars, titles, and scoreboards display the current phase, remaining time, border size, and number of alive players
• ⚙️ Fully Configurable – Gameplay and balancing values can be customized through YAML without recompiling the plugin
• 🧩 No Client Mods Required – Works with the vanilla Minecraft client on compatible Paper servers

---

🎮 Game Flow

Phase	Description
Waiting	Players wait in the lobby until enough players have joined
Preparation	Players are randomly distributed across the map while PvP remains disabled
PvP	PvP is enabled and the WorldBorder begins shrinking
Endgame	The playable area becomes small, greatly increasing the chance of encounters
Finished	The last surviving player wins the round

---

🖥️ Commands

Command	Description	Permission
/br start	Start a Battle Royale round	—
/br stop	Stop the current round	—
/br status	Display the current game status	—
/br add <player>	Add a player to the current game	—
/br remove <player>	Remove a player from the current game	—

Note: Command permissions and additional commands may change during development.

---

⚙️ Configuration

Example

The plugin is designed to make important gameplay settings configurable, including:

• WorldBorder size and shrinking stages
• Spawn settings
• Minimum spawn distance
• Preparation time
• PvP timing
• Game phases
• UI settings
• Gameplay balancing

This allows every round to be configured differently without requiring a new plugin build.

Configuration options are still being implemented and may change in future versions.

---

📋 Requirements

• Server: Paper or a compatible fork
• Client: Vanilla Minecraft — no client-side mods required
• Minecraft Version: 1.21.1

---

🚧 Roadmap

The following features are planned for future versions:

• Additional configuration options
• Improved game management
• More advanced WorldBorder shrinking mechanics
• Additional UI elements
• Improved spectator functionality
• More gameplay customization
• Additional commands
• Better error handling
• Performance optimizations
• More extensive testing

The roadmap is subject to change as development progresses.

---

🐛 Bugs & Suggestions

Found a bug or have an idea for a new feature?

Please report it through the Issue Tracker or use the project's Discord to share your feedback.

Bug reports and suggestions are highly appreciated and help improve the project during development.

---

🚀 Development Status

This project is currently under active development.

Features may be added, removed, redesigned, or changed at any time. Some functionality may not work as expected yet.

Do not consider this project production-ready until a stable release has been published.

---

[!IMPORTANT] This README describes the planned/current functionality of the project. Not every feature listed above is necessarily implemented yet.

The project is still being developed and more features will be added over time.