ChestSort (+ API) - ChestSort - 箱子整理大师

厌倦了整理箱子？让我们少花时间在整理上，多花时间在游戏上！

ChestSort 可以在你使用后自动整理每个箱子、木桶等容器。每位玩家都可以通过简单的命令 /sort（或 /chestsort）按需启用或禁用此功能。玩家还可以使用命令 /invsort 整理自己的物品栏，或使用 /invsort on|off 设置自动整理。如果你不希望自动整理，也可以在玩家物品栏、箱子等界面中使用热键（中键点击、双击、Shift+左键点击和 Shift+右键点击）来触发整理。

箱子内容将按类别和/或字母顺序排序，可堆叠的物品会被堆叠。默认情况下，物品会排在方块之前。自动整理适用于箱子、末影箱、潜影盒、木桶、运输矿车和玩家物品栏。使用热键时也同样适用。羊毛、陶瓦和其他可染色方块也会按颜色排序，工具按其材料排序等。排序算法可以更改。绝对没有物品丢失/复制或元数据损坏的风险！保证！

默认情况下，排序功能是禁用的。玩家需要拥有 chestsort.use 权限才能使用箱子整理功能，或拥有 chestsort.use.inventory 权限才能整理自己的物品栏。如果玩家在登录后首次使用箱子，并且拥有使用 ChestSort 的权限，将会看到如何启用自动箱子整理的提示文本。排序功能也可以在某些世界中禁用。

所有消息均可自定义。支持英语、中文、中文（繁体）、荷兰语、法语、德语、匈牙利语、意大利语、日语、韩语、葡萄牙语、俄语、西班牙语和土耳其语。

ChestSort 支持 1.8 至最新版本之间的所有版本！（如果使用 1.14 之前的版本，请使用 ChestSort 9.5.1。）

💡版本兼容性说明

• 使用 Minecraft 1.15 或更低版本时，请使用 版本 11.5.6。
• 使用 Minecraft 1.13 或更低版本时，请使用 版本 9.5.1。

🎮命令

箱子整理命令

• /sort 或 /chestsort - 使用 100% 可自定义的 GUI 切换你的排序设置。
• /sort on|off|toggle 或 /chestsort on|off|toggle - 启用/禁用自动箱子整理。
• /sort hotkeys 或 /chestsort hotkeys - 打开热键 GUI，供每位玩家启用/禁用热键。
• /sort help 或 /chestsort help - 显示关于 /sort 命令的帮助信息。

物品栏整理命令

• /invsort 或 /isort - 整理玩家的物品栏。
• /invsort hotbar 或 /isort hotbar - 整理玩家的快捷栏。
• /invsort all 或 /isort all - 整理玩家的物品栏和快捷栏。
• /invsort toggle 或 /isort toggle - 切换自动物品栏整理。
• /invsort on|off 或 /isort on|off - 启用/禁用自动物品栏整理。
• /invsort help 或 /isort help - 显示关于 /invsort 命令的帮助信息。

✨权限

• chestsort.use - 允许使用自动箱子整理以及 /sort（和 /chestsort）命令。
• chestsort.use.inventory - 允许使用自动物品栏整理以及 /invsort（和 /isort）命令。
• chestsort.reload - 允许使用 /sort reload（和 /chestsort reload）命令重新加载配置。

注意：还有更多权限（例如针对每个单独功能的权限），但它们默认都是启用的。更多信息请参阅 config.yml。如果你不想使用权限插件，也可以在 config.yml 中将 use-permissions 设置为 false，以允许所有玩家使用 ChestSort。

🔧热键

你可以使用热键来整理容器，而无需输入命令。如果你只想偶尔整理箱子而不想启用自动排序，或者想快速整理自己的物品栏，这会很有用。每个热键都可以在 config.yml 中启用/禁用。默认情况下，所有热键都是启用的。此外，玩家可以通过运行 /chestsort hotkeys 来单独启用/禁用每个热键。

