条目中某些信息已经不符合当前版本情况。

在13w36a快照之后，NBT标签可以在/give和/summon等命令用作设定物品、生物和方块实体的高级数据。同时，它也可以给你的命令系统添加不少乐趣！

在开始学习NBT命令标签之前，你应当对这些概念有一些基本的了解：

NBT，正如其名，它是通过一个个标签来储存和读取数据的。一个标签由标签名称和数值两部分组成，两者用冒号:隔开。例如foo:1就是一个标签。

标签名称应当仅出现字母a-z,A-Z、数字0˜9和下划线_。标签名称中不允许出现空格[注 1]、中文或是特殊符号，且对大小写敏感。例如，Tag:1、tag:1和TAG:1是三个不同的标签。a_Tag_name是一个合法的标签名称，而a tag name或tag&com则不是。

多个标签需要使用逗号,隔开。例如foo:1,bar:2。

请注意：本文中所提到的标点符号均为半角符号，即英文输入法输入的符号。他们要比中文输入法输入的全角符号更窄更小。

一串标签应该被包裹在一对花括号{}中，才能被称之为NBT。例如{foo:1,bar:2}就是一串NBT。在命令中所使用的NBT标签都需要被花括号括起来。

NBT可以储存多种多样类型的数据，例如整数、实数、字符串、甚至是另一串NBT。不同的数据类型会有不同的表示数据的方法。这个表格列出了所有的数据类型：

无特定格式，可以直接填写数值。

需要在数值后面加上一个字母s。（不区分大小写）

需要在数值后面加上一个字母b。（不区分大小写）

需要在数值后面加上一个字母L。（不区分大小写）

需要在数值后面加上一个字母f。（不区分大小写） 注意：小数点并非必要，但是建议填写此类型的数值时始终带上小数点。

需要在数值后面加上一个字母d。（不区分大小写） 注意：小数点并非必要，但是建议填写此类型的数值时始终带上小数点。

文字需要用双引号""或单引号''[注 2]括起来。

数据需要用方括号[]括起来，多个数据间用逗号隔开。 对于储存多个 整型、 字节型和 长整型类型数据的标签，请见下方的 整型数组、 字节型数组和 长整型数组。

需要用方括号括起来，并以I;开头，随后即为多个用逗号分隔的 整型数据。

需要用方括号括起来，并以B;开头，随后即为多个用逗号分隔的 字节型数据（不需要带上b）。

需要用方括号括起来，并以L;开头，随后即为多个用逗号分隔的 长整型数据（不需要带上l）。

下文即将列出一些表格，来说明各个物品、实体和方块实体所含有的标签及其含义。例如：

那么你应当这样使用它：

就可以获得玩家名称为Steve的皮肤的头颅。

这里只是一个示范，你可以自行更改标签的值。

掌握这些小技巧，可以让你在学习和使用NBT标签中事半功倍：

这些标签能够用在 /give 、/item 和 /clear等有关物品操作的命令里。

这些标签只能用在物品上。对于实体形式的掉落物所用的标签，请见下文。

使用命令施加的魔咒可以忽略魔咒之间的冲突和等级限制。

注意：此标签仅提供了类似于在在生存模式中破坏方块的可能性，一些本来在生存模式中就无法被破坏的方块（例如基岩）依然无法被破坏，且不会影响方块被破坏后试图产生掉落物时的工具检查（例如使用可破坏石头的木斧来破坏石头，你将不会获得任何东西）。

1=附魔；2=属性修饰符；4=无法损坏；8=能破坏的方块；16=能放在的方块；32=其他，比如药水效果；64=皮革盔甲染色信息；128=盔甲纹饰的工具提示；255=所有资料，除了物品名称和介绍。 如果要隐藏多种信息，你只需要把那些标签的数值加起来。比如你想把附魔和属性修饰符的资料隐藏，你需要写3（即1+2）。

以下这个表格对之前的子标签提供更多细节。

