快速开始

安装

1. 确保服务端版本为 1.12.2 或更高
2. 将 TreasuresLite.jar 放入 plugins/ 目录
3. 重启服务器，插件会自动生成默认配置

插件内置 TabooLib，不需要额外安装前置。

需要更详细的步骤？

如果你是第一次配置这类插件，详细版教程 里有逐步骤的完整流程和名词解释。

目录结构

plugins/TreasuresLite/
├── config.yml          # 主配置（显示距离、刷新频率、发包方式等）
├── location.yml        # 坐标分组与刷新规则配置
└── treasures/          # 宝箱配置目录（每个 yml 文件 = 一个宝箱类型）
    └── def.yml         # 默认示例宝箱

宝箱配置文件名即为宝箱 ID。例如 def.yml 对应宝箱 ID def。

默认样例

首次启动时，插件只会自动释放 treasures/def.yml。源码中还带有 treasures/skull_test.yml 头颅测试样例，但它不会自动生成到服务器配置目录，需要手动取用后才会被加载。

创建你的第一个宝箱

1. 进入 treasures/ 目录，复制 def.yml 并重命名，例如 daily.yml
2. 编辑宝箱配置（标题、布局、方块外观、奖励等）
3. 在 location.yml 中为新宝箱配置坐标分组和刷新规则
4. 执行 /tsl reload 重载配置
5. 使用 /tsl open daily 测试打开效果

基本工作流程

1. 插件启动时加载 location.yml 中的坐标分组和刷新规则
2. 玩家进服时，根据规则为该玩家缓存宝箱坐标
3. 在显示距离内，通过 NMS 发包向玩家客户端发送虚拟方块
4. 玩家右键点击虚拟方块，触发开箱流程（钥匙检查 -> 打开事件 -> GUI 界面 -> 领取奖励）
5. 领取后该坐标宝箱从玩家缓存中移除，等待下一次刷新周期

显示刷新时机

玩家在以下情况会刷新宝箱显示：

时机	延迟	说明
进入服务器	60 tick（约 3 秒）	强制全量重发
切换世界	1 tick	强制全量重发
传送	1 tick	强制全量重发，被取消的传送不触发
定时刷新	按 view.refresh	只补发发生变化的坐标

首次进服时，插件需要先把该玩家的固定坐标缓存建好才会显示宝箱。若缓存尚未就绪，这一次显示会被推迟到初始化完成之后，因此刚进服可能会看到宝箱稍晚出现。