PlotPlugin - 地皮插件

许可证: 保留所有权利/无许可证

插件介绍
PlotPlugin 是一款专为 Hytale 服务器设计的地皮管理插件，提供完整的地皮认领、保护、管理功能。玩家可以在地皮世界中认领属于自己的土地，自由建造而不受他人干扰。
###

主要功能
-

**地皮认领** - 玩家可以认领空闲地皮作为自己的领地
-

**方块保护** - 自动保护已认领地皮，防止他人破坏
-

**自动道路** - 新区块生成时自动生成道路网格
-

**信任系统** - 地皮主人可以信任其他玩家在自己地皮建造
-

**快速传送** - 支持从任何世界传送到自己的地皮
-

**数据持久化** - 自动保存地皮数据，重启不丢失
---
##

安装方法
1. 下载 PlotPlugin-1.0.0.jar
2. 将文件放入服务器的 mods 文件夹
3. 创建地皮世界（超平坦世界）：

/world add plotworld --gen=Flat

4. 重启服务器
5. 配置文件会自动生成在 mods/plot_PlotPlugin/config.json
---
##

命令列表
### 玩家命令
| 命令 | 别名 | 说明 | 权限 |
|------|------|------|------|
| /plot auto | /plot a | 自动领取一块空闲地皮并传送 | plot.claim |
| /plot world | /plot w | 传送到地皮世界 | plot.world |
| /plot home [编号] | /plot h | 传送到自己的地皮 | plot.home |
| /plot claim | - | 认领脚下的地皮 | plot.claim |
| /plot unclaim | /plot delete | 放弃当前地皮 | plot.unclaim |
| /plot trust <玩家> | /plot add | 信任玩家（允许在你的地皮建造） | plot.trust |
| /plot untrust <玩家> | /plot remove | 取消信任玩家 | plot.trust |
| /plot info | /plot i | 查看当前地皮信息 | plot.use |
| /plot list | /plot l | 列出你拥有的所有地皮 | plot.use |
| /plot help | /plot ? | 显示帮助信息 | - |

### 管理员命令
| 命令 | 说明 | 权限 |
|------|------|------|
| /plot save | 手动保存地皮数据 | plot.admin |
| /plot reload | 重载配置文件 | plot.admin |
| /plot setup [半径] | 手动生成道路网格 | plot.admin |
| /plot debug | 显示调试信息 | plot.admin |
---
##

权限节点
| 权限节点 | 说明 | 默认 |
|----------|------|------|
| plot.use | 基础使用权限（查看信息、列表） | 所有玩家 |
| plot.claim | 认领地皮权限 | 所有玩家 |
| plot.unclaim | 放弃地皮权限 | 所有玩家 |
| plot.home | 传送到地皮权限 | 所有玩家 |
| plot.world | 传送到地皮世界权限 | 所有玩家 |
| plot.trust | 信任/取消信任玩家权限 | 所有玩家 |
| plot.admin | 管理员权限（保存、重载、调试） | OP |
| * | 通配符权限（绕过所有保护） | OP |
---

##

配置文件
配置文件位置：mods/plot_PlotPlugin/config.json

JSON:

json
{
  "PlotSize": 64,                    // 地皮大小 (64x64)
  "RoadWidth": 4,                    // 道路宽度
  "MaxPlotsPerPlayer": 1,            // 每人最多拥有的地皮数
  "PlotWorldName": "plotworld",      // 地皮世界名称
  "PlotWorldY": 10,                  // 地皮世界地面高度
  "RoadBlockType": "Rock_Stone_Cobble", // 道路方块类型
  "AutoGenerateRoads": true,         // 是否自动生成道路
  "ProtectUnclaimedPlots": true,     // 是否保护未认领的地皮
  "ProtectRoads": true,              // 是否保护道路
  "AutoSaveIntervalMinutes": 5       // 自动保存间隔（分钟）
}




### 配置项说明


| 配置项 | 类型 | 默认值 | 说明 |
|--------|------|--------|------|
| PlotSize | 整数 | 64 | 地皮的边长（64 表示 64x64 的地皮） |
| RoadWidth | 整数 | 4 | 道路的宽度 |
| MaxPlotsPerPlayer | 整数 | 1 | 每个玩家最多可认领的地皮数量 |
| PlotWorldName | 字符串 | "plotworld" | 地皮世界的名称 |
| PlotWorldY | 整数 | 10 | 地皮世界的地面高度 |
| RoadBlockType | 字符串 | "Rock_Stone_Cobble" | 道路使用的方块类型 |
| AutoGenerateRoads | 布尔 | true | 是否在新区块生成时自动生成道路 |
| ProtectUnclaimedPlots | 布尔 | true | 是否保护未被认领的地皮 |
| ProtectRoads | 布尔 | true | 是否保护道路不被破坏 |
| AutoSaveIntervalMinutes | 整数 | 5 | 自动保存数据的间隔时间（分钟） |

数据存储
地皮数据存储位置：mods/plot_PlotPlugin/plots.json
数据包含：
- 地皮坐标
- 地皮主人 UUID 和名称
- 信任的玩家列表
- 地皮设置
>

**注意**：请定期备份 plots.json 文件！

##

常见问题
**Q: 如何增加每人可拥有的地皮数量？**
> 修改 config.json 中的 MaxPlotsPerPlayer 值，然后执行 /plot reload
**Q: 如何修改地皮大小？**
> 修改 config.json 中的 PlotSize 值。注意：修改后只对新生成的地皮有效
**Q: 数据会丢失吗？**
> 插件会自动保存数据（默认每5分钟），并在领取/放弃地皮时立即保存。服务器正常关闭时也会保存
**Q: 如何让 OP 绕过保护？**
> 拥有 plot.admin 或 * 权限的玩家可以在任何地方建造/破坏方块
---
##