ClaimMod

ClaimMod — Advanced Land Claiming & Grief Prevention

ClaimMod is a server-side Fabric mod designed to give players and server administrators total control over land protection and grief prevention. Operating entirely server-side, it functions seamlessly for plain vanilla clients while offering a lightweight companion packet API that unlocks advanced, automatic client-side boundary rendering for players running compatible companion client configurations.

Featuring a modular, highly performant spatial indexing engine, tick-accurate accrual math, independent trust matrices, and expansive per-world permission overrides, ClaimMod is built to handle heavy server environments with zero configuration reboots required.

🛠️ Performance Architecture

Unlike old protection mods that loop over massive arrays or suffer from tick-drift, ClaimMod is built from the ground up for modern server performance:

• O(1) Spatial Indexing: Claims are indexed cleanly using a chunk-hashed spatial grid (worldKey → chunkKey → Set<Claim>). Border checks and interaction lookups run instantly regardless of how many thousands of claims exist on your world.
• Real-Time Accrual Processing: Claim block generation checks look at real wall-clock milliseconds (System.currentTimeMillis()) instead of standard server tick counting. Your players earn points at a perfectly stable rate even when the server drops TPS under heavy entity load.

🔑 Independent Trust Tiers

ClaimMod rejects standard cumulative trust hierarchies. Granting a tier does NOT inherently grant the permissions of any tier beneath it, allowing for fine-grained player delegation:

| Tier | Role Capabilities |
|—|—|
| OWNER | Full building/breaking access, container rights, flag management, claim deletion, and ownership transfers. |
| CO_OWNER | Identical rights to the Owner, except cannot force-delete the claim or transfer primary ownership away. |
| TRUSTED | Full building and block breaking access, along with all standard block/container interactions. |
| FLAGS | Purely grants visibility and toggles for claim flags; cannot build, break, or look inside containers. |
| CONTAINER | Restricts usage strictly to inventories (chests, furnaces, etc.). |
| TRAVELER | Purely restricted to mechanical navigation pathways (standard doors, trapdoors, and fence gates). |

🏳️ Expansive Flag Controls

Customize rules globally, per-world, or dynamically inside individual player/admin zones using our specialized flag register:

| Flag Name | Default | What it governs |
|—|—|—|
| block_break | false | Allows non-trusted players to mine blocks inside the claim boundaries. |
| block_place | false | Allows non-trusted players to place blocks inside the claim boundaries. |
| block_interact | false | Allows non-trusted players to interact with doors, buttons, levers, and blocks. |
| container_access | false | Allows non-trusted players to open chests, furnaces, and standard containers. |
| pvp | false | Dictates combat outcomes between completely non-trusted actors inside the boundaries. |
| friendly_fire | true | Governs whether explicitly trusted players can attack each other inside the zone. |
| animal_killing | false | Controls whether non-trusted entities can slaughter passive livestock animals. |
| mob_killing | true | Allows players to clean up unwanted hostile or neutral living monsters. |
| protect_nametagged | true | Overrides generic slaughter permissions to protect custom name-tagged entities. |
| tnt_explosion | false | Protects terrain blocks from being broken by active TNT explosions. |
| creeper_explosion| true | Toggles environmental structural breakdown from Creeper explosions. |
| other_explosion | true | Restricts block impact from alternative explosion forces like beds or anchors. |
| explosion_player_damage| true| Controls whether explosion shockwaves inflict health damage on players. |
| fire_spread | true | Allows natural fire blocks to tick and find new flammable surfaces. |
| fire_damage | true | Dictates whether burning blocks are completely consumed and destroyed by fire. |
| mob_spawning | true | Dictates structural monster generation patterns, including Phantoms. |
| animal_spawning | true | Governs natural passive fauna and animal generation sequences across the chunks. |
| item_pickup | true | Blocks or allows untrusted floor item collection interactions. |
| vehicle_use | false | Toggles interactive transport mounts like boats, minecarts, and horses. |
| vehicle_destroy | false | Stops untrusted item breakage of transport infrastructure like boats or minecarts. |
| portal_use | false | Limits dimension travel block pathways (nether/end) inside the claim zone. |
| piston_protection| false | Stops external piston machines from pushing block structures across boundaries. |
| fluid_protection | false | Halts cross-border external flow sequences from liquids like lava and water sources. |
| command_use | true | When false, enforces restricted command blacklists defined in the configuration. |
| allow_flight | false | Instantly grants flight configurations on entry and revokes them on exit. |
| passthrough | true | Forbids airborne trespassers from bypassing physical boundaries while flying. |
| protect_crops | true | Suppresses vector forces that turn valuable farmland blocks back into generic dirt. |
| sethome | false | Prevents untrusted visitors from binding teleport keys inside your territory. |

