简易索赔

EasyClaims

在 Hytale 服务器上保护你的建筑！认领土地，在地图上查看，并与朋友分享。

专为欧洲 Hytale 生存服务器 play.hyfyve.net 打造

快速开始

1. 安装：下载最新版本并将 JAR 文件放入服务器的 mods/ 文件夹中
2. 重启你的服务器
3. 认领土地：站在你想要保护的位置并输入 /easyclaims claim
4. 查看你的领地：打开你的地图 (M) - 已认领的区块会显示颜色！

就是这样！你的建筑现在已受到保护。

---

功能

• 可视化地图集成 - 已认领的区块在世界地图上显示为彩色
• 游戏时间奖励 - 玩得越久，认领的土地越多
• 与朋友分享 - 授予不同权限等级的玩家信任
• 全面保护 - 防止陌生人破坏、放置方块及进行交互

---

命令

所有命令均使用 /easyclaims。

基本命令

命令	功能
/easyclaims claim	认领你当前所在的区块
/easyclaims unclaim	移除你对当前区块的认领
/easyclaims list	列出你所有已认领的区块
/easyclaims help	显示所有可用命令

与朋友分享

命令	功能
/easyclaims trust PlayerName	授予某位玩家完全访问权限
/easyclaims trust PlayerName use	仅允许他们使用门/按钮
/easyclaims trust PlayerName container	额外允许他们打开箱子
/easyclaims untrust PlayerName	移除某位玩家的访问权限
/easyclaims trustlist	查看你已信任的玩家

其他命令

命令	功能
/easyclaims unclaimall	移除你所有的认领（小心使用！）
/easyclaims playtime	查看你的游戏时间和认领数量

管理员命令

命令	功能
/easyclaims admin config	显示当前设置
/easyclaims admin set <key> <value>	更改某项设置（立即保存）
/easyclaims admin reload	从文件重新加载配置

示例：

/easyclaims admin set max 100
/easyclaims admin set starting 6
/easyclaims admin set perhour 3

---

信任等级说明

当你信任某人时，可以选择授予他们的访问权限等级：

等级	命令示例	可执行操作
use	/easyclaims trust Steve use	开门、按按钮、拉杆
container	/easyclaims trust Steve container	以上 + 打开箱子、木桶
workstation	/easyclaims trust Steve workstation	以上 + 使用熔炉、工作台
build	/easyclaims trust Steve build	完全访问权限 - 可破坏和放置方块

注意： 如果未指定等级，玩家将获得完全的 build 访问权限。

提示： 对于只需要通过门的访客，请使用 /easyclaims trust PlayerName use！

---

认领机制说明

• 每个认领保护一个 32x32 方块区域（一个区块）
• 认领范围从基岩延伸至天空 - 完全的垂直保护
• 你从 4 个认领槽位 开始，并通过游戏逐渐获得更多
• 打开你的**世界地图 (M)**即可看到以颜色高亮显示的认领地
• 你的认领地显示为你独特的颜色，他人的认领地则显示为他们的颜色

获取更多认领数量

游戏时间越长，你能认领的土地就越多：

游戏时间	总认领槽位
新玩家	4 个区块
1 小时	6 个区块
5 小时	14 个区块
10 小时	24 个区块

使用 /easyclaims playtime 查看你的进度！

---

安装

面向服主

1. 从发布页面下载最新的 JAR 文件
2. 将其放入服务器目录下的 mods/ 文件夹中
3. 重启服务器
4. 配置文件将出现在 mods/Community_EasyClaims/ 目录下

设置权限

授予以下权限以让玩家使用本插件：

perm group add Adventure easyclaims.use
perm group add admin easyclaims.admin

easyclaims.use 权限授予所有玩家命令（claim, unclaim, trust 等）的使用权。easyclaims.admin 权限授予 /easyclaims admin 命令（config, set, reload）的使用权。

---

配置

配置文件位于 mods/Community_EasyClaims/ 目录下。

config.json - 主要设置

{
  "startingClaims": 4,
  "claimsPerHour": 2,
  "maxClaims": 50,
  "playtimeSaveInterval": 60
}

设置项	默认值	描述
startingClaims	4	新玩家可用的认领数量
claimsPerHour	2	每游玩一小时获得的额外认领数量
maxClaims	50	任何玩家可拥有的最大认领数量

公式： startingClaims + (hoursPlayed × claimsPerHour)，上限为 maxClaims

提示： 使用 /easyclaims admin set 命令在游戏内更改设置，无需编辑文件！

block_groups.json - 方块权限

控制哪些方块需要哪种信任等级。使用模式匹配：

{
  "usePatterns": ["door", "button", "lever", "gate", "trapdoor"],
  "containerPatterns": ["chest", "barrel", "storage", "hopper"],
  "workstationPatterns": ["crafting", "furnace", "anvil", "brewing"]
}

在发现新的 Hytale 方块 ID 时添加它们！

---

数据存储

所有插件数据均存储在 mods/Community_EasyClaims/ 目录下：

mods/Community_EasyClaims/
├── config.json          # 主要设置
├── block_groups.json    # 方块权限规则
├── claims/
│   ├── index.json       # 所有认领的快速索引
│   └── <uuid>.json      # 每位玩家的认领及信任玩家
└── playtime/
    └── <uuid>.json      # 每位玩家的游戏时间

---

故障排除

"你没有权限"

请你的服务器管理员授予你 easyclaims.use 权限。

地图上不显示领地？

尝试关闭并重新打开地图，或重新连接到服务器。

无法认领？

• 检查你是否有可用的槽位：/easyclaims playtime
• 确保该区块尚未被其他人认领

保护无效？

检查服务器控制台中 [EasyClaims] 相关的消息，以调试方块事件。

---

从源码构建

需要 Java 25+ 和 Maven：

mvn clean package

输出文件：target/EasyClaims-*.jar

---