ClickSorted
用鼠标点击即可整理任何物品栏——并打包你的束口袋。
ClickSorted 允许玩家通过一次鼠标操作来整理玩家物品栏、箱子、末影箱、潜影盒、桶、漏斗等容器。你可以锁定单个格子,使其在整理时不受影响;在整理过程中可选择将散落的物品打包进束口袋;并通过针对每个玩家的黑名单精确控制哪些类型的物品会进入束口袋。偏好设置按玩家保存,并在不同游戏会话间保持持久化。
- 三种排序顺序:名称、分组或树状图(每种物品类型呈现接近正方形的区块)
- 可配置的填充方向:选择起始角落以及优先填充行还是列
- 锁定单个格子,使整理操作避开它们
- 可选的束口袋打包功能,支持针对每个玩家的物品类型或显示名称黑名单
- 服务器管理员可以强制实施全局物品黑名单,并锁定特定玩家的物品栏格子
- 按玩家的本地化支持与自动更新的默认消息——管理员自定义仅为稀疏覆盖,不会遮蔽未来默认文本的改进
快速开始
开箱即用:打开任意物品栏,将鼠标悬停在任意空槽位上并按 F 键(交换副手物品),即可整理该物品栏。无需配置。
通过命令进行个性化调整:
/clicksorted click method <…>—— 选择触发整理的鼠标手势。/clicksorted sort method <…>—— 选择排序方式。/clicksorted sort start-corner <…>/sort fill-axis <…>—— 选择物品从哪个角落开始填充以及填充方向。/clicksorted sort enabled—— 启用或禁用点击时的整理功能。/clicksorted lock-slots—— 打开图形界面以锁定不应被整理的格子。/clicksorted bundle enabled—— 启用或禁用点击时将堆叠物品打包进束口袋。/clicksorted bundle blacklist—— 打开图形界面以排除特定的物品类型或显示名称不被打包进束口袋。/clicksorted status—— 查看当前设置。/clicksorted menu—— 打开一个单一对话框,一次性列出所有排序偏好设置,并提供按钮以启动格子锁定和束口袋黑名单图形界面。需要 Paper 的 Dialog API(1.21.6+),在旧版服务器或 Bedrock/Geyser 客户端上不可用——请使用上述命令代替。
管理员可完全自定义物品组、消息以及可整理的物品栏类型。管理员还可以声明全服物品黑名单(永不参与整理或打包的物品),并锁定所有玩家的特定物品栏格子。
消息存储在 plugins/ClickSorted/lang/ 下的稀疏本地化覆盖文件中(例如 en_us.yml);未覆盖的部分仍会解析为插件内置的默认值,因此新版本中改进的措辞会自动应用到你的游戏中。现有的 lang.yml 文件会在首次加载时自动迁移到此格式。参见 docs/admin/lang.md。
要求
- Paper 或 Folia 1.20.6+(
/clicksorted menu对话框 UI 额外需要 1.21.6+) - 无依赖项
文档
完整的管理员与玩家文档位于 kccricket.github.io/ClickSorted。
ClickSorted 是基于原始 ClickSort(由 Des Herriott (desht) 制作)的现代版 Paper-API 分支。遵循 GPL v3 许可证。
ClickSorted
Sort any inventory — and pack your bundles — with a mouse click.
ClickSorted lets players sort their player inventory, chests, ender chests, shulker boxes, barrels, hoppers, and more with a single mouse gesture. You can lock individual slots so they're left untouched, optionally pack loose items into bundles as you sort, and control exactly which item types land in your bundles with a per-player blacklist. Preferences are saved per-player and persist across sessions.
- Three sort orders — name, group, or treemap (near-square blocks per item type)
- Configurable fill direction — choose the starting corner and whether rows or columns fill first
- Lock individual slots so sorting leaves them alone
- Optional bundle packing, with a per-player blacklist for item types or display names
- Server admins can enforce a global item blacklist and lock specific player slots
- Per-player localisation with self-updating default messages — admin customizations are sparse overrides that never shadow a future default-text improvement
Quick start
Out of the box: open any inventory and press F (swap-offhand) over any empty slot to sort the inventory. No configuration required.
Tune it to taste with commands:
/clicksorted click method <…>— choose your sort trigger./clicksorted sort method <…>— choose the sort order./clicksorted sort start-corner <…>/sort fill-axis <…>— choose which corner items fill from and which way./clicksorted sort enabled— enable or disable sorting on click./clicksorted lock-slots— open a GUI to lock slots that should never be sorted./clicksorted bundle enabled— enabled or disable packing stacks into your bundles on click./clicksorted bundle blacklist— open a GUI to exclude specific item types or display names from bundle packing./clicksorted status— see your current settings./clicksorted menu— open a single dialog listing every sorting preference at once, with buttons to launch the slot-lock and bundle-blacklist GUIs. Requires Paper's Dialog API (1.21.6+) and is unavailable on older servers or Bedrock/Geyser clients — use the commands above instead.
Fully customisable item groups, messages, and sortable inventory types are available for admins. Admins can also declare a server-wide item blacklist (items that are never sorted or packed) and lock specific player inventory slots across all players.
Messages are stored as sparse per-locale override files under plugins/ClickSorted/lang/ (e.g. en_us.yml); anything you don't override keeps resolving to the plugin's built-in default, so a new release's improved wording reaches you automatically. Existing lang.yml files are migrated to this format automatically on first load. See docs/admin/lang.md.
Requirements
- Paper or Folia 1.20.6+ (the
/clicksorted menudialog UI additionally requires 1.21.6+) - No dependencies
Documentation
Full admin and player documentation is at kccricket.github.io/ClickSorted.
ClickSorted is a modernised Paper-API fork of the original ClickSort by Des Herriott (desht). GPL v3.
下载 ClickSorted
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 ClickSorted
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 ClickSorted
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 ClickSorted
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 ClickSorted
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 ClickSorted
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 ClickSorted
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 ClickSorted
下载 ClickSorted
ClickSorted 2.3.0 添加了游戏内自检和兼容性诊断工具,将最低支持的服务器版本回退至 Paper 1.20.6,并将插件的内部实用代码提取到共享库中。
亮点
- 新增
/clicksorted admin selftest—— 一项用于验证正确性和版本兼容性的游戏内自检功能,供管理员在信任更新并部署到正式服务器之前,针对其具体的 Paper 构建版本进行验证。 - 兼容性扩展 —— 最低支持的服务器版本已回退至 Paper/Folia 1.20.6(此前 2.2.0 版本引入的最低要求为 1.21.6)。在低于 1.21.6 的服务器上,
/clicksorted menu对话框会自动禁用自身(因缺少 Dialog API);其他所有功能均可向下兼容至 1.20.6。 - 内部与插件无关的实用代码(配置/迁移引擎、日志记录、本地化、速率限制、权限辅助、更新检查、Adventure Component 辅助)已被提取到一个新的共享库 KcMcLib 中,作为 git 子模块被调用。对玩家或管理员而言,行为无变化。
破坏性变更
/clicksorted admin benchmark现在还需要在config.yml中设置enable_benchmark: true(新增键,默认值为false),这与现有的enable_selftest风格的门禁机制一致——此前仅拥有clicksorted.admin.commands.benchmark权限即可。使用基准测试命令的管理员需要添加此键。- 内部 Java API 重组,仅限第三方插件开发者注意。 多个非事件内部类(迁移引擎、配置生命周期、日志记录、
MessageSource/Localized消息外观、速率限制、权限辅助、Modrinth 更新检查器以及 Adventure Component 辅助)已从net.kccricket.clicksorted.*移至新的net.kccricket.kcmclib.*命名空间,且MessageSource/Localized的getColoredMessage/getMessage方法已重命名为render/raw。公共事件 API——InventorySortEvent、PlayerPreferenceChangeEvent、Preference以及PlayerSortingPrefs的设置器——保持不变;只有直接导入已移动内部类的代码才需要更新。
新功能
游戏内自检与兼容性诊断
/clicksorted admin selftest(权限 clicksorted.admin.commands.selftest,默认为 op;同时也需要新的 enable_selftest 配置键,默认值为 false,因为运行时会暂存并恢复测试者的真实物品栏和偏好设置)会在实际安装该插件的服务器上运行插件的算法和集成检查:
selftest algo—— 纯算法检查,不涉及任何 Paper API 表面。selftest probe—— 仅运行能力探测套件,生成运行服务器的快速兼容性指纹。selftest sim—— 通过真实监听器分发的合成事件。selftest start [quick|full]—— 交互式实时会话,引导测试者执行真实的点击手势(quick)或完整的区域/锁定/黑名单/捆绑场景(full),随后从防崩溃备份中恢复其物品栏和偏好设置;selftest next/status/stop控制进行中的会话。
故障被归类为 SANITY/INTEGRATION/ENDTOEND 类别,以防止微弱的算法异常伪装成真正的版本兼容性断裂——只有 ENDTOEND 故障(真实客户端手势)才具备完整的兼容性信号。旨在供管理员/测试者检查插件更新时使用,而非常规游玩。
错误修复
- 自检实时会话恢复时,如果单个恢复步骤失败,可能会丢失防崩溃备份——这正是本子系统旨在捕获的版本不兼容性故障类型——导致测试者的真实物品栏和偏好设置陷入困境且无法恢复。现在每个恢复步骤独立运行,仅在每一步都实际运行完毕后才会清除备份。
- 当单个保存操作同时更改了点击方法和允许悬停偏好时,
/clicksorted menu的点击方法状态行可能会显示过时的“悬停”提示文本。 - 修复了一个权限泄漏问题:
/clicksorted admin命令节点在 tab-completion 中对所有玩家可见,尽管其中没有任何子命令在没有各自权限的情况下真正可用。 /clicksorted bundle blacklist add|remove material的 tab-completion 现在建议名称空间化的材质 ID(例如minecraft:dirt),以匹配命令实际接受的内容,而非之前漂移的、未名称空间化的本地实现。- 包含另一个捆绑包的捆绑包被视为完全装满,因此 ClickSorted 永远不会向其打包任何东西——嵌套捆绑包被收取了整个捆绑包的容量,而不是原版的一分之十六加上其持有的内容。捆绑包重量现在与原版完全匹配,包括蜂巢/蜜蜂巢穴持有蜜蜂的情况(整个捆绑包,此前计数不足——这种计数不足可能导致捆绑包超出其真实容量并在重新加载时被拒绝)以及具有自定义堆叠大小的物品。
- TREEMAP 排序在每个 pre-1.21.2 的服务器上崩溃——对较新的
hasCustomModelDataComponent()API 的调用缺乏对该插件自身声明的 1.20.6 底线的回退机制。它在较新 API 不存在的服务器上回退到较旧的hasCustomModelData()检查。
其他改进
- 触发说明(聊天消息和自检提示)现在反映玩家实际的允许悬停设置,而不是始终描述普通的非悬停手势。
config.yml现在在重新加载/加载时,对其无法识别的任何键发出警告(来自旧配置版本的残留项或拼写错误),而不是静默忽略。- 新增仅供维护者使用的
./gradlew generateItemNames工具,根据当前 Paper API 重新生成物品显示名称/排序键表;不打包进插件 jar 中。
兼容性
✔️ Paper/Folia 1.20.6 – 26.2.x ✔️ Java 21+
升级指南
- 停止你的服务器。
- 用此发布版替换
plugins/中的旧 jar 文件。 - 如果你使用
/clicksorted admin benchmark,请在config.yml中添加enable_benchmark: true。 - 启动你的服务器。
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
插件
PacketEvents 是一款专为 Minecraft Java 版打造的协议库,旨在简化数据包的处理与传输。
插件
ExyliaPlugins 的库。
插件
通过对话框或铁砧界面帮助你的 Anthme
插件
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
插件
为基于 Spigot/Paper/Folia 的服务器添加对 Vivecraft 的支持
插件
用于绘制游戏内地图或在浏览器中随探索实时进行地图绘制的实时地图。
评论 0
登录后参与评分
还没有评论,来抢沙发吧