基岩版世界格式/方块实体格式

这是基岩版中方块实体NBT结构文件的页面。

方块实体是与各类方块关联的附加数据，作为方块的各种状态有限组合的补充。

方块实体

所有方块实体的共通数据：

• ：方块实体的根标签。
  •  id：方块实体的命名空间ID。
  •  x：方块实体的X轴位置。
  •  y：方块实体的Y轴位置。
  •  z：方块实体的Z轴位置。
  •  isMovable：方块实体可以被活塞移动时为true。
  •  CustomName：（可能不存在）方块实体的自定义名称。

方块实体种类的附加字段

旗帜

旗帜的附加字段：

• ：方块实体的根标签。
  •  Base：旗帜的底色。参见旗帜#方块数据。
  •  Type：旗帜的类型。0为普通旗帜，1为灾厄旗帜。
  •  Patterns：（可能不存在）旗帜所有的图案组合。
    • ：单个图案。
      •  Pattern：图案的ID。参见旗帜#方块数据。
      •  Color：图案的颜色。参见旗帜#方块数据。

信标

信标的附加字段：

• ：方块实体的根标签。
  •  primary：信标设定的主要效果，参见状态效果/ID来获取具体数据。0表示未设定。
  •  secondary：信标设定的次要效果，参见状态效果/ID来获取具体数据。0表示未设定。当没有设定主要效果时，次要效果无法使用。当设定为与主要效果相同时，会产生II级效果（5个效果的正常可用行为）。当设置为与主要值不同的值（通常只有生命提升）时，会产生I级的效果。^{[需要测试]}

床

床的附加字段：

• ：方块实体的根标签。
  •  color：床的被子颜色。当床被破坏时，床头的方块实体的颜色会变成床物品掉落时的颜色。

蜂巢和蜂箱

蜂箱的附加字段：

• ：方块实体的根标签。
  •  ShouldSpawnBees：生成新蜜蜂时值为true。
  •  Occupants：（可能不存在）蜂巢或蜂箱内的实体。
    • ：蜂巢或蜂箱内的具体实体。
      •  ActorIdentifier：蜂巢或蜂箱蜂箱内的具体单个实体。在原版游戏下总会是minecraft:bee<>。^{[需要更多信息]}
      •  TicksLeftToStay：实体离开蜂巢或蜂箱蜂箱前的时间（刻）。
      •  SaveData：蜂巢或蜂箱蜂箱内实体的NBT数据。
        • 实体共通标签
        • 此实体种类独有的标签。

钟

钟的附加字段：

• ：方块实体的根标签。
  •  Ringing：钟在敲响时为true。
  •  Ticks：钟在敲响后持续摆动的时间（刻）。
  •  Direction：钟的放置方式。0表示放在地上，1表示挂在左边墙上，2表示挂在右边墙上，3表示挂在墙壁中间，4表示悬挂。^{[需要测试]}

酿造台

酿造台的附加字段：

• ：方块实体的根标签。
  •  FuelTotal：燃料的最大值。
  •  CookTime：完成酿造前的剩余时间（刻）。
  •  FuelAmount：燃料的剩余量。
  •  Items：放进酿造台内的物品列表。
    • ：酿造台内的物品，以及其槽位标签。
      •  Slot：物品所在的槽位编号。
      • 物品堆叠共通标签

营火和灵魂营火

营火和灵魂营火的附加字段：

• ：方块实体的根标签。
  •  ItemTime<num>：每个物品的烹饪时间，<num>为1-4。
  •  Item<num>：（可能不存在）具体烹饪的物品的列表，<num>为1-4。
    • 物品堆叠共通标签

炼药锅

炼药锅的附加字段：

