原创 开源 工具 [VisualWorkbench] 可视化合成——让工作台里的材料在工作台上显示模型！ 1.0.0

核心特性​

原生合成，零学习成本

• 右键原版工作台，直接打开原生 3×3 合成界面
• 保留原版配方、配方书（Recipe Book）、Shift 批量合成、拖拽、数字键全部流程
• 不新增命令、不新增 GUI、不需要权限节点

材料暂存

• 关界面后九格剩余材料留在对应工作台，再次打开继续使用
• 只保存九格真实材料，界面里的结果预览不算库存，不会被刷
• 数据写入区块 PDC，随正常区块保存/加载恢复，不需要额外数据库

桌面静态展示

• 用不可拾取的静态 ItemDisplay 按九宫格位置平铺材料
• 每个非空槽最多一个展示实体，空槽不生成实体，不产生多余实体负担
• 展示用的是物品副本的单件，不修改真实材料数量
• 展示结果不显示——桌上只有材料，没有“成品预览”

多人并发安全

• 一张工作台同时只允许一位玩家操作，其他玩家能看见桌上材料但动不了
• 打开期间持有区块票，玩家走远/断线/传送会正常结算并释放

世界交互保护

• 桌上有材料或有活动会话时，该工作台禁止被活塞推动
• 跨区域活塞检查只查线程安全坐标索引，不触碰其他区域的方块或区块数据（Folia 关键）
• 破坏/爆炸时先关闭会话并结算材料，不会让材料凭空蒸发

Folia 原生适配

• folia-supported: true，按区域线程模型编写，不依赖 BukkitScheduler 全局调度
• 全程做区域/实体所有权检查，不跨区域操作实体

---

行为规则速查​

内置玩家提示（无需额外配置）：

• 这张工作台正在使用中，请稍后再试。
• 工作台暂时无法打开，请查看服务器日志。
• 该工作台的数据异常，已锁定，请联系管理员查看日志。

---

数据安全设计​

这部分是这个插件最“较真”的地方，也是它能上生产的前提：

• 持久活动锁：打开会话前写入锁，成功关闭且材料提交完成后才解锁。异常重启后不会盲目恢复一份可能重叠的快照
• 停服安全：
  • Paper：插件在合法线程主动接管矩阵、提交材料，再关闭原生菜单，不依赖已禁用的监听器接事件
  • Folia：区域调度停止顺序与 Paper 不同，插件改走“已缓存 PDC + 库存”路径，不重新查询区块/方块、不提交新的区域任务；先存快照，再镜像清零矩阵，回读确认清空后才解锁
• 失败即保守：数据损坏、异常退休、无法确认材料转移完成时，保留隔离锁并锁定该工作台，而不是自动“补发”一份可能重复的物品
• 展示与库存解耦：展示更新失败不会阻止库存提交，展示异常永远不影响玩家真实材料

---

已知限制​

请务必读完这一段再决定是否上主服：

• 不导入旧 Mod 数据：这是独立插件，不读取原 Mod 存档、不做 NBT 转换；只从装上它的那一刻开始记录
• 不提供：多人同时编辑同一张桌、桌面结果预览、动画、漏斗接入、比较器输出、自动合成、JEI 专用适配、逐客户端视觉配置
• 展示实体不持久化，按材料重建；客户端自定义模型（CIT）只做尺寸近似，不保证外观完全一致
• 不支持热重载 / PlugMan 类热卸载；Folia 非所属区域禁用时不强跨区域操作菜单，活动记录保持锁定
• 不提供断电、强杀、线程超时未完全停下、部分文件回滚情况下的跨玩家/区块事务保证
• 不承诺高版本世界/物品数据降级读取；升级请先备份并在测试服验证物品组件
• 世界编辑类、回滚类插件、直接换块不是完整支持的集成路径；插件每秒钟检查一次工作台方块，不能替代这类插件的事务集成
• Folia 停服分支依赖目标服务端的库存镜像行为，已覆盖成功/失败模拟测试，但仍建议在真实服上做一次停服验收

---

常见问题​

Q：客户端要装 Mod 吗？ 不用。纯服务端实现，原版客户端即可，也不需要资源包。
Q：为什么桌上没有合成结果？ 设计如此。结果的“预览”会诱导玩家以为可以直接取，容易和真实库存混淆，所以只展示材料。
Q：能改成潜行也打开吗？ 当前潜行 + 手持物品是刻意保留的原版交互（避免挡住放置方块），没有配置项。
Q：材料会不会被别的玩家拿走？ 不会。桌上的是不可拾取的展示实体，真实材料在区块 PDC 里，只能由打开会话的玩家通过原生界面操作。
Q：和工作台相关的红石机器会受影响吗？ 工作台本身没有漏斗/比较器交互，插件也未新增这些能力；带材料或活动会话的工作台会被活塞保护。
Q：能装 PlugMan 热重载吗？ 不能，明确不支持。

---