SuperAPI AI 工具集

nbt

编程与开发

查看项目

更新于 10-16 10:51

技能介绍

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() 进行协议编码(添加类型标签,无根名称)