Inventory Management

你可以在配置文件夹中的 inventorymanagement.toml 文件里配置该模组的行为。如果安装了模组菜单，也可以通过模组菜单的模组列表界面访问配置；将鼠标悬停在每个选项上时，还会显示带有说明的提示框。

常规

modEnabled：true|false（默认值为 true）- 模组总开关。关闭后不会显示任何按钮，也不会运行任何功能。

快捷栏交换（位于 hotbarSwap 部分）

hotbarSwap.enableHotbarSwap：true|false（默认值为 true）- 快捷栏交换功能的总开关。关闭后，快捷栏交换（按住）按键绑定将不起作用（滚动鼠标和数字键都不会再将某一行切换进快捷栏），同时也会隐藏已交换行的标记。请参阅下方的快捷栏交换部分。

hotbarSwap.hotbarSwapNumberKeys：true|false（默认值为 true）- 按住快捷栏交换（按住）按键绑定时，允许使用数字键 1–3 选择要切换到快捷栏的主物品栏行（再次按下当前行对应的数字键即可将其切换回去）。默认启用；关闭后，即使按住该按键，数字键也会继续用于切换当前选中的快捷栏槽位。无论此选项如何设置，按住该按键时滚动鼠标始终有效。

物品耐久度（位于 durability 部分）

durability.durabilityAlertEnabled：true|false（默认值为 true）- 当工具或装备物品的耐久度低于阈值时，在快捷栏上方显示低耐久度提示，并播放铁砧“提示音”。此功能完全在客户端运行：它读取已经同步到客户端的耐久度信息，因此可以在任何服务器上使用，即使是原版服务器也不例外。请参阅下方的物品耐久度部分。

durability.durabilityAlertThreshold1：<Integer>（默认值为 10）- 第一个最大耐久度百分比阈值（0–99）。当耐久度下降并越过该阈值时触发一次提醒。设置为 0 可跳过此阈值。

durability.durabilityAlertThreshold2：<Integer>（默认 5）- 第二个耐久度百分比阈值（0–99），当耐久度向下越过该阈值时触发一次警报。设为 0 可跳过此阈值。

durability.durabilityAlertAtOne：true|false（默认 true）- 除百分比阈值外，在剩余耐久度恰好为 1 点时也触发警报。

durability.durabilityAlertSound：true|false（默认 true）- 触发警报时播放铁砧敲击声。无论是否开启，动作栏消息始终会显示。

durability.durabilityAutoReplace：true|false（默认 false）- 在手持或穿戴的物品即将损坏前，从你的物品栏中换入一个匹配的替代品。由客户端驱动：你的客户端检测到即将损坏并请求替换，因此在多人游戏中服务器也必须安装此模组（不会同步任何设置）。

durability.durabilityAutoReplaceSimilar：true|false（默认 false）- 将自动替换的匹配规则从严格（相同物品 + 附魔）放宽为相似（相同类别，忽略材质/附魔）：滑翔翼可替换任意滑翔翼，同一盔甲槽位可替换任意物品，任意共享损坏工具工具标签（#minecraft:pickaxes、axes、shovels、hoes、swords）的物品均可替换。

排序/转移（位于 sorting 部分下）

sorting.showSort：true|false（默认 true）- 是否显示排序按钮。

sorting.showTransfer：true|false（默认 true）- 是否显示全部转移（放入/取出）按钮。

sorting.showStack：true|false（默认 true）- 是否显示自动堆叠按钮。

sorting.sortMode："alphabetical"|"creative"（默认 "alphabetical"）- 排序时物品的排列方式。alphabetical 按物品名称排序；creative 使用创造模式菜单的排序方式。

sorting.containersFirst：true|false（默认 false）- 将装有内容的物品（潜影盒、收纳袋等）排在其他物品之前。仅在 alphabetical 模式下生效。

sorting.defaultPosition："(<Integer>,<Integer>)" – 自定义按钮位置的默认值。

sorting.screenPositions：{"ID": "(<Integer>,<Integer>)"} – 按界面分别自定义按钮位置。虽然可以在配置文件中手动修改，但推荐通过配置界面进行修改。详见下文！

