原创 付费 世界管理 YccBoxLock 2.0.0 - 新一代 全 GUI 箱子保护丨自由分组丨数据迁移 2.0.0

重磅功能：换箱子锁插件，不等于让玩家重新锁一遍全服箱子。

YccBoxLock 主打旧服数据搬迁，提供 ChestLock、BlockLocker、LWC、LockettePro、Deadbolt 迁移入口。ChestLock 还会尝试同步导入玩家群组名单。迁移后再用全 GUI 管理锁箱、成员、分组和坐标。

插件名称：YccBoxLock
当前版本：2.1.0
作者：YccSlim
联系 QQ：1549611570
适用服务端：Spigot / Paper / Purpur / Folia 1.21-26.x
Java：21

主打功能：从旧插件迁移数据

很多老服想更换箱子保护插件，最怕的不是新插件不会用，而是旧箱子数据丢失、玩家要重新上锁、管理员要手动补权限。YccBoxLock 的发布重点就是解决这个问题：让旧服尽量平滑迁移到新的 GUI 箱子保护体系。

支持的迁移入口：


迁移设计重点：

• 保留源数据：迁移过程不会主动删除或改写原插件文件，方便先测试、再切换。
• 锁记录导入：尝试把旧插件已有的上锁容器导入到 plugins/YccBoxLock/locks.yml。
• ChestLock 群组导入：ChestLock 迁移会同时尝试导入玩家群组名单，减少服主重建权限组的工作量。
• 适合旧服搬家：对已经运行很久、箱子数量很多的生存服，比让玩家重新上锁更现实。
• 可回滚验证：建议先备份，在测试环境或停服维护期间迁移，抽查锁主、双箱和群组权限后再停用旧插件。

一句话宣传：从告示牌锁、老牌箱子锁迁到 YccBoxLock，不是推倒重来，而是带着旧数据进入全 GUI 管理。







注意：Folia 使用区域线程，不支持在线执行全图扫描迁移。需要搬迁旧插件数据时，请先在 Paper、Spigot 或 Purpur 环境完成迁移并检查结果，再切回 Folia。

插件定位

YccBoxLock 不只是“给箱子加一把锁”，而是一套面向生存服、社区服和多人服务器的容器权限管理方案。

玩家将准心对准容器，双击 F 即可切换锁定状态；之后可以通过 /yccb gui 管理箱子分组、访问成员、容器坐标、远程解锁和付费传送。普通玩家不需要记忆一长串管理指令，也不需要在箱子旁摆放告示牌。

为什么选择 YccBoxLock

1. 数据迁移优先，换插件成本更低

传统容器保护插件之间迁移，经常会卡在“旧锁记录怎么处理”上。YccBoxLock 将迁移入口直接做成管理员指令，重点面向已经有 ChestLock、BlockLocker、LWC、LockettePro、Deadbolt 数据的服务器。

• 旧插件数据不会被直接破坏，方便保守切换。
• 迁移完成后，玩家可以继续在 /yccb gui 里查看和管理自己的锁。
• ChestLock 用户可以额外迁移玩家群组，减少重建成员名单的时间。
• 管理员可以通过 GUI 按玩家头像核对在线与离线玩家数据。

2. 真正以 GUI 为核心

相较于常见的告示牌锁和纯指令锁方案，YccBoxLock 将日常管理集中到 GUI：

• 主界面直接显示箱子分组，而不是把所有坐标堆成一页。
• 黑色玻璃边框、分页按钮、玩家头像和统一中文标题。
• 所有可点击按钮均提供功能说明 Lore，新玩家不需要猜测按钮用途。
• 管理员可以按头像查看所有玩家，包括离线玩家的锁记录。
• 容器条目直接显示世界、坐标、锁主、传送费用和操作提示。
• Shift + 左键删除箱子锁，右键传送，减少误操作。

3. 权限自由，适合真实生存玩法

YccBoxLock 同时提供两种互补的分组系统：

• 玩家群组：维护固定队友、城镇成员或长期合作玩家。
• 箱子分组：按仓库、机器、商店、公共物资等用途整理容器。

每个箱子分组都可以单独授权玩家或玩家群组。你可以让队友访问“公共仓库”，同时把“贵重物品”保持私有，不必为每个箱子重复添加名单。主界面会显示玩家实际创建的分组，并提供“未分组锁箱”虚拟入口，用来收纳所有已上锁但未设置箱子分组的容器；它不是实际分组，不会写入分组配置。

普通左键直接查看分组箱子，Shift + 左键打开独立设置界面，右键进入访问权限管理。设置界面提供“分组粘贴”和“外观设置”，可以批量给锁箱粘贴分组，并自定义分组 Lore 与图标。GUI 左下角提供纯文本使用指南，统一提示当前界面的左键、右键和 Shift + 左键操作。

4. 管理方便，不打断玩家操作

