- 版权类型
- 原创
- 插件中文名称
- 梦旅宝箱
- 插件英文名称
- MorpChest
- 原帖地址
- minebbs
- 支持的核心（服务端）
- Paper
- 语言支持
- 中文（简体）
- 前置组件
- mmoitems
- 适配版本（Java）
- 1.21
=====================================
MorpChest v2.0 - 宝藏箱插件使用说明
=====================================
一、插件简介
-----------
MorpChest 是一款为 MMORPG 服务器设计的宝藏箱插件。
支持每人独立领取、区域分类、收集进度、里程碑奖励、指南针寻宝等功能。
兼容 MMOItems 自定义物品，领取时实时生成，跟随配置更新。
运行环境：Paper 1.21+ / Java 25 / 依赖 MMOItems 插件
二、安装
--------
1. 将 MorpChest-x.x.x.jar 放入 plugins/ 目录
2. 确保已安装 MMOItems 插件
3. 启动服务器，插件首次加载会自动下载 SQLite 依赖到 libraries/ 目录
4. 生成的配置文件位于 plugins/MorpChest/
三、配置文件说明
----------------
plugins/MorpChest/
├── config.yml 全局配置（特效、音效、消息文本）
├── regions.yml 区域定义
├── chests.yml 所有宝藏箱数据（自动生成，一般不手动编辑）
└── milestones/ 里程碑配置（每个区域一个yml文件）
├── 冬熊岭.yml
├── 覆雪营地.yml
└── ...
四、命令列表
------------
所有命令前缀: /morpchest (别名: /mc)
【管理员命令】(需要权限: morpchest.admin)
/morpchest set <内部ID> <显示名> [区域]
注册宝藏箱。准星对准一个容器方块执行。
内部ID不可重复，相当于箱子的唯一标识。
区域为可选参数，不填则归入"无区域"分组。
/morpchest remove
注销准星对准的宝藏箱。注销后方块恢复为普通容器，可正常破坏。
/morpchest list
列出所有已注册的宝藏箱（最多显示20个）。
/morpchest info
查看准星对准的宝藏箱详细信息。
/morpchest gui
打开管理GUI面板（区域列表 → 箱子列表 → 箱子编辑）。
/morpchest reload
重载所有配置文件。
/morpchest reset <箱子ID> <玩家名>
重置某玩家对某箱子的领取记录，该玩家可再次领取。
不影响已领取的里程碑奖励。
/morpchest reset all <玩家名>
清空该玩家的所有数据（领取记录 + 里程碑），完全重置。
/morpchest region create <区域名> [显示名] [图标材质]
创建一个新区域。自动生成权限节点 morpchest.region.<区域名>
/morpchest region delete <区域名>
删除一个区域（不会删除该区域下的箱子，箱子会变为无区域）。
/morpchest region list
列出所有区域及其箱子数量。
【玩家命令】(需要权限: morpchest.use)
/morpchest collection
打开自己的宝藏收集界面。
/morpchest collection <玩家名>
为指定玩家打开收集界面（需要 morpchest.admin 权限）。
五、权限节点
------------
morpchest.admin 所有管理命令（默认: OP）
morpchest.use 收集界面和指南针使用（默认: 所有人）
morpchest.region.<区域名> 控制玩家可见哪些区域的收集进度（需手动授予）
权限示例（LuckPerms）:
lp user 玩家名 permission set morpchest.region.冬熊岭 true
六、宝藏箱设置流程
------------------
1. 在世界中放置一个容器方块（箱子、铜箱子、木桶等）
2. 右键打开容器，将奖励物品按你想要的布局摆放进去
- 支持 MMOItems 物品（领取时通过API实时生成，跟随配置更新）
- 支持原版物品（序列化存储，领取时还原）
- 物品在哪个格子，玩家预览时就看到在哪个格子
3. 关闭容器，准星对准该容器
4. 执行: /morpchest set <内部ID> <显示名> [区域]
例: /morpchest set ice_001 &b冰晶宝箱 冰精灵山谷
5. 完成！箱子已注册，自动启用防破坏保护
七、玩家交互方式
----------------
右键宝藏箱 打开27格只读预览GUI，查看箱子内奖励
Shift+右键宝藏箱 领取奖励（需背包空间足够）
已领取后:
右键 仍可预览（回顾已领取的物品）
Shift+右键 提示已领取及领取时间
防破坏: 已注册的宝藏箱任何人都无法破坏（包括OP）
删除流程: 先 /morpchest remove 注销，再手动破坏方块
八、收集系统
------------
玩家执行 /morpchest collection 打开收集界面:
- 显示玩家有权限查看的区域列表
- 每个区域显示进度条（如: 347/400）
- 点击区域进入里程碑界面
权限控制:
- 玩家需要 morpchest.region.<区域名> 权限才能看到对应区域
- 创建区域时权限节点自动生成，用权限插件授予即可
九、里程碑配置
--------------
在 plugins/MorpChest/milestones/ 目录下创建yml文件。
文件名 = 区域名（需与 regions.yml 中的区域ID一致）。
示例: milestones/冰精灵山谷.yml
gui-name: "&3冰精灵山谷 - 里程碑"
gui-size: 27
milestones:
11: # GUI中的格子位置（0-53）
icon: IRON_CHEST_MINECART # 图标材质
name: "&f初入山谷" # 显示名称
lore: # 描述文本
- "&7收集 50 个宝箱"
- ""
- "&a奖励: 1000 金币"
enchanted: false # 是否附魔光效
required: 50 # 需要收集的箱子数量
commands: # 达标后执行的命令（%player% 替换为玩家名）
- "eco give %player% 1000"
13:
icon: DIAMOND
name: "&b山谷征服者"
lore:
- "&7收集 200 个宝箱"
enchanted: true
required: 200
commands:
- "mmoitems give %player% SWORD LEGENDARY_ICE 1"
说明:
- gui-size: GUI大小，可选 9/18/27/36/45/54
- 格子位置从0开始，OP自由决定每个里程碑放在哪个格子
- 里程碑奖励需要玩家在GUI中手动点击领取，不会自动发放
- 防重复: 每个里程碑每人只能领取一次
十、指南针寻宝系统
------------------
【道具】
普通指南针 = 寻宝道具（一次性消耗品）
【使用流程】
1. 玩家手持普通指南针，右键激活
2. 指南针变为"寻宝指南针"，指向当前世界中离玩家最近的未领取箱子
3. 被追踪的箱子对该玩家锁定（其他玩家不受影响）
4. 玩家到达箱子后，手持寻宝指南针右键箱子解锁
5. 指南针消耗，箱子恢复正常，玩家可以正常预览和领取
【取消追踪】
手持寻宝指南针 Shift+右键空气 = 取消追踪
指南针同样消耗（防止反复激活挑选箱子）
【限制】
- 一名玩家同时只能激活一个指南针追踪
- 被锁定的箱子只影响该玩家，其他玩家正常交互
- 玩家路上遇到其他未锁定的箱子，可以正常预览和领取
【特殊情况】
- OP删除被追踪的箱子时，自动归还指南针给玩家
- 玩家离线时箱子被删除，下次上线时自动补发指南针
十一、管理GUI
-------------
执行 /morpchest gui 打开管理面板:
第一层: 区域列表
显示所有区域 + 无区域分组，点击进入
第二层: 箱子列表（分页，每页45个）
显示该区域所有箱子，包含ID、坐标、物品数量
底部有翻页和返回按钮
第三层: 箱子编辑面板
- 传送到箱子位置
- 修改箱子内容（提示重新执行set命令）
- 重置所有玩家的领取记录
- 删除箱子
MorpChest v2.0 - 宝藏箱插件使用说明
=====================================
一、插件简介
-----------
MorpChest 是一款为 MMORPG 服务器设计的宝藏箱插件。
支持每人独立领取、区域分类、收集进度、里程碑奖励、指南针寻宝等功能。
兼容 MMOItems 自定义物品，领取时实时生成，跟随配置更新。
运行环境：Paper 1.21+ / Java 25 / 依赖 MMOItems 插件
二、安装
--------
1. 将 MorpChest-x.x.x.jar 放入 plugins/ 目录
2. 确保已安装 MMOItems 插件
3. 启动服务器，插件首次加载会自动下载 SQLite 依赖到 libraries/ 目录
4. 生成的配置文件位于 plugins/MorpChest/
三、配置文件说明
----------------
plugins/MorpChest/
├── config.yml 全局配置（特效、音效、消息文本）
├── regions.yml 区域定义
├── chests.yml 所有宝藏箱数据（自动生成，一般不手动编辑）
└── milestones/ 里程碑配置（每个区域一个yml文件）
├── 冬熊岭.yml
├── 覆雪营地.yml
└── ...
四、命令列表
------------
所有命令前缀: /morpchest (别名: /mc)
【管理员命令】(需要权限: morpchest.admin)
/morpchest set <内部ID> <显示名> [区域]
注册宝藏箱。准星对准一个容器方块执行。
内部ID不可重复，相当于箱子的唯一标识。
区域为可选参数，不填则归入"无区域"分组。
/morpchest remove
注销准星对准的宝藏箱。注销后方块恢复为普通容器，可正常破坏。
/morpchest list
列出所有已注册的宝藏箱（最多显示20个）。
/morpchest info
查看准星对准的宝藏箱详细信息。
/morpchest gui
打开管理GUI面板（区域列表 → 箱子列表 → 箱子编辑）。
/morpchest reload
重载所有配置文件。
/morpchest reset <箱子ID> <玩家名>
重置某玩家对某箱子的领取记录，该玩家可再次领取。
不影响已领取的里程碑奖励。
/morpchest reset all <玩家名>
清空该玩家的所有数据（领取记录 + 里程碑），完全重置。
/morpchest region create <区域名> [显示名] [图标材质]
创建一个新区域。自动生成权限节点 morpchest.region.<区域名>
/morpchest region delete <区域名>
删除一个区域（不会删除该区域下的箱子，箱子会变为无区域）。
/morpchest region list
列出所有区域及其箱子数量。
【玩家命令】(需要权限: morpchest.use)
/morpchest collection
打开自己的宝藏收集界面。
/morpchest collection <玩家名>
为指定玩家打开收集界面（需要 morpchest.admin 权限）。
五、权限节点
------------
morpchest.admin 所有管理命令（默认: OP）
morpchest.use 收集界面和指南针使用（默认: 所有人）
morpchest.region.<区域名> 控制玩家可见哪些区域的收集进度（需手动授予）
权限示例（LuckPerms）:
lp user 玩家名 permission set morpchest.region.冬熊岭 true
六、宝藏箱设置流程
------------------
1. 在世界中放置一个容器方块（箱子、铜箱子、木桶等）
2. 右键打开容器，将奖励物品按你想要的布局摆放进去
- 支持 MMOItems 物品（领取时通过API实时生成，跟随配置更新）
- 支持原版物品（序列化存储，领取时还原）
- 物品在哪个格子，玩家预览时就看到在哪个格子
3. 关闭容器，准星对准该容器
4. 执行: /morpchest set <内部ID> <显示名> [区域]
例: /morpchest set ice_001 &b冰晶宝箱 冰精灵山谷
5. 完成！箱子已注册，自动启用防破坏保护
七、玩家交互方式
----------------
右键宝藏箱 打开27格只读预览GUI，查看箱子内奖励
Shift+右键宝藏箱 领取奖励（需背包空间足够）
已领取后:
右键 仍可预览（回顾已领取的物品）
Shift+右键 提示已领取及领取时间
防破坏: 已注册的宝藏箱任何人都无法破坏（包括OP）
删除流程: 先 /morpchest remove 注销，再手动破坏方块
八、收集系统
------------
玩家执行 /morpchest collection 打开收集界面:
- 显示玩家有权限查看的区域列表
- 每个区域显示进度条（如: 347/400）
- 点击区域进入里程碑界面
权限控制:
- 玩家需要 morpchest.region.<区域名> 权限才能看到对应区域
- 创建区域时权限节点自动生成，用权限插件授予即可
九、里程碑配置
--------------
在 plugins/MorpChest/milestones/ 目录下创建yml文件。
文件名 = 区域名（需与 regions.yml 中的区域ID一致）。
示例: milestones/冰精灵山谷.yml
gui-name: "&3冰精灵山谷 - 里程碑"
gui-size: 27
milestones:
11: # GUI中的格子位置（0-53）
icon: IRON_CHEST_MINECART # 图标材质
name: "&f初入山谷" # 显示名称
lore: # 描述文本
- "&7收集 50 个宝箱"
- ""
- "&a奖励: 1000 金币"
enchanted: false # 是否附魔光效
required: 50 # 需要收集的箱子数量
commands: # 达标后执行的命令（%player% 替换为玩家名）
- "eco give %player% 1000"
13:
icon: DIAMOND
name: "&b山谷征服者"
lore:
- "&7收集 200 个宝箱"
enchanted: true
required: 200
commands:
- "mmoitems give %player% SWORD LEGENDARY_ICE 1"
说明:
- gui-size: GUI大小，可选 9/18/27/36/45/54
- 格子位置从0开始，OP自由决定每个里程碑放在哪个格子
- 里程碑奖励需要玩家在GUI中手动点击领取，不会自动发放
- 防重复: 每个里程碑每人只能领取一次
十、指南针寻宝系统
------------------
【道具】
普通指南针 = 寻宝道具（一次性消耗品）
【使用流程】
1. 玩家手持普通指南针，右键激活
2. 指南针变为"寻宝指南针"，指向当前世界中离玩家最近的未领取箱子
3. 被追踪的箱子对该玩家锁定（其他玩家不受影响）
4. 玩家到达箱子后，手持寻宝指南针右键箱子解锁
5. 指南针消耗，箱子恢复正常，玩家可以正常预览和领取
【取消追踪】
手持寻宝指南针 Shift+右键空气 = 取消追踪
指南针同样消耗（防止反复激活挑选箱子）
【限制】
- 一名玩家同时只能激活一个指南针追踪
- 被锁定的箱子只影响该玩家，其他玩家正常交互
- 玩家路上遇到其他未锁定的箱子，可以正常预览和领取
【特殊情况】
- OP删除被追踪的箱子时，自动归还指南针给玩家
- 玩家离线时箱子被删除，下次上线时自动补发指南针
十一、管理GUI
-------------
执行 /morpchest gui 打开管理面板:
第一层: 区域列表
显示所有区域 + 无区域分组，点击进入
第二层: 箱子列表（分页，每页45个）
显示该区域所有箱子，包含ID、坐标、物品数量
底部有翻页和返回按钮
第三层: 箱子编辑面板
- 传送到箱子位置
- 修改箱子内容（提示重新执行set命令）
- 重置所有玩家的领取记录
- 删除箱子