sorting.enableSlotLocking：true|false（默认 true）- 锁定玩家物品栏槽位的总开关。关闭后，Ctrl/Cmd+点击不再锁定槽位，不再绘制标记或提示，排序、自动堆叠和转移也不再跳过已锁定的槽位。已锁定的槽位会被记住，以便你重新开启时恢复。详见下文的锁定槽位部分。

sorting.lockedSlotDisplay："shown"|"hidden"|"hotkey"（默认 "shown"）- 何时在锁定槽位上绘制标记（边框 + 变暗背景）。shown 始终绘制；hidden 从不绘制；hotkey 仅在按住查看锁定槽位按键绑定时绘制。锁定本身（Ctrl/Cmd+点击）和悬停提示不受影响。

lockedPlayerSlots / sorting.serverLockedPlayerSlots：（默认为空）- 被锁定的玩家主物品栏槽位索引，按世界分别记忆。在单人游戏中，它们保存在该存档自己的配置文件（<save>/config/inventorymanagement.toml）中的 lockedPlayerSlots 下，因此会随存档一起移动；在多人服务器上，它们保存在你的全局配置中的 sorting.serverLockedPlayerSlots 下，这是一个以服务器地址为键的表。无论哪种方式，它们都由你在游戏内通过 Ctrl/Cmd+点击槽位来管理（没有 GUI 控件），但如果你需要检查或清除它们，它们就存放在配置文件中。

排序分组（位于 grouping 部分下）

grouping.itemGrouping：true|false（默认 true）- 变体分组的总开关：将相关的物品系列（所有羊毛颜色、所有木板等等）聚集在一起，而不是纯粹按名称对每个变体进行排序。请参阅下方的物品分组部分。

grouping.dynamicGroups：true|false（默认 true）- 数据包定义的分组系列的总开关（请参阅下方的数据包分组标签部分）。

grouping.disabledDynamicGroups：["<tag id>", ...]（默认为空）- 单独禁用的数据包分组系列，按完整标签 id 指定。在配置文件中管理（没有 GUI 控件）。

grouping.<family>：true|false（默认 true）- 每个内置变体系列对应一个开关；关闭其中一个即可按纯名称对该系列排序，而不是将其聚集。系列：wool、wool_carpets、beds、candles、banners、shulker_boxes、dyes、terracotta、glazed_terracotta、concrete、concrete_powder、stained_glass、stained_glass_pane、planks、wooden_slabs、wooden_stairs、wooden_doors、wooden_trapdoors、wooden_fences、fence_gates、signs、hanging_signs、leaves、saplings、boats、spawn_eggs、pottery_sherds、horse_armor、coral。

为了保持与其他模组的兼容性，你现在可以调整物品栏管理按钮的位置了！要调整所有按钮的位置，请查看配置中的 sorting.defaultPosition 选项，或者如果你安装了 ModMenu，可以在配置界面中调整。如果你有某个特定界面需要调整（例如另一个模组增加了更多物品栏空间），你可以按住 Ctrl/Cmd 并点击其中一个 UI 按钮，打开按界面单独设置的位置编辑器！该编辑器只会调整当前界面的按钮位置，因此你可以随意调整位置，让它与你那闪亮的背包模组 UI 对齐！;)

编辑器打开后，只需用鼠标点击并拖动按钮即可将它们滑到合适的位置，它们会一比一地跟随光标。更喜欢精确操作？方向键仍然可以一次微调一个像素（按住 Shift 可进行更大跳跃），Ctrl/Cmd+R 可重置为默认值。同样的拖放操作也适用于配置界面中的 defaultPosition 编辑器。

Ctrl/Cmd+点击是主要的进入方式，但也有专用的按键绑定可用于打开编辑器（一个用于玩家物品栏按钮，另一个用于容器按钮）。Inventory Management 的所有按键绑定默认均未设置。如果你想使用它们，请前往“选项”，然后进入“控制”，在Inventory Management分类下分配按键。

整理

