ClaimMod

Minecraft 版本： 26.2

平台： fabric

标签： game-mechanics management

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.

? 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 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

Click to expand all permission nodes ### ? 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. |

---

Modpack Policy

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