NBT 编码技能
使用 mc_protocol 中的 nbt! 宏来创建 NBT 数据。
何时使用
当你需要执行以下操作时,可以使用此技能:
- 为 Minecraft 数据包编码 NBT 数据
- 为聊天、动作栏、标题创建文本组件
- 构建复合 NBT 结构
基本用法
use mc_protocol::nbt;
// 简单复合结构 let compound = nbt! { "text" => "Hello", "count" => 42i32, "flag" => true, };
// 转换为网络字节 let bytes = compound.to_network_bytes();
嵌套复合结构
use mc_protocol::nbt;
let nested = nbt! { "outer" => nbt! { "inner" => 123i32, }, };
支持的类型
- i8 - Byte
- i16 - Short
- i32 - Int
- i64 - Long
- f32 - Float
- f64 - Double
- &str / String - String
- bool - Byte(0 或 1)
- NbtCompound - 嵌套复合结构
- NbtList - 同类型元素列表
文本组件(聊天/动作栏)
对于 Minecraft 文本组件(用于聊天、动作栏、标题):
use mc_protocol::nbt;
// 简单文本 let text_component = nbt! { "text" => "Hello World", };
// 带颜色 let colored = nbt! { "text" => "Red text", "color" => "red", };
最佳实践
- 始终使用 nbt! 宏,而不是手动操作字节
- 对数值字面量使用显式类型后缀(42i32、1.0f32)
- 使用 to_network_bytes() 进行协议编码(添加类型标签,无根名称)