如果是用在命令方块上，它执行命令时的名字会改变（能够以/say看见）。

你也可以使用网上的转换器，这里提供了一些：

RGB 换为十六进制: http://www.yellowpipe.com/yis/tools/hex-to-rgb/color-converter.php

十六进制转为十进制: http://www.statman.info/conversions/hexadecimal.html

 AttributeModifiers（的一项）

注：请不要和 Name混淆。

注：请不要和 AttributeName混淆。

注：请不要和实体的UUID混淆，它不会修改实体的UUID。

获取一个名称为“极好的剑”、拥有附魔锋利6和耐久2，且无法损坏的金剑。

获得的金剑的效果

点拨

获取一个穿在身上时提供20（ × 10）点盔甲值的鞘翅。

获得的鞘翅的效果

鞘翅穿在身上时的效果

两者的作用完全一样。

点拨

 UUID可以是任何值，但请避免在多个属性修饰符中使用相同的UUID。

NBT标签中经常有地方需要表达一个物品。例如生物手持的物品、村民买入的项目、容器中的一个物品等等。它们都使用同一种表达方式，你只需要将此表中的标签都塞进一个 复合标签里。

 Count

大多数物品中可以省略。

玩家物品栏各个槽位的编号

这些标签用于自定义药水（包括喷溅药水和滞留药水）和药箭（包括它们以弹射物形式发射出去的实体）的状态效果。它同样适用于定义实体拥有的状态效果和区域效果云生效时的状态效果。

 ShowIcon

注意：负数会被显示为白色。

这些标签是用在/summon命令生成实体或是/data命令来更改实体的NBT标签。

注意：如果那个效果和属性有关，比如迅捷，就需要同时更改实体的属性修饰符，否则状态效果将无效。

注意：这个标签不能被/data更改，通常只会在使用/summon中。若要修改骑乘者的数据，请直接在命令中指向该实体。

注意：此标签不适用于部分实体，例如牛。

注意：此标签不适用于部分实体，且各个槽位（除头部）会限制可穿戴的物品。

注意：填写的大于10.0d或小于-10.0d的值会被视为0.0d。[需要更多信息]

注意：这里的“无敌”并非绝对意义上的保证该实体永不受任何伤害，由创造模式玩家发起的攻击（近战、发射出的弹射物如箭或三叉戟、直接或经其射出的着火的箭点燃的TNT等）、虚空和/kill仍然能对该实体造成伤害。此外，虽然除此之外的所有攻击行为都会对此标签值被设定为1的实体无效（弹射物则会被直接弹开），该实体依然能被爆炸推动。 注意：对于存在需要使用攻击键进行交互的实体（如从物品展示框上取下物品），将此标签值设定为1会导致不为创造模式的玩家无法与其进行该交互行为。

注意：一些原本不会被清除的生物在此标签值被设置成0之后将可以被自然清除，比如被命名牌命名后的敌对生物。但是如果一个生物其所属的类别原本就不会被清除（比如Boss生物），那么即使此标签值设置为0也不会导致其被自然清除。

性能警告：越大的实体会造成越严重的游戏卡顿问题，尤其是Size大于32的实体。

 DropItem

性能警告：过大威力的火球在爆炸时会产生大量的运算和掉落物，导致游戏卡顿、卡死或崩溃。

性能警告：过大威力的苦力怕在爆炸时会产生大量的运算和掉落物，导致游戏卡顿、卡死或崩溃。

下表为上面所提到的子标签提供更多细节：

召唤一个下落中的草方块。

下落的草方块

点拨

召唤一只蝙蝠，上面骑着一只手持木棍、头戴皮革帽子的骷髅。

一只手持木棍、头戴皮革帽子，骑着蝙蝠的骷髅

点拨

生成一只生命上限为100（ × 50）的僵尸。

点拨

这些标签用于掉落物形式（即实体）的物品。对于在物品中使用的NBT标签，请参见上文。

