ClaimMod

模组

· 作者 official.andy

这是一款灵感源自 Grief Prevention 的地域认领模组,通过认领工具来划定并保护指定区域!

0 本站下载 0 关注 更新于 1 周前

最新 1.0.8 · 26.3 · Fabric

一键开服(送7天)

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 在任何整合包中。
  • ❌ 该整合包 不得出售。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源