NBT

类似Json，NBT是一种可嵌套的数据结构，基类是NbtElement

基本类型

• NbtByte

• NbtShort

• NbtInt

• NbtLong

• NbtFloat

• NbtDouble

• NbtString

boolean一般转换为byte储存(1或0)

调用对应类的newInstance方法来创建nbt

java

复制代码

NbtByte nbt1 = NbtByte.newInstance((byte)114);
NbtByte nbt2 = NbtByte.newInstance(true);
NbtString nbt3 = NbtString.newInstance("HelloWorld");

通过getValue得到其储存的值

java

复制代码

byte v1 = nbt1.getValue();
String v3 = nbt3.getValue();

基本类型一般认为是只读的，创建新实例而不是使用setValue修改已有实例

NbtCompound

类似Map<String, NbtElement>的结构，储存键值对，键是唯一的String

使用newInstance创建实例，使用put添加元素

java

复制代码

NbtCompound nbt = NbtCompound.newInstance();
nbt.put("v1", NbtInt.newInstance(114514));

使用put的重载方法快捷添加元素

java

复制代码

nbt.put("v1", (short) 114);
nbt.put("v2", 514);
nbt.put("v3", "awa");

使用get获取元素：由于元素不一定存在，返回值是Option<NbtElement>

java

复制代码

for(NbtElement ele: nbt.get("v1")) // 如果元素存在
{
    if(ele.is(NbtString.FACTORY)) // 判断元素类型
        System.out.println(ele.as(NbtString.FACTORY).getValue()); // 转换类型
}

对于已知类型的元素，使用特化的get方法

java

复制代码

Option<String> s = nbt.getString("v3");
Option<NbtCompound> child = nbt.getNbtCompound("v4");

当元素不存在或不为对应类型时，返回Option.none()

修订

当你想修改元素但不想改变原实例时，可以使用浅克隆

java

复制代码

NbtCompound child = nbt.getNBTCompound("child")
    .map(NbtCompound::clone0) // 浅克隆
    .unwrapOrGet(NbtCompound::newInstance); // 不存在则newInstance
child.put("value", 114514); // 修改
nbt.put("child", child); // 将结果放回

也可以直接使用等效的修订（revise）

java

复制代码

for(NbtCompound child: nbt.reviseNbtCompoundOrNew("child")) // 修订
{
    child.put("value", 114514); // 修改
}

修订方法的返回值为Editor，更详细的例子在Item中

NbtList

类似List<NbtElement>的结构，但所有元素必须为同一类型

使用newInstance创建实例

java

复制代码

NbtList nbt = NbtList.newInstance();
NbtList nbtListInt = NbtList.newInstance(NbtInt.newInstance(114), NbtInt.newInstance(514));

使用add和set修改元素

java

复制代码

nbt.add(NbtString.newInstance("hello"));
nbt.add(NbtString.newInstance("world"));
nbt.set(1, NbtString.newInstance("nbt"));

使用get获取元素

java

复制代码

NbtElement e1 = nbt.get(0);
String e2 = nbt.getString(1);

保存到文件

使用NbtIo类

将一个NbtElement存入文件，原则上它必须是NbtCompound

java

复制代码

NbtIo.write(nbt, dataOutput);

读取时使用NbtSizeTracker限制其大小，NbtSizeTracker.newInstance()是默认最大限度

java

复制代码

NbtElement nbt = NbtIo.read(dataInput, NbtSizeTracker.newInstance());

压缩保存

推荐使用默认的压缩格式保存：仅支持NbtCompound

java

复制代码

NbtIo.writeCompoundCompressed(nbt, stream);

java

复制代码

NbtCompound nbt = NbtIo.readCompoundCompressed(stream);