跳到主要内容

快速开始

安装​

  1. 确保服务端版本 1.12+，已安装 TabooLib 6.2
  2. 将 TreasuresLite.jar 放入 plugins/ 目录
  3. 重启服务器，插件会自动生成默认配置

目录结构​

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

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

创建你的第一个宝箱​

  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）
  • 切换世界
  • 传送
  • 定时刷新（默认每 600 tick）