玩家丢出的物品将默认带有40刻的延迟。

生成一个无法被捡起的钻石剑掉落物。

/summon minecraft:item ~ ~ ~ {Item:{id:"minecraft:diamond_sword",Count:1b},PickupDelay:32767s}

这些标签用于生成村民和流浪商人。

注意：此标签可以独自存在，并非必须搭配 buy标签。由于所有影响价格的标签都不会对此标签生效，这可以用来制造一个无论发生什么情况价格都不会有任何变动的交易。

注意：虽然允许填入任意数值，但是如果此值与 priceMultiplier最终的乘积是负数，价格并不会受到影响。

注意：所以想降价的话，请把这个值设置为负数。

注意：如果此标签为none，交易页面将无法正常打开。

（在流浪商人身上是不必要的）

注意：major_negative会导致铁傀儡对引发该言论的玩家敌对，具体取决于 Value（不小于20）。

（在流浪商人身上是不必要的）

注意：对每一个玩家，其言论导致的价格变化按如下规则计算：最终价格 = 原价 - （ Type为major_positive时的 Value值的5倍 +  Type为minor_positive时的 Value值的1倍 +  Type为trading时的 Value值的1倍 -  Type为minor_negative时的 Value值的1倍 -  Type为major_negative时的 Value值的5倍）与 priceMultiplier的值的乘积（向下取整）。

（在流浪商人身上是不必要的）

这些标签被使用于召唤盔甲架时。

注意：这同时也会导致该盔甲架无视重力，且不会受到伤害，类似{Invulnerable:1b,NoGravity:1b}）。

注意： LeftArm和 RightArm只有在 ShowArms启用时才会显示。

注意：通过这种方式变得不可见的盔甲架的碰撞箱不会显示，也不会受到伤害（类似{Invulnerable:1b}）。但是其他行为与普通盔甲架相同。

注意：输入无法通过上述过程计算出来的正数值（比如64）是允许的，但是不产生任何影响。输入负数值也会禁用某个或某些部位的交互行为，比如-1就会直接禁用所有的交互行为[需要测试]。

生成一只跳舞的盔甲架，同时带着一个苦力怕的头和一套皮革盔甲。

跳舞的苦力怕盔甲架

注意：由于聊天栏的长度限制，过长的命令可能无法在聊天栏中输入。你可以使用命令方块来突破此限制。

点拨

这些标签用于生成猪灵或疣猪兽。

注意：这个标签在下界无效。

注意：这也会使得它们不再有类似治愈中的僵尸村民那样的“抖动”的动作。

这些标签被用于生成海龟。

这些标签被用于生成区域效果云。

注意：这里的“存在时间”是从区域效果云这个实体生成出来的那一刻开始计算的，即使此时这个区域效果云还处在“等待”状态。

注意：这里的“最大存在时间”是区域云“有效”（即具有为其范围内的生物施加状态效果的能力）的时间。

性能警告：设置成正数有可能导致此区域效果云消散所需时间大幅延长。

注意：区域效果云的碰撞箱会受到这个标签的影响，其边长始终是这个标签的值，即使区域效果云此时仍处在“等待”状态，视觉上甚至看不到区域效果云的存在。 性能警告：过大的半径可能产生严重的卡顿。

性能警告：设置成正数有可能导致此区域效果云在极短的时间内以极高的速度膨胀并带来大量运算量，从而产生严重的卡顿。

性能警告：设置成正数有可能导致此区域效果云在消散前膨胀至一个较大范围，从而产生严重的卡顿。

注意：如果此标签和 Effects均为空，那么此区域效果云将始终不会对生物“生效”，这意味着所有需要区域效果云“生效”才会发挥作用的标签如 DurationOnUse和 RadiusOnUse将无法发挥作用。

生成一个满足以下条件的区域效果云：

