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. <details> <summary>📧 Contact & Support</summary> ### 💬 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! </details> --- ## 🛠️ 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