ChunkClaims

CHUNK CLAIMS
Fabric Mod for Minecraft Java 1.21.11

OVERVIEW

Chunk Claims lets players claim individual chunks and control who may interact
with them. Claims persist with the world, work in every dimension, and do not
prevent players from walking through claimed land.

The mod includes three trust levels, territory entry titles, operator-safe claim
removal, and optional integration with Xaero's Minimap and World Map.

REQUIREMENTS

- Minecraft Java 1.21.11
- Fabric Loader 0.19.3 or newer
- Fabric API 0.141.4+1.21.11
- Java 21 or newer

For Xaero integration:

- Xaero's Minimap 26.1.4
- Xaero's World Map 1.41.2

Cloth Config is not required.

INSTALLATION

Install Chunk Claims and Fabric API on the server. Install the same Chunk Claims
jar and Fabric API on clients that need Xaero map controls and claim highlights.
Xaero's Minimap and World Map are client-side optional dependencies and are not
required on a dedicated server.

The same Chunk Claims jar works on dedicated servers and clients. Singleplayer is
also supported through Minecraft's integrated server.

COMMANDS

/claims add
Claims the chunk in which the player is standing. A chunk cannot be claimed when
another player already owns it.

/claims remove
Removes the claim in which the player is standing when they own it.

/claims remove confirm
Confirms an operator's attempt to remove another player's claim. Confirmation
must be completed within 30 seconds.

/claims trust <username> trustlevel <1|2|3>
Sets the named player's trust level for all claims owned by the command sender.
The target must have joined the server previously.

/claims untrust <username>
Removes the named player's trust from all claims owned by the command sender.

TRUST LEVELS

Level 1 - View-only containers

May only open supported item containers and view their contents. Level 1 cannot
move items, open doors or gates, use buttons or levers, trigger protected pressure
plates or tripwires, build, break blocks, or interact with protected entities.

Level 2 - Containers and entrances

May view and modify supported containers. Level 2 may also open and close doors,
fence gates, and trapdoors and use buttons, levers, pressure plates, and tripwires.
It does not grant general building, breaking, or entity access.

Level 3 - Full access

May build, break blocks, use containers and protected blocks, and interact with
or attack protected entities.

The claim owner always has full access. Trust is global per owner, so a player's
level applies to every claim owned by that owner in every dimension.

CLAIM PROTECTION

Players without sufficient trust cannot directly break or place blocks, use
protected blocks or containers, or interact with or attack protected entities.
All players may freely walk through claimed chunks.

Only the owner may normally unclaim a chunk. Operators may remove another
player's claim only after receiving this warning and confirming the action:

"This chunk is owned by <username>. Are you sure you want to unclaim their chunk?"

XAERO COMPATIBILITY

To use Xaero integration, install Chunk Claims, Fabric API, Xaero's Minimap, and
Xaero's World Map on the client. The server must have Chunk Claims and Fabric API.

To claim or unclaim through Xaero:

1. Open Xaero's fullscreen World Map.
2. Select exactly one chunk with Xaero's map selection control.
3. Open the right-click options for the selected chunk.
4. Choose the Chunk Claims claim or unclaim action.

Selecting more than one chunk is not supported. An ordinary player cannot
unclaim another player's chunk. Operators receive a confirmation screen before
removing another player's claim.

The player's own claimed chunks are highlighted green. Claims belonging to other
players are highlighted red. Claim changes refresh after the server accepts and
synchronizes the request.

TERRITORY TITLES

Entering claimed land displays:

Entering <username>'s Claim

Entering unclaimed land displays:

Entering Unclaimed Territory

CURRENT PROTECTION SCOPE

This version protects direct player block actions, supported containers, door and
redstone access controls, and entity interactions. Environmental and automated
changes such as explosions, fire, fluid flow, pistons, hoppers, and mob griefing
are not currently claim-filtered.