Restricted Inventory

受限物品栏

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

想过给剑留一个专用槽位、让槽位 0 永远放着火把，或是在整个服务器统一物品摆放规则吗？受限物品栏都能做到——可将任意物品栏槽位（0–35）设为只能放入特定物品或物品标签，并应用于整个服务器或单个玩家。

功能

• 槽位限制 — 将任意快捷栏或物品栏槽位锁定为特定物品（例如 minecraft:torch）或整个物品标签（例如 #minecraft:swords）
• 服务器或客户端模式 — 通过服务器配置将相同规则应用于所有玩家，或让每位玩家在自己的客户端配置中设置限制
• 视觉提示 — 受限槽位会显示所需物品的幽灵预览，让玩家随时知道各物品该放在哪里
• 槽位索引叠加显示 — 在任意物品栏界面中按住 Tab，即可显示每个槽位的索引编号，轻松完成配置
• 智能物品分配 — 拾取的物品会优先放入指定槽位，再填入未受限的槽位

命令

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

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

权限规则

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

限制配置界面

配置界面是用于编辑槽位限制的游戏内 GUI。使用 /restrictedinventory config 打开。

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

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

槽位网格（中间面板）

• 以标准物品栏布局显示玩家的全部 36 个物品栏槽位（0–35）。
• 每个槽位会循环展示当前限制对应的预览；未受限的槽位则为空。
• 左键点击槽位即可选中它（以白色高亮显示）。选择器中选定的物品或标签将应用到该槽位。
• 右键点击槽位可移除已选定的物品或标签。
• 将鼠标悬停在槽位上，可通过提示框查看其当前限制值。

配置

限制定义在简单的 JSON 配置文件中。支持指定物品和物品标签，也支持 NBT/组件。

{
  "useClientRestriction": false,
  "useTeamAndTagRestrictions": true,
  "restrictedSlots": {
    "0": "minecraft:torch",
    "1": {
      "item": "#minecraft:swords",
      "display": { // 这是一个带有 nbt/组件 的物品示例
        "components": { // 1.20.1 请使用 "tag"
         "minecraft:stored_enchantments": {
           "mineraft:silk_touch": 1
        },
      }
    },
    "2": {
       "item": "minecraft:enchanted_book",
       "components": { // 1.20.1 请使用 "tag"
         "minecraft:stored_enchantments": {
           "mineraft:silk_touch": 1
        },
       "display": "minecraft:dirt" // 这是一个普通物品示例
      }
    },
    "3": {
      "group": "group_name"
    }
  },
  "groups": { // 仅在通用配置中可用
    "group_name": [
      {"item": "minecraft:dirt"},
      {
       "item": "minecraft:enchanted_book",
       "components": { // 1.20.1 请使用 "tag"
         "minecraft:stored_enchantments": {
           "mineraft:silk_touch": 1
        }
      }
    ]
  },
   "teamRestrictions": {
    "team": {
       "restrictedSlots": {
          "0": "minecraft:dirt"
       }
    }
  },
  "tagRestrictions": {
    "dirt": {
       "restrictedSlots": {
          "1": "minecraft:grass_block"
       }
    }
  }
}

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

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

兼容性说明

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