区块声明

区块声明（Chunk Claims）
适用于《我的世界》Java版 1.21.11 的 Fabric 模组

概述

区块声明（Chunk Claims）允许玩家声明单个区块，并控制谁可以与之交互。声明会随世界保存，适用于所有维度，并且不会阻止玩家穿过已声明的土地。

每位玩家在所有维度中总共可以拥有可配置数量的已声明区块。默认上限为 15 个。

该模组包含三个信任等级、领地进入标题、管理员安全的声明移除、可选的 Xaero 地图集成，以及可选的传送石碑（Waystones）兼容性。

前置要求

• 《我的世界》Java版 1.21.11
• Fabric Loader 0.19.3 或更高版本
• Fabric API 0.141.4+1.21.11
• Java 21 或更高版本

如需 Xaero 集成：

• Xaero 的小地图（Xaero's Minimap） 26.1.4
• Xaero 的世界地图（Xaero's World Map） 1.41.2

如需可选的传送石碑（Waystones）兼容性：

• 适用于《我的世界》1.21.11 的传送石碑（Waystones） 21.11.x
• Balm（传送石碑所需）
• 服务器和参与客户端均需安装传送石碑和 Balm

不需要 Cloth Config。

安装

在服务器上安装 Chunk Claims 和 Fabric API。在需要 Xaero 地图控制和声明高亮功能的客户端上安装相同的 Chunk Claims jar 文件和 Fabric API。Xaero 的小地图和世界地图是客户端可选依赖项，在专用服务器上不是必需的。

同一个 Chunk Claims jar 文件适用于专用服务器和客户端。单人游戏也通过《我的世界》的内置服务器受支持。

命令

/claims add
声明玩家当前所站立的区块。如果该区块已被其他玩家拥有，则无法声明。

/claims add (x1, z1) (x2, z2) <用户名|服务器>
仅限管理员。为指定玩家或服务器声明两个对角相对的角之间包含的矩形区域。数字是管理员当前维度中的区块坐标。单次操作最多可处理 65,536 个区块。

如果所选区块属于不同所有者，则整个区域声明将被取消，且不更改任何区块。已属于所选目标的区块保持不变。目标玩家必须之前已加入过服务器。如果新增区块会使玩家超过配置的所有权上限，该操作也会被取消。服务器拥有的声明不受玩家上限限制。

/claims remove
移除玩家当前所站立且自己拥有的区块声明。

/claims remove confirm
确认管理员移除其他玩家声明的尝试。确认必须在 30 秒内完成。

/claims trust <用户名> trustlevel <1|2|3>
为指定玩家设置其在命令发送者拥有的所有声明中的信任等级。目标玩家必须之前已加入过服务器。

/claims untrust <用户名>
从命令发送者拥有的所有声明中移除指定玩家的信任。

信任等级

通用权限 —— 未受信任的玩家及信任等级 1、2、3

所有玩家都可以攻击声明内的敌对生物，并且可以激活、打开和通过可选传送石碑（Waystones）模组中的方块。这些权限不会提高玩家的信任等级。未受信任的玩家仍然不能攻击被动动物、村民、宠物或其他受保护实体，也不能破坏传送石碑、在其旁边放置方块或使用无关的受保护方块。

等级 1 —— 仅查看容器

除了通用的敌对生物和传送石碑权限外，等级 1 只能打开受支持的物品容器并查看其内容。等级 1 不能移动物品、打开门或栅栏门、使用按钮或拉杆、触发受保护的压力板或绊线、建造、破坏方块，或与受保护实体交互。

等级 2 —— 容器和入口

包括通用的敌对生物和传送石碑权限。等级 2 可以查看和修改受支持的容器，打开和关闭门、栅栏门和活板门，并可以使用按钮、拉杆、压力板和绊线。它不授予一般建造、破坏或其他实体访问权限。

等级 3 —— 完全访问

包括通用的敌对生物和传送石碑权限。等级 3 可以建造、破坏方块、使用容器和受保护方块，并可以与其他受保护实体交互或攻击它们。

声明所有者始终拥有完全访问权限。信任是每个所有者全局性的，因此玩家的等级适用于该所有者在所有维度中拥有的每个声明。服务器管理员对服务器拥有的声明拥有完全访问权限。

配置的上限适用于普通声明和由管理员分配的区域。加载旧世界时，如果玩家已经超过上限，现有声明不会自动移除，但在其总数低于上限之前，该玩家无法声明更多区块。

服务器配置

服务器首次启动时会创建 config/chunk_claims.properties 文件。使用以下配置设置每位玩家的上限：

max-player-claims=15

有效值为 1 到 1,000,000 之间的整数。该值统计玩家在所有维度中拥有的所有声明。更改后请重启专用服务器或内置服务器。缺失或无效的值将使用默认上限 15，并会在服务器日志中报告。

声明保护

没有足够信任的玩家不能直接破坏或放置方块、使用受保护方块或容器，或与受保护实体交互或攻击它们。所有玩家都可以自由穿过已声明的区块。

“信任等级”下列出的通用敌对生物和传送石碑例外适用于每个声明。

通常只有所有者才能取消声明区块。管理员只有在收到以下警告并确认操作后，才能移除其他玩家的声明：

“该区块由 <用户名> 拥有。你确定要取消声明他们的区块吗？”

XAERO 兼容性

要使用 Xaero 集成，请在客户端安装 Chunk Claims、Fabric API、Xaero 的小地图和 Xaero 的世界地图。服务器必须安装 Chunk Claims 和 Fabric API。

单个区块：

1. 打开 Xaero 的全屏世界地图。
2. 使用 Xaero 的地图选择控件精确选择一个区块。
3. 打开右键选项，选择声明或取消声明操作。

管理员多选：

1. 选择包含多个区块的矩形区域。
2. 打开选择的右键选项。
3. 选择为自己、为服务器或为其他玩家声明该区域。其他玩家选项会打开用户名输入界面，并保持 Xaero 中当前显示的维度。
4. 要移除声明，请选择批量取消声明操作。查看受影响的声明数量和所有者，然后明确确认移除。

批量声明和取消声明仅限管理员操作，每次操作限制为 65,536 个区块。服务器会重新检查管理员身份、维度、大小、所有权和确认信息。在移除警告后发生变化的声明不会被该待定确认移除。

玩家自己的声明以绿色高亮显示。属于其他玩家或服务器的声明以红色高亮显示。高亮会在服务器同步后刷新。

领地标题

进入已声明的土地时显示：

正在进入 <用户名> 的领地

进入未声明的土地时显示：

正在进入未声明领地

当前保护范围

此版本保护玩家的直接方块操作、受支持的容器、门和红石访问控制以及实体交互。环境变化和自动化变化，如爆炸、火焰、流体流动、活塞、漏斗和生物破坏，目前不进行声明过滤。敌对生物攻击和传送石碑使用是声明保护的有意例外。