现在，所有容器（只要空间足够）和你的物品栏中都会出现一个整理按钮。点击此按钮即可自动整理物品栏！大多数情况下会按字母顺序整理，但也有少数手动设定的例外。整理会忽略快捷栏，因此不用担心主要物品的位置被打乱！

有些槽位你永远不希望被动到，比如备用方块、食物，或者那个出于习惯一直放在同一位置的物品堆？把它锁定吧。按住 Ctrl/Cmd 并点击主物品栏中的任意槽位，即可切换该槽位的锁定状态。锁定的槽位会被整理、自动堆叠和全部转移（放入/取出）操作跳过，因此这些操作不会移动、重新排列锁定槽位中的物品，也不会从中取出物品。锁定和解锁使用同样的 Ctrl/Cmd+点击操作，并且鼠标左右键都支持。

只有主物品栏网格可以锁定。快捷栏、盔甲栏、副手栏以及任何已打开容器的槽位都不能锁定（快捷栏本来就会被所有操作忽略）。锁定状态会按世界分别保存：每个单人存档和每个多人服务器都会保留各自独立的锁定设置（单人游戏中的锁定状态甚至会随存档文件夹一同转移），并且会跨会话保留。空的锁定槽位也会继续保持预留状态，因此转移操作不会填入其中。

默认情况下，锁定槽位会以略微变暗的背景和绘制在物品下方的边框进行标记，将鼠标悬停在其上时会显示 Locked (Ctrl+click to unlock) 提示。觉得这些标记碍眼？lockedSlotDisplay 配置选项可以将其设为始终显示（默认）、隐藏或按住按键时显示。最后一种模式只会在你按住查看锁定槽位按键绑定时绘制标记，让物品栏保持整洁，直到你想确认哪些槽位已被锁定。无论如何，悬停提示始终会显示，因此锁定的槽位不会让人摸不着头脑。

提示：和 Inventory Management 的所有按键绑定一样，查看锁定槽位默认未绑定。如果你想使用 hotkey 显示模式，请前往“选项”，然后进入“控制”，在 Inventory Management 分类下为其分配按键。

想要在不打开物品栏的情况下，随手使用第二栏（甚至第三栏）物品吗？按住切换键并滚动鼠标滚轮。每次滚动都会切换主物品栏的三行物品中哪一行与快捷栏互换，顺序为正常状态、 第 1 行、第 2 行、第 3 行，再回到正常状态，并循环往复。物品会实际交换位置，因此快捷栏中原有的物品会移到对应行，反之亦然。一次只会移出一行物品，滚回正常状态后，一切都会回到原位。

比起滚动鼠标滚轮，你更喜欢按键操作？启用 hotbarSwapNumberKeys 选项后（默认启用），按住切换键时，数字键 1–3 可直接跳转到对应行；再次按下当前行对应的数字键，则会将其切换回正常状态。按住切换键时，数字键不会改变你选中的快捷栏槽位，因此 4–9 会被直接忽略。如果你希望即使按住切换键，数字键也始终保持正常功能，可以关闭该选项。

一个小标记会显示当前激活的行：在任意物品栏或容器界面中，切换行左侧会显示一个彩色标签；在游戏 HUD 中，快捷栏左侧则会显示一个不显眼的数字标记（1–3）。

在后台，每次切换都会将某一行的九个槽位与快捷栏的九个槽位逐一交换，其中第 1 行是主物品栏网格最上方的一行，第 3 行是最靠近快捷栏的一行。物品移动通过数据包在服务端执行，与整理按钮的工作方式相同；切换行时，总会先将上一行恢复原位，再应用新的切换。服务端信任客户端对当前移出行的判断，因此如果某一行处于切换状态时快捷栏内容发生变化（例如物品损坏、拾取物品进入快捷栏、使用 /give，或其他模组进行了操作），下一次切换可能会移动错误的槽位。在对移出的快捷栏进行任何会重新排列物品的操作前，请先滚回正常状态。

如果你遇到不同步的情况，例如在切换过程中退出了游戏，请按下重置快捷栏切换按键绑定。该操作会将模组的追踪状态清除并恢复为“正常”，但不会移动任何物品，而是以当前快捷栏中实际存在的物品为基准重新建立状态。

