mca-json 1.0.0

package/dist/lib/chunk.d.ts

@@ -0,0 +1,112 @@
+/**
+ * A Chunk is a 16 x 383 x 16 portion of a Minecraft world. It's stored as NBT
+ * data in sections of 16 blocks in the Y axis. The Y axis range is from -64 to
+ * 320.
+ *
+ * This class helps manipulate the chunk data.
+ */
+import { BlockInstance } from '../block/block';
+import { Coords2d, Coords3d } from '../types/coords';
+import { NbtBase } from '../nbt/nbt-base';
+import { NbtCompound } from '../nbt/nbt-compound';
+import { NbtList } from '../nbt/nbt-list';
+export declare class Chunk {
+    private dataVersion;
+    private parsedSections;
+    private rootNbt;
+    /**
+     * Constructs a new chunk object from a given NBT tag.
+     *
+     * @param root the NBT tag containing the chunk's data
+     */
+    constructor(root: NbtBase<any>);
+    /**
+     * Gets the block entity list tag.
+     */
+    blockEntities(): NbtList<NbtCompound> | undefined;
+    /**
+     * Gets a block's entity data
+     */
+    blockEntityData(coords: Coords3d): NbtCompound | undefined;
+    /**
+     * Gets the chunk's location in chunk coordinates.
+     *
+     * Returns a tuple of the chunk's X and Z coordinates.
+     */
+    chunkCoordinates(): Coords2d | undefined;
+    /**
+     * Returns a unique id for this chunk. It's just the chunk's X and Z
+     * coordinates in number of chunks from the world's origin.
+     */
+    chunkKey(): string | undefined;
+    /**
+     * Returns an instance of a block at a given location using world
+     * coordinates.
+     */
+    getBlock(coords: Coords3d): BlockInstance;
+    /**
+     * Finds all blocks by a given name. Provides [X, Y, Z] real-world coordinates.
+     */
+    findBlocksByName(name: string): Coords3d[];
+    /**
+     * See how long the chunk has been inhabited. This number increases by 1
+     * for each game tick, which is 20 times per second when a player is
+     * nearby. It can also advance slowly when players are farther away.
+     *
+     * On newly created chunks, this value does not match what is expected. Use
+     * this with caution.
+     */
+    inhabitedTime(): bigint | undefined;
+    /**
+     * Converts the chunk data to a JSON object.
+     */
+    toObject(): any;
+    /**
+     * Returns a list of unique block names in the chunk as a Set.
+     */
+    uniqueBlockNames(): Set<string>;
+    /**
+     * Gets the chunk's location in real-world coordinates.
+     *
+     * Returns a tuple of the starting block's world X and Z coordinates. The
+     * chunk contains the range from X to X+15 (going East), Y to Y+15 (going
+     * up), and Z to Z+15 (going South).
+     */
+    worldCoordinates(): Coords2d | undefined;
+    /**
+     * Checks if the given NBT tag is a valid chunk root tag.
+     * @param tag the tag to check.
+     */
+    private isValidChunkRoot;
+    /**
+     * Checks if the given NBT tag is a valid chunk section tag, containing a list of chunk sections.
+     */
+    private isValidChunkSection;
+    /**
+     * Returns a list of names within a palette tag.
+     */
+    private paletteNameList;
+    /**
+     * Parses a section tag into BlockData.
+     *
+     * Uses a cached version if available;
+     */
+    private parseSection;
+    /**
+     * Finds the BlockStates tag in a section.
+     */
+    private sectionBlockStates;
+    /**
+     * Finds the block palette in a section.
+     */
+    private sectionPalette;
+    /**
+     * Returns all sections
+     */
+    private sectionsTag;
+    /**
+     * Returns the Y coordinate of a section, which goes from 0 to 256. If you want the world coordinate, pass true to get -128 to 4031.
+     */
+    private sectionY;
+}
+//# sourceMappingURL=chunk.d.ts.map

package/dist/lib/chunk.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunk.d.ts","sourceRoot":"","sources":["../../src/lib/chunk.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAS,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAEtD,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAElD,OAAO,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAM1C,qBAAa,KAAK;IACd,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,cAAc,CAAqC;IAC3D,OAAO,CAAC,OAAO,CAAc;IAE7B;;;;OAIG;gBACS,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC;IAW9B;;OAEG;IACH,aAAa,IAAI,OAAO,CAAC,WAAW,CAAC,GAAG,SAAS;IASjD;;OAEG;IACH,eAAe,CAAC,MAAM,EAAE,QAAQ,GAAG,WAAW,GAAG,SAAS;IAc1D;;;;OAIG;IACH,gBAAgB,IAAI,QAAQ,GAAG,SAAS;IAmBxC;;;OAGG;IACH,QAAQ,IAAI,MAAM,GAAG,SAAS;IAU9B;;;OAGG;IACH,QAAQ,CAAC,MAAM,EAAE,QAAQ,GAAG,aAAa;IAuCzC;;OAEG;IACH,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,EAAE;IAoC1C;;;;;;;OAOG;IACH,aAAa,IAAI,MAAM,GAAG,SAAS;IASnC;;OAEG;IACH,QAAQ,IAAI,GAAG;IAIf;;OAEG;IACH,gBAAgB,IAAI,GAAG,CAAC,MAAM,CAAC;IAoB/B;;;;;;OAMG;IACH,gBAAgB,IAAI,QAAQ,GAAG,SAAS;IAUxC;;;OAGG;IACH,OAAO,CAAC,gBAAgB;IAIxB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAe3B;;OAEG;IACH,OAAO,CAAC,eAAe;IAYvB;;;;OAIG;IACH,OAAO,CAAC,YAAY;IA2BpB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAS1B;;OAEG;IACH,OAAO,CAAC,cAAc;IAWtB;;OAEG;IACH,OAAO,CAAC,WAAW;IAcnB;;OAEG;IACH,OAAO,CAAC,QAAQ;CAenB"}

