NBT（Named Binary Tag）是 Minecraft 中用于存储数据的一种结构化格式，广泛用于指令、存档、实体、物品等数据存储。
NBT 可以修改物品、实体、方块等的属性，例如附魔、名称、耐久度等。
1. NBT 基本结构
NBT 数据由 键值对（Key-Value Pairs） 组成，格式为 {键:值, 键:值, ...}，支持多种数据类型：
| 数据类型 | 示例 | 说明 |
|---|---|---|
Byte | 1b | 字节（-128~127） |
Short | 100s | 短整数（-32768~32767） |
Int | 1000 | 整数 |
Long | 1000L | 长整数 |
Float | 3.14f | 单精度浮点数 |
Double | 3.14d | 双精度浮点数 |
String | "Hello" | 字符串（必须用引号） |
Compound | {key:value} | 复合标签（嵌套数据） |
List | [value1, value2] | 列表（同类型数据） |
ByteArray | [B;1b,2b] | 字节数组 |
IntArray | [I;1,2,3] | 整数数组 |
LongArray | [L;1L,2L] | 长整数数组 |
2. 常用 NBT 标签分类
(1) 物品（Item）NBT
| 标签 | 用途 | 示例 |
|---|---|---|
Count | 物品数量 | {Count:64b} |
Damage | 耐久度 | {Damage:10} |
tag | 物品额外数据 | {tag:{display:{Name:'"Super Sword"'}}} |
Enchantments | 附魔 | {Enchantments:[{id:"sharpness",lvl:5}]} |
display | 显示名称/Lore | {display:{Name:'"Legendary Sword"',Lore:['"Very Sharp!"']}} |
Unbreakable | 无法破坏 | {Unbreakable:1b} |
CanDestroy | 可破坏的方块 | {CanDestroy:["minecraft:stone"]} |
CanPlaceOn | 可放置的方块 | {CanPlaceOn:["minecraft:dirt"]} |
示例（给予一把锋利V钻石剑）：
/give @p minecraft:diamond_sword 1 0 {Enchantments:[{id:"minecraft:sharpness",lvl:5s}],Unbreakable:1b,display:{Name:'"God Sword"',Lore:['"This sword is OP!"]}}(2) 实体（Entity）NBT
| 标签 | 用途 | 示例 |
|---|---|---|
CustomName | 自定义名称 | {CustomName:'"Boss Zombie"'} |
CustomNameVisible | 名称是否可见 | {CustomNameVisible:1b} |
Health | 生命值 | {Health:100f} |
Attributes | 属性修改 | {Attributes:[{Name:"generic.max_health",Base:100}]} |
NoAI | 禁用AI | {NoAI:1b} |
Silent | 静音 | {Silent:1b} |
Invulnerable | 无敌 | {Invulnerable:1b} |
PersistenceRequired | 不被清除 | {PersistenceRequired:1b} |
Motion | 运动速度 | {Motion:[0.0,1.0,0.0]} |
Rotation | 旋转角度 | {Rotation:[90f,0f]} |
示例（生成一个无敌的僵尸Boss）：
/summon minecraft:zombie ~ ~ ~ {CustomName:'"Boss Zombie"',CustomNameVisible:1b,Health:100f,Attributes:[{Name:"generic.max_health",Base:100}],Invulnerable:1b}(3) 方块（Block）NBT
| 标签 | 用途 | 示例 |
|---|---|---|
Items | 容器内容 | {Items:[{id:"minecraft:diamond",Count:1,Slot:0}]} |
Lock | 容器锁 | {Lock:"Secret"} |
CustomName | 容器名称 | {CustomName:'"Treasure Chest"'} |
RepairCost | 铁砧修复消耗 | {RepairCost:10} |
示例（放置一个带物品的箱子）：
/setblock ~ ~ ~ minecraft:chest{Items:[{id:"minecraft:diamond",Count:5,Slot:0}]}(4) 玩家（Player）NBT
| 标签 | 用途 | 示例 |
|---|---|---|
Inventory | 玩家背包 | {Inventory:[{id:"minecraft:diamond_sword",Count:1,Slot:0}]} |
EnderItems | 末影箱物品 | {EnderItems:[{id:"minecraft:emerald",Count:64,Slot:0}]} |
FoodLevel | 饱食度 | {foodLevel:20} |
XpLevel | 经验等级 | {XpLevel:30} |
示例（修改玩家背包）：
/data merge entity @p {Inventory:[{id:"minecraft:diamond",Count:64,Slot:0}]}3. 如何查看 NBT 数据？
- 使用
/data get指令：
/data get entity @p Inventory # 查看玩家背包数据
/data get block ~ ~ ~ Items # 查看箱子内容- 使用 F3 + I（Java版）：
手持物品时按F3 + I复制其 NBT 数据。
4. 高级 NBT 应用
(1) 自定义刷怪笼
/setblock ~ ~ ~ minecraft:spawner{SpawnData:{id:"minecraft:zombie",CustomName:'"Boss"',Health:100f},Delay:20,MinSpawnDelay:10,MaxSpawnDelay:100}(2) 自定义药水效果
/give @p minecraft:potion{Potion:"minecraft:strong_strength",CustomPotionEffects:[{Id:1,Duration:600,Amplifier:2}]}(3) 自定义村民交易
/summon minecraft:villager ~ ~ ~ {VillagerData:{profession:"minecraft:librarian"},Offers:{Recipes:[{buy:{id:"minecraft:emerald",Count:1},sell:{id:"minecraft:enchanted_book",Count:1,tag:{StoredEnchantments:[{id:"sharpness",lvl:5}]}}}]}}5. 总结
| 用途 | 关键 NBT 标签 |
|---|---|
| 物品 | Enchantments, display, Unbreakable |
| 实体 | CustomName, Attributes, NoAI |
| 方块 | Items, Lock, CustomName |
| 玩家 | Inventory, EnderItems, XpLevel |
NBT 是 Minecraft 数据存储的核心，掌握它可以实现 自定义武器、特殊生物、自动化存储系统 等高级功能！