StorageWorkbench
将储物室变为工作台。
StorageWorkbench 是一个服务端 Paper 插件,允许玩家使用自己背包和附近箱子里的物品进行合成。
在储物室放置一个工作台,潜行右击它,即可通过兼容原版的工作台界面进行合成。材料会直接从附近的储物设备中消耗。玩家无需先将所有木板、锭、木棍、石头和宝石放入背包中。
本插件专为希望在不依赖客户端模组、资源包、自定义纹理或仅限 Java 端的 UI 技巧的情况下实现强大储物合成功能的服务器设计。
配套插件
StorageWorkbench 与以下插件配合效果更佳:
它们共同将一面储物墙转变为实用的工坊:整理普通箱子,在扩展箱子中存储大量材料,并通过一个工作台对整个房间的物品进行合成。
体验对比
| Before |
After |
| 将材料从箱子移动到自己的背包中。 |
直接从附近的储物设备进行合成。 |
| 因背包被材料塞满而停止合成。 |
将材料保留在储物设备中,通过菜单进行合成。 |
| 手动搜索多个箱子。 |
使用配方分类、排序、分页和刷新功能。 |
| 基岩端玩家可能因客户端模组而被排除在外。 |
菜单使用正常的服务端库存界面和原版物品。 |
| 储物室仅用于存放物品。 |
储物室变成了真正的合成室。 |
工作原理
- 在工作台附近放置箱子。
- 潜行右击工作台。
- 从储物合成菜单中选择一个配方。
- StorageWorkbench 会从玩家背包和附近箱子中消耗材料。
- 合成产物尽可能放入玩家背包。
常规右击仍会打开原版正常的工作台界面。
玩家还可以看向工作台并运行:
/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 设置。 |
安装
- 停止 Paper 服务器。
- 备份服务器文件夹,特别是
world、world_nether、world_the_end、plugins 以及配置文件。
- 将
storage-workbench-1.0.1.jar 复制到服务器的 plugins 文件夹中。
- 启动服务器。
- 如有需要,调整
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 不会生成区块、编辑方块、重写世界文件、迁移世界数据、使用数据库或发起外部网络调用。
在合成过程中,它确实会在玩家物品栏和储物箱物品栏之间移动物品,因此建议在价值较高的正式生存世界安装前先进行测试。
推荐部署步骤:
- 对服务器进行全面备份。
- 在复制的世界或独立的测试服务器上测试。
- 测试普通合成台的行为。
- 测试潜行+右键点击储物合成的行为。
- 测试完整物品栏的行为。
- 测试两名玩家从同一附近储物箱区域进行合成的情况。
- 只有在复制世界的测试看起来正确无误后,才将其安装到正式运行的服务器上。
配套插件兼容性
StorageWorkbench 设计为可与 OpenChestSorter 共存。
OpenChestSorter 响应正常的储物箱物品栏打开事件。StorageWorkbench 使用其专属的储物合成菜单,并直接读取附近储物箱的物品栏。这两个插件不共享 UI 状态,打开 StorageWorkbench 合成菜单不会通过 OpenChestSorter 打开储物箱物品栏。
StorageWorkbench 还与 ExpandedChests 集成。当安装了 ExpandedChests 时,附近的扩展储物箱内容会出现在储物合成菜单中,并可作为合成原料被消耗。如果未安装 ExpandedChests,StorageWorkbench 则仅作为普通的附近储物箱合成插件运行。
此集成是可选的且基于反射实现,因此这些插件可以一起安装,也可以单独安装。
已知限制
- 服务器插件无法在不借助客户端模组或资源包的情况下,以兼容 Java/基岩版的方式向客户端原版配方书面板添加新标签页。
- StorageWorkbench 改用带有原版物品按钮的服务端物品栏菜单来实现。
- 遗留的原版配方书预览模式作为备用方案存在,但默认情况下处于禁用状态。
- 某些特殊的自定义配方或经过重度定制的物品元数据可能无法像简单的原版形状合成和无形状合成那样表现正常。
许可证
StorageWorkbench 根据 MIT 许可证发布。
StorageWorkbench
Turn a storage room into a crafting station.
StorageWorkbench is a server-side Paper plugin that lets players craft using items from their own inventory and nearby chests.
Place a crafting table in your storage room, sneak-right-click it, and craft from a vanilla-compatible storage crafting menu. Ingredients are consumed directly from nearby storage. Players do not need to carry every plank, ingot, stick, stone, and gem in their inventory first.
It is built for servers that want powerful storage crafting without client mods, resource packs, custom textures, or Java-only UI tricks.
Companion Plugins
StorageWorkbench works especially well with:
| Plugin |
What it adds |
| ExpandedChests |
Adds huge server-side storage containers. StorageWorkbench can craft from their contents when both plugins are installed. |
| OpenChestSorter |
Automatically sorts ordinary chest contents when players open chests. |
Together, they turn a storage wall into a practical workshop: sort ordinary chests, store bulk materials in expanded chests, and craft from the whole room through one crafting table.
The Experience
| Before |
After |
| Move ingredients from chests into your inventory. |
Craft directly from nearby storage. |
| Stop crafting because your inventory is full of materials. |
Keep ingredients in storage and craft from the menu. |
| Search through multiple chests manually. |
Use recipe categories, sorting, pagination, and refresh. |
| Bedrock players can be excluded by client-side mods. |
The menu uses normal server inventory screens and vanilla items. |
| Storage rooms only store items. |
Storage rooms become real crafting rooms. |
How It Works
- Place a crafting table near your chests.
- Sneak-right-click the crafting table.
- Pick a recipe from the Storage Crafting menu.
- StorageWorkbench consumes ingredients from the player inventory and nearby chests.
- Crafted output goes to the player inventory when possible.
Regular right-click still opens the normal vanilla crafting table.
Players can also look at a crafting table and run:
/swb open
Features
| Feature |
Details |
| Storage crafting menu |
Server-side inventory GUI opened from normal crafting tables. |
| Nearby chest support |
Uses items from the player inventory and nearby vanilla chests. |
| ExpandedChests support |
Also reads nearby ExpandedChests storage when that optional plugin is installed. |
| Direct chest consumption |
Chest ingredients are consumed directly from storage, not moved into the player inventory first. |
| Full inventory support |
Crafting still works when the player inventory is full. |
| Categories |
All, Building, Tools, Combat, Redstone, Food, Transport, Ingredients, Misc. |
| Sorting |
Name, Available, Output, Category. |
| Max crafting |
Shift-left-click crafts the maximum available amount. |
| Controller-friendly max mode |
A max-mode button helps Bedrock/Xbox players use maximum crafting. |
| Chest highlights |
Included chests get lightweight vanilla particle highlights while the menu is open. |
| Multiplayer-aware sessions |
Each player has an independent crafting session. |
| Server-side only |
No client mod, no resource pack, no custom UI assets, no custom packets. |
| Standalone-first design |
Works without companion plugins; integrations are optional. |
Compatibility
| 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 is a server-side Paper plugin. It is not a Fabric, Forge, or NeoForge client mod.
Chest Search Range
Default range around the crafting table:
| Direction |
Blocks |
| North |
5 |
| South |
5 |
| East |
5 |
| West |
5 |
| Up |
5 |
| Down |
0 |
Horizontal directions use world axes because crafting table blocks do not have a facing direction. Diagonal chests inside the resulting rectangular area are included.
Server operators can change the range through commands or in plugins/StorageWorkbench/config.yml.
Commands
Player command:
| Command |
Permission |
Description |
/swb open |
storageworkbench.use |
Opens the storage crafting menu while looking at a crafting table. |
Admin commands:
| Command |
Permission |
Description |
/swb status |
storageworkbench.admin |
Shows plugin status and active sessions. |
/swb range show |
storageworkbench.admin |
Shows the current chest search range. |
/swb range default |
storageworkbench.admin |
Restores the default range. |
/swb range horizontal <blocks> |
storageworkbench.admin |
Sets all four horizontal directions at once. |
/swb range set <north|south|east|west|up|down> <blocks> |
storageworkbench.admin |
Sets one direction. |
/swb reload |
storageworkbench.admin |
Reloads the plugin config. |
Permissions
| Permission |
Default |
Purpose |
storageworkbench.use |
Everyone |
Allows using StorageWorkbench crafting. |
storageworkbench.admin |
Operators |
Allows changing StorageWorkbench settings in game. |
Installation
- Stop the Paper server.
- Back up the server folder, especially
world, world_nether, world_the_end, plugins, and config files.
- Copy
storage-workbench-1.0.1.jar into the server plugins folder.
- Start the server.
- Adjust
plugins/StorageWorkbench/config.yml if needed.
Default configuration
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
Performance
StorageWorkbench is built to avoid repeated expensive world scans:
- Chest discovery runs per player storage crafting session.
- The plugin scans loaded chunk tile entities instead of every block in the search volume.
- Recipe availability is based on a compact material index built from current inventory contents.
- Chest particles are batched and only active while the storage crafting menu is open.
- Item consumption checks the current chest slot state before taking items.
- No database, telemetry, external network calls, or world data migrations.
Safety
StorageWorkbench does not generate chunks, edit blocks, rewrite world files, migrate world data, use a database, or make external network calls.
It does move items between player inventories and chest inventories during crafting, so test it before installing on a valuable live world.
Recommended rollout:
- Make a full server backup.
- Test on a copied world or separate test server.
- Test normal crafting table behavior.
- Test sneak-right-click storage crafting.
- Test full inventory behavior.
- Test two players crafting from the same nearby chest area.
- Install on the live server only after the copied-world test looks correct.
Companion Plugin Compatibility
StorageWorkbench is designed to coexist with OpenChestSorter.
OpenChestSorter reacts to normal chest inventory opens. StorageWorkbench uses its own storage crafting menu and reads nearby chest inventories directly. The plugins do not share UI state, and opening the StorageWorkbench crafting menu does not open chest inventories through OpenChestSorter.
StorageWorkbench also integrates with ExpandedChests. When ExpandedChests is installed, nearby expanded chest contents can appear in the storage crafting menu and can be consumed as crafting ingredients. If ExpandedChests is not installed, StorageWorkbench simply works as a normal nearby-chest crafting plugin.
This integration is optional and reflection-based, so the plugins can be installed together or separately.
Known Limitations
- A server plugin cannot add new tabs to the client-side vanilla recipe-book panel in a Java/Bedrock-compatible way without a client mod or resource pack.
- StorageWorkbench uses a server-side inventory menu with vanilla item buttons instead.
- The legacy vanilla recipe-book preview mode exists as a fallback but is disabled by default.
- Some unusual custom recipes or heavily customized item metadata may not behave like simple vanilla shaped and shapeless recipes.
License
StorageWorkbench is released under the MIT License.
评论 0
登录后参与评分
还没有评论,来抢沙发吧