• ：方块实体的根标签。
  •  PotionId：如果炼药锅中含有药水，则此标签存储该药水的ID。如果没有储存药水，则被设置为-1。
  •  PotionType：如果炼药锅中含有药水，则此标签存储该药水的类型。0是常规药水，1是喷溅药水，2是滞留药水。如果没有储存药水，则被设置为-1。
  •  CustomColor：（可能不存在）此标签仅在炼药锅储存染色的水时存在，储存了32位ARGB编码颜色。
  •  Items：容器内的物品。
    • ：物品以及其槽位标签。
      •  Slot：物品所在的槽位编号。
      • 物品堆叠共通标签

黑板

黑板的附加字段：

• ：方块实体的根标签。
  •  BaseX：底部的X轴坐标。
  •  BaseY：底部的Y轴坐标。
  •  BaseZ：底部的Z轴坐标。
  •  Size：黑板的大小。
  •  OnGround：放置在地面时为true。
  •  Locked：黑板内容被锁定时为true。
  •  Owner：黑板拥有者的独特ID。
  •  Text：黑板上的文本信息。

化学仪器

化学仪器（化合物创建器、元素构造器、试验台、材料分解器）的附加字段：

• ：方块实体的根标签。
  •  itemId：物品的ID。
  •  itemAux：物品的次级ID。
  •  itemStack：物品的堆叠数。

箱子

箱子、陷阱箱、木桶和末影箱的附加字段：

• ：方块实体的根标签。
  •  forceunpair：（可能不存在）箱子并排放置时不合并成大箱子时为true。
  •  pairlead：（可能不存在）配对后形成的大箱子的前部。
  •  pairx：（可能不存在）箱子的X轴位置配对。
  •  pairz：（可能不存在）箱子的Z轴位置配对。
  •  Findable：未知。
  •  LootTable：（可能不存在）用于在下次打开时填充物品栏的战利品表，或者以其他方式与之交互的物品。
  •  LootTableSeed：生成战利品表所需的种子号，0表示随机生成。
  •  Items：容器内物品的列表。
    • ：单个物品及其槽位标签。
      •  Slot：物品所在槽位的编号。
      • 物品堆叠共通标签

雕纹书架

雕纹书架的附加字段：

• ：方块实体的根标签。
  •  Items：书架里放有的书的列表。
    • ：单个物品。
      • 物品堆叠共通标签
  •  LastInteractedSlot：最后一个交互过的槽位编号（1-6），值为0时表示没有进行过交互。

命令方块

命令方块的附加字段：

• ：方块实体的根标签。
  •  powered：命令方块是否被红石激活。
  •  auto：命令方块是否不需要红石而被激活。
  •  conditionMet：命令方块是否受条件制约，不受制约时为true。
  •  LPCondionalMode：未知。
  •  LPRedstoneMode：未知。
  •  LPCommandMode：未知。
  •  conditionalMode：是否处于条件制约模式下。
  • 命令方块共通标签

红石比较器

红石比较器的附加字段：

• ：方块实体的根标签。
  •  OutputSignal：表示此红石比较器的模拟信号输出强度。

潮涌核心

潮涌核心的附加字段：

• ：方块实体的根标签。
  •  Target：潮涌核心正在攻击的实体的独特ID。没有攻击目标时为-1。
  •  Active：潮涌核心被激活时为true。

发射器和投掷器

发射器和投掷器的附加字段：

• ：方块实体的根标签。
  •  LootTable：（可能不存在）用于在下次打开时填充物品栏的战利品表，或者以其他方式与之交互的物品。
  •  LootTableSeed：生成战利品表所需的种子号，0表示随机生成。
  •  Items：容器内物品的列表。
    • ：物品及其槽位标签。
      •  Slot：物品所在槽位的编号。
      • 物品堆叠共通标签

附魔台

附魔台的附加字段：

• ：方块实体的根标签。
  •  CustomName：（可能不存在）附魔台的自定义名称。
  •  rott：附魔台上的书本的旋转角度。^{[需要更多信息]}

末地折跃门方块

末地折跃门方块的附加字段：

