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. <iframe width="560" height="315" src="https://www.youtube-nocookie.com/embed/Bg2Rs500Dzw" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowfullscreen></iframe> --- ## 🏆 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 (https://modrinth.com/user/JayPyro2000) 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 (https://github.com/jaypyro2000/minipurge/blob/main/How_to_Make_Add_Ons.md) 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? (https://discord.gg/nBbSb5Ga5M) * **Support the Project:** If you enjoy the pack and want to help keep development going, consider supporting me on (https://patreon.com/JayPyro2000?utm_medium=unknown&utm_source=join_link&utm_campaign=creatorshare_creator&utm_content=copyLink). ### Let the games begin! **— The Minipurge Team**