package/dist/lib/chunk.js

@@ -0,0 +1,299 @@
+/**
+ * A Chunk is a 16 x 383 x 16 portion of a Minecraft world. It's stored as NBT
+ * data in sections of 16 blocks in the Y axis. The Y axis range is from -64 to
+ * 320.
+ *
+ * This class helps manipulate the chunk data.
+ */
+import { Block } from '../block/block';
+import { BlockData } from './block-data';
+import { NbtTagType } from '../nbt/nbt-tag-type';
+export class Chunk {
+    dataVersion;
+    parsedSections = new Map();
+    rootNbt;
+    /**
+     * Constructs a new chunk object from a given NBT tag.
+     *
+     * @param root the NBT tag containing the chunk's data
+     */
+    constructor(root) {
+        if (!this.isValidChunkRoot(root)) {
+            throw new Error('Invalid chunk root tag');
+        }
+        this.rootNbt = root;
+        // 1.2.1 does not have this tag.
+        this.dataVersion = root.findChild('DataVersion')?.data ?? 0;
+    }
+    /**
+     * Gets the block entity list tag.
+     */
+    blockEntities() {
+        return (
+        // 1.18+
+        this.rootNbt.findChild('block_entities') ||
+            // up to 1.17
+            this.rootNbt.findChild('Level/TileEntities'));
+    }
+    /**
+     * Gets a block's entity data
+     */
+    blockEntityData(coords) {
+        return this.blockEntities()?.data.find((tag) => {
+            const x = tag.findChild('x');
+            const y = tag.findChild('y');
+            const z = tag.findChild('z');
+            return (x?.data === coords[0] &&
+                y?.data === coords[1] &&
+                z?.data === coords[2]);
+        });
+    }
+    /**
+     * Gets the chunk's location in chunk coordinates.
+     *
+     * Returns a tuple of the chunk's X and Z coordinates.
+     */
+    chunkCoordinates() {
+        const x = 
+        // 1.18+
+        this.rootNbt.findChild('xPos') ||
+            // up to 1.17
+            this.rootNbt.findChild('Level/xPos');
+        const z = 
+        // 1.18+
+        this.rootNbt.findChild('zPos') ||
+            // up to 1.17
+            this.rootNbt.findChild('Level/zPos');
+        if (typeof x?.data !== 'number' || typeof z?.data !== 'number') {
+            return;
+        }
+        return [x.data, z.data];
+    }
+    /**
+     * Returns a unique id for this chunk. It's just the chunk's X and Z
+     * coordinates in number of chunks from the world's origin.
+     */
+    chunkKey() {
+        const coords = this.chunkCoordinates();
+        if (!coords) {
+            return;
+        }
+        return `${coords[0]},${coords[1]}`;
+    }
+    /**
+     * Returns an instance of a block at a given location using world
+     * coordinates.
+     */
+    getBlock(coords) {
+        const sectionY = Math.floor(coords[1] / 16);
+        const sectionsTag = this.sectionsTag();
+        if (!sectionsTag) {
+            throw new Error('Invalid chunk - no sections found');
+        }
+        const section = sectionsTag.data.find((section) => this.sectionY(section) === sectionY);
+        if (!section) {
+            throw new Error('Block not found in any sections');
+        }
+        const blockData = this.parseSection(section);
+        const [xWorld, zWorld] = this.worldCoordinates() || [0, 0];
+        const xChunk = coords[0] - xWorld;
+        const zChunk = coords[2] - zWorld;
+        if (xChunk < 0 || xChunk > 15) {
+            throw new Error('X coordinate out of bounds');
+        }
+        if (zChunk < 0 || zChunk > 15) {
+            throw new Error('Z coordinate out of bounds');
+        }
+        const index = blockData.chunkCoordinatesToIndex([
+            xChunk,
+            coords[1] % 16,
+            zChunk,
+        ]);
+        const name = blockData.getBlockByIndex(index);
+        return Block.create(name, coords, this.blockEntityData(coords));
+    }
+    /**
+     * Finds all blocks by a given name. Provides [X, Y, Z] real-world coordinates.
+     */
+    findBlocksByName(name) {
+        const sectionsTag = this.sectionsTag();
+        if (!sectionsTag) {
+            return [];
+        }
+        return sectionsTag.data.flatMap((section) => {
+            const yWorld = this.sectionY(section, true);
+            const [xWorld, zWorld] = this.worldCoordinates() || [0, 0];
+            const palette = this.sectionPalette(section);
+            if (palette === undefined) {
+                return [];
+            }
+            // // If it's not in the palette, we can skip processing.
+            if (!this.paletteNameList(palette).includes(name)) {
+                return [];
+            }
+            const blockData = this.parseSection(section);
+            return blockData.findBlocksByName(name).map((index) => {
+                const chunkCoordinates = blockData.indexToChunkCoordinates(index);
+                return [
+                    xWorld + chunkCoordinates[0],
+                    yWorld + chunkCoordinates[1],
+                    zWorld + chunkCoordinates[2],
+                ];
+            });
+        });
+    }
+    /**
+     * See how long the chunk has been inhabited. This number increases by 1
+     * for each game tick, which is 20 times per second when a player is
+     * nearby. It can also advance slowly when players are farther away.
+     *
+     * On newly created chunks, this value does not match what is expected. Use
+     * this with caution.
+     */
+    inhabitedTime() {
+        return (
+        // 1.18+
+        this.rootNbt.findChild('InhabitedTime')?.data ||
+            // up to 1.17
+            this.rootNbt.findChild('Level/InhabitedTime')?.data);
+    }
+    /**
+     * Converts the chunk data to a JSON object.
+     */
+    toObject() {
+        return this.rootNbt.toObject();
+    }
+    /**
+     * Returns a list of unique block names in the chunk as a Set.
+     */
+    uniqueBlockNames() {
+        const sectionsTag = this.sectionsTag();
+        if (!sectionsTag) {
+            return new Set();
+        }
+        const names = sectionsTag.data.flatMap((section) => {
+            const palette = this.sectionPalette(section);
+            if (!palette) {
+                return [];
+            }
+            return this.paletteNameList(palette);
+        });
+        return new Set(names);
+    }
+    /**
+     * Gets the chunk's location in real-world coordinates.
+     *
+     * Returns a tuple of the starting block's world X and Z coordinates. The
+     * chunk contains the range from X to X+15 (going East), Y to Y+15 (going
+     * up), and Z to Z+15 (going South).
+     */
+    worldCoordinates() {
+        const result = this.chunkCoordinates();
+        if (!result) {
+            return;
+        }
+        return [result[0] * 16, result[1] * 16];
+    }
+    /**
+     * Checks if the given NBT tag is a valid chunk root tag.
+     * @param tag the tag to check.
+     */
+    isValidChunkRoot(nbt) {
+        return nbt.isCompound('');
+    }
+    /**
+     * Checks if the given NBT tag is a valid chunk section tag, containing a list of chunk sections.
+     */
+    isValidChunkSection(nbt) {
+        if (!nbt.isList(NbtTagType.COMPOUND)) {
+            return false;
+        }
+        // Java uses "sections", unsure what uses "Sections"
+        if (nbt.name.toLowerCase() === 'sections') {
+            return true;
+        }
+        return false;
+    }
+    /**
+     * Returns a list of names within a palette tag.
+     */
+    paletteNameList(palette) {
+        if (!palette.isList(NbtTagType.COMPOUND)) {
+            return [];
+        }
+        return palette.data.map((tag) => {
+            const name = tag.findChild('Name');
+            return name?.data ?? '';
+        });
+    }
+    /**
+     * Parses a section tag into BlockData.
+     *
+     * Uses a cached version if available;
+     */
+    parseSection(section) {
+        if (this.parsedSections.has(section)) {
+            return this.parsedSections.get(section);
+        }
+        const palette = this.sectionPalette(section);
+        if (!palette) {
+            throw new Error('Invalid chunk section - no palette found');
+        }
+        const blockStates = this.sectionBlockStates(section);
+        if (!blockStates) {
+            throw new Error('Invalid chunk section - no block states found');
+        }
+        const blockData = BlockData.fromPaletteBlockStates(this.dataVersion, palette, blockStates);
+        this.parsedSections.set(section, blockData);
+        return blockData;
+    }
+    /**
+     * Finds the BlockStates tag in a section.
+     */
+    sectionBlockStates(section) {
+        return (
+        // 1.18+
+        section.findChild('block_states/data') ||
+            // up to 1.17
+            section.findChild('BlockStates'));
+    }
+    /**
+     * Finds the block palette in a section.
+     */
+    sectionPalette(section) {
+        return (
+        // 1.18+
+        section.findChild('block_states/palette') ||
+            // up to 1.17
+            section.findChild('Palette'));
+    }
+    /**
+     * Returns all sections
+     */
+    sectionsTag() {
+        const section = 
+        // 1.18+
+        this.rootNbt.findChild('sections') ||
+            // up to 1.17
+            this.rootNbt.findChild('Level/Sections');
+        if (section && this.isValidChunkSection(section)) {
+            return section;
+        }
+        return;
+    }
+    /**
+     * Returns the Y coordinate of a section, which goes from 0 to 256. If you want the world coordinate, pass true to get -128 to 4031.
+     */
+    sectionY(section, useWorldCoordinate = false) {
+        const ySection = section.findChild('Y')?.data || 0;
+        if (!useWorldCoordinate) {
+            return ySection;
+        }
+        let yWorld = ySection * 16;
+        if (yWorld >= 4032) {
+            yWorld -= 4096;
+        }
+        return yWorld;
+    }
+}
+//# sourceMappingURL=chunk.js.map