生成的区域效果云和其生效时施加的状态效果，为便于观察区域效果云的形状已显示碰撞箱

再次警告：不要轻易将 DurationOnUse、 RadiusOnUse和 RadiusPerTick均设置为正数，特别是数值较大的正数，除非你有把握在区域效果云失控前清除它。如果确有需求，在一个新存档里进行测试并在旁边准备一个写有/kill @e[type=area_effect_cloud]的命令方块是推荐的。

这些标签用于生成烟花火箭。但是其中的一些标签也用于定义物品形式的烟花火箭或者烟火之星。

注意：如果需要让烟花火箭按照预设的Motion飞行，则设置为1。

注意：此标签及其所有子标签也适用于物品形式的烟花火箭。

 Flight

注意：这个标签的取值范围比工作台大得多，最大是127b，更大的值将会变为-128 + 其与128的差，结果大于-1的将强制变为-1，比如128变为-128，200变为-56，512变为-1。如果值为-2b或更小（包括上文提到的，“转换”过后的值），烟花火箭看上去基本不会飞行。

注意：此标签及其所有子标签也适用于烟火之星。 注意：对于烟花火箭，这个列表每增加一项，就相当于在工作台上合成时增加了一个烟火之星，这会提高烟花火箭的爆炸伤害。

注意：其他数据类型允许的值是允许的，但是会被处理为0b。

注意：这意味着，一个仅定义了一个爆炸效果的烟花火箭爆炸时是完全可能有多个颜色同时出现的。

这些标签用于/setblock或/fill命令放置方块或是/data命令更改方块实体的NBT标签。

这些标签被用于放置或修改命令方块、连锁型命令方块或循环型命令方块

放置一个保持开启的循环型命令方块，并让这个方块包含一条目的为“将自己所在位置的方块改变为条件制约且保持开启的连锁型命令方块”的命令： /setblock ~ ~ ~ repeating_command_block{auto:1b,Command:"/setblock ~ ~ ~ chain_command_block[conditional=true]{auto:1b}"}

注意：命令方块的“条件制约”模式并不是一个NBT标签，而只是一个方块状态，这一点可以从上面使用的括号的差异上看出来。

这些标签被用于放置或修改大多数容器方块，但是同样也适用于使用/summon生成或使用/data更改的运输矿车和漏斗矿车。

注意：这个标签比较的其实是容器的Lock和手持物品的Name两个标签内的“名字”的文本是否一致，而不是物品名字或者存档id是否一致。换句话说，在简体中文语言下拿着一把从没有改过名字的钻石剑是无法打开写有标签{Lock:"钻石剑"}的容器的。

注意：定义此标签后，用于定义容器原有内容物的Items将会被删除，所有内容物都会丢失。

{LootTable:"战利品表的命名空间ID值"}，详见战利品表#数据包。

注意：这个标签在机制上类似于生成世界的种子，这意味着只要这个标签值一样，同一个战利品表始终会得到完全相同的战利品，连位置都不会变。

这些标签被用于放置或修改信标。

注意：即使信标等级并不够该效果所需的等级，此标签依然会正常工作，这甚至包括原本只能在辅助效果中选择到的生命恢复。

注意：如果信标等级不够4级，此标签无效。

注意：如果所填写的状态效果的id不在上述列举的范围内，信标并不会提供该状态效果，而是会将该值改为-1[注 4]。

点拨

这些标签用于放置或修改刷怪笼，但是同样也对刷怪笼矿车有效。

注意：与通常所理解的不同，这个“范围”实际上是一个长方体。这个长方体的计算方法是以刷怪笼所在位置的西北下角（即XYZ坐标最小的那个点）为中心，其边界为X±R、Y±1、Z±R（R为SpawnRange的值），从而得到一个2R*3*2R的空间。这也意味着这个标签填入负数值和填入为其相反数的正数值没有区别。

注意：旁观模式玩家不会被检测。

