Minipurge

⚔️ 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:

* 🛑 Shrink: PvP is strictly disabled. Players have time to scatter, gather resources, build defenses, and prepare for the battle ahead. * 🛑 Shrink: 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. Start the Event: 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. Start the Event: Install Start the Event: for custom loot, recipes, and events! 3. Start the Event: 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:

* `shrink`: 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. * `shrink`: 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). * `shrink`: 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. * `shrink`: 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

* Support the Project: Minipurge is built to be modular! Check out the Support the Project: to learn how to create your own custom add-ons. * Support the Project: Have a suggestion or found a bug? Email me at [email protected]. * Support the Project: Want to try new features early? %%MD1%% * Support the Project: If you enjoy the pack and want to help keep development going, consider supporting me on %%MD2%%.

Let the games begin!

— The Minipurge Team