npm - mca-json - Versions diffs - 1.0.5 → 1.1.0 - Mend

mca-json 1.0.5 → 1.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (36) hide show

package/README.md +41 -8
package/dist/bin/mca-find-signs.d.ts +3 -0
package/dist/bin/mca-find-signs.d.ts.map +1 -0
package/dist/bin/mca-find-signs.js +148 -0
package/dist/bin/mca-find-signs.js.map +1 -0
package/dist/bin/mca-remove-chunks.d.ts +3 -0
package/dist/bin/mca-remove-chunks.d.ts.map +1 -0
package/dist/bin/mca-remove-chunks.js +144 -0
package/dist/bin/mca-remove-chunks.js.map +1 -0
package/dist/bin/nbt-get-player-location.js +18 -9
package/dist/bin/nbt-get-player-location.js.map +1 -1
package/dist/lib/anvil.d.ts.map +1 -1
package/dist/lib/anvil.js +4 -3
package/dist/lib/anvil.js.map +1 -1
package/dist/lib/bit-data.js +2 -2
package/dist/lib/bit-data.js.map +1 -1
package/dist/lib/chunk.d.ts.map +1 -1
package/dist/lib/chunk.js +12 -7
package/dist/lib/chunk.js.map +1 -1
package/package.json +2 -2
package/src/bin/mca-find-signs.ts +214 -0
package/src/bin/mca-remove-chunks.ts +183 -0
package/src/bin/nbt-get-player-location.ts +19 -11
package/src/lib/anvil.ts +5 -3
package/src/lib/bit-data.ts +2 -2
package/src/lib/chunk.ts +15 -7
package/dist/bin/mca-find-chunks-with-signs.d.ts +0 -3
package/dist/bin/mca-find-chunks-with-signs.d.ts.map +0 -1
package/dist/bin/mca-find-chunks-with-signs.js +0 -79
package/dist/bin/mca-find-chunks-with-signs.js.map +0 -1
package/dist/bin/mca-trim-chunks-without-signs.d.ts +0 -3
package/dist/bin/mca-trim-chunks-without-signs.d.ts.map +0 -1
package/dist/bin/mca-trim-chunks-without-signs.js +0 -117
package/dist/bin/mca-trim-chunks-without-signs.js.map +0 -1
package/src/bin/mca-find-chunks-with-signs.ts +0 -109
package/src/bin/mca-trim-chunks-without-signs.ts +0 -146

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

	@@ -1 +1 @@
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"}
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;AAGlD,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;IA0BxC;;;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 CHANGED Viewed