👁️ Border Visualization Matrix

Vanilla client? Companion client? No problem. ClaimMod securely processes visualization vectors for everyone:

• Fake Block Packets (Vanilla-Friendly): Right-clicking with items shifts regional border grids smoothly into view via ClientboundBlockUpdatePacket arrays. Surfaces are automatically mapped locally without shifting physical world files.
• Adaptive Dynamic Palette: Edge color configurations morph cleanly relative to a player’s spatial context:
• Owner / Co-Owner: Vibrant Gold Blocks accented by Glowstone corners.
• Trusted / Flag Access: Deep Lapis Lazuli Blocks illuminated by Sea Lanterns.
• Stranger / Traveler: Solid Iron Blocks finished with Shroomlight indicators.
• Companion Mod Auto-Sync: Equipping selection tools instantly signals our networking bridge, updating client-side renderers smoothly before the player even crosses a claim border.

🛑 Hardened Exploit Protections

• Piston Redstone Shielding: When piston_protection is enabled, external flying machines, sweeping blocks, or glitch mechanisms trying to move materials inside your perimeter are completely blocked at the border.
• Fluid Displacement Containment: Prevents griefers from pouring massive lava towers or water cascades outside your claims to flood your builds.
• Anti-Kick Teleport Exploits: When an administrator or claim owner kicks a trespasser with /claim kick, the player’s last position is securely logged. This prevents them from instantly utilizing command pathways like /back or /dback to return to their target.

⚙️ Configuration File Hub

All parameters reside cleanly within config/claimmod/. Run /claim reload to push formatting adjustments into live memory instantly:

| Target Path | Functional Content |
|—|—|
| config.yml | Sets up default flags, min/max layout sizing constraints, item tool registration nodes, and structural settings. |
| message_formatting.yml | Localization layout holding every system string with full support for & legacy color translation parameters. |
| worlds/ | Destination holding fine-grained per-world configuration locks and command execution blacklists. |

Commands

| Command | Operational Definition | Base Permission Node |
|—|—|—|
| /claim | Renders the primary menu interface directory. | Available to all |
| /claim list [player] | Lists owned properties. Admins can view other player profiles. | claimmod.claim.list |
| /claim info | Evaluates structural properties, bounding dimensions, and current trust. | claimmod.claim.info |
| /claim nearby | Highlights surrounding boundaries within tracking limits. | claimmod.claim.nearby |
| /claim rename <name> | Updates display tag variables for the zone. | claimmod.claim.rename |
| /claim trust <player> [tier]| Maps target player parameters to a dedicated trust matrix tier. | claimmod.trust.full |
| /claim untrust <player>| Completely purges a target from all property trust arrays. | claimmod.trust.untrust |
| /claim trustlist | Loops through tracking nodes to present active claim access rules. | claimmod.trust.list |
| /claim flag [flag] [val] | Toggles flag states directly inside the property quadrant. | claimmod.flag.<flag> |
| /claim flaginfo [dim] | Pulls up global world flag metrics or local claim flag details. | claimmod.flag.view |
| /claim owner <player> | Begins two-step ownership transfer processing. | claimmod.claim.owner |
| /claim abandon [id/name]| Relinquishes territory land properties back to nature. | claimmod.claim.abandon |
| /claim abandonall | Triggers double-confirmation logic to erase all personal claims. | claimmod.claim.abandon |
| /claim balance [player] | Checks active claim block economic metrics. | claimmod.claim.balance |
| /claim kick <player> | Expels an unwanted entity safely out of your territory boundaries. | claimmod.claim.kick |
| /claim bypass | Toggles admin bypass override configurations. | claimmod.admin.bypass |
| /claim priority <n> | Modifies overwrite priority thresholds on overlapping admin zones. | claimmod.admin.setpriority |
| /claim force <p> [r] | Forcefully builds a protection square around a player coordinate. | claimmod.admin.forceclaim |
| /claim tp <target> | Instantly links and teleports admin to specified claim zones. | claimmod.admin.teleport |
| /claim blocks give/take| Administratively grants or subtracts economy blocks from player balance pools. | claimmod.admin.blocks.give / take |
| /claim blocks reset | Resets tracking records back to starting config baselines. | claimmod.admin.blocks.reset |
| /claim reload | Pulls structural data updates from disk directly into memory. | claimmod.admin.reload |

Permissions

Modpack Policy

• ✅ You may include ClaimMod in any modpack.
• ❌ The modpack must not be sold.