package/dist/lib/chunk.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunk.js","sourceRoot":"","sources":["../../src/lib/chunk.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * A Chunk is a 16 x 383 x 16 portion of a Minecraft world. It's stored as NBT\n * data in sections of 16 blocks in the Y axis. The Y axis range is from -64 to\n * 320.\n *\n * This class helps manipulate the chunk data.\n */\n\nimport { Block, BlockInstance } from '../block/block';\nimport { BlockData } from './block-data';\nimport { Coords2d, Coords3d } from '../types/coords';\nimport { NbtBase } from '../nbt/nbt-base';\nimport { NbtCompound } from '../nbt/nbt-compound';\nimport { NbtInt } from '../nbt/nbt-int';\nimport { NbtList } from '../nbt/nbt-list';\nimport { NbtLong } from '../nbt/nbt-long';\nimport { NbtLongArray } from '../nbt/nbt-long-array';\nimport { NbtString } from '../nbt/nbt-string';\nimport { NbtTagType } from '../nbt/nbt-tag-type';\n\nexport class Chunk {\n    private dataVersion: number;\n    private parsedSections = new Map<NbtCompound, BlockData>();\n    private rootNbt: NbtCompound;\n\n    /**\n     * Constructs a new chunk object from a given NBT tag.\n     *\n     * @param root the NBT tag containing the chunk's data\n     */\n    constructor(root: NbtBase<any>) {\n        if (!this.isValidChunkRoot(root)) {\n            throw new Error('Invalid chunk root tag');\n        }\n\n        this.rootNbt = root;\n\n        // 1.2.1 does not have this tag.\n        this.dataVersion = root.findChild<NbtInt>('DataVersion')?.data ?? 0;\n    }\n\n    /**\n     * Gets the block entity list tag.\n     */\n    blockEntities(): NbtList<NbtCompound> | undefined {\n        return (\n            // 1.18+\n            this.rootNbt.findChild<NbtList<NbtCompound>>('block_entities') ||\n            // up to 1.17\n            this.rootNbt.findChild<NbtList<NbtCompound>>('Level/TileEntities')\n        );\n    }\n\n    /**\n     * Gets a block's entity data\n     */\n    blockEntityData(coords: Coords3d): NbtCompound | undefined {\n        return this.blockEntities()?.data.find((tag: NbtCompound) => {\n            const x = tag.findChild<NbtInt>('x');\n            const y = tag.findChild<NbtInt>('y');\n            const z = tag.findChild<NbtInt>('z');\n\n            return (\n                x?.data === coords[0] &&\n                y?.data === coords[1] &&\n                z?.data === coords[2]\n            );\n        });\n    }\n\n    /**\n     * Gets the chunk's location in chunk coordinates.\n     *\n     * Returns a tuple of the chunk's X and Z coordinates.\n     */\n    chunkCoordinates(): Coords2d | undefined {\n        const x =\n            // 1.18+\n            this.rootNbt.findChild<NbtInt>('xPos') ||\n            // up to 1.17\n            this.rootNbt.findChild<NbtInt>('Level/xPos');\n        const z =\n            // 1.18+\n            this.rootNbt.findChild<NbtInt>('zPos') ||\n            // up to 1.17\n            this.rootNbt.findChild<NbtInt>('Level/zPos');\n\n        if (typeof x?.data !== 'number' || typeof z?.data !== 'number') {\n            return;\n        }\n\n        return [x.data, z.data];\n    }\n\n    /**\n     * Returns a unique id for this chunk. It's just the chunk's X and Z\n     * coordinates in number of chunks from the world's origin.\n     */\n    chunkKey(): string | undefined {\n        const coords = this.chunkCoordinates();\n\n        if (!coords) {\n            return;\n        }\n\n        return `${coords[0]},${coords[1]}`;\n    }\n\n    /**\n     * Returns an instance of a block at a given location using world\n     * coordinates.\n     */\n    getBlock(coords: Coords3d): BlockInstance {\n        const sectionY = Math.floor(coords[1] / 16);\n        const sectionsTag = this.sectionsTag();\n\n        if (!sectionsTag) {\n            throw new Error('Invalid chunk - no sections found');\n        }\n\n        const section = sectionsTag.data.find(\n            (section) => this.sectionY(section) === sectionY\n        );\n\n        if (!section) {\n            throw new Error('Block not found in any sections');\n        }\n\n        const blockData = this.parseSection(section);\n        const [xWorld, zWorld] = this.worldCoordinates() || [0, 0];\n        const xChunk = coords[0] - xWorld;\n        const zChunk = coords[2] - zWorld;\n\n        if (xChunk < 0 || xChunk > 15) {\n            throw new Error('X coordinate out of bounds');\n        }\n\n        if (zChunk < 0 || zChunk > 15) {\n            throw new Error('Z coordinate out of bounds');\n        }\n\n        const index = blockData.chunkCoordinatesToIndex([\n            xChunk,\n            coords[1] % 16,\n            zChunk,\n        ]);\n        const name = blockData.getBlockByIndex(index);\n\n        return Block.create(name, coords, this.blockEntityData(coords));\n    }\n\n    /**\n     * Finds all blocks by a given name. Provides [X, Y, Z] real-world coordinates.\n     */\n    findBlocksByName(name: string): Coords3d[] {\n        const sectionsTag = this.sectionsTag();\n\n        if (!sectionsTag) {\n            return [];\n        }\n\n        return sectionsTag.data.flatMap((section) => {\n            const yWorld = this.sectionY(section, true);\n            const [xWorld, zWorld] = this.worldCoordinates() || [0, 0];\n            const palette = this.sectionPalette(section);\n\n            if (palette === undefined) {\n                return [];\n            }\n\n            // // If it's not in the palette, we can skip processing.\n            if (!this.paletteNameList(palette).includes(name)) {\n                return [];\n            }\n\n            const blockData = this.parseSection(section);\n\n            return blockData.findBlocksByName(name).map((index): Coords3d => {\n                const chunkCoordinates =\n                    blockData.indexToChunkCoordinates(index);\n\n                return [\n                    xWorld + chunkCoordinates[0],\n                    yWorld + chunkCoordinates[1],\n                    zWorld + chunkCoordinates[2],\n                ];\n            });\n        });\n    }\n\n    /**\n     * See how long the chunk has been inhabited. This number increases by 1\n     * for each game tick, which is 20 times per second when a player is\n     * nearby. It can also advance slowly when players are farther away.\n     *\n     * On newly created chunks, this value does not match what is expected. Use\n     * this with caution.\n     */\n    inhabitedTime(): bigint | undefined {\n        return (\n            // 1.18+\n            this.rootNbt.findChild<NbtLong>('InhabitedTime')?.data ||\n            // up to 1.17\n            this.rootNbt.findChild<NbtLong>('Level/InhabitedTime')?.data\n        );\n    }\n\n    /**\n     * Converts the chunk data to a JSON object.\n     */\n    toObject(): any {\n        return this.rootNbt.toObject();\n    }\n\n    /**\n     * Returns a list of unique block names in the chunk as a Set.\n     */\n    uniqueBlockNames(): Set<string> {\n        const sectionsTag = this.sectionsTag();\n\n        if (!sectionsTag) {\n            return new Set();\n        }\n\n        const names = sectionsTag.data.flatMap((section) => {\n            const palette = this.sectionPalette(section);\n\n            if (!palette) {\n                return [];\n            }\n\n            return this.paletteNameList(palette);\n        });\n\n        return new Set(names);\n    }\n\n    /**\n     * Gets the chunk's location in real-world coordinates.\n     *\n     * Returns a tuple of the starting block's world X and Z coordinates. The\n     * chunk contains the range from X to X+15 (going East), Y to Y+15 (going\n     * up), and Z to Z+15 (going South).\n     */\n    worldCoordinates(): Coords2d | undefined {\n        const result = this.chunkCoordinates();\n\n        if (!result) {\n            return;\n        }\n\n        return [result[0] * 16, result[1] * 16];\n    }\n\n    /**\n     * Checks if the given NBT tag is a valid chunk root tag.\n     * @param tag the tag to check.\n     */\n    private isValidChunkRoot(nbt: NbtBase<any>): nbt is NbtCompound {\n        return nbt.isCompound('');\n    }\n\n    /**\n     * Checks if the given NBT tag is a valid chunk section tag, containing a list of chunk sections.\n     */\n    private isValidChunkSection(\n        nbt: NbtBase<any>\n    ): nbt is NbtList<NbtCompound> {\n        if (!nbt.isList(NbtTagType.COMPOUND)) {\n            return false;\n        }\n\n        // Java uses \"sections\", unsure what uses \"Sections\"\n        if (nbt.name.toLowerCase() === 'sections') {\n            return true;\n        }\n\n        return false;\n    }\n\n    /**\n     * Returns a list of names within a palette tag.\n     */\n    private paletteNameList(palette: NbtBase<any>): string[] {\n        if (!palette.isList(NbtTagType.COMPOUND)) {\n            return [];\n        }\n\n        return (palette as NbtList<NbtCompound>).data.map((tag) => {\n            const name = tag.findChild<NbtString>('Name');\n\n            return name?.data ?? '';\n        });\n    }\n\n    /**\n     * Parses a section tag into BlockData.\n     *\n     * Uses a cached version if available;\n     */\n    private parseSection(section: NbtCompound): BlockData {\n        if (this.parsedSections.has(section)) {\n            return this.parsedSections.get(section)!;\n        }\n\n        const palette = this.sectionPalette(section);\n\n        if (!palette) {\n            throw new Error('Invalid chunk section - no palette found');\n        }\n\n        const blockStates = this.sectionBlockStates(section);\n\n        if (!blockStates) {\n            throw new Error('Invalid chunk section - no block states found');\n        }\n\n        const blockData = BlockData.fromPaletteBlockStates(\n            this.dataVersion,\n            palette,\n            blockStates\n        );\n        this.parsedSections.set(section, blockData);\n\n        return blockData;\n    }\n\n    /**\n     * Finds the BlockStates tag in a section.\n     */\n    private sectionBlockStates(section: NbtCompound): NbtLongArray | undefined {\n        return (\n            // 1.18+\n            section.findChild<NbtLongArray>('block_states/data') ||\n            // up to 1.17\n            section.findChild<NbtLongArray>('BlockStates')\n        );\n    }\n\n    /**\n     * Finds the block palette in a section.\n     */\n    private sectionPalette(\n        section: NbtCompound\n    ): NbtList<NbtCompound> | undefined {\n        return (\n            // 1.18+\n            section.findChild<NbtList<NbtCompound>>('block_states/palette') ||\n            // up to 1.17\n            section.findChild<NbtList<NbtCompound>>('Palette')\n        );\n    }\n\n    /**\n     * Returns all sections\n     */\n    private sectionsTag(): NbtList<NbtCompound> | undefined {\n        const section =\n            // 1.18+\n            this.rootNbt.findChild<NbtList<NbtCompound>>('sections') ||\n            // up to 1.17\n            this.rootNbt.findChild<NbtList<NbtCompound>>('Level/Sections');\n\n        if (section && this.isValidChunkSection(section)) {\n            return section;\n        }\n\n        return;\n    }\n\n    /**\n     * Returns the Y coordinate of a section, which goes from 0 to 256. If you want the world coordinate, pass true to get -128 to 4031.\n     */\n    private sectionY(section: NbtCompound, useWorldCoordinate = false): number {\n        const ySection = section.findChild<NbtInt>('Y')?.data || 0;\n\n        if (!useWorldCoordinate) {\n            return ySection;\n        }\n\n        let yWorld = ySection * 16;\n\n        if (yWorld >= 4032) {\n            yWorld -= 4096;\n        }\n\n        return yWorld;\n    }\n}\n"]}

package/dist/nbt/nbt-base.d.ts

@@ -0,0 +1,20 @@
+import { BinaryData } from '../lib/binary-data';
+import { NbtTagType } from './nbt-tag-type';
+export declare abstract class NbtBase<T> {
+    type: NbtTagType;
+    data: T;
+    name: string;
+    static readName(bd: BinaryData): string;
+    constructor(type: NbtTagType, data: T, name?: string);
+    /**
+     * Search for a child by path. Use '/' as separators.
+     *
+     * nbt.findChild('Level/Sections/0/BlockStates')
+     */
+    findChild<T extends NbtBase<any>>(_path: string): T | undefined;
+    isCompound(_name?: string): boolean;
+    isList(_subtype?: NbtTagType): boolean;
+    abstract toObject(): any;
+    abstract toSnbt(): string;
+}
+//# sourceMappingURL=nbt-base.d.ts.map

package/dist/nbt/nbt-base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nbt-base.d.ts","sourceRoot":"","sources":["../../src/nbt/nbt-base.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAE5C,8BAAsB,OAAO,CAAC,CAAC;IAQhB,IAAI,EAAE,UAAU;IAChB,IAAI,EAAE,CAAC;IACP,IAAI;IATf,MAAM,CAAC,QAAQ,CAAC,EAAE,EAAE,UAAU;gBAOnB,IAAI,EAAE,UAAU,EAChB,IAAI,EAAE,CAAC,EACP,IAAI,SAAK;IAGpB;;;;OAIG;IACH,SAAS,CAAC,CAAC,SAAS,OAAO,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS;IAK/D,UAAU,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO;IAInC,MAAM,CAAC,QAAQ,CAAC,EAAE,UAAU,GAAG,OAAO;IAItC,QAAQ,CAAC,QAAQ,IAAI,GAAG;IAExB,QAAQ,CAAC,MAAM,IAAI,MAAM;CAC5B"}

package/dist/nbt/nbt-base.js

@@ -0,0 +1,30 @@
+export class NbtBase {
+    type;
+    data;
+    name;
+    static readName(bd) {
+        const nameLength = bd.getUShort();
+        return bd.getString(nameLength);
+    }
+    constructor(type, data, name = '') {
+        this.type = type;
+        this.data = data;
+        this.name = name;
+    }
+    /**
+     * Search for a child by path. Use '/' as separators.
+     *
+     * nbt.findChild('Level/Sections/0/BlockStates')
+     */
+    findChild(_path) {
+        // By default, most elements do not have children.
+        return;
+    }
+    isCompound(_name) {
+        return false;
+    }
+    isList(_subtype) {
+        return false;
+    }
+}
+//# sourceMappingURL=nbt-base.js.map

package/dist/nbt/nbt-base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nbt-base.js","sourceRoot":"","sources":["../../src/nbt/nbt-base.ts"],"names":[],"mappings":"AAGA,MAAM,OAAgB,OAAO;IAQd;IACA;IACA;IATX,MAAM,CAAC,QAAQ,CAAC,EAAc;QAC1B,MAAM,UAAU,GAAG,EAAE,CAAC,SAAS,EAAE,CAAC;QAElC,OAAO,EAAE,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;IACpC,CAAC;IAED,YACW,IAAgB,EAChB,IAAO,EACP,OAAO,EAAE;QAFT,SAAI,GAAJ,IAAI,CAAY;QAChB,SAAI,GAAJ,IAAI,CAAG;QACP,SAAI,GAAJ,IAAI,CAAK;IACjB,CAAC;IAEJ;;;;OAIG;IACH,SAAS,CAAyB,KAAa;QAC3C,kDAAkD;QAClD,OAAO;IACX,CAAC;IAED,UAAU,CAAC,KAAc;QACrB,OAAO,KAAK,CAAC;IACjB,CAAC;IAED,MAAM,CAAC,QAAqB;QACxB,OAAO,KAAK,CAAC;IACjB,CAAC;CAKJ","sourcesContent":["import { BinaryData } from '../lib/binary-data';\nimport { NbtTagType } from './nbt-tag-type';\n\nexport abstract class NbtBase<T> {\n    static readName(bd: BinaryData) {\n        const nameLength = bd.getUShort();\n\n        return bd.getString(nameLength);\n    }\n\n    constructor(\n        public type: NbtTagType,\n        public data: T,\n        public name = '',\n    ) {}\n\n    /**\n     * Search for a child by path. Use '/' as separators.\n     *\n     * nbt.findChild('Level/Sections/0/BlockStates')\n     */\n    findChild<T extends NbtBase<any>>(_path: string): T | undefined {\n        // By default, most elements do not have children.\n        return;\n    }\n\n    isCompound(_name?: string): boolean {\n        return false;\n    }\n\n    isList(_subtype?: NbtTagType): boolean {\n        return false;\n    }\n\n    abstract toObject(): any;\n\n    abstract toSnbt(): string;\n}\n"]}

package/dist/nbt/nbt-byte-array.d.ts

@@ -0,0 +1,13 @@
+import { BinaryData } from '../lib/binary-data';
+import { NbtBase } from './nbt-base';
+import { NbtTagType } from './nbt-tag-type';
+export declare class NbtByteArray extends NbtBase<number[]> {
+    static fromBinaryData(bd: BinaryData, name?: string): NbtByteArray;
+    constructor(data: number[], name?: string);
+    toObject(): {
+        type: NbtTagType;
+        byteArray: number[];
+    };
+    toSnbt(): string;
+}
+//# sourceMappingURL=nbt-byte-array.d.ts.map

package/dist/nbt/nbt-byte-array.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nbt-byte-array.d.ts","sourceRoot":"","sources":["../../src/nbt/nbt-byte-array.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AACrC,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAI5C,qBAAa,YAAa,SAAQ,OAAO,CAAC,MAAM,EAAE,CAAC;IAC/C,MAAM,CAAC,cAAc,CAAC,EAAE,EAAE,UAAU,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,YAAY;gBAetD,IAAI,EAAE,MAAM,EAAE,EAAE,IAAI,CAAC,EAAE,MAAM;IAIzC,QAAQ;;;;IAOR,MAAM;CAGT"}

package/dist/nbt/nbt-byte-array.js

@@ -0,0 +1,30 @@
+import debug from 'debug';
+import { NbtBase } from './nbt-base';
+import { NbtTagType } from './nbt-tag-type';
+const debugLogFromBinaryData = debug('nbt:byte-array:from-binary-data');
+export class NbtByteArray extends NbtBase {
+    static fromBinaryData(bd, name) {
+        name ??= NbtByteArray.readName(bd);
+        const data = [];
+        const length = bd.getInt();
+        debugLogFromBinaryData(`BYTE_ARRAY, name ${name}, length ${length}`);
+        for (let i = 0; i < length; i++) {
+            data.push(bd.getByte());
+        }
+        debugLogFromBinaryData(`BYTE_ARRAY, data ${data}`);
+        return new NbtByteArray(data, name);
+    }
+    constructor(data, name) {
+        super(NbtTagType.BYTE_ARRAY, data, name);
+    }
+    toObject() {
+        return {
+            type: this.type,
+            byteArray: this.data,
+        };
+    }
+    toSnbt() {
+        return `[B;${this.data.map((v) => `${v}b`).join(',')}]`;
+    }
+}
+//# sourceMappingURL=nbt-byte-array.js.map

package/dist/nbt/nbt-byte-array.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nbt-byte-array.js","sourceRoot":"","sources":["../../src/nbt/nbt-byte-array.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AACrC,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAE5C,MAAM,sBAAsB,GAAG,KAAK,CAAC,iCAAiC,CAAC,CAAC;AAExE,MAAM,OAAO,YAAa,SAAQ,OAAiB;IAC/C,MAAM,CAAC,cAAc,CAAC,EAAc,EAAE,IAAa;QAC/C,IAAI,KAAK,YAAY,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;QACnC,MAAM,IAAI,GAAa,EAAE,CAAC;QAC1B,MAAM,MAAM,GAAG,EAAE,CAAC,MAAM,EAAE,CAAC;QAC3B,sBAAsB,CAAC,oBAAoB,IAAI,YAAY,MAAM,EAAE,CAAC,CAAC;QAErE,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YAC9B,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC;QAC5B,CAAC;QAED,sBAAsB,CAAC,oBAAoB,IAAI,EAAE,CAAC,CAAC;QAEnD,OAAO,IAAI,YAAY,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IACxC,CAAC;IAED,YAAY,IAAc,EAAE,IAAa;QACrC,KAAK,CAAC,UAAU,CAAC,UAAU,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;IAC7C,CAAC;IAED,QAAQ;QACJ,OAAO;YACH,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,SAAS,EAAE,IAAI,CAAC,IAAI;SACvB,CAAC;IACN,CAAC;IAED,MAAM;QACF,OAAO,MAAM,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;IAC5D,CAAC;CACJ","sourcesContent":["import debug from 'debug';\nimport { BinaryData } from '../lib/binary-data';\nimport { NbtBase } from './nbt-base';\nimport { NbtTagType } from './nbt-tag-type';\n\nconst debugLogFromBinaryData = debug('nbt:byte-array:from-binary-data');\n\nexport class NbtByteArray extends NbtBase<number[]> {\n    static fromBinaryData(bd: BinaryData, name?: string): NbtByteArray {\n        name ??= NbtByteArray.readName(bd);\n        const data: number[] = [];\n        const length = bd.getInt();\n        debugLogFromBinaryData(`BYTE_ARRAY, name ${name}, length ${length}`);\n\n        for (let i = 0; i < length; i++) {\n            data.push(bd.getByte());\n        }\n\n        debugLogFromBinaryData(`BYTE_ARRAY, data ${data}`);\n\n        return new NbtByteArray(data, name);\n    }\n\n    constructor(data: number[], name?: string) {\n        super(NbtTagType.BYTE_ARRAY, data, name);\n    }\n\n    toObject() {\n        return {\n            type: this.type,\n            byteArray: this.data,\n        };\n    }\n\n    toSnbt() {\n        return `[B;${this.data.map((v) => `${v}b`).join(',')}]`;\n    }\n}\n"]}

package/dist/nbt/nbt-byte.d.ts

@@ -0,0 +1,13 @@
+import { BinaryData } from '../lib/binary-data';
+import { NbtBase } from './nbt-base';
+import { NbtTagType } from './nbt-tag-type';
+export declare class NbtByte extends NbtBase<number> {
+    static fromBinaryData(bd: BinaryData, name?: string): NbtByte;
+    constructor(data: number, name?: string);
+    toObject(): {
+        type: NbtTagType;
+        byte: number;
+    };
+    toSnbt(): string;
+}
+//# sourceMappingURL=nbt-byte.d.ts.map

package/dist/nbt/nbt-byte.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nbt-byte.d.ts","sourceRoot":"","sources":["../../src/nbt/nbt-byte.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AACrC,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAI5C,qBAAa,OAAQ,SAAQ,OAAO,CAAC,MAAM,CAAC;IACxC,MAAM,CAAC,cAAc,CAAC,EAAE,EAAE,UAAU,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO;gBAQjD,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM;IAIvC,QAAQ;;;;IAOR,MAAM;CAGT"}

package/dist/nbt/nbt-byte.js

@@ -0,0 +1,25 @@
+import debug from 'debug';
+import { NbtBase } from './nbt-base';
+import { NbtTagType } from './nbt-tag-type';
+const debugLogFromBinaryData = debug('nbt:byte:from-binary-data');
+export class NbtByte extends NbtBase {
+    static fromBinaryData(bd, name) {
+        name ??= NbtByte.readName(bd);
+        const data = bd.getByte();
+        debugLogFromBinaryData(`BYTE, name ${name}, data ${data}`);
+        return new NbtByte(data, name);
+    }
+    constructor(data, name) {
+        super(NbtTagType.BYTE, data, name);
+    }
+    toObject() {
+        return {
+            type: this.type,
+            byte: this.data,
+        };
+    }
+    toSnbt() {
+        return `${this.data}b`;
+    }
+}
+//# sourceMappingURL=nbt-byte.js.map

package/dist/nbt/nbt-byte.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nbt-byte.js","sourceRoot":"","sources":["../../src/nbt/nbt-byte.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AACrC,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAE5C,MAAM,sBAAsB,GAAG,KAAK,CAAC,2BAA2B,CAAC,CAAC;AAElE,MAAM,OAAO,OAAQ,SAAQ,OAAe;IACxC,MAAM,CAAC,cAAc,CAAC,EAAc,EAAE,IAAa;QAC/C,IAAI,KAAK,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;QAC9B,MAAM,IAAI,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC;QAC1B,sBAAsB,CAAC,cAAc,IAAI,UAAU,IAAI,EAAE,CAAC,CAAC;QAE3D,OAAO,IAAI,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IACnC,CAAC;IAED,YAAY,IAAY,EAAE,IAAa;QACnC,KAAK,CAAC,UAAU,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;IACvC,CAAC;IAED,QAAQ;QACJ,OAAO;YACH,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,IAAI,EAAE,IAAI,CAAC,IAAI;SAClB,CAAC;IACN,CAAC;IAED,MAAM;QACF,OAAO,GAAG,IAAI,CAAC,IAAI,GAAG,CAAC;IAC3B,CAAC;CACJ","sourcesContent":["import debug from 'debug';\nimport { BinaryData } from '../lib/binary-data';\nimport { NbtBase } from './nbt-base';\nimport { NbtTagType } from './nbt-tag-type';\n\nconst debugLogFromBinaryData = debug('nbt:byte:from-binary-data');\n\nexport class NbtByte extends NbtBase<number> {\n    static fromBinaryData(bd: BinaryData, name?: string): NbtByte {\n        name ??= NbtByte.readName(bd);\n        const data = bd.getByte();\n        debugLogFromBinaryData(`BYTE, name ${name}, data ${data}`);\n\n        return new NbtByte(data, name);\n    }\n\n    constructor(data: number, name?: string) {\n        super(NbtTagType.BYTE, data, name);\n    }\n\n    toObject() {\n        return {\n            type: this.type,\n            byte: this.data,\n        };\n    }\n\n    toSnbt() {\n        return `${this.data}b`;\n    }\n}\n"]}

package/dist/nbt/nbt-compound.d.ts

@@ -0,0 +1,15 @@
+import { BinaryData } from '../lib/binary-data';
+import { NbtBase } from './nbt-base';
+import { NbtTagType } from './nbt-tag-type';
+export declare class NbtCompound extends NbtBase<NbtBase<any>[]> {
+    static fromBinaryData<T>(bd: BinaryData, name?: string): NbtCompound;
+    constructor(data: NbtBase<any>[], name?: string);
+    findChild<RESULT extends NbtBase<any>>(path: string): RESULT | undefined;
+    isCompound(name?: string): boolean;
+    toObject(): {
+        type: NbtTagType;
+        compound: Record<string, any>;
+    };
+    toSnbt(): string;
+}
+//# sourceMappingURL=nbt-compound.d.ts.map

package/dist/nbt/nbt-compound.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nbt-compound.d.ts","sourceRoot":"","sources":["../../src/nbt/nbt-compound.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAEhD,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AACrC,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAK5C,qBAAa,WAAY,SAAQ,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;IACpD,MAAM,CAAC,cAAc,CAAC,CAAC,EAAE,EAAE,EAAE,UAAU,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,WAAW;gBAwBxD,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,EAAE,EAAE,IAAI,CAAC,EAAE,MAAM;IAItC,SAAS,CAAC,MAAM,SAAS,OAAO,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,MAAM;IAmBnD,UAAU,CAAC,IAAI,CAAC,EAAE,MAAM;IAQjC,QAAQ;;;;IAmBR,MAAM;CAUT"}