容器¶
容器（Container）是Minecraft基岩版中可以存放物品的方块或实体所持有的物品存储空间。容器具有固定数量的槽位（Slot），每个槽位可以存放一组物品堆叠。
概述¶
容器是游戏中物品管理的基础设施。玩家的背包、箱子、熔炉的输入输出口等均为容器。当玩家与拥有容器的方块或实体交互时，游戏打开一个容器界面，显示容器中各槽位的物品并允许玩家进行物品的存取和移动操作。
方块容器¶
许多方块拥有内置的容器，其物品数据通过方块实体的NBT进行存储。常见的方块容器包括：
| 方块 | 槽位数 | 说明 |
|---|---|---|
| 箱子 | 27 | 两个相邻箱子可合并为大箱子（54槽位） |
| 陷阱箱 | 27 | 打开时输出红石信号 |
| 潜影盒 | 27 | 被破坏后保留其中的物品 |
| 木桶 | 27 | 类似箱子但不需要上方空间 |
| 发射器 | 9 | 被激活时发射或使用物品 |
| 投掷器 | 9 | 被激活时投掷或输送物品 |
| 漏斗 | 5 | 自动传输物品到相邻容器 |
| 熔炉 | 3 | 输入槽、燃料槽和输出槽 |
| 高炉 | 3 | 快速烧炼矿石 |
| 烟熏炉 | 3 | 快速烹饪食物 |
| 酿造台 | 5 | 3个药水槽、1个材料槽和1个烈焰粉槽 |
实体容器¶
部分实体也拥有容器。常见的实体容器包括：
- 玩家背包：36个主背包槽位、4个盔甲槽位和1个副手槽位。
- 骡子和羊驼：装备箱子后获得额外的容器空间。
- 矿车箱子：与普通箱子相同的27个槽位。
- 矿车漏斗：与普通漏斗相同的5个槽位。
容器操作¶
容器中的物品可以通过以下方式操作：
- 玩家交互：打开容器界面，手动拖拽物品。
- 漏斗传输：漏斗可以从上方容器中抽取物品，并向连接方向的容器中输入物品。
- 命令：通过
/replaceitem命令直接设置容器中指定槽位的物品。 - 脚本API：通过实体或方块的容器组件接口读写物品数据。
容器数据存储¶
方块容器的物品数据存储在对应方块实体的NBT标签中，通常为一个Items列表标签，列表中的每个元素记录一个槽位的物品信息（包括物品标识符、数量、损坏值和附加NBT数据）。