PvP Chunk manager

# PvP Chunk Manager **Advanced Localized PvP Management for Fabric 1.21.x & 26.x** PvP Chunk Manager is a lightweight, server-side utility designed for server owners who want to create high-stakes PvP zones (like custom arenas or dangerous islands) while keeping the rest of the world completely safe. It allows you to bypass `gamerule pvp false` in specific chunks and enforces strict combat rules to prevent players from chicken-ing out of fights. --- ## Key Features * **Multi-Version Combat:** Fully compatible across all **Fabric 1.21.x** releases (including 1.21.11) and the latest **26.x** snapshots/releases. * **Localized PvP Bypass:** Enable PvP in specific chunks, even if global PvP is turned off. * **Combat Tagging:** Automatically tags players when they deal or take damage. * **Mace-Friendly Flight:** Tagged players can still use Elytras and Ender Pearls, but only within a set radius around the PvP zoneperfect for setup and landing those massive Mace smash attacks! * **Escape Prevention:** Players attempting to flee the combat zone will hit invisible walls or be teleported back. * **Anti-Combat Log:** Punish players who disconnect mid-fight to deny enemies their loot. > **Enhance your server setup!** Check out my other server-side mods over at : [Fabric Server Essentials](https://modrinth.com/organization/fabric-server-essentials) --- ## Commands & Tools All management has been consolidated under the main `/pvpzone` command: * `/pvpzone hoe` Gives the operator a **Diamond Hoe** (PvP Chunk Tool). * **How to use:** Right-click a block with the tool to toggle that chunk as a **PvP-enabled zone**. * `/pvpzone reload` Reloads the `pvp_chunks.json` configuration instantly without needing to restart the server. --- ## Configuration (`pvp_chunks.json`) The mod generates a config file in your server's `/config` folder. Customize the combat mechanics to fit your server's playstyle: | Setting | Type | Default | Description | | --- | --- | --- | --- | | `pvp_border_distance` | Integer | `2` | Number of chunks away from the PvP border where flight/pearls are permitted. | | `combat_tag_duration` | Integer | `20` | How long (in seconds) the combat tag lasts. | | `action_on_escape` | String | `INVISIBLE_WALL` | What happens when a tagged player leaves the allowed radius. | | `action_on_logout` | String | `KILL` | What happens when a tagged player disconnects. | ### Action Options Breakdowns * **`action_on_escape` options:** * `INVISIBLE_WALL`: Blocks movement at the border (velocity is instantly stopped). * `TELEPORT_BACK`: Teleports the player back to the center of the nearest PvP chunk. * `KILL`: Instantly kills the player for trying to run away. * **`action_on_logout` options:** * `KILL`: Player is dead when they rejoin. * `BAN_TEMPORARY`: Player is killed and banned for 30 minutes. * `NONE`: No penalty (not recommended for competitive play). --- ## Performance & Tech > **Server-Side Only:** Players do not need to install this mod to join your server! Designed to run smoothly on modern hardware (optimized for processors like the Ryzen 3 6800H). The mod utilizes `PersistentState` for chunk storage and highly optimized Mixins, ensuring **zero impact on TPS** even with dozens of active, high-population combat zones. ### Installation 1. Drop the `.jar` into your server's `mods` folder. 2. Ensure you have the correct **Fabric API** version for your target release (1.21.x or 26.x). 3. Restart, grab your tool via `/pvpzone hoe`, and start marking your arenas!