ClaimMod

ClaimMod — Advanced Land Claiming & Grief Prevention

This image is from ClaimModCompanion.

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.

📧 Contact & Support

💬 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 income is measured in real wall-clock time instead of server ticks, so players earn at a perfectly stable rate even when TPS drops under heavy load.

---

💰 Claim Block Economy

• Per-Player Online-Time Income: Every player earns claim blocks for each full hour of their own online time. Progress is saved per player and carries over between sessions and restarts, so nobody gets a full payout for logging in a minute before the hour.
• Rank Income Rates: Give ranks a higher hourly income with claimmod.accrual.<amount> (e.g. claimmod.accrual.100). The highest rate a player has wins; everyone else earns the base accrual.blocks_per_hour.
• Buy Claim Blocks with Money: With EcoBal installed, players can buy claim blocks using /claim buy <amount>. The price per block and the maximum per purchase are set in config.yml.
• Clear Balance Overview: /claim balance shows your total claim blocks, how many are used by your claims, and how many are still available.
• Claim Limits: Optionally cap how many claims a player may own (max_claims_per_player) and their total claimed area (max_claim_blocks_per_player).

---

⏳ Inactive Claim Expiry

• Claims of players who have been offline for a configurable number of days (default 60) can be deleted automatically.
• Nobody's claims expire by default. claimmod.expiry.exempt is true for everyone; set it to false on a LuckPerms group to make expiry apply to that group only.
• Admin claims never expire, and /claim info shows when the owner was last seen and how many days a claim has left.

---

🔑 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).

Trust everywhere at once: run /claim trust or /claim untrust inside your own claim to change just that claim, or anywhere else to apply it to all of your claims in one go.

---

🏳️ 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	Master switch: allows non-trusted players to use all ordinary blocks (doors, buttons, levers, note blocks…), overriding the interaction flags.
container_access	false	Allows non-trusted players to open chests, furnaces, and standard containers.
traveler_interaction_player / _admin	false / true	Doors, trapdoors, fence gates, buttons, levers and pressure plates in player / admin claims.
miscellaneous_interaction_player / _admin	false / true	Item frames, paintings, leads, armor stands, lecterns, jukeboxes and more in player / admin claims.
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.
enderman_griefing	false	Allows endermen to pick up and place blocks inside the claim.
wither_griefing	false	Allows withers to break blocks inside the claim.
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.
use_crafting_table	true	Allows non-trusted players to use crafting tables.
use_anvil	true	Allows non-trusted players to use anvils.
use_enchanting_table	true	Allows non-trusted players to use enchanting tables.
use_bed	false	Allows non-trusted players to sleep in beds.
use_ender_chest	true	Allows non-trusted players to open ender chests.
use_wandering_trader	true	Allows trading with the Wandering Trader (and lets it spawn in the claim).
shop_access	true	Allows non-trusted players to buy, sell and trade at ShopShelves and TradeShelves shelves.
edit_signs	false	Allows non-trusted players to edit signs.
allow_flight	false	Instantly grants flight configurations on entry and revokes them on exit.
passthrough	true	When false, flying players can't fly out over the claim border.
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.
show_border	true	Shows the claim border to the owner on entry.
notify_animal_deaths / _kills	true	Notifies claim members when an animal dies, or is killed by a player, in the claim.
notify_villager_deaths / _kills	true	Notifies claim members when a villager dies, or is killed by a player, in the claim.

Always-on pet protection: tamed pets (dogs, cats, parrots, horses and more) inside claims can only be hurt by their own owner. No flag needed.

---

🛒 Shop Mod Integration

• ShopShelves & TradeShelves: Shop shelves from ShopShelves (money) and trade shelves from TradeShelves (item trading) are handled identically. Visitors can use them in any claim where shop_access is on, without getting build or container access. Works automatically when either mod is installed.
• EcoBal: Powers /claim buy so players can turn money into claim blocks.

---

👁️ 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: The server keeps ClaimModCompanion clients up to date with nearby claims, your claim block balance and income, and your list of claims, so the companion can draw borders and show its menus instantly.

---

🛑 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.
• Mob Griefing Control: Endermen and withers can be stopped from moving or destroying blocks inside claims.
• 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	Default flags, claim size and count limits, claim block income and rank rates, buying claim blocks, claim expiry, tool items 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, current trust and expiry.	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]	Trusts a player in this claim, or in all your claims when used outside your own claim.	claimmod.trust.full
/claim untrust <player>	Removes a player from this claim, or from all your claims when used outside your own claim.	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]	Shows total, used and available claim blocks.	claimmod.claim.balance
/claim buy [amount]	Buys claim blocks with EcoBal money; without an amount it shows the price.	claimmod.claim.buy
/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 give <player> [type] [amount]	Gives a claim tool or admin claim tool item.	claimmod.admin.givetool
/claim reload	Pulls structural data updates from disk directly into memory.	claimmod.admin.reload

---

Permissions

Click to expand all permission nodes

🌐 Umbrella Nodes

Node	Functional Clearance
claimmod.claims	Grants every claimmod.claim.* node.
claimmod.trusts	Grants every claimmod.trust.* node.
claimmod.flags	Grants every claimmod.flag.* node.
claimmod.admins	Master administrative umbrella; grants every claimmod.admin.* node.

👤 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.buy	Allows buying claim blocks with EcoBal money.
claimmod.claim.kick	Permits using /claim kick on trespassers.
claimmod.dback	Allows /dback into a claim you died in (default: false).

💰 Income & Expiry

Node	Functional Clearance
claimmod.accrual.<amount>	Earn <amount> claim blocks per hour online instead of the base rate (amounts listed in accrual.rank_rates).
claimmod.expiry.exempt	Claims never expire. Default: true; set to false on a group to make its claims expire.

🤝 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.

🏳️ Flags

Node	Functional Clearance
claimmod.flag.view	Allows viewing your own claim's flags.
claimmod.flag.<flag>	Allows toggling that specific flag (one node per flag, e.g. claimmod.flag.enderman_griefing).

🛠️ Administrative Operations

Node	Functional Clearance
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.
claimmod.admin.givetool	Allows giving claim tool items with /claim give.

---

Modpack Policy

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