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.

💬 Primary Support (Preferred)

All general questions, feature requests, and non-urgent bug reports should be posted in the appropriate channels on our Discord Server. We actively monitor it and will respond as soon as possible so the whole community benefits.

🆘 Urgent PM Policy

You may PM me directly only under specific urgent circumstances:

Allowed reason: Your server is crashing or experiencing critical, game-breaking errors directly related to this mod.
Requirement: You must be the server owner.
Time zone: (CET/CEST) — Brussels Time
PM hours: 10:00 AM – 10:00 PM Brussels Time only

Immediate responses are not guaranteed. Private messaging is a professional courtesy, not an entitlement. Thank you for your understanding!

🛠️ 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

👤 Claim Modifiers

Node Functional Clearance claimmod.claim.create Allows territory allocation creation via standard tools. claimmod.claim.resize Grants resizing access to adjust territory borders. claimmod.claim.info Grants authorization to query spatial claim properties. claimmod.claim.list Grants clearance to view active owned properties. claimmod.claim.nearby Allows visualization checks on surrounding claims. claimmod.claim.rename Grants access to modify claim names. claimmod.claim.abandon Permits abandoning claims and territory. claimmod.claim.owner Grants permission to transfer claim ownership. claimmod.claim.balance Allows checking your own claim block balance. claimmod.claim.kick Permits using /claim kick on trespassers.

🤝 Trust Management

Node Functional Clearance claimmod.trust.coowner Allows promoting players to the Co-Owner matrix tier. claimmod.trust.full Grants authority to trust players with standard build tier rights. claimmod.trust.flags Grants permission to assign flag operator trust tiers. claimmod.trust.containers Allows trusting players with container access. claimmod.trust.traveler Allows granting traveler door navigation rights. claimmod.trust.untrust Permits untrusting players from your properties. claimmod.trust.list Allows viewing access lists on properties.

🛠️ Administrative Operations

Node Functional Clearance claimmod.admin Master administrative umbrella; grants all sub-nodes. claimmod.admin.bypass Instantly bypasses structural land block locks. claimmod.admin.delete Permits administrative deletion of any claim by UUID. claimmod.admin.inspect Allows inspecting properties anywhere across worlds. claimmod.admin.flag Allows modifying properties owned by other players. claimmod.admin.teleport Permits administrative teleportation tracking keys. claimmod.admin.reload Allows reloading system properties from terminal commands. claimmod.admin.blocks.give Administratively increases a target's claim block totals. claimmod.admin.blocks.take Administratively reduces a target's claim block totals. claimmod.admin.blocks.reset Resets player balance pools across the server environment. claimmod.admin.balance Permissive clearance node to investigate other balances. claimmod.admin.list Grants clearance to list other players' land properties. claimmod.admin.worldflags Allows editing default global world overrides. claimmod.admin.setpriority Updates overlay sorting weight variables on admin claims. claimmod.admin.forceclaim Grants clearance to use administrative force claim systems. claimmod.admin.adminclaim Grants access to build Server Admin zones.