还有两个热键可以让你通过左键点击（填充）或右键点击（清空）箱子等容器界面的外部区域，快速将物品栏中的物品填充到容器中或从容器中取出。

整理热键

• 中键点击 - 在任何物品槽位上点击鼠标中键（滚轮）。
• 重要：由于客户端更改，中键点击在 MC 1.18+ 中无法工作。不会出现任何错误，只是中键点击不会被检测到。我将很快为 1.18+ 用户更改为此热键。
• Shift + 左键点击 - 在任何空物品槽位上按住 Shift 并左键点击。
• 双击 - 在任何空物品槽位上双击。
• Shift + 右键点击 - 在任何空物品槽位上按住 Shift 并右键点击。

额外热键（在容器界面外操作）

• 左键点击容器 - 整理被点击的容器（箱子、木桶、潜影盒等）。
• 左键点击容器界面外部 - 将所有匹配的物品（快捷栏除外）放入箱子、木桶等容器中。
• 双击左键点击容器界面外部 - 将所有物品（快捷栏除外）放入箱子、木桶等容器中。
• 右键点击容器界面外部 - 将箱子、木桶等容器中的匹配物品放入你的物品栏。
• 双击右键点击容器界面外部 - 将整个箱子、木桶等容器清空到你的物品栏中。

❓常见问题与说明

WorldGuard 和其他保护插件

ChestSort 只会整理玩家有权访问的箱子。换句话说：当 WorldGuard 等其他插件阻止访问箱子时，ChestSort 将不会整理这个箱子。这适用于所有取消 InventoryOpenEvent 的插件，因为 ChestSort 只会在 InventoryCloseEvent 被调用时进行整理。此外，如果玩家处于旁观者模式或冒险模式，箱子将不会被整理。

关于排序算法

• 在 1.13 之前的版本中，排序有时可能有点随机，因为一些物品名称不一致（例如，1.8 中的金合欢楼梯被命名为 acacia_stairs，而橡木木板只被称为 planks）。排序算法仅针对 1.13+ 进行了优化。
• 排序算法速度极快，应该不会对你的服务器性能产生任何影响。整理一个双箱大约需要四分之一毫秒。

语言与翻译

如果你的语言尚未支持，只需自己在配置文件中更改消息。如果你将翻译发送给我们，我们很乐意在下次更新中包含该语言。

统计与反馈

• ChestSort 使用 bStats 收集指标数据。你可以通过编辑 plugins/bstats/config.yml 文件来禁用它。在 https://bstats.org/plugin/bukkit/ChestSort 查看统计信息。
• 要查看源代码，请访问 https://github.com/JEFF-Media-GbR/Spigot-ChestSort。
• 如果你遇到任何错误或有任何改进想法，请在此处或在 GitHub 上联系我们。

⭐第三方插件兼容性

ChestSort 可以挂钩到某些第三方插件（如果它们安装在你的服务器上），以便更好地对自定义物品进行排序。

• CrackShot - 所有 CrackShot 武器将被分组在一起，并放入默认的武器类别中。
• InventoryPages - 当你安装了 InventoryPages 时，ChestSort 将忽略“下一页”和“上一页”按钮，这样你的 GUI 就不会被弄乱。
• Better Shulker Boxes / Minepacks / ShulkerPacks - 像整理其他箱子一样整理你的背包！应该适用于几乎所有的背包插件。
• 使用 GUI 物品栏的插件 - ChestSort 会尝试检测由第三方插件创建的 GUI 物品栏。如果此检测失败，请在 GitHub 上联系我，以便我添加对该插件的支持。

面向插件开发者的 API

ChestSort 提供了一种方法来整理任何 Inventory 实例，使用 ChestSort 提供的高级分组功能！在此处阅读有关 API 的更多信息。如果你的插件使用了 ChestSort API，请随时联系我，我很乐意将其列在这里。

✨默认配置

如果配置文件不存在，则会自动生成。每次新的 ChestSort 发布时，配置文件都会更新以包含最新的选项。你的更改将被保留。在此处查看默认配置文件。