⚔️ Minipurge | 1-Command Multiplayer Events

Turn your Minecraft server into a massive Purge, Hunger Games, or Fortnite-style battle royale with a single command! Minipurge is an ultra-lightweight, highly customizable data pack designed to handle multiplayer PVP events with minimal admin intervention. Whether you are hosting a quick 5-player arena with friends or a massive 100-player server-wide event, Minipurge scales perfectly to your needs.

🏆 Three Dynamic Game Phases

The event flows automatically through three highly customizable stages:

🕊️ Peace: PvP is strictly disabled. Players have time to scatter, gather resources, build defenses, and prepare for the battle ahead.
⚔️ War: The grace period ends. PvP is enabled, and the hunt begins.
🛑 Shrink: The world border relentlessly shrinks down to the center, forcing all remaining players into a final, chaotic showdown.

⚙️ Quick Setup Guide

Install: Drop the Minipurge .zip file into the datapacks folder of your server world. (Note: We highly recommend using a fresh world or one you don't mind trashing, as the event modifies the world border and player inventories).
Add Flavor (Optional): Install Minipurge Add-on Data Packs for custom loot, recipes, and events!
Position: Teleport yourself to a random, unexplored area of the map to act as the center of the arena.
Start the Event: Run the start command below!

🛠️ Configuration & Commands

Start your event using the following command. Every variable is fully customizable!

/function minipurge:start {lives:<int>, border:<int>, peace:<int>, war:<int>, shrink:<int>}

📊 Parameter Guide:

lives: The number of lives a player has.
- Positive number: Players are kicked from the server when out of lives.
- Negative number: Players switch to spectator mode when out of lives.
border: The starting border size (in blocks).
- If set to 0: Automatically calculates a balanced border size based on your player count (~160,000 blocks per player).
peace: The length of the Peace (No-PvP) phase in minutes.
- Positive: Locks the time of day at noon.
- Negative: Allows the normal daylight cycle to progress.
- If set to 0: Skips the Peace phase; players are scattered and PvP begins immediately.
war: The length of the War (PvP enabled) phase in minutes.
- Positive: Turns the daylight cycle off.
- Negative: Turns the daylight cycle on.
shrink: The time it takes for the border to shrink down to a 20-block radius, in minutes.
- Positive: Turns the daylight cycle off.
- Negative: Turns the daylight cycle on.
- If set to 0: Disables border shrinking entirely.

⚠️ WARNING: Running the start command will immediately teleport all online players, clear their inventories, and wipe their ender chests! Make sure everyone is ready before executing.

💡 Example Start Command:

Want to test a quick 30-minute game with 3 lives? Copy and paste this: /function minipurge:start {lives:3, border:0, peace:10, war:15, shrink:5}

🔧 Admin Helper Commands

/function minipurge:reset - Safely resets the world mid-event or after an event finishes.
/function minipurge:pause - Pauses the event (Requires function-permission-level 4+).
/function minipurge:unpause - Resumes the event (Requires function-permission-level 4+).
/function minipurge:help - Displays the in-game help menu.

🤝 Community & Support

Create Your Own Add-ons: Minipurge is built to be modular! Check out the Wiki to learn how to create your own custom add-ons.
Feedback & Bugs: Have a suggestion or found a bug? Email me at jaypyro2000@gmail.com.
Beta Testing: Want to try new features early? Help test experimental versions here!
Support the Project: If you enjoy the pack and want to help keep development going, consider supporting me on Patreon.