@@ -55,19 +55,24 @@ export class Chunk {
      */
     chunkCoordinates() {
         const x =
-        // 1.18+
+        // 1.18+ region chunks
         this.rootNbt.findChild('xPos') ||
-            // up to 1.17
+            // up to 1.17 region chunks
             this.rootNbt.findChild('Level/xPos');
         const z =
-        // 1.18+
+        // 1.18+ region chunks
         this.rootNbt.findChild('zPos') ||
-            // up to 1.17
+            // up to 1.17 region chunks
             this.rootNbt.findChild('Level/zPos');
-        if (typeof x?.data !== 'number' || typeof z?.data !== 'number') {
-            return;
+        if (typeof x?.data === 'number' && typeof z?.data === 'number') {
+            return [x.data, z.data];
+        }
+        // Check for entity chunks
+        const position = this.rootNbt.findChild('Position');
+        if (position && position.data.length === 2) {
+            return [position.data[0], position.data[1]];
         }
-        return [x.data, z.data];
+        return;
     }
     /**
      * Returns a unique id for this chunk. It's just the chunk's X and Z

package/dist/lib/chunk.js.map CHANGED Viewed

	@@ -1 +1 @@
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"]}
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 { NbtIntArray } from '../nbt/nbt-int-array';\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+ region chunks\n this.rootNbt.findChild<NbtInt>('xPos') \|\|\n // up to 1.17 region chunks\n this.rootNbt.findChild<NbtInt>('Level/xPos');\n const z =\n // 1.18+ region chunks\n this.rootNbt.findChild<NbtInt>('zPos') \|\|\n // up to 1.17 region chunks\n this.rootNbt.findChild<NbtInt>('Level/zPos');\n\n if (typeof x?.data === 'number' && typeof z?.data === 'number') {\n return [x.data, z.data];\n }\n\n // Check for entity chunks\n const position = this.rootNbt.findChild<NbtIntArray>('Position');\n\n if (position && position.data.length === 2) {\n return [position.data[0], position.data[1]];\n }\n\n return;\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/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
     "name": "mca-json",
-    "version": "1.0.5",
+    "version": "1.1.0",
     "description": "Convert Minecraft MCA (Anvil files) and NBT into JSON and back, or modify directly in memory. Works on region files and player data.",
     "bin": {
         "mca-chunks": "dist/bin/mca-chunks.js",
@@ -21,7 +21,7 @@
     },
     "devDependencies": {
         "@types/debug": "^4.1.12",
-        "@types/node": "^25.2.3",
+        "@types/node": "^25.3.0",
         "@types/pako": "^2.0.4",
         "typescript": "^5.9.3"
     }

package/src/bin/mca-find-signs.ts ADDED Viewed

@@ -0,0 +1,214 @@
+#!/usr/bin/env node
+import debug from 'debug';
+import neodoc from 'neodoc';
+import { Anvil } from '../lib/anvil';
+import { Chunk } from '../lib/chunk';
+import { Sign } from '../block/sign';
+import { readFile } from 'node:fs/promises';
+interface SignInfo {
+    chunkX: number;
+    chunkZ: number;
+    x: number;
+    y: number;
+    z: number;
+    front: string[];
+    back: string[] | null;
+}
+interface Args {
+    '--blank'?: boolean;
+    '--generated'?: boolean;
+    '--first'?: boolean;
+    '--user'?: boolean;
+    '--verbose'?: boolean;
+    MCA_FILE?: string[];
+}
+const debugLog = debug('mca-find-signs');
+const args: Args = neodoc.run(
+    `Usage: mca-find-signs [OPTIONS] MCA_FILE...
+Extracts sign coordinates from MCA files. This is designed to find different
+categories of signs.
+* Blank signs are blank on both sides.
+* Generated signs can be blank or have any non-numeric and non-alphabetic
+  characters. This is so igloos with "<----" and "---->" are included.
+* User-created signs must have at least a number or a letter on the front or
+  the back. There's no way to tell from the block data that a user placed a
+  sign, but this is a good heuristic.
+The default output is a JSON array that shows the following information:
+[
+    {
+        "chunkX": 0,
+        "chunkZ": 3,
+        "x": 12,
+        "y": 34,
+        "z": 56,
+        "front": ["Line 1", "Line 2", "Line 3", "Line 4"],
+        "back": ["Line 1", "Line 2", "Line 3", "Line 4"]
+    },
+    ...
+]
+Options:
+    --blank         Only show blank signs. Conflicts with --generated and --user.
+    --generated     Only show generated signs. Conflicts with --blank and --user.
+    --user          Only show user-created signs. Conflicts with --blank and --generated.
+    --first         Stop scanning a chunk after the first sign is found.
+    -h, --help      Show this message.
+    -v, --verbose   Show more information during processing.
+`,
+    {
+        argv: [...process.argv].slice(2),
+        laxPlacement: true,
+    }
+);
+if (!args.MCA_FILE?.length) {
+    console.error('No files specified.');
+    process.exit(1);
+}
+if (
+    (args['--blank'] ? 1 : 0) +
+        (args['--generated'] ? 1 : 0) +
+        (args['--user'] ? 1 : 0) >
+    1
+) {
+    console.error(
+        'Conflicting options specified. Please choose only one of --blank, --generated, or --user.'
+    );
+    process.exit(1);
+}
+const signs: SignInfo[] = [];
+for (const file of args.MCA_FILE) {
+    try {
+        const moreSigns = await processFile(file);
+        signs.push(...moreSigns);
+    } catch (e) {
+        console.error(`Error processing file ${file}: ${e}`);
+        process.exit(1);
+    }
+}
+console.log(JSON.stringify(signs, null, 4));
+async function processFile(filename: string): Promise<SignInfo[]> {
+    debugLog(`Reading file: ${filename}`);
+    if (args['--verbose']) {
+        console.log(`Reading file: ${filename}`);
+    }
+    const contents = await readFile(filename);
+    const anvil = Anvil.fromBuffer(contents.buffer);
+    const chunks = anvil.getAllChunks();
+    const allSignsFound: SignInfo[] = [];
+    for (const chunk of chunks) {
+        const chunkKey = chunk.chunkKey() || '';
+        const signs = processChunk(chunk);
+        if (signs.length > 0) {
+            debugLog(`Found ${signs.length} signs in chunk ${chunkKey}.`);
+            if (args['--verbose']) {
+                console.log(
+                    `Found ${signs.length} signs in chunk ${chunkKey}.`
+                );
+            }
+            allSignsFound.push(...signs);
+        }
+    }
+    return allSignsFound;
+}
+function processChunk(chunk: Chunk): SignInfo[] {
+    const blockNames = chunk.uniqueBlockNames();
+    const foundSigns: SignInfo[] = [];
+    for (const blockName of blockNames) {
+        if (blockName.match(/^minecraft:.+_sign$/)) {
+            debugLog(`Found sign: ${blockName}`);
+            const listOfBlockCoordinates = chunk.findBlocksByName(blockName);
+            if (listOfBlockCoordinates.length === 0) {
+                debugLog(
+                    `Possible corruption - no blocks found for sign: ${blockName}`
+                );
+            }
+            for (const coords of listOfBlockCoordinates) {
+                debugLog(`Checking block at coordinates: ${coords}`);
+                const block = chunk.getBlock(coords);
+                if (!(block instanceof Sign)) {
+                    throw new Error(
+                        `Block is supposed to be a sign: ${block.name}`
+                    );
+                }
+                const front = block.frontText();
+                const back = block.backText();
+                const text = [...front, ...(back ?? [])].join('');
+                debugLog(`Front: ${JSON.stringify(front)}`);
+                debugLog(`Back: ${JSON.stringify(back)}`);
+                if (args['--blank'] && text.length !== 0) {
+                    debugLog(`Skipping non-blank sign.`);
+                    continue;
+                }
+                if (args['--generated'] && !text.match(/^[^a-z0-9]*$/i)) {
+                    debugLog(`Skipping user-created sign.`);
+                }
+                if (args['--user'] && !text.match(/[a-z0-9]/i)) {
+                    debugLog(`Skipping a possible generated sign.`);
+                    continue;
+                }
+                debugLog(`Found a matching sign.`);
+                if (args['--verbose']) {
+                    console.log(
+                        `Found a matching sign: ${JSON.stringify(front)} and ${JSON.stringify(back)}`
+                    );
+                }
+                const chunkCoordinates = chunk.chunkCoordinates();
+                if (!chunkCoordinates) {
+                    throw new Error('Chunk coordinates not found.');
+                }
+                foundSigns.push({
+                    chunkX: chunkCoordinates[0],
+                    chunkZ: chunkCoordinates[1],
+                    x: coords[0],
+                    y: coords[1],
+                    z: coords[2],
+                    front,
+                    back: back ?? null,
+                });
+                if (args['--first']) {
+                    return foundSigns;
+                }
+            }
+        }
+    }
+    return foundSigns;
+}

package/src/bin/mca-remove-chunks.ts ADDED Viewed

@@ -0,0 +1,183 @@
+#!/usr/bin/env node
+import debug from 'debug';
+import neodoc from 'neodoc';
+import { Anvil } from '../lib/anvil';
+import { readFile, writeFile } from 'node:fs/promises';
+const debugLog = debug('mca-remove-chunks');
+const args: {
+    '--dry-run'?: boolean;
+    '--remove'?: string[];
+    '--remove-list'?: string;
+    '--preserve'?: string[];
+    '--preserve-list'?: string;
+    '--verbose'?: boolean;
+    MCA_FILE?: string[];
+} = neodoc.run(
+    `Usage: mca-remove-chunks [OPTIONS] MCA_FILE...
+Removes chunks from MCA files (region/r.*.*.mca or entities/r.*.*.mca).
+This does not change the file size. Similar to deleting a file on a hard drive,
+the space is marked as free but not actually removed. Minecraft will reuse or reclaim the space when the region file is next modified.
+You can either specify chunk coordinates to preserve or chunk coordinates to remove, but not both.
+Options:
+    -h, --help      Show this message.
+    -n, --dry-run   Do not write changes to the file.
+    --remove CHUNK_COORDINATES...
+                    Remove chunks with these coordinates. Coordinates are in
+                    the format "x,z". May be specified multiple times.
+    --remove-list FILE
+                    Remove chunks with coordinates specified in a text file.
+                    Each line of the file should have coordinates in the format
+                    "x,z". Safe to combine with --remove option.
+    --preserve CHUNK_COORDINATES...
+                    Do not remove chunks with these coordinates. Coordinates
+                    are in the format "x,z". May be specified multiple times.
+    --preserve-list FILE
+                    Preserve chunks with coordinates specified in a text file.
+                    Each line of the file should have coordinates in the format
+                    "x,z". Safe to combine with --preserve option.
+    -v, --verbose   Show more information during processing.
+`,
+    {
+        argv: [...process.argv].slice(2),
+        laxPlacement: true,
+    }
+);
+main();
+async function main() {
+    if (!args.MCA_FILE?.length) {
+        console.error('No files specified.');
+        process.exit(1);
+    }
+    if (args['--remove-list']) {
+        const coordinates = await readCoordinates(args['--remove-list']);
+        if (!args['--remove']) {
+            args['--remove'] = [];
+        }
+        args['--remove'].push(...coordinates);
+    }
+    if (args['--preserve-list']) {
+        const coordinates = await readCoordinates(args['--preserve-list']);
+        if (!args['--preserve']) {
+            args['--preserve'] = [];
+        }
+        args['--preserve'].push(...coordinates);
+    }
+    if (args['--remove'] && args['--preserve']) {
+        console.error('Cannot specify both --remove and --preserve options.');
+        process.exit(1);
+    }
+    if (!args['--remove'] && !args['--preserve']) {
+        console.error('Must specify either --remove or --preserve option.');
+        process.exit(1);
+    }
+    if (args['--preserve'] && args['--verbose']) {
+        console.log(`Preserving coordinates: ${args['--preserve'].join(' ')}`);
+    }
+    if (args['--remove'] && args['--verbose']) {
+        console.log(`Removing coordinates: ${args['--remove'].join(' ')}`);
+    }
+    const determinator = makeDeterminator();
+    for (const file of args.MCA_FILE) {
+        try {
+            await processFile(file, determinator);
+        } catch (e) {
+            console.error(`Error processing file ${file}: ${e}`);
+            process.exit(1);
+        }
+    }
+}
+async function processFile(
+    filename: string,
+    determinator: (chunkKey: string) => boolean
+) {
+    debugLog(`Reading file: ${filename}`);
+    if (args['--verbose']) {
+        console.log(`Reading file: ${filename}`);
+    }
+    const contents = await readFile(filename);
+    const anvil = Anvil.fromBuffer(contents.buffer);
+    const chunks = anvil.getAllChunks();
+    let changes = 0;
+    for (const chunk of chunks) {
+        const chunkKey = chunk.chunkKey() || '';
+        if (determinator(chunkKey)) {
+            debugLog(`Preserving chunk: ${chunkKey}`);
+            if (args['--verbose']) {
+                console.log(`Preserving chunk: ${chunkKey}`);
+            }
+        } else {
+            debugLog(`Removing chunk: ${chunkKey}`);
+            if (args['--verbose']) {
+                console.log(`Removing chunk: ${chunkKey}`);
+            }
+            anvil.deleteChunk(chunk);
+            changes += 1;
+        }
+    }
+    if (args['--verbose']) {
+        console.log(`Chunks removed: ${changes}/${chunks.length}`);
+    }
+    if (changes) {
+        if (args['--dry-run']) {
+            console.log(`DRY RUN: Would write changes to file: ${filename}`);
+        } else {
+            console.log(`Writing changes to file: ${filename}`);
+            const modifiedBuffer = Buffer.from(anvil.buffer());
+            await writeFile(filename, modifiedBuffer);
+        }
+    }
+}
+function makeDeterminator() {
+    if (args['--preserve']) {
+        const preservedCoordinates = new Set(args['--preserve']);
+        return (chunkKey: string) => preservedCoordinates.has(chunkKey);
+    } else if (args['--remove']) {
+        const removedCoordinates = new Set(args['--remove']);
+        return (chunkKey: string) => !removedCoordinates.has(chunkKey);
+    } else {
+        throw new Error('Invalid state: no determinator could be created.');
+    }
+}
+async function readCoordinates(filename: string): Promise<string[]> {
+    const contents = await readFile(filename, 'utf-8');
+    const lines = contents
+        .split('\n')
+        .map((line) => line.trim())
+        .filter((line) => line.length > 0);
+    return lines;
+}

package/src/bin/nbt-get-player-location.ts CHANGED Viewed

@@ -19,14 +19,16 @@ const args: {
 Scans a player NBT data file for the player location and prints it to stdout.
 NBT files can be compressed or uncompressed and this tool can handle both. If the filename is "-" or not provided, this will read from stdin.
-The output shows the following tab delimited fields:
-* Dimension: "minecraft:overworld", "minecraft:the_nether", or "minecraft:the_end"
-* X: The player's X coordinate, rounded
-* Y: The player's Y coordinate, rounded
-* Z: The player's Z coordinate, rounded
-* chunkX: The player's chunk X coordinate
-* chunkZ: The player's chunk Z coordinate
+The output is JSON with the following fields:
+{
+    "chunkX": 7,                            # player's chunk X coordinate
+    "chunkZ": -29                           # player's chunk Z coordinate
+    "x": 123,                               # player's X coordinate, rounded
+    "y": 64,                                # player's Y coordinate, rounded
+    "z": -456,                              # player's Z coordinate, rounded
+    "dimension": "minecraft:overworld",     # or "minecraft:the_nether" or "minecraft:the_end"
+}
 Options:
     -h, --help      Show this message.
@@ -96,7 +98,13 @@ async function processFile(filename: string) {
     const chunkX = Math.floor(x / 16);
     const chunkZ = Math.floor(z / 16);
-    const output = [dimension, Math.round(x), Math.round(y), Math.round(z), chunkX, chunkZ];
-    console.log(output.join('\t'));
+    const output = {
+        chunkX,
+        chunkZ,
+        x: Math.round(x),
+        y: Math.round(y),
+        z: Math.round(z),
+        dimension,
+    };
+    console.log(JSON.stringify(output, null, 4));
 }

package/src/lib/anvil.ts CHANGED Viewed

@@ -61,9 +61,11 @@ export class Anvil {
         // Clear cache before modifying location entries
         this.cachedLocationEntries = null;
-        this.data.seek(index * 4);
-        this.data.setNByteInteger(0, 3);
-        this.data.setByte(0);
+        this.data.seek(index * 4); // Go to the pointer location for this chunk
+        this.data.setNByteInteger(0, 3); // Erase the offset
+        this.data.setByte(0); // Erase the sector count
+        // The actual chunk data is still present in the file.
     }
     /**

package/src/lib/bit-data.ts CHANGED Viewed

@@ -3,8 +3,8 @@ import { NbtLongArray } from '../nbt/nbt-long-array';
 const debugLog = debug('bit-data');
-// At most, we will have 7 bits to mask
-const MASK = [0, 1, 3, 7, 15, 31, 63, 127];
+// At most, we will have 8 bits to mask
+const MASK = [0, 1, 3, 7, 15, 31, 63, 127, 255];
 export class BitData {
     static fromLongArrayTag(tag: NbtLongArray): BitData {

package/src/lib/chunk.ts CHANGED Viewed

@@ -12,6 +12,7 @@ import { Coords2d, Coords3d } from '../types/coords';
 import { NbtBase } from '../nbt/nbt-base';
 import { NbtCompound } from '../nbt/nbt-compound';
 import { NbtInt } from '../nbt/nbt-int';
+import { NbtIntArray } from '../nbt/nbt-int-array';
 import { NbtList } from '../nbt/nbt-list';
 import { NbtLong } from '../nbt/nbt-long';
 import { NbtLongArray } from '../nbt/nbt-long-array';
@@ -75,21 +76,28 @@ export class Chunk {
      */
     chunkCoordinates(): Coords2d | undefined {
         const x =
-            // 1.18+
+            // 1.18+ region chunks
             this.rootNbt.findChild<NbtInt>('xPos') ||
-            // up to 1.17
+            // up to 1.17 region chunks
             this.rootNbt.findChild<NbtInt>('Level/xPos');
         const z =
-            // 1.18+
+            // 1.18+ region chunks
             this.rootNbt.findChild<NbtInt>('zPos') ||
-            // up to 1.17
+            // up to 1.17 region chunks
             this.rootNbt.findChild<NbtInt>('Level/zPos');
-        if (typeof x?.data !== 'number' || typeof z?.data !== 'number') {
-            return;
+        if (typeof x?.data === 'number' && typeof z?.data === 'number') {
+            return [x.data, z.data];
         }
-        return [x.data, z.data];
+        // Check for entity chunks
+        const position = this.rootNbt.findChild<NbtIntArray>('Position');
+        if (position && position.data.length === 2) {
+            return [position.data[0], position.data[1]];
+        }
+        return;
     }
     /**