OpenChestSorter
打开一个普通的箱子。它会自动整理自身。
OpenChestSorter 是一款轻量、快速的 Paper 插件,会在玩家打开箱子的瞬间自动整理其中的物品。
无需潜行点击。无需命令。无需客户端模组。无需资源包。仅保留原版 Minecraft 箱子的体验,让存储更加整洁有序。
本插件专为希望获得“原生般”生活便利功能的服务器设计,包括使用 Geyser/Floodgate 的 Java 版与基岩版混合社区。
服务端存储套件
OpenChestSorter 与以下插件配合效果更佳:
它们共同让存储房间各司其职:
| 存储问题 |
负责解决的插件 |
| 普通箱子变得杂乱无章。 |
OpenChestSorter 在玩家打开时自动整理。 |
| 合成过程需要频繁调整背包。 |
StorageWorkbench 直接从附近存储区进行合成。 |
| 大量材料需要超过双箱的空间。 |
ExpandedChests 提供大型分页存储,并自带排序按钮。 |
这些插件可以一起安装,也可以单独使用。无需客户端模组或资源包。
使用体验
| 之前 |
之后 |
| 玩家需要记住特殊的潜行点击操作。 |
玩家只需直接打开箱子。 |
| 物品散落在随机的格子中。 |
相似物品合并并按整洁的顺序排列。 |
| 基岩版玩家可能被依赖客户端模组的插件排除在外。 |
排序在 Paper 服务端运行,行为符合原版库存逻辑。 |
| 缺乏视觉反馈。 |
箱子上方会出现一次以玩家颜色着色的粒子特效。 |
| 其他玩家意外重新排列已打开的箱子。 |
默认情况下,如果已有其他玩家正在查看该箱子,则跳过排序。 |
功能特性
| 功能 |
详情 |
| 自动箱子整理 |
在打开时自动整理普通的单箱和双箱。 |
| 无需特殊交互 |
玩家无需蹲下、点击按钮或运行命令。 |
| 安全的堆叠合并 |
使用 Bukkit ItemStack#isSimilar,因此改名、受损、附魔及自定义物品不会与非同类堆叠合并。 |
| 实用的默认排序 |
先按常见物品类别分组,再按材质 ID 排序。 |
| 可选的名称排序 |
若更符合服务器需求,可在配置文件中切换为 name(名称)排序模式。 |
| 多玩家感知行为 |
多名玩家可以同时打开同一个箱子。当有其他玩家正在查看时,默认跳过排序。 |
| 玩家着色粒子 |
箱子上方出现一次轻量级的原版 DUST 粒子效果,每位玩家的粒子颜色稳定一致。 |
| 管理员测试命令 |
操作员可使用 /ocs sort 对自己注视的箱子进行排序,便于测试。 |
| 兼容 ExpandedChests |
有意将 ExpandedChests 的存储交给其自带的排序按钮处理,不受本插件干扰。 |
| 独立优先设计 |
可独立工作;配套插件为可选安装。 |
| 仅服务端 |
无需客户端模组、资源包、自定义 UI 或自定义数据包。 |
兼容性
| 目标 |
支持情况 |
| 平台 |
Paper |
| Minecraft 版本 |
1.21.x 和 26.1.x |
| 1.21.x 服务器的 Java 版本 |
Java 21 |
| 26.1.x 服务器的 Java 版本 |
Java 25 或更高版本 |
| 客户端安装 |
不需要 |
| 资源包 |
不需要 |
| 依赖项 |
无 |
| 可选配套插件 |
StorageWorkbench, ExpandedChests |
| Geyser/Floodgate |
围绕服务端库存变更和原版粒子效果设计。 |
OpenChestSorter 是一个服务端 Paper 插件。它不是 Fabric、Forge 或 NeoForge 的客户端模组。
OpenChestSorter 仅整理普通的单箱和双箱。如果您也使用了 ExpandedChests,那些大型分页存储将保留其自带的内置排序控制,而不会被本插件重新排列。这种分离是有意为之:普通箱子保持自动整理,扩展存储保持分页感知。
命令
正常整理无需玩家执行任何命令。
管理命令:
| 命令 |
权限 |
描述 |
/ocs status |
openchestsorter.admin |
显示插件状态和当前激活的设置。 |
/ocs reload |
openchestsorter.admin |
重新加载插件配置文件。 |
/ocs sort |
openchestsorter.admin |
整理玩家当前注视的箱子。适用于测试。 |
权限
| 权限 |
默认分配 |
用途 |
openchestsorter.use |
所有人 |
允许在打开箱子时自动整理。 |
openchestsorter.admin |
操作员 |
允许使用管理命令。 |
安装
- 停止 Paper 服务器。
- 备份服务器文件夹,特别是
world、world_nether、world_the_end、plugins 以及配置文件。
- 测试期间禁用其他箱子整理插件,例如 SimpleAutoSort。
- 将
open-chest-sorter-1.0.2.jar 复制到服务器的 plugins 文件夹中。
- 启动服务器。
- 如有需要,调整
plugins/OpenChestSorter/config.yml。
默认配置
enabled: true
sort-on-open: true
skip-when-other-viewers: true
notify-player: true
sort-effect:
enabled: true
particles: 14
spread: 0.35
sort-mode: category_then_name
merge-similar-stacks: true
debug-logging: false
性能
OpenChestSorter 有意保持简洁:
- 不进行后台世界扫描。
- 不执行定时库存遍历。
- 不使用数据库。
- 不进行网络调用。
- 不收集遥测数据。
- 仅在打开受支持的箱子时运行整理功能。
- 默认效果为每次打开时产生一小簇粒子特效。
普通箱子有 27 个槽位,双层箱子有 54 个槽位,因此整理工作量保持在较小且可预测的范围内。
安全性
OpenChestSorter 不会生成区块、编辑方块、重写世界文件、迁移世界数据、使用数据库或进行外部网络调用。
它会移动箱子库存内的物品,因此建议在安装到珍贵的在线世界之前先进行测试。
推荐的部署步骤:
- 制作完整的服务器备份。
- 在复制的世界或独立的测试服务器上测试。
- 测试期间禁用其他箱子整理插件。
- 测试普通单格箱子。
- 测试双层箱子。
- 测试命名、附魔、受损及自定义物品。
- 测试两名玩家同时打开同一箱子的情况。
- 只有在复制世界的测试结果无误后,才将其安装到在线服务器。
配套插件兼容性
OpenChestSorter 旨在与 StorageWorkbench 共存。
OpenChestSorter 响应正常的箱子库存打开事件。StorageWorkbench 使用其专属的存储合成菜单,并直接读取附近箱子的库存内容。这两个插件不共享 UI 状态,打开 StorageWorkbench 的合成菜单不会通过 OpenChestSorter 触发箱子库存的打开。
OpenChestSorter 也设计为可与 ExpandedChests 共存。它故意忽略扩展存储方块,因为 ExpandedChests 拥有自己的分页 GUI 和全容量排序控制功能。
已知限制
- 仅对普通的单格和双层箱子进行整理。
- 故意忽略其他容器和自定义插件 GUI。
- 为避免重新排列其他玩家正在查看的界面,默认情况下会跳过当另一名玩家已查看同一箱子时的整理操作。
许可证
OpenChestSorter 依据 MIT 许可证发布。
OpenChestSorter
Open an ordinary chest. It organizes itself.
OpenChestSorter is a small, fast Paper plugin that sorts ordinary chest contents the moment a player opens the chest.
No sneak-click. No command. No client mod. No resource pack. Just cleaner storage with the normal Minecraft chest experience.
It is built for servers that want quality-of-life features to feel like they belong in vanilla Minecraft, including mixed Java and Bedrock communities using Geyser/Floodgate.
Server-Side Storage Suite
OpenChestSorter works especially well with:
| Plugin |
What it adds |
| StorageWorkbench |
Craft from nearby chests through a vanilla-compatible storage crafting menu. |
| ExpandedChests |
Large paged storage blocks with their own built-in sorting controls. |
Together, they give storage rooms a clear job:
| Storage problem |
Plugin that handles it |
| Ordinary chests get messy. |
OpenChestSorter sorts them the moment players open them. |
| Crafting needs too much inventory juggling. |
StorageWorkbench crafts from nearby storage. |
| Bulk materials need more space than double chests. |
ExpandedChests adds large paged storage with its own sort buttons. |
The plugins can be installed together or separately. No client mod or resource pack is required.
The Experience
| Before |
After |
| Players need to remember a special sneak-click action. |
Players simply open the chest. |
| Materials are scattered across random slots. |
Similar items merge and sort into a clean order. |
| Bedrock players can be left out by client-side mods. |
Sorting runs on the Paper server with vanilla inventory behavior. |
| Visual feedback is missing. |
A small player-colored particle burst appears above the chest. |
| Another player's open chest can be rearranged unexpectedly. |
Sorting is skipped by default if someone else is already viewing that chest. |
Features
| Feature |
Details |
| Automatic chest sorting |
Sorts ordinary single and double chests when opened. |
| No special interaction |
Players do not need to crouch, click a button, or run a command. |
| Safe stack merging |
Uses Bukkit ItemStack#isSimilar, so renamed, damaged, enchanted, and custom items do not merge with unlike stacks. |
| Practical default order |
Groups common item categories, then sorts by material id. |
| Optional name sorting |
Switch to name sorting in the config if that fits your server better. |
| Multiplayer-aware behavior |
Multiple players can open the same chest. Sorting is skipped by default when another player is already viewing it. |
| Player-colored particles |
A lightweight vanilla DUST effect appears once above the chest, with a stable color per player. |
| Admin testing command |
Operators can sort the chest they are looking at with /ocs sort. |
| ExpandedChests-safe |
ExpandedChests storage is intentionally left to ExpandedChests' own sorting buttons. |
| Standalone-first design |
Works by itself; companion plugins are optional. |
| Server-side only |
No client mod, no resource pack, no custom UI, no custom packets. |
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 companions |
StorageWorkbench, ExpandedChests |
| Geyser/Floodgate |
Designed around server-side inventory changes and vanilla particles. |
OpenChestSorter is a server-side Paper plugin. It is not a Fabric, Forge, or NeoForge client mod.
OpenChestSorter sorts ordinary single and double chests only. If you also use ExpandedChests, those large paged storages keep their own built-in sort controls instead of being rearranged by this plugin. This separation is intentional: ordinary chests stay automatic, expanded storage stays page-aware.
Commands
Players do not need commands for normal sorting.
Admin commands:
| Command |
Permission |
Description |
/ocs status |
openchestsorter.admin |
Shows plugin status and active settings. |
/ocs reload |
openchestsorter.admin |
Reloads the plugin config. |
/ocs sort |
openchestsorter.admin |
Sorts the chest the player is looking at. Useful for testing. |
Permissions
| Permission |
Default |
Purpose |
openchestsorter.use |
Everyone |
Allows automatic sorting when opening chests. |
openchestsorter.admin |
Operators |
Allows admin commands. |
Installation
- Stop the Paper server.
- Back up the server folder, especially
world, world_nether, world_the_end, plugins, and config files.
- Disable other chest-sorting plugins while testing, such as SimpleAutoSort.
- Copy
open-chest-sorter-1.0.2.jar into the server plugins folder.
- Start the server.
- Adjust
plugins/OpenChestSorter/config.yml if needed.
Default configuration
enabled: true
sort-on-open: true
skip-when-other-viewers: true
notify-player: true
sort-effect:
enabled: true
particles: 14
spread: 0.35
sort-mode: category_then_name
merge-similar-stacks: true
debug-logging: false
Performance
OpenChestSorter is intentionally simple:
- No background world scanning.
- No scheduled inventory sweeps.
- No database.
- No network calls.
- No telemetry.
- Sorting only runs when a supported chest is opened.
- The default effect is one small particle burst per open.
An ordinary chest has 27 slots and a double chest has 54 slots, so sorting work stays small and predictable.
Safety
OpenChestSorter does not generate chunks, edit blocks, rewrite world files, migrate world data, use a database, or make external network calls.
It does move items inside chest inventories, 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.
- Disable other chest-sorting plugins while testing.
- Test single chests.
- Test double chests.
- Test named, enchanted, damaged, and custom items.
- Test two players opening the same chest.
- Install on the live server only after the copied-world test looks correct.
Companion Plugin Compatibility
OpenChestSorter is designed to coexist with StorageWorkbench.
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.
OpenChestSorter is also designed to sit beside ExpandedChests. It intentionally ignores expanded storage blocks because ExpandedChests owns its own paged GUI and full-storage sorting controls.
Known Limitations
- Only ordinary single and double chests are sorted.
- Other containers and custom plugin GUIs are intentionally ignored.
- Sorting while another player already views the same chest is skipped by default to avoid rearranging their open screen.
License
OpenChestSorter is released under the MIT License.
评论 0
登录后参与评分
还没有评论,来抢沙发吧