注意：刷怪笼只会检测范围内与下一次将要生成的实体（储存于 SpawnData，见下）id相同的实体的数量，范围为一个以刷怪笼自身为中心的2R*8*2R为棱长的柱体区域（R为SpawnRange的值）。注意这个检测实际上检测的是实体的碰撞箱而不是实体的位置，只要碰撞箱有一部分在这个区域内即判定该实体在附近。如果附近的实体数大于这个值，刷怪笼将不会生成实体。

注意：填入负数会被视为0s。

注意：如果这个值比MinSpawnDelay还小，那么会被视为与MinSpawnDelay相等。

注意：刷怪笼会在每次成功生成实体后从 SpawnPotentials中选择一项覆盖此标签。

注意：Weight对概率的算法是，该实体被选中的概率=该实体的 Weight值/所有 Weight值之和。 警告：如果填入小于1的值，会导致游戏崩溃。

以下是一些示例：

比如带有钻石剑和锁链头盔的僵尸：

/setblock ~ ~1 ~ spawner{SpawnData:{entity:{id:"zombie",HandItems:[{id:"diamond_sword",Count:1},{}],ArmorItems:[{},{},{},{id:"minecraft:chain_helmet",Count:1}]}}}

如你所见，自定义实体NBT需要被置于SpawnData下的entity复合标签。

你可以把猪、牛或鸡的刷怪笼放置于村庄的屠夫家的后院，以便创造永恒的肉类来源，例如：/setblock ~1 ~-1 ~0 spawner{MaxNearbyEntities:10,RequiredPlayerRange:16,SpawnCount:6,SpawnRange:2,MinSpawnDelay:50,MaxSpawnDelay:200,SpawnData:{entity:{id:"minecraft:pig",Passengers:[{id:"chicken"}]}}}

此命令会放置生成“骑猪鸡”刷怪笼，不过这不重要。注意前面的SNBT：MaxNearbyEntities:10,RequiredPlayerRange:16,SpawnCount:6,SpawnRange:2,MinSpawnDelay:50,MaxSpawnDelay:200

这个SNBT描述的前2个NBT键值对MaxNearbyEntities:10和RequiredPlayerRange:16必须成对使用。本例中的参数需要16格范围内存在玩家，附近相同实体数少于10时才会生成实体。下一个是SpawnCount:6，顾名思义，其代表单次生成的数量，此处为6个。SpawnRange:2指定了生成的范围，是一个长方体区域，详见上。MinSpawnDelay:50和MaxSpawnDelay:200也是成对使用的，此处的参数会使每次生成间隔50~200游戏刻。

我们可以在刷怪笼中使用SpawnPotentials标签来生成多种实体。当计时器重置时（生成前一个生物的后一秒钟），它会随机选择一个标签进行生成。由于这些NBT包含多个生物，所以描述它们的SNBT往往是相当长的。以下是一个示例命令，看起来十分“赏心悦目”：

