StorageWorkbench

插件

· 作者 asakura475

通过一个与原版兼容的存储合成菜单,从附近的箱子中进行合成(适用于 Paper 服务器)。

0 本站下载 0 关注 更新于 5 个月前

最新 1.0.1 · 26.1.2 · Paper

一键开服(送7天)

StorageWorkbench

将储物室变为工作台。

StorageWorkbench 是一个服务端 Paper 插件,允许玩家使用自己背包和附近箱子里的物品进行合成。

在储物室放置一个工作台,潜行右击它,即可通过兼容原版的工作台界面进行合成。材料会直接从附近的储物设备中消耗。玩家无需先将所有木板、锭、木棍、石头和宝石放入背包中。

本插件专为希望在不依赖客户端模组、资源包、自定义纹理或仅限 Java 端的 UI 技巧的情况下实现强大储物合成功能的服务器设计。

配套插件

StorageWorkbench 与以下插件配合效果更佳:

Plugin 功能说明
ExpandedChests 添加大型服务端储物容器。当两个插件同时安装时,StorageWorkbench 可以从其内容中进行合成。
OpenChestSorter 玩家打开箱子时自动整理普通箱子的物品。

它们共同将一面储物墙转变为实用的工坊:整理普通箱子,在扩展箱子中存储大量材料,并通过一个工作台对整个房间的物品进行合成。

体验对比

Before After
将材料从箱子移动到自己的背包中。 直接从附近的储物设备进行合成。
因背包被材料塞满而停止合成。 将材料保留在储物设备中,通过菜单进行合成。
手动搜索多个箱子。 使用配方分类、排序、分页和刷新功能。
基岩端玩家可能因客户端模组而被排除在外。 菜单使用正常的服务端库存界面和原版物品。
储物室仅用于存放物品。 储物室变成了真正的合成室。

工作原理

  1. 在工作台附近放置箱子。
  2. 潜行右击工作台。
  3. 从储物合成菜单中选择一个配方。
  4. StorageWorkbench 会从玩家背包和附近箱子中消耗材料。
  5. 合成产物尽可能放入玩家背包。

常规右击仍会打开原版正常的工作台界面。

玩家还可以看向工作台并运行:

/swb open

功能特性

Feature Details
储物合成菜单 从正常工作台打开的服务端库存 GUI。
附近箱子支持 使用玩家背包和附近原版箱子中的物品。
ExpandedChests 支持 当安装了该可选插件时,也会读取附近 ExpandedChests 的储物内容。
直接消耗箱子物品 箱子材料直接从储物设备中消耗,而非先移入玩家背包。
完整背包支持 即使玩家背包已满,合成仍然有效。
分类 All(全部)、Building(建筑)、Tools(工具)、Combat(战斗)、Redstone(红石)、Food(食物)、Transport(运输)、Ingredients(材料)、Misc(其他)。
排序 Name(名称)、Available(可用数量)、Output(产出量)、Category(分类)。
最大合成 Shift+左键点击可合成当前可用的最大数量。
手柄友好的最大模式 提供最大模式按钮,帮助基岩版/Xbox 玩家使用最大合成。
箱子高亮 包含的箱子在菜单打开时会显示轻量级的原版粒子高亮效果。
多人游戏感知会话 每位玩家拥有独立的合成会话。
纯服务端 无需客户端模组、资源包、自定义 UI 资产或自定义数据包。
独立优先设计 无需配套插件即可工作;集成选项是可选的。

兼容性

Target Support
Platform Paper
Minecraft versions 1.21.x and 26.1.x
Java for 1.21.x servers Java 21
Java for 26.1.x servers Java 25 or newer
Client-side install Not required
Resource pack Not required
Dependencies None
Optional integrations ExpandedChests, OpenChestSorter
Geyser/Floodgate Designed around vanilla server inventory screens for better cross-client behavior.

StorageWorkbench 是一个服务端 Paper 插件。它不是 Fabric、Forge 或 NeoForge 客户端模组。

箱子搜索范围

工作台周围的默认范围:

Direction Blocks
North 5
South 5
East 5
West 5
Up 5
Down 0

水平方向使用世界坐标轴,因为工作台方块没有朝向方向。结果矩形区域内的对角线箱子也被包含在内。

服务器管理员可以通过命令或在 plugins/StorageWorkbench/config.yml 中更改范围。