注意：由于物品会实际交换位置（并且服务端会保存这些变化），如果某一行处于切换状态时退出游戏，那么重新登录后这些物品仍会处于移出位置，即使指示器显示为“正常”。要将所有物品恢复原位，请重新选中该行（通过滚动鼠标滚轮或按对应数字键将其切换进来），然后再滚回正常状态。

提示：和 Inventory Management 的所有按键绑定一样，快捷栏切换（按住）和重置快捷栏切换默认都未绑定。要使用此功能，请前往“选项”，然后进入“控制”，在 Inventory Management 分类下为它们分配按键。

辛苦获得的工具即将损坏，你却因为没有注意而眼睁睁看着它消失，这种情况是不是很令人烦恼？物品耐久度选项提供了两种相互独立的装备保护方式。你可以在配置中分别启用或禁用它们；警报默认开启，而自动替换默认关闭。

低耐久度警报。 当工具或已装备的物品（包括鞘翅）耐久度降至阈值以下时，你会收到一条动作栏消息：“\ 耐久度低！剩余 \”，同时伴有铁砧的“叮”声。它会监视你的主手、副手以及全部四个盔甲槽位，并且每当物品在耐久度下降过程中越过一个阈值时触发一次，其设计理念源自 Vanilla Tweaks 的“Durability Ping”数据包。有两个可配置的百分比阈值（默认 10% 和 5%），另外还有一个独立的剩余 1 点时警报选项，用于最后一点耐久度。它完全是客户端侧的：它读取已经同步给你的耐久度数据，因此适用于任何服务器，甚至是原版服务器。如果你只想要消息，可以用 durabilityAlertSound 关闭声音，或者在配置中调整两个阈值滑块（将任一设为 0 即可跳过）。

损坏前自动替换。 在手持或穿戴的物品即将损坏之前，模组会从你的物品栏中换入一个匹配的替代品。用旧的物品会回到替代品原来所在的槽位，因此你几乎不会中断操作，也绝不会在动作过程中丢失旧物品。默认情况下，匹配是严格的（相同物品、相同附魔），但 durabilityAutoReplaceSimilar 会将其放宽为相似：任何滑翔装备替换滑翔装备，任何同盔甲槽位的装备替换同槽位装备，或任何与损坏物品同类别（镐、斧、锹、锄、剑）的工具。它会扫描你的主物品栏和副手，并选择剩余耐久度最高的候选物品。由于它始终只是两个槽位之间的交换，因此绝不会复制或丢失物品。

需要注意一点：自动替换会在物品的最后一点耐久度时触发，因此一次消耗超过一点耐久度的动作仍可能在替换发生前损坏物品。警报和快速手动替换仍然可以帮你应对这种情况。

多人游戏。 自动替换是客户端驱动的：你的客户端已经能看到装备的耐久度，它会注意到物品即将损坏，选择替代品，并请求服务器执行交换，其工作方式与排序和转移按钮完全相同。你的设置不会同步，请求中包含了服务器所需的一切信息。在多人游戏中，模组必须安装在服务器上才能进行交换，由服务器验证并应用。警报完全是客户端侧的，服务器上不需要任何东西。

所有耐久度选项都位于配置的 durability 部分下。

当 itemGrouping 开启时（默认开启），按字母排序会将相关物品的家族聚集在一起，而不是按每个变体自己的名称分散排列，因此所有 16 种羊毛颜色会聚在一起，所有木板类型会聚在一起，依此类推。每个内置家族都有自己的 grouping.<id> 开关（全部默认开启）；关闭其中一个即可仅对该家族回退到普通名称排序。

一个家族在排序结果中会“落位”在其锚点的显示名称槽位处（对于颜色家族来说，锚点是白色变体，例如整个羊毛簇会排在白色羊毛应在的位置）。内置家族列在上面的配置部分中。

分组按先匹配先赢的顺序查询：**内置分组，然后是模组注册的分组，最后是数据包分组**。内置分组始终最先查询，因此模组或数据包添加的任何内容都无法劫持原版家族。