受限库存

受限物品栏

将玩家物品栏槽位锁定为特定物品或物品标签。

是否曾想为你的剑保留一个专用槽位，让0号槽位始终是火把，或是在服务器上强制执行物品整理？受限物品栏能让你做到这些——配置任意物品栏槽位（0–35）仅接受特定物品或物品标签，可全局应用或按玩家单独设置。

功能特性

• 槽位限制 — 将任意快捷栏或物品栏槽位锁定为特定物品（例如 minecraft:torch）或整个物品标签（例如 #minecraft:swords）
• 服务器或客户端模式 — 通过服务器配置对所有玩家应用相同规则，或让每个玩家在各自的客户端配置中定义自己的限制
• 视觉反馈 — 受限槽位会显示所需物品的幽灵预览，让玩家始终知道什么物品该放在哪里
• 槽位索引叠加 — 在任何物品栏界面按住 Tab 键即可显示每个槽位的索引编号，让配置设置变得轻松简单
• 智能物品路由 — 拾取物品时，物品会优先自动放入指定槽位，然后才填充未受限的槽位

命令

所有命令均使用 /restrictedinventory 前缀。

命令	描述	权限
/restrictedinventory config	打开限制配置界面	管理员（OP等级4），或当 useClientRestriction 启用时任意玩家可使用

权限规则

• 当 useClientRestriction 为 false（服务器模式）时：仅服务器管理员（OP等级4）可打开配置界面。
• 当 useClientRestriction 为 true（客户端模式）时：每位玩家都可以打开自己的配置界面。

限制配置界面

配置界面是用于编辑槽位限制的游戏内图形界面。通过 /restrictedinventory config 命令打开。

物品/标签选择器（顶部面板）

• 物品标签页 — 以¾比例列出所有已注册物品。悬停可查看物品名称和注册ID。点击可选择。
• 标签标签页 — 列出所有已注册物品标签。每个标签会循环展示其成员作为实时预览。悬停可查看标签ID。点击可选择。
• 使用鼠标滚轮滚动或拖动右侧滚动条。

槽位网格（中间面板）

• 显示全部36个玩家物品栏槽位（0–35），按标准物品栏布局排列。
• 每个槽位循环显示当前限制预览，若未受限制则为空。
• 左键点击槽位可选择该槽位（以白色高亮显示）。被选中的槽位将接收选择器中选择的物品或标签。
• 右键点击槽位可移除已选择的物品或标签。
• 悬停槽位可查看其当前限制值作为悬停提示。

配置

限制通过简单的 JSON 配置文件定义。同时支持特定物品和物品标签。

{
  "useClientRestriction": false,
  "restrictedSlots": {
    "0": "minecraft:torch",
    "1": "#minecraft:swords",
    "8": "minecraft:totem_of_undying"
  }
}

槽位范围	位置
0–8	快捷栏（仅生存模式）
9–35	主物品栏

注意： 槽位索引 0–8 对应于生存模式中的快捷栏。在创造模式中，快捷栏使用不同的物品栏布局，槽位限制在创造模式下不会生效。

兼容性说明

本模组通过 Mixin 接入原版的槽位放置和物品拾取逻辑。直接向玩家物品栏插入物品（绕过标准槽位逻辑）的模组或方块实体可能不会遵守这些限制。同样修改 Slot、Inventory 或 AbstractContainerScreen 的模组可能会产生冲突。