• ：方块实体的根标签。
  •  Age：末地折跃门的“年龄”（刻），用于控制光柱的产生。
  •  ExitPortal：实体进入折跃门后传送的地点坐标。
    • ：X轴坐标。
    • ：Y轴坐标。
    • ：Z轴坐标。

花盆

花盆的附加字段：

• ：方块实体的根标签。
  •  PlantBlock：花盆内展示的方块。
    • 方块共通标签

熔炉

熔炉、高炉和烟熏机的附加字段：

• ：方块实体的根标签。
  •  BurnTime：燃料在耗尽前的时间（刻）。
  •  CookTime：烹饪时间（刻）。在值达到200刻（10秒）时烹饪完成，且在BurnTime达到0时自动设置为0。^{[需要测试]}
  •  BurnDuration：使用的燃料允许的总燃烧时间（刻）。
  •  StoredXPInt：储存的经验值数量。
  •  Items：容器内物品的列表。
    • ：物品及其槽位标签。
      •  Slot：物品所在槽位的编号。
      • 物品堆叠共通标签

漏斗

Additional fields for hopper:

• ：方块实体的根标签。
  •  TransferCooldown：在进行下次物品传输时剩余时间（刻），0-8的值表示不会传送。
  •  Items：容器内物品的列表。
    • ：物品及其槽位标签。
      •  Slot：物品所在槽位的编号。
      • 物品堆叠共通标签

物品展示框

物品展示框的附加字段：

• ：方块实体的根标签。
  •  ItemRotation：（可能不存在）所展示的物品的旋转角度。
  •  ItemDropChance：（可能不存在）在物品展示框被破坏后掉落所展示物品的概率。
  •  Item：所展示的物品。
    • 物品堆叠共通标签

拼图方块

拼图方块的附加字段：

• ：方块实体的根标签。
  •  name：拼图方块的名称。此拼图方块会和其他结构中目标标签里具有此值的拼图方块对齐。
  •  target：拼图方块的目标名称。此拼图方块会和其他结构中目标标签里具有此值的拼图方块对齐。
  •  target_pool：拼图方块的目标池，用于从中选择结构。
  •  final_state：这个拼图方块将变成的方块。
  •  joint：拼图方块所展示的一个结构的连接类型，只能是rollable和aligned。

唱片机

唱片机的附加字段：

• ：方块实体的根标签。
  •  RecordItem：唱片机装载的音乐唱片。
    • 物品堆叠共通标签

讲台

讲台的附加字段：

• ：方块实体的根标签。
  •  hasBook：放置书本后值为true。
  •  page：（可能不存在）书本目前的页码。
  •  totalPages：（可能不存在）书本的总页码数。
  •  book：（可能不存在）讲台上的具体物品。
    • 物品堆叠共通标签

磁石

磁石的附加字段：

• ：方块实体的根标签。
  •  trackingHandle：（可能不存在）磁石的ID。

刷怪笼

刷怪笼的附加字段：

• ：方块实体的根标签。
  • 刷怪笼共通标签

移动的方块

移动的方块的附加字段：

• ：方块实体的根标签。
  •  movingBlock：被移动的方块。
    • 方块共通标签
  •  movingBlockExtra：被移动的方块（额外值）。
    • 方块共通标签
  •  pistonPosX：活塞基底的X轴坐标。
  •  pistonPosY：活塞基底的Y轴坐标。
  •  pistonPosZ：活塞基底的Z轴坐标。
  •  movingEntity：该移动的方块储存的方块实体数据。
    • 方块实体共通标签

音符盒

音符盒的附加字段：

• ：方块实体的根标签。
  •  note：音符盒的音高。

下界反应核

下界反应核的附加字段：

• ：方块实体的根标签。
  •  HasFinished：在反应核运作结束后为true，并且变成黑色纹理。
  •  IsInitialized：在反应核被激活后为true，并且变成红色纹理。
  •  Progress：反应核的运作时间，在经过900刻（45秒）后自动设为0。

活塞

活塞的附加字段：

