PvP Chunk Manager

Per-chunk PvP control for Fabric servers. Mark chunks where the vanilla PvP gamerule is inverted, tag players in combat, and stop them from escaping the fight by running away, pearling out, or logging out.

What the mod does

Exempt chunks

Use the PvP Chunk Tool (a Diamond Hoe named "PvP Chunk Tool") to toggle chunks where PvP rules are inverted:

• When the vanilla pvp gamerule is on, PvP damage is blocked if the attacker or the target stands in an exempt chunk.
• When the vanilla pvp gamerule is off, PvP damage is allowed only when both players stand in exempt chunks (team and friendly-fire rules are respected where supported).

Combat tag

Hitting another player tags both the attacker and the target for a configurable duration (combat_tag_duration). Every new hit refreshes the tag.

Border enforcement

While tagged, a player may not move more than pvp_border_distance chunks away from their anchor (the last exempt chunk they stood in, or the chunk where combat started when no exempt chunks are used). Leaving the allowed radius triggers the configured escape action on every tick until the player is back inside:

• INVISIBLE_WALL (default): pushes the player back to the border, acting like an invisible wall around the anchor.
• TELEPORT_BACK: teleports the player to the center of the anchor chunk.
• KILL: kills the player.

Teleports resolve a safe surface position via heightmap lookup, so players are never placed inside or under blocks.

Ender pearl block

Ender pearls thrown during combat that would land outside the allowed radius are discarded, so pearls cannot be used to escape.

Anti-logout

Disconnecting while combat-tagged drops the player's entire inventory on the ground at their position and clears all combat state. Logging out to avoid death costs the player their items.

Death reset

Dying from any cause clears all combat tracking (anchor position, combat tag, attacker record), so border enforcement resets on respawn.

Admin options (26.3 build)

The chunk-tool command, the reload command, and physical tool use can be restricted to operators with a configurable permission level (tool_requires_op, reload_requires_op, op_permission_level).

Installation

1. Install Fabric Loader and Fabric API for your Minecraft version.
2. Download the file matching your Minecraft version (1.21.x, 26.1.x, 26.2 or 26.3) and place it in the mods folder.
3. Start the server once to generate config/pvp_chunks.json.
4. Mark your zones with /pvpzone hoe, tune the settings, then run /pvpzone reload.

Setting up a PvP zone

1. Decide the base behaviour with the vanilla pvp gamerule.
2. Run /pvpzone hoe to receive the chunk tool.
3. Right-click a block in each chunk you want to exempt. The change is saved to the config file immediately and a chat message confirms it.
4. Edit pvp_border_distance, combat_tag_duration and action_on_escape in config/pvp_chunks.json if needed, then run /pvpzone reload to apply.

Commands

Command	Description
/pvpzone hoe	Gives the Diamond Hoe chunk tool. Right-click a block to toggle its chunk's exempt status.
/pvpzone reload	Reloads config/pvp_chunks.json from disk.

All command names are configurable via the commands section of the config file.

Configuration (config/pvp_chunks.json)

The file is created automatically on first launch if missing. Example:

{
  "commands": {
    "base_pvp_command": "pvpzone",
    "sub_get_tool": "hoe",
    "sub_reload": "reload"
  },
  "settings": {
    "pvp_border_distance": 2,
    "combat_tag_duration": 20,
    "action_on_escape": "INVISIBLE_WALL",
    "tool_requires_op": true,
    "reload_requires_op": true,
    "op_permission_level": 2
  },
  "exemptChunks": []
}

Setting	Default	Description
pvp_border_distance	2	How many chunks a tagged player may move away from their anchor before the escape action triggers.
combat_tag_duration	20	How long, in seconds, the combat tag lasts after the last hit.
action_on_escape	INVISIBLE_WALL	What happens when a tagged player leaves the allowed radius: INVISIBLE_WALL, TELEPORT_BACK or KILL.
tool_requires_op	true	Only operators may receive the chunk tool and toggle chunks (26.3 build).
reload_requires_op	true	Only operators may reload the config (26.3 build).
op_permission_level	2	Permission level required for the restricted actions above (26.3 build).
base_pvp_command	pvpzone	Base command name.
sub_get_tool	hoe	Sub-command that gives the chunk tool.
sub_reload	reload	Sub-command that reloads the config.
exemptChunks	[]	List of chunk coordinates managed through the chunk tool.

Supported versions

File	Minecraft versions
1.21.x build	1.21 through 1.21.11
26.1.x build	26.1 through 26.1.2
26.2 build	26.2
26.3 build	26.3 (includes admin permission options)

Requires Fabric Loader and Fabric API on every version. Server-side only.