OpenChestSorter

插件

· 作者 asakura475

在 Paper 服务器上,当玩家打开箱子时自动整理箱内物品。

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

最新 1.0.2 · 26.1.2 · Paper

一键开服(送7天)

OpenChestSorter

打开一个普通的箱子。它会自动整理自身。

OpenChestSorter 是一款轻量、快速的 Paper 插件,会在玩家打开箱子的瞬间自动整理其中的物品。

无需潜行点击。无需命令。无需客户端模组。无需资源包。仅保留原版 Minecraft 箱子的体验,让存储更加整洁有序。

本插件专为希望获得“原生般”生活便利功能的服务器设计,包括使用 Geyser/Floodgate 的 Java 版与基岩版混合社区。

服务端存储套件

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

插件 新增功能
StorageWorkbench 通过兼容原版的存储合成菜单,直接从附近的箱子中合成物品。
ExpandedChests 大型分页存储方块,自带内置排序控制功能。

它们共同让存储房间各司其职:

存储问题 负责解决的插件
普通箱子变得杂乱无章。 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 操作员 允许使用管理命令。

安装

  1. 停止 Paper 服务器。
  2. 备份服务器文件夹,特别是 world、world_nether、world_the_end、plugins 以及配置文件。
  3. 测试期间禁用其他箱子整理插件,例如 SimpleAutoSort。
  4. 将 open-chest-sorter-1.0.2.jar 复制到服务器的 plugins 文件夹中。
  5. 启动服务器。
  6. 如有需要,调整 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 不会生成区块、编辑方块、重写世界文件、迁移世界数据、使用数据库或进行外部网络调用。

它会移动箱子库存内的物品,因此建议在安装到珍贵的在线世界之前先进行测试。

推荐的部署步骤:

  1. 制作完整的服务器备份。
  2. 在复制的世界或独立的测试服务器上测试。
  3. 测试期间禁用其他箱子整理插件。
  4. 测试普通单格箱子。
  5. 测试双层箱子。
  6. 测试命名、附魔、受损及自定义物品。
  7. 测试两名玩家同时打开同一箱子的情况。
  8. 只有在复制世界的测试结果无误后,才将其安装到在线服务器。

配套插件兼容性

OpenChestSorter 旨在与 StorageWorkbench 共存。

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

OpenChestSorter 也设计为可与 ExpandedChests 共存。它故意忽略扩展存储方块,因为 ExpandedChests 拥有自己的分页 GUI 和全容量排序控制功能。

已知限制

  • 仅对普通的单格和双层箱子进行整理。
  • 故意忽略其他容器和自定义插件 GUI。
  • 为避免重新排列其他玩家正在查看的界面,默认情况下会跳过当另一名玩家已查看同一箱子时的整理操作。

许可证

OpenChestSorter 依据 MIT 许可证发布。

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源