• 准心对准容器并双击 F 即可上锁或解锁。
• 前方不是容器时不处理按键，不影响正常副手切换。
• 判定距离跟随玩家实际方块交互距离。
• 双箱只保存一个逻辑坐标，列表更干净。
• /yccb 指令提供中文帮助和 Tab 补全。
• 所有聊天提示、GUI 标题、按钮名称和消息前缀均可在 lang.yml 修改。

5. 对自动化更友好

很多保护插件只能在“完全禁止漏斗”和“完全放开漏斗”之间二选一。YccBoxLock 会结合所有权与分组权限判断：

• 锁住的箱子、熔炉等容器不会向无权限漏斗输出物品。
• 同一主人、同一玩家群组或获得箱子分组授权的漏斗可以正常工作。
• 锁住的漏斗仍可正常吸取和推出物品，锁只负责防止玩家打开或破坏。
• 锁漏斗不显示在玩家 GUI 和锁箱数量中。
• 不使用全图扫描或每 Tick 轮询，物品实际移动时才执行权限判定。

这使插件既能保护仓库，也能保留分类机、熔炉组和运输线路等原有红石设备。

6. 面向旧服的数据搬迁

YccBoxLock 提供以下迁移入口：


ChestLock 迁移会同时尝试导入锁记录与玩家群组。其他迁移入口用于兼容常见告示牌锁、老牌容器锁和同类保护插件的数据搬迁场景。迁移采用保留源数据的方式，不会主动删除或改写原插件文件，方便服主验证结果后再决定是否停用旧插件。

迁移提示：不同插件版本和第三方修改版的数据结构可能不同。迁移前请完整备份 plugins 与世界文件，迁移后抽查锁主、双箱和群组名单，再正式开放服务器。Folia 使用区域线程，不支持在线执行全图扫描迁移；请先在 Paper、Spigot 或 Purpur 环境完成迁移，再切回 Folia。

功能一览

• 双击 F 上锁、解锁
• 全 GUI 锁箱与箱子分组管理
• 玩家群组与箱子分组双层授权
• 单独玩家授权
• 在线、离线玩家头像管理
• 远程解锁与坐标传送
• Vault 上锁、远程解锁、传送收费
• PlaceholderAPI 变量 %yccb_s%
• Dominion 与 Residence 领地兼容
• 漏斗、漏斗矿车及红石自动化权限保护
• ChestLock、BlockLocker、LWC、LockettePro、Deadbolt 迁移入口，重点支持旧服换插件
• ChestLock 群组数据迁移
• 完整中文语言文件与可自定义消息前缀
• 内置锁箱材质包导出与发送支持
• 爆炸、活塞和非主人破坏保护
• 事件驱动，无持续区块扫描任务

指令


权限


可选兼容插件

• Vault：支持上锁、远程解锁和传送收费。
• PlaceholderAPI：提供 %yccb_s% 锁箱数量变量。
• Dominion / Residence：防止玩家在无权操作的领地内创建容器锁。

上述插件均为可选依赖。没有安装时，YccBoxLock 的基础保护和 GUI 功能仍可运行。

安装方法

1. 确认服务端为 Spigot、Paper、Purpur 或 Folia 1.21-26.x。
2. 将 YccBoxLock-2.1.0.jar 放入服务端 plugins 文件夹。
3. 完整启动服务器，生成配置文件。
4. 按需修改 config.yml 与 lang.yml。
5. 修改插件后请完整重启服务器，不建议使用热加载插件。

迁移建议

迁移功能是 YccBoxLock 的重点宣传能力，推荐服主按“先备份、再导入、后核验、最后停旧插件”的顺序操作。

1. 停服并备份世界与原保护插件数据。
2. 保留原插件文件夹，安装 YccBoxLock 后启动服务器。
3. 执行对应的 /yccb migrate <类型> 指令。
4. 检查典型区域、双箱、离线玩家和群组权限。
5. 确认无误后再移除旧插件，并完整重启。

2.1.0 更新重点

• 适配 Spigot、Paper、Purpur、Folia 1.21-26.x。
• 新增 Folia/Paper 调度适配层，GUI 聊天回调、资源包发送、延迟保存和外观刷新不再依赖全局 BukkitScheduler。
• 远程传送改用安全的异步传送路径，避免同步加载远处区块。
• Folia 上禁用在线全图扫描迁移，防止区域线程违规。

2.0.0 更新重点

• 主 GUI 升级为箱子分组入口。
• 新增箱子分组、单独玩家和玩家群组授权。
• 新增 GUI 内箱子分组设置模式。
• 完善 ChestLock 锁记录与群组迁移。
• 优化漏斗所有权与锁容器输出判定。
• 锁漏斗不再占用 GUI 列表和锁箱计数。
• 旧漏斗采用首次合法传输时的低开销兼容策略。
• 启动时不强制加载全部锁坐标所在区块。
• 统一中文 GUI、语言文件和消息前缀。

作者信息

YccBoxLock 由 YccSlim 制作与维护。
问题反馈与建议：QQ 1549611570