@xnlc/nbt: чтение и запись NBT-файлов Minecraft

import { NBTReader } from "@xnlc/nbt";
import * as fs from "node:fs";

const buffer = fs.readFileSync("level.dat");
const reader = new NBTReader(buffer);

// level.dat сжат gzip
const data = reader.read({ compressed: "gzip" });
console.log(data.Data?.Player?.Pos); // [number, number, number]

import { NBTWriter } from "@xnlc/nbt";
import * as fs from "node:fs";

const writer = new NBTWriter();

const nbt = {
  Data: {
    DayTime: 1000,
    GameType: 1,
    LevelName: "My World",
    SpawnX: 0,
    SpawnY: 64,
    SpawnZ: 0,
    Hardcore: 0,
    version: 19133,
    DataVersion: 3465,
    // Long: bigint
    Time: 1000n,
    // Byte Array: массив чисел от -128 до 127
    HeightMap: new Array(256).fill(0),
    // Int Array
    ServerBrands: ["vanilla"],
    // List: { type, values }
    Sections: {
      type: 10, // TAG_Compound
      values: []
    }
  }
};

const buffer = writer.write(nbt, { compressed: "gzip" });
fs.writeFileSync("level.dat", buffer);

import { NBTReader } from "@xnlc/nbt";
import * as fs from "node:fs";
import * as path from "node:path";

const serversDat = path.join(process.env.APPDATA, ".minecraft", "servers.dat");
const buffer = fs.readFileSync(serversDat);

const reader = new NBTReader(buffer);
const data = reader.read(); // без сжатия

const servers = data.servers.values; // NBTList
for (const server of servers) {
  console.log(`${server.name}: ${server.ip}`);
}

import { NBTReader } from "@xnlc/nbt";
import * as fs from "node:fs";

const buffer = fs.readFileSync("saves/MyWorld/level.dat");

const reader = new NBTReader(buffer);
const data = reader.read({ compressed: "gzip" });

console.log("Имя мира:", data.Data?.LevelName);
console.log("Версия данных:", data.Data?.DataVersion);
console.log("Режим:", data.Data?.GameType);
console.log("Сложность:", data.Data?.Difficulty);

import { NBTWriter } from "@xnlc/nbt";

const writer = new NBTWriter();

const player = {
  Pos: [100.5, 64.0, -200.5],        // TAG_List Double (автовывод: Float)
  Rotation: [90.0, 0.0],              // TAG_List Float
  Health: 20,                          // TAG_Int
  HurtTime: 0,                         // TAG_Short (0 в диапазоне Short)
  OnGround: 1,                         // TAG_Byte
  Inventory: {
    type: 10,                          // TAG_Compound
    values: []
  }
};

// Явное указание типа: для Double используйте строки или другие методы
// Примечание: текущая версия выводит Float для дробных чисел

const buffer = writer.write(player, { compressed: "gzip", rootName: "" });
fs.writeFileSync("player.dat", buffer);

import { TagType } from "@xnlc/nbt";

// Значения enum:
// TAG_End = 0, TAG_Byte = 1, TAG_Short = 2, TAG_Int = 3,
// TAG_Long = 4, TAG_Float = 5, TAG_Double = 6,
// TAG_Byte_Array = 7, TAG_String = 8, TAG_List = 9,
// TAG_Compound = 10, TAG_Int_Array = 11, TAG_Long_Array = 12

import type { NBTValue, NBTCompound, NBTList } from "@xnlc/nbt";

// NBTValue = number | bigint | string | NBTValue[] | NBTList | { [key: string]: NBTValue } | null
// NBTCompound = { [key: string]: NBTValue }
// NBTList = { type: TagType, values: NBTValue[] }