命令

玩家命令:

Command Permission Description
/swb open storageworkbench.use 看向工作台时打开储物合成菜单。

管理员命令:

Command Permission Description
/swb status storageworkbench.admin 显示插件状态和活跃会话。
/swb range show storageworkbench.admin 显示当前的箱子搜索范围。
/swb range default storageworkbench.admin 恢复默认范围。
/swb range horizontal <blocks> storageworkbench.admin 一次性设置所有四个水平方向。
/swb range set <north|south|east|west|up|down> <blocks> storageworkbench.admin 设置单个方向。
/swb reload storageworkbench.admin 重新加载插件配置。

Permissions

权限 默认值 用途
storageworkbench.use 所有人 允许使用 StorageWorkbench 合成。
storageworkbench.admin 操作员 允许在游戏中更改 StorageWorkbench 设置。

安装

  1. 停止 Paper 服务器。
  2. 备份服务器文件夹,特别是 world、world_nether、world_the_end、plugins 以及配置文件。
  3. 将 storage-workbench-1.0.1.jar 复制到服务器的 plugins 文件夹中。
  4. 启动服务器。
  5. 如有需要,调整 plugins/StorageWorkbench/config.yml。
默认配置
enabled: true

storage-range:
  north: 5
  south: 5
  east: 5
  west: 5
  up: 5
  down: 0

storage-menu-enabled: true
highlight-chests-enabled: true
highlight-batch-size: 12
highlight-ticks-between-batches: 2
highlight-refresh-ticks: 20
borrow-custom-chest-items: false
debug-logging: false

性能

StorageWorkbench 的设计旨在避免重复执行昂贵的世界扫描操作:

  • 储物箱发现仅在玩家的储物合成会话期间运行。
  • 插件仅扫描已加载区块的实体(Tile Entities),而不是搜索体积内的每个方块。
  • 配方可用性基于从当前物品栏内容构建的紧凑材料索引。
  • 储物箱粒子效果已进行批处理,且仅在打开储物合成菜单时激活。
  • 物品消耗检查会在取用物品前验证当前储物箱槽位的状态。
  • 不使用数据库、遥测数据、外部网络调用或世界数据迁移。

安全性

StorageWorkbench 不会生成区块、编辑方块、重写世界文件、迁移世界数据、使用数据库或发起外部网络调用。

在合成过程中,它确实会在玩家物品栏和储物箱物品栏之间移动物品,因此建议在价值较高的正式生存世界安装前先进行测试。

推荐部署步骤:

  1. 对服务器进行全面备份。
  2. 在复制的世界或独立的测试服务器上测试。
  3. 测试普通合成台的行为。
  4. 测试潜行+右键点击储物合成的行为。
  5. 测试完整物品栏的行为。
  6. 测试两名玩家从同一附近储物箱区域进行合成的情况。
  7. 只有在复制世界的测试看起来正确无误后,才将其安装到正式运行的服务器上。

配套插件兼容性

StorageWorkbench 设计为可与 OpenChestSorter 共存。

OpenChestSorter 响应正常的储物箱物品栏打开事件。StorageWorkbench 使用其专属的储物合成菜单,并直接读取附近储物箱的物品栏。这两个插件不共享 UI 状态,打开 StorageWorkbench 合成菜单不会通过 OpenChestSorter 打开储物箱物品栏。

StorageWorkbench 还与 ExpandedChests 集成。当安装了 ExpandedChests 时,附近的扩展储物箱内容会出现在储物合成菜单中,并可作为合成原料被消耗。如果未安装 ExpandedChests,StorageWorkbench 则仅作为普通的附近储物箱合成插件运行。

此集成是可选的且基于反射实现,因此这些插件可以一起安装,也可以单独安装。

已知限制

  • 服务器插件无法在不借助客户端模组或资源包的情况下,以兼容 Java/基岩版的方式向客户端原版配方书面板添加新标签页。
  • StorageWorkbench 改用带有原版物品按钮的服务端物品栏菜单来实现。
  • 遗留的原版配方书预览模式作为备用方案存在,但默认情况下处于禁用状态。
  • 某些特殊的自定义配方或经过重度定制的物品元数据可能无法像简单的原版形状合成和无形状合成那样表现正常。

许可证

StorageWorkbench 根据 MIT 许可证发布。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源