⚔️ 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 zero lag and 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 seamlessly 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

1. 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).
2. Add Flavor (Optional): Install Minipurge Add-on Data Packs for custom loot, recipes, and events!
3. Position: Teleport yourself to a random, unexplored area of the map to act as the center of the arena.
4. 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).
  • 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.
  • 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.
  • 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.

Let the games begin!

— The Minipurge Team