基岩版世界格式/物品格式

这是基岩版中物品NBT结构文件的页面。

物品NBT在玩家的物品栏和末影箱等容器物品栏中使用。

物品堆叠

所有物品的共通数据：

• ：物品的根标签。
  •  Name：物品的ID。
  •  Count：物品在单个槽位里的数量。
  •  Damage：元数据。此标签并不储存物品的损害数据（例如剑和镐的损害情况）。
  •  WasPickedUp：是否被捡起过。
  •  Block：（可能不存在）该物品的方块形式，在放置时使用。
    • 方块共通标签
  •  tag：（可能不存在）物品的附加数据。
  •  CanDestroy：用于控制在冒险模式下这个物品能够破坏什么类型的方块。
    • ：方块的ID。
  •  CanPlaceOn：（可能不存在）用于控制在冒险模式下这个方块可以放置在什么类型的方块的上面。
    • ：方块的ID。

常规标签

具有耐久度的物品，其伤害值存储在NBT中。此外，物品可以有自定义的显示名称及其描述。还有一个RepairCost标签可以跟踪物品的铁砧使用情况，使得每次使用铁砧的成本更高。

•  tag：父级标签。
  •  Damage：（可能不存在）此物品的损害数据（默认为0）。
  •  display：（可能不存在）显示的属性。
    •  Name：（可能不存在）用于显示物品的JSON文本组件。
    •  Lore：（可能不存在）显示为物品描述的字符串列表。
      • ：（可能不存在）物品的描述。
  •  RepairCost：（可能不存在）使用铁砧修复、合并或重命名此物品时，要添加到基础等级成本中的经验等级数量。
  •  minecarft:item_lock：1为锁定在槽位里无法取出；2为锁定在物品栏里，可以在物品栏内移动但不能移出物品栏。
  •  minecraft:keep_on_death：1为死后不会掉落。

附魔标签

在Java版中，有两种办法储存物品的魔咒NBT：第一种办法是该物品储存实际的魔咒并且魔咒会影响该物品的行为，而第二种办法是该物品是附魔书，它只存储魔咒而不会影响该物品的行为。

但在基岩版中，只有一种办法：已经附魔的物品和附魔书都共享一个 ench标签。

•  tag：父级标签。
  •  ench：包含了物品附有的魔咒。
    • ：单个魔咒。
      •  id：魔咒的ID。
      •  lvl：魔咒的等级，在读取数值时会限制在0-255之间。

水生生物桶

水生生物桶的附加字段：

•  tag：父级标签。
  •  AppendCustomName: 实体颜色、状态和ID是否用于生成桶物品的名称， 默认为true。
  •  CustomName：（可能不存在）桶内实体的自定义名称，用于生成桶的名称。
  •  ColorID：（可能不存在）颜色的本地化键名，用于生成桶的名称。
  •  Color2ID：（可能不存在）第二种颜色的本地化键名，用于生成桶的名称。
  •  BodyID：（可能不存在）桶内实体的状态，用于生成桶的名称。
  •  GroupName：（可能不存在）未知。用于生成桶的名称。
  • 实体共通标签
  • 鱼或美西螈实体特有的附加标签。

磁石指针

磁石指针的附加字段：

•  tag：父级标签。
  •  trackingHandle：磁石指针所跟踪的磁石的ID。

填充的地图

填充的地图的附加字段：

•  tag：父级标签。
  •  map_is_init：是否为创建世界时提供的初始地图。^{[需要测试]}
  •  map_uuid：地图的UUID。
  •  map_name_index：地图名称的索引。
  •  map_display_players：（可能不存在）地图是否显示玩家标记。
  •  map_scale：地图的缩放等级。值为0-3。
  •  map_is_scaling：地图是否经过缩放处理。

马铠

马铠的附加字段：

•  tag：父级标签。
  •  customColor：（可能不存在）皮革马铠的自定义颜色。

荧光棒

荧光棒的附加字段：

• ：父级标签。
  •  active_time：（可能不存在）荧光棒激活后的剩余发光时间。

旗帜

旗帜的附加字段：

•  tag：父级标签。
  •  Type：（可能不存在）0为普通旗帜，1为灾厄旗帜。
  •  Patterns：旗帜的图案列表。
    • ：单个图案。
      •  Pattern：图案的ID。参见旗帜#方块数据。
      •  Color：图案的颜色。参见旗帜#方块数据。

烟花火箭

烟花火箭的附加字段：

•  tag：父级标签。
  •  Fireworks：烟花火箭的效果。
  •  Explosions：烟花火箭的爆裂组合的组件列表。
    • ：爆裂效果
      • 烟花火箭爆裂共通标签
  •  Flight：表示烟花的飞行时间（等于合成烟花火箭所用的火药数量）。可以是-128到127之间的任何值。

烟火之星

烟火之星的附加字段：

•  tag：父级标签。
  •  FireworksItem：烟火之星提供的爆裂效果。
    • 烟花火箭爆裂共通标签
  •  customColor：烟火之星的颜色。

成书

成书的附加字段：

•  tag：父级标签。
  •  author：书的作者。
  •  title：书的标题。
  •  xuid：书的ID。
  •  pages：书的页码列表。
    • ：书的单页。
      •  text：此页的文本内容。
      •  photoname：书上的图片的名称。
  •  generation：书的副本。0表示原著，1表示副本，2表示副本的副本，3表示破烂不堪。

书与笔

书与笔的附加字段：

•  tag：父级标签。
  •  pages：书的页码列表。
    • ：书的单页。
      •  text：此页的文本内容。
      •  photoname：书上的图片的名称。

潜影盒

潜影盒的附加字段：

•  tag：父级标签。
  •  Items：潜影盒内的物品列表。
    • ：物品及其槽位标签。
      •  Slot：物品所在的槽位编号。
      • 物品堆叠共通标签

弩

弩的附加字段：

•  tag：父级标签。
  •  chargedItem：弩所装填的物品。
    • 物品堆叠共通标签

药水

药水的附加字段：

•  tag：父级标签。
  •  wasJustBrewed：（可能不存在）药水是否通过酿造获得。

语言

• English