物品¶
物品(Item)是Minecraft基岩版中存在于玩家背包、容器和世界中的可交互对象。物品可以被持有、使用、放置、丢弃和交易,是玩家与游戏世界交互的主要媒介。
概述¶
物品在游戏中以多种形态存在:背包中的物品栏格子、手持时的模型渲染、丢弃后地面上的掉落物实体等。每种物品通过赋命名空间标识符唯一标识。物品具有名称、图标纹理、最大堆叠数量、稀有度等基础属性,以及特定类别物品(如武器、工具、盔甲、食物等)的专属属性。
物品堆叠¶
物品堆叠(Item Stack)是物品在背包和容器中的存在形式,由物品类型、数量和附加数据组成。同一类型且附加数据相同的物品可以堆叠在同一个槽位中,堆叠上限取决于物品的max_stack_size属性,默认为64。武器、工具、盔甲等物品的堆叠上限通常为1。
损坏值与数据值¶
损坏值(Damage Value)在早期版本中同时承担两种角色:对于工具和武器,表示物品的损耗程度,即耐久(Durability)的消耗量;对于某些方块和物品,表示其数据值(Data Value),用于区分同一标识符下的不同变种。
在较新的格式版本中,数据值的概念已被方块状态和物品组件所取代。自定义物品不再使用损坏值来区分变种,而是通过独立的标识符或自定义属性实现。
附加值¶
附加值(Aux Value)是损坏值的别称,在早期文档和社区中较为常用。附加值与损坏值指代完全相同的概念。
物品组件¶
在数据驱动系统中,自定义物品通过组件(Component)定义其属性和行为。常见的物品组件包括:
minecraft:max_stack_size:最大堆叠数量。minecraft:damage:物品造成的伤害值。minecraft:durability:耐久属性。minecraft:food:食物属性,包括营养值和饱和度。minecraft:wearable:可穿戴属性,定义穿戴槽位。minecraft:icon:物品在界面中的图标纹理。minecraft:display_name:物品的显示名称。minecraft:hand_equipped:是否在手持时以工具姿态显示。
物品定义¶
自定义物品通过行为包中的定义文件创建,文件位于行为包的items/目录中。定义文件的根键为minecraft:item,包含描述和组件两个主要部分:
- 描述(Description):声明物品的标识符和所属的创造模式物品栏类别。
- 组件(Components):定义物品的各项属性和行为。
物品的图标纹理通过资源包中的item_texture.json文件进行映射。该文件定义了纹理短名称与实际纹理文件路径之间的对应关系。
物品实体¶
物品实体(Item Entity)是物品被丢弃到世界中后以掉落物形态存在的实体。物品实体在地面上存在一定时间后会消失(默认5分钟)。物品实体可以被玩家拾取、被漏斗吸收或被岩浆销毁。
容器¶
容器(Container)是可以存放物品的方块或实体。箱子、潜影盒、熔炉、发射器、漏斗等方块均为容器,驴、羊驼等实体在装备箱子后也可作为容器。每个容器拥有若干槽位(Slot),每个槽位可以存放一个物品堆叠。