• ：方块实体的根标签。
  •  Progress：方块被移动的距离，值为0.0、0.5或1.0。
  •  LastProgress：未知。
  •  State：未知。
  •  NewState：未知。
  •  Sticky：是黏性活塞时为true。
  •  AttachedBlocks：需要移动的方块的坐标。
    • ：第一个方块的X轴坐标。
    • ：第一个方块的Y轴坐标。
    • ：第一个方块的Z轴坐标。
    • ：第二个方块的X轴坐标。
    • ：第二个方块的Y轴坐标。
    • ：第二个方块的Z轴坐标。
    • ：以此类推。
  •  BreakBlocks：需要被破坏（而不能被正常移动）的方块的坐标。
    • ：第一个方块的X轴坐标。
    • ：第一个方块的Y轴坐标。
    • ：第一个方块的Z轴坐标。
    • ：第二个方块的X轴坐标。
    • ：第二个方块的Y轴坐标。
    • ：第二个方块的Z轴坐标。
    • ：以此类推。

潜影盒

潜影盒的附加字段：

• ：方块实体的根标签。
  • 箱子共通标签
  •  facing：潜影盒的朝向。^{[需要更多信息]}

告示牌

告示牌的附加字段：

• ：方块实体的根标签。
  •  TextOwner：写下告示牌文本的玩家的ID。
  •  IgnoreLighting：告示牌文本被使用荧光墨囊后为true。
  •  SignTextColor：告示牌文本使用的颜色，默认为黑色。^{[需要测试]}
  •  TextIgnoreLegacyBugResolved：是否忽略此前的文本显示漏洞。^{[需要更多信息]}
  •  Text：告示牌上的文本信息。

生物头颅

生物头颅的附加字段：

• ：方块实体的根标签。
  •  SkullType：头颅的类型。^{[需要更多信息]}
  •  Rotation：头颅的朝向。^{[需要更多信息]}
  •  MouthMoving：龙首的嘴巴在动时为true。
  •  MouthTickCount：用于控制龙首的嘴巴动画。^{[需要测试]}

可疑的方块

可疑的方块的附加字段：

• ：方块实体的根标签。
  •  LootTable：所调用的战利品表json文件的路径。
  •  LootTableSeed：战利品表的种子码。
  •  brush_count：刷扫次数。
  •  brush_direction：清刷的方向，决定物品渲染的位置。可选值1-6，分别对应下上北南西东。
  •  type：用于指示该可以的方块的种类，值为minecraft:suspicious_gravel（可疑的沙砾）或minecraft:suspicious_sand（可疑的沙子）。

结构方块

结构方块的附加字段：

• ：方块实体的根标签。
  •  isPowered：结构方块被红石信号激活时为true。
  •  data：储存的数据。
  •  redstoneSaveMode：结构方块的模式。^{[需要更多信息]}
  •  xStructureOffset：结构的X轴偏移量坐标。
  •  yStructureOffset：结构的Y轴偏移量坐标。
  •  zStructureOffset：结构的Z轴偏移量坐标。
  •  xStructureSize：结构的X轴大小坐标。
  •  yStructureSize：结构的Y轴大小坐标。
  •  zStructureSize：结构的Z轴大小坐标。
  •  structureName：结构的名称。
  •  dataField：未知。
  •  ignoreEntities：结构内的实体是否被忽略。
  •  includePlayers：结构内的玩家是否被忽略。
  •  removeBlocks：结构内的方块是否被忽略。
  •  showBoundingBox：结构方块是否为创造模式下的玩家展示边界框。
  •  rotation：结构的旋转角度。^{[需要更多信息]}
  •  mirror：结构的对称情况。^{[需要更多信息]}
  •  animationMode：动画模式。^{[需要更多信息]}
  •  animationSeconds：动画的持续时间。^{[需要更多信息]}
  •  integrity：放置的结构的完整度。
  •  seed：用于结构完整性的种子，0表示随机。^{[需要测试]}

语言

• English