/setblock ~ ~1 ~1 spawner{SpawnRange:6,RequiredPlayerRange:12,SpawnCount:1,MaxNearbyEntities:6,MinSpawnDelay:100,MaxSpawnDelay:600,SpawnData:{entity:{id:"zombie",HandItems:[{id:"wooden_sword",Count:1},{}],ArmorItems:[{id:"leather_boots",Count:1},{id:"leather_leggings",Count:1,tag:{display:{color:5013401}}},{id:"leather_chestplate",Count:1,tag:{display:{color:6717235}}},{id:"player_head",Count:1,tag:{SkullOwner:Reimac}}]}},SpawnPotentials:[{data:{entity:{id:"zombie",HandItems:[{id:"wooden_sword",Count:1,tag:{Damage:58}},{}],ArmorItems:[{id:"leather_boots",Count:1},{id:"leather_leggings",Count:1,tag:{display:{color:5013401}}},{id:"leather_chestplate",Count:1,tag:{display:{color:6717235}}},{id:"player_head",Count:1,tag:{SkullOwner:Reimac}}]}},weight:4},{data:{entity:{id:"skeleton",HandItems:[{id:"iron_sword",Count:1},{}],ArmorItems:[{id:"leather_boots",Count:1,tag:{display:{color:1644825}}},{id:"leather_leggings",Count:1,tag:{display:{color:1644825}}},{id:"leather_chestplate",Count:1,tag:{display:{color:1644825}}},{id:"player_head",Count:1,tag:{SkullOwner:2insanepeople}}]}},weight:2},{data:{entity:{id:"zombie",HandItems:[{id:"stone_sword",Count:1},{}],ArmorItems:[{id:"chainmail_boots",Count:1,tag:{Enchantments:[{id:"protection"}]}},{id:"chainmail_leggings",Count:1,tag:{Enchantments:[{id:"protection"}]}},{id:"chainmail_chestplate",Count:1,tag:{Enchantments:[{id:"protection"}]}},{id:"player_head",Count:1,tag:{SkullOwner:Flixnore}}]}},weight:4},{data:{entity:{id:"zombie",Fire:2400,HandItems:[{id:"golden_sword",Count:1,tag:{Enchantments:[{id:"punch",lvl:1}]}},{}],ArmorItems:[{id:"golden_boots",Count:1},{id:"golden_leggings",Count:1},{id:"golden_chestplate",Count:1},{id:"carved_pumpkin",Count:1,tag:{Enchantments:[{id:"protection",lvl:2},{id:"fire_protection",lvl:10}]}}]}},weight:4},{data:{entity:{id:"zombie",HandItems:[{id:"iron_sword",Count:1,tag:{Enchantments:[{id:"sharpness",lvl:2}]}},{}],ArmorItems:[{id:"iron_boots",Count:1},{id:"iron_leggings",Count:1},{id:"iron_chestplate",Count:1},{id:"player_head",Count:1,tag:{ench:[{id:0,lvl:2}],SkullOwner:2zqa}}]}},weight:4},{data:{entity:{id:"zombie",HandItems:[{id:"diamond_pickaxe",Count:1,tag:{Enchantments:[{id:"sharpness",lvl:4},{id:"knockback",lvl:4},{id:"bane_of_arthropods",lvl:4},{id:"looting",lvl:3},{id:"unbreaking",lvl:3}]}},{}],ArmorItems:[{id:"diamond_boots",Count:1,tag:{Enchantments:[{id:"fire_protection",lvl:4},{id:"feather_falling",lvl:4}]}},{id:"diamond_leggings",Count:1,tag:{Enchantments:[{id:"blast_protection",lvl:4}]}},{id:"diamond_chestplate",Count:1,tag:{Enchantments:[{id:"protection",lvl:4}]}},{id:"player_head",Count:1,tag:{SkullOwner:MHF_Herobrine,Enchantments:[{id:"protection",lvl:4},{id:"fire_protection",lvl:4},{id:"blast_protection",lvl:4},{id:"thorns",lvl:3},{id:"respiration",lvl:1}]}}],CustomNameVisible:1,CustomName:'"Herobrine"',PersistenceRequired:1}},weight:1}]}

这个命令的NBT部分特别长，因为它实际上是6个独立的生物。其中有：

除了那个忍者，这里一共有5种不同的剑和盔甲。注意weight标签，其需要在每个SpawnPotentials中的entityNBT后使用。这决定了该生物被选中并生成的概率。具体的数字没有什么意义，有意义的只是数字之间的比例。例如，如果你想让所有预置生物等概率生成，则可以将每个weight都设置为1，将它们全部改成8也没有什么不同（它们之间的比例仍然是相同的），但是将除了某一个之外的所有其他weight更改为8则会使其中1/8的可能性与其余的1/8相同。在这个NBT中，默认值是4，而忍者只有2（使它被选中的可能性减半），而那只假Herobrine只有1。

语言