ClaimMod — 高级领地声明与反破坏防护
此图片来自 ClaimModCompanion。

ClaimMod 是一款服务端 Fabric 模组,旨在赋予玩家和服务器管理员对土地保护和反破坏防护的完全控制权。它完全在服务端运行,对于原版客户端无缝兼容,同时提供了一个轻量级的配套数据包 API,为运行兼容配套客户端配置的玩家解锁高级、自动化的客户端边界渲染功能。
凭借模块化的高性能空间索引引擎、精确到刻(tick)的累加计算逻辑、独立的信任矩阵以及广泛的单世界权限覆盖功能,ClaimMod 专为应对高负载服务器环境而设计,无需任何配置重启即可稳定运行。
📧 联系与支持
💬 主要支持渠道(推荐)
所有常规问题、功能请求和非紧急错误报告,请发布在我们 Discord 服务器的相应频道中。 我们会积极监控并尽快回复,以便整个社区都能受益。
🆘 紧急私信政策
您仅在特定紧急情况下可以直接私信我:
- 允许原因: 您的服务器因本模组直接导致崩溃或出现严重、破坏游戏性的错误。
- 要求: 您必须是服务器所有者。
- 时区: (CET/CEST) — 布鲁塞尔时间
- 私信时间: 仅限布鲁塞尔时间上午 10:00 – 晚上 10:00
不保证立即回复。私信是一种职业礼仪,而非理所当然的权利。感谢您的理解!
🛠️ 性能架构
与那些遍历庞大数组或存在刻数漂移问题的旧式保护模组不同,ClaimMod 从底层开始即为现代服务器性能而构建:
- O(1) 空间索引:使用区块哈希的空间网格(
worldKey → chunkKey → Set<Claim>)清晰地索引领地。无论世界中存在多少数千个领地,边界检查和交互查找都能瞬间完成。
- 实时累加处理:领地方块收入按真实墙钟时间测量,而非服务器刻数,因此即使在 TPS 因高负载下降时,玩家也能以完美稳定的速率获得收入。
💰 领地方块经济
- 按玩家在线时间的收入:每位玩家每拥有完整的个人在线时长一小时,即可获得领地方块。进度按玩家保存,并在会话和重启之间延续,因此没有人会在登录不到一分钟时就获得全额支付。
- 阵营收入倍率:通过
claimmod.accrual.<amount>(例如 claimmod.accrual.100)给予阵营更高的每小时收入倍率。玩家拥有的最高倍率生效;其他玩家赚取基础 accrual.blocks_per_hour。
- 用金钱购买领地方块:安装 EcoBal 后,玩家可以使用
/claim buy <amount> 购买领地方块。每个方块的价格和每次购买的最大数量在 config.yml 中设置。
- 清晰的余额概览:
/claim balance 显示您的总领地方块数、已用于领地的数量以及剩余可用数量。
- 领地限制:可选择限制玩家可拥有的领地数量(
max_claims_per_player)及其总领地面积(max_claim_blocks_per_player)。
⏳ 闲置领地过期
- 离线天数达到可配置数值(默认 60 天)的玩家领地可以自动删除。
- 默认情况下,没有任何人的领地会过期。 所有人的
claimmod.expiry.exempt 均为 true;将其设置为 false 以仅使过期规则应用于特定的 LuckPerms 组。
- 管理员领地永不过期,且
/claim info 会显示所有者上次上线的时间以及领地剩余的天数。
🔑 独立信任层级
ClaimMod 摒弃了标准的累积信任层级体系。授予某个层级不会自动授予其下方层级的权限,从而实现精细化的玩家权限委托:
| 层级 |
角色能力 |
| OWNER (所有者) |
完全的建筑/破坏访问权、容器权利、旗帜管理、领地删除及所有权转移。 |
| CO_OWNER (共同所有者) |
拥有与所有者相同的权利,但无法强制删除领地或将主要所有权转移出去。 |
| TRUSTED (受信任者) |
完全的建筑和方块破坏访问权,以及所有标准的方块/容器交互。 |
| FLAGS (旗帜权限) |
仅授予领地旗帜的可见性和切换权限;无法建造、破坏或查看容器内部。 |
| CONTAINER (容器权限) |
严格限制仅用于库存(箱子、熔炉等)。 |
| TRAVELER (旅行者) |
严格限制于机械导航路径(标准门、陷阱门和栅栏门)。 |
一键应用至所有领地:在自己的领地内运行 /claim trust 或 /claim untrust 仅更改当前领地,或在其他地方运行则一次性应用到你所有的领地。
🏳️ 广泛的旗帜控制
使用我们专门的旗帜注册表,自定义全局、单世界或动态在单个玩家/管理员区域中的规则:
| 标志名称 |
默认值 |
控制内容 |
block_break |
false |
允许非受信任玩家在领地边界内挖掘方块。 |
block_place |
false |
允许非受信任玩家在领地边界内放置方块。 |
block_interact |
false |
主开关:允许非受信任玩家使用所有普通方块(如门、按钮、拉杆、音符盒等),覆盖其他交互标志。 |
container_access |
false |
允许非受信任玩家打开箱子、熔炉和标准容器。 |
traveler_interaction_player / _admin |
false / true |
在玩家/管理员领地中的门、陷阱门、栅栏门、按钮、拉杆和压力板。 |
miscellaneous_interaction_player / _admin |
false / true |
在玩家/管理员领地中的物品展示框、画作、拴绳、盔甲架、讲台、唱片机等。 |
pvp |
false |
决定完全不受信任的角色在边界内的战斗结果。 |
friendly_fire |
true |
规定明确受信任的玩家是否可以在区域内互相攻击。 |
animal_killing |
false |
控制非受信任实体是否可以屠杀被动家畜动物。 |
mob_killing |
true |
允许玩家清理不需要的敌对或中立生物怪物。 |
protect_nametagged |
true |
覆盖通用屠杀权限,以保护拥有自定义名称标签的实体。 |
tnt_explosion |
false |
防止地形方块被活跃的火药爆炸破坏。 |
creeper_explosion |
true |
切换苦力怕爆炸造成的环境结构破坏。 |
other_explosion |
true |
限制床或锚等其他爆炸力量对方块的冲击影响。 |
explosion_player_damage |
true |
控制爆炸冲击波是否会对玩家造成生命伤害。 |
fire_spread |
true |
允许自然火方块进行刻钟更新并寻找新的可燃表面。 |
fire_damage |
true |
决定燃烧方块是否会被火焰完全消耗并销毁。 |
enderman_griefing |
false |
允许末影人在领地内拾取和放置方块。 |
wither_griefing |
false |
允许凋灵在领地内破坏方块。 |
mob_spawning |
true |
决定结构性怪物的生成模式,包括幻翼。 |
animal_spawning |
true |
管理整个区块中自然被动动物和生物的生成序列。 |
item_pickup |
true |
阻止或允许未受信任者收集地上的物品。 |
vehicle_use |
false |
切换交互式运输坐骑,如船、矿车和马匹。 |
vehicle_destroy |
false |
阻止未受信任者破坏船只或矿车等运输基础设施。 |
portal_use |
false |
限制领地区域内的维度旅行方块路径(下界/末地)。 |
piston_protection |
false |
阻止外部活塞机器将方块结构推过边界。 |
fluid_protection |
false |
阻止来自岩浆和水源等液体的跨边界外部流动序列。 |
command_use |
true |
当设置为 false 时,强制执行配置文件中定义的限制命令黑名单。 |
use_crafting_table |
true |
允许非受信任玩家使用工作台。 |
use_anvil |
true |
允许非受信任玩家使用铁砧。 |
use_enchanting_table |
true |
允许非受信任玩家使用附魔台。 |
use_bed |
false |
允许非受信任玩家在床上睡觉。 |
use_ender_chest |
true |
允许非受信任玩家打开末影箱。 |
use_wandering_trader |
true |
允许与流浪商人进行交易(并允许其在领地内生成)。 |
shop_access |
true |
允许非受信任玩家在 ShopShelves 和 TradeShelves 货架上进行购买、出售和交易。 |
edit_signs |
false |
允许非受信任玩家编辑告示牌。 |
allow_flight |
false |
进入时立即授予飞行配置,退出时撤销。 |
passthrough |
true |
当设置为 false 时,飞行的玩家不能飞出领地边界。 |
protect_crops |
true |
抑制矢量力,防止珍贵的农田方块变回普通泥土。 |
sethome |
false |
防止未受信任的访客在你的领土内绑定传送点。 |
show_border |
true |
进入时向所有者显示领地边界。 |
notify_animal_deaths / _kills |
true |
当领地上有动物死亡或被玩家杀死时,通知领地成员。 |
notify_villager_deaths / _kills |
true |
当领地上有村民死亡或被玩家杀死时,通知领地成员。 |
始终开启的宠物保护:领地内的驯服宠物(狗、猫、鹦鹉、马等)只能受到其主人的伤害。无需设置任何标志。
🛒 商店模组集成
- ShopShelves & TradeShelves:ShopShelves 的商店货架(货币)和 TradeShelves 的交易货架(物品交易)处理方式相同。只要
shop_access 开启,访客即可在任何领地中使用它们,而无需获得建造或容器访问权限。安装任一模组即可自动生效。
- EcoBal:为
/claim buy 提供动力,使玩家可以将货币转换为领地方块。
👁️ 边界可视化矩阵
客户端原版?伴侣客户端?没问题。ClaimMod 为所有人安全地处理可视化向量:
- 假区块数据包(兼容原版):使用物品右键点击时,区域边界网格会通过
ClientboundBlockUpdatePacket 数组平滑显示。表面会在本地自动映射,而无需更改物理世界文件。
- 自适应动态调色板:边缘颜色配置会根据玩家的空间上下文进行无缝变化:
- 所有者 / 共同所有者:以发光红石块角点缀的鲜艳金块。
- 受信任者 / 旗帜访问权限:由海晶灯照亮的深青金石块。
- 陌生人 / 旅行者:以蘑菇灯指示器收尾的实心铁块。
- 伴侣模组自动同步:服务器使 ClaimModCompanion 客户端保持与附近领地、你的领地方块余额和收入以及你的领地列表同步,以便伴侣客户端能够立即绘制边界并显示其菜单。
🛑 强化漏洞防护
- 活塞红石屏蔽:启用
piston_protection 后,试图在你的领地范围内移动材料的外部飞行机器、扫掠方块或故障机制将在边界处被完全阻止。
- 流体置换隔离:防止恶意玩家在领地外倾倒巨大的岩浆塔或瀑布来淹没你的建筑。
- 生物破坏控制:可以阻止末影人和凋灵在领地内移动或破坏方块。
- 反踢出传送漏洞:当管理员或领地所有者使用
/claim kick 踢出一个入侵者时,该玩家的最后位置会被安全记录。这可以防止他们立即利用 /back 或 /dback 等命令路径返回目标位置。
⚙️ 配置文件中心
所有参数都整洁地位于 config/claimmod/ 中。运行 /claim reload 可立即将格式调整推送到内存中:
| 目标路径 |
功能内容 |
config.yml |
默认标志、领地大小和数量限制、领地方块收入和等级费率、购买领地方块、领地过期、工具物品及结构设置。 |
message_formatting.yml |
布局包含每个系统字符串的本地化,完全支持 & 旧版颜色转换参数。 |
worlds/ |
目的地,持有细粒度的按世界配置锁定和命令执行黑名单。 |
命令
| 命令 |
操作定义 |
基础权限节点 |
/claim |
渲染主菜单界面目录。 |
所有人均可用 |
/claim list [player] |
列出拥有的属性。管理员可以查看其他玩家资料。 |
claimmod.claim.list |
/claim info |
评估结构属性、边界尺寸、当前信任和过期时间。 |
claimmod.claim.info |
/claim nearby |
在跟踪限制内突出显示周围边界。 |
claimmod.claim.nearby |
/claim rename <name> |
更新区域的显示标签变量。 |
claimmod.claim.rename |
/claim trust <player> [tier] |
在此领地中信任一名玩家,或在未处于自己的领地时使用此命令时信任你所有领地中的玩家。 |
claimmod.trust.full |
/claim untrust <player> |
从此领地中移除一名玩家,或在未处于自己的领地时使用此命令时从你所有领地中移除玩家。 |
claimmod.trust.untrust |
/claim trustlist |
遍历跟踪节点以展示活动的领地访问规则。 |
claimmod.trust.list |
/claim flag [flag] [val] |
直接在属性象限内切换标志状态。 |
claimmod.flag.<flag> |
/claim flaginfo [dim] |
调出全局世界标志指标或本地领地标志详情。 |
claimmod.flag.view |
/claim owner <player> |
开始两步所有权转移处理。 |
claimmod.claim.owner |
/claim abandon [id/name] |
将领土土地财产归还自然。 |
claimmod.claim.abandon |
/claim abandonall |
触发双重确认逻辑以擦除所有个人领地。 |
claimmod.claim.abandon |
/claim balance [player] |
显示总共有、已使用和可用的领地方块。 |
claimmod.claim.balance |
/claim buy [amount] |
使用 EcoBal 货币购买领地方块;如果不带数量则显示价格。 |
claimmod.claim.buy |
/claim kick <player> |
将不需要的实体安全地驱逐出你的领土边界。 |
claimmod.claim.kick |
/claim bypass |
切换管理员覆盖配置。 |
claimmod.admin.bypass |
/claim priority <n> |
修改重叠管理员区域上的覆盖优先级阈值。 |
claimmod.admin.setpriority |
/claim force <p> [r] |
强制在玩家坐标周围构建保护正方形。 |
claimmod.admin.forceclaim |
/claim tp <target> |
立即链接并传送管理员到指定的领地区域。 |
claimmod.admin.teleport |
/claim blocks give/take |
在管理层面向玩家余额池中授予或扣除经济方块。 |
claimmod.admin.blocks.give / take |
/claim blocks reset |
将跟踪记录重置回初始配置基线。 |
claimmod.admin.blocks.reset |
/claim give <player> [type] [amount] |
给予一个领地工具或管理员领地工具物品。 |
claimmod.admin.givetool |
/claim reload |
直接从磁盘拉取结构数据更新到内存中。 |
claimmod.admin.reload |
权限
点击展开所有权限节点
🌐 伞状节点
| 节点 |
功能清除级别 |
claimmod.claims |
授予所有 claimmod.claim.* 节点。 |
claimmod.trusts |
授予所有 claimmod.trust.* 节点。 |
claimmod.flags |
授予所有 claimmod.flag.* 节点。 |
claimmod.admins |
主要管理伞状节点;授予所有 claimmod.admin.* 节点。 |
👤 领地修改器
| 节点 |
功能权限 |
claimmod.claim.create |
允许通过标准工具创建领土分配。 |
claimmod.claim.resize |
授予调整领土边界的重新缩放访问权限。 |
claimmod.claim.info |
授予查询空间领地属性的授权。 |
claimmod.claim.list |
授予查看已拥有的活跃领地的权限。 |
claimmod.claim.nearby |
允许检查周围领地的可视化信息。 |
claimmod.claim.rename |
授予修改领地名称的访问权限。 |
claimmod.claim.abandon |
允许放弃领地及领土。 |
claimmod.claim.owner |
授予转移领地所有权的权限。 |
claimmod.claim.balance |
允许查看您自己的领地方块余额。 |
claimmod.claim.buy |
允许使用 EcoBal 货币购买领地方块。 |
claimmod.claim.kick |
允许对入侵者使用 /claim kick。 |
claimmod.dback |
允许返回到您死亡的领地(默认:false)。 |
💰 收入与过期
| 节点 |
功能权限 |
claimmod.accrual.<amount> |
在线时每小时获得 <amount> 个领地方块,而非基础速率(数值列于 accrual.rank_rates 中)。 |
claimmod.expiry.exempt |
领地永不过期。默认值:true;在组上设置为 false 可使其领地过期。 |
🤝 信任管理
| 节点 |
功能权限 |
claimmod.trust.coowner |
允许将玩家提升为共同所有者矩阵层级。 |
claimmod.trust.full |
授予以标准建造层级权利信任玩家的权限。 |
claimmod.trust.flags |
授予分配旗帜操作员信任层级的权限。 |
claimmod.trust.containers |
允许信任拥有容器访问权限的玩家。 |
claimmod.trust.traveler |
允许授予旅行者门导航权限。 |
claimmod.trust.untrust |
允许从您的财产中取消信任玩家。 |
claimmod.trust.list |
允许查看财产上的访问列表。 |
🏳️ 旗帜
| 节点 |
功能权限 |
claimmod.flag.view |
允许查看您自己领地的旗帜。 |
claimmod.flag.<flag> |
允许切换该特定旗帜(每个旗帜一个节点,例如 claimmod.flag.enderman_griefing)。 |
🛠️ 管理操作
| 节点 |
功能权限 |
claimmod.admin.bypass |
立即绕过结构土地块锁定。 |
claimmod.admin.delete |
允许按 UUID 进行任何领地的管理删除。 |
claimmod.admin.inspect |
允许跨世界检查任何财产。 |
claimmod.admin.flag |
允许修改其他玩家拥有的财产。 |
claimmod.admin.teleport |
允许进行管理传送追踪键。 |
claimmod.admin.reload |
允许从终端命令重新加载系统属性。 |
claimmod.admin.blocks.give |
管理性地增加目标玩家的领地方块总数。 |
claimmod.admin.blocks.take |
管理性地减少目标玩家的领地方块总数。 |
claimmod.admin.blocks.reset |
重置服务器环境中玩家的余额池。 |
claimmod.admin.balance |
宽松的权限节点,用于调查其他余额。 |
claimmod.admin.list |
授予列出其他玩家土地财产的权限。 |
claimmod.admin.worldflags |
允许编辑默认的全局世界覆盖项。 |
claimmod.admin.setpriority |
更新管理领地上的叠加排序权重变量。 |
claimmod.admin.forceclaim |
授予使用管理强制领地系统的权限。 |
claimmod.admin.adminclaim |
授予建造服务器管理员区域的权限。 |
claimmod.admin.givetool |
允许使用 /claim give 给予领地工具物品。 |
整合包政策
- ✅ 您可以 包含 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.
评论 0
登录后参与评分
还没有评论,来抢沙发吧