mca-json 1.0.0

package/dist/nbt/snbt-to-nbt.js

@@ -0,0 +1,178 @@
+import { NbtByteArray } from '../nbt/nbt-byte-array';
+import { NbtByte } from '../nbt/nbt-byte';
+import { NbtCompound } from '../nbt/nbt-compound';
+import { NbtDouble } from '../nbt/nbt-double';
+import { NbtFloat } from '../nbt/nbt-float';
+import { NbtIntArray } from '../nbt/nbt-int-array';
+import { NbtInt } from '../nbt/nbt-int';
+import { NbtList } from '../nbt/nbt-list';
+import { NbtLongArray } from '../nbt/nbt-long-array';
+import { NbtLong } from '../nbt/nbt-long';
+import { NbtShort } from '../nbt/nbt-short';
+import { NbtString } from '../nbt/nbt-string';
+export const fromSnbtData = {
+    BYTE: snbtToNbtByte,
+    BYTE_ARRAY_START: snbtToNbtByteArray,
+    COMPOUND_START: snbtToNbtCompound,
+    DOUBLE: snbtToNbtDouble,
+    FLOAT: snbtToNbtFloat,
+    INT: snbtToNbtInt,
+    INT_ARRAY_START: snbtToNbtIntArray,
+    LIST_START: snbtToNbtList,
+    LONG: snbtToNbtLong,
+    LONG_ARRAY_START: snbtToNbtLongArray,
+    SHORT: snbtToNbtShort,
+    STRING: snbtToNbtString,
+};
+export function snbtToNbt(snbtData) {
+    const token = snbtData.token();
+    const processor = fromSnbtData[token.type];
+    if (processor) {
+        return processor(token, snbtData);
+    }
+    throw new Error(`Invalid, non-matching token ${snbtData.showToken(token)}`);
+}
+function snbtToNbtByte(token) {
+    return new NbtByte(parseInt(token.content || ''));
+}
+function snbtToNbtByteArray(_token, snbtData) {
+    const bytes = [];
+    let token = snbtData.token();
+    while (token && token.type === 'BYTE') {
+        bytes.push(parseInt(token.content || ''));
+        try {
+            token = snbtData.token();
+        }
+        catch (err) {
+            throw new Error(`${err} - Unexpected end of SNBT data while parsing byte array`);
+        }
+        if (token.type !== 'COMMA') {
+            throw new Error(`Expecting a comma but found ${snbtData.showToken(token)}`);
+        }
+        token = snbtData.token();
+    }
+    return new NbtByteArray(bytes);
+}
+function snbtToNbtCompound(_token, snbtData) {
+    const data = [];
+    let token = snbtData.token();
+    while (token && token.type !== 'COMPOUND_END') {
+        if (token.type !== 'STRING') {
+            throw new Error(`Expecting a string but found ${snbtData.showToken(token)}`);
+        }
+        const name = token.content;
+        let colon;
+        try {
+            colon = snbtData.token();
+        }
+        catch (err) {
+            throw new Error(`${err} - Unexpected end of SNBT data while looking for colon`);
+        }
+        if (colon.type !== 'COLON') {
+            throw new Error(`Expecting a colon but found ${snbtData.showToken(colon)}`);
+        }
+        const nbt = snbtToNbt(snbtData);
+        nbt.name = name;
+        data.push(nbt);
+        token = snbtData.token();
+    }
+    return new NbtCompound(data);
+}
+function snbtToNbtDouble(token) {
+    return new NbtDouble(parseFloat(token.content.slice(0, -1) || ''));
+}
+function snbtToNbtFloat(token) {
+    return new NbtFloat(parseFloat(token.content || ''));
+}
+function snbtToNbtInt(token) {
+    return new NbtInt(parseInt(token.content || ''));
+}
+function snbtToNbtIntArray(_token, snbtData) {
+    const ints = [];
+    let token = snbtData.token();
+    while (token && token.type === 'INT') {
+        ints.push(parseInt(token.content || ''));
+        try {
+            token = snbtData.token();
+        }
+        catch (err) {
+            throw new Error(`${err} - Unexpected end of SNBT data while parsing int array`);
+        }
+        if (token.type !== 'COMMA') {
+            throw new Error(`Expecting a comma but found ${snbtData.showToken(token)}`);
+        }
+        token = snbtData.token();
+    }
+    return new NbtIntArray(ints);
+}
+function snbtToNbtList(_token, snbtData) {
+    const list = [];
+    let token;
+    try {
+        token = snbtData.token();
+    }
+    catch (err) {
+        throw new Error(`${err} - Unexpected end of SNBT data while parsing list at beginning`);
+    }
+    while (token.type !== 'LIST_END') {
+        snbtData.step(-1);
+        let nbt;
+        try {
+            nbt = snbtToNbt(snbtData);
+        }
+        catch (err) {
+            throw new Error(`${err} - Error parsing list element`);
+        }
+        list.push(nbt);
+        token = snbtData.token();
+        if (token.type === 'COMMA') {
+            try {
+                token = snbtData.token();
+            }
+            catch (err) {
+                throw new Error(`${err} - Unexpected end of SNBT data while looking for comma or end of list`);
+            }
+        }
+        else if (token.type !== 'LIST_END') {
+            throw new Error(`Expecting a comma or list end but found ${snbtData.showToken(token)}`);
+        }
+    }
+    if (!list.length) {
+        throw new Error('Empty list not allowed in SNBT because the type cannot be inferred');
+    }
+    const firstType = list[0].type;
+    for (let i = 1; i < list.length; i++) {
+        if (list[i].type !== firstType) {
+            throw new Error(`List contains mixed types: ${firstType} and ${list[i].type}`);
+        }
+    }
+    return new NbtList(list, firstType);
+}
+function snbtToNbtLong(token) {
+    return new NbtLong(BigInt(token.content.slice(0, -1) || ''));
+}
+function snbtToNbtLongArray(_token, snbtData) {
+    const longs = [];
+    let token = snbtData.token();
+    while (token && token.type === 'LONG') {
+        longs.push(BigInt(token.content.slice(0, -1) || ''));
+        try {
+            token = snbtData.token();
+        }
+        catch (err) {
+            throw new Error(`${err} - Unexpected end of SNBT data while parsing long array`);
+        }
+        if (token.type !== 'COMMA') {
+            throw new Error(`Expecting a comma but found ${snbtData.showToken(token)}`);
+        }
+        token = snbtData.token();
+    }
+    return new NbtLongArray(longs);
+}
+function snbtToNbtShort(token) {
+    return new NbtShort(parseInt(token.content || ''));
+}
+function snbtToNbtString(token) {
+    return new NbtString(token.content);
+}
+//# sourceMappingURL=snbt-to-nbt.js.map

package/dist/nbt/snbt-to-nbt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"snbt-to-nbt.js","sourceRoot":"","sources":["../../src/nbt/snbt-to-nbt.ts"],"names":[],"mappings":"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","sourcesContent":["import { NbtBase } from '../nbt/nbt-base';\nimport { NbtByteArray } from '../nbt/nbt-byte-array';\nimport { NbtByte } from '../nbt/nbt-byte';\nimport { NbtCompound } from '../nbt/nbt-compound';\nimport { NbtDouble } from '../nbt/nbt-double';\nimport { NbtFloat } from '../nbt/nbt-float';\nimport { NbtIntArray } from '../nbt/nbt-int-array';\nimport { NbtInt } from '../nbt/nbt-int';\nimport { NbtList } from '../nbt/nbt-list';\nimport { NbtLongArray } from '../nbt/nbt-long-array';\nimport { NbtLong } from '../nbt/nbt-long';\nimport { NbtShort } from '../nbt/nbt-short';\nimport { NbtString } from '../nbt/nbt-string';\nimport { SnbtData, SnbtToken } from './snbt-data';\n\nexport const fromSnbtData: {\n    [key: string]: (token: SnbtToken, snbtData: SnbtData) => NbtBase<any>;\n} = {\n    BYTE: snbtToNbtByte,\n    BYTE_ARRAY_START: snbtToNbtByteArray,\n    COMPOUND_START: snbtToNbtCompound,\n    DOUBLE: snbtToNbtDouble,\n    FLOAT: snbtToNbtFloat,\n    INT: snbtToNbtInt,\n    INT_ARRAY_START: snbtToNbtIntArray,\n    LIST_START: snbtToNbtList,\n    LONG: snbtToNbtLong,\n    LONG_ARRAY_START: snbtToNbtLongArray,\n    SHORT: snbtToNbtShort,\n    STRING: snbtToNbtString,\n};\n\nexport function snbtToNbt(snbtData: SnbtData): NbtBase<any> {\n    const token = snbtData.token();\n    const processor = fromSnbtData[token.type];\n\n    if (processor) {\n        return processor(token, snbtData);\n    }\n\n    throw new Error(`Invalid, non-matching token ${snbtData.showToken(token)}`);\n}\n\nfunction snbtToNbtByte(token: SnbtToken): NbtByte {\n    return new NbtByte(parseInt(token.content || ''));\n}\n\nfunction snbtToNbtByteArray(_token: SnbtToken, snbtData: SnbtData): NbtByteArray {\n    const bytes: number[] = [];\n    let token = snbtData.token();\n\n    while (token && token.type === 'BYTE') {\n        bytes.push(parseInt(token.content || ''));\n\n        try {\n            token = snbtData.token();\n        } catch (err) {\n            throw new Error(`${err} - Unexpected end of SNBT data while parsing byte array`);\n        }\n\n        if (token.type !== 'COMMA') {\n            throw new Error(`Expecting a comma but found ${snbtData.showToken(token)}`);\n        }\n\n        token = snbtData.token();\n    }\n\n    return new NbtByteArray(bytes);\n}\n\nfunction snbtToNbtCompound(_token: SnbtToken, snbtData: SnbtData): NbtCompound {\n    const data: NbtBase<any>[] = [];\n    let token = snbtData.token();\n\n    while (token && token.type !== 'COMPOUND_END') {\n        if (token.type !== 'STRING') {\n            throw new Error(`Expecting a string but found ${snbtData.showToken(token)}`);\n        }\n\n        const name = token.content;\n        let colon;\n\n        try {\n            colon = snbtData.token();\n        } catch (err) {\n            throw new Error(`${err} - Unexpected end of SNBT data while looking for colon`);\n        }\n\n        if (colon.type !== 'COLON') {\n            throw new Error(`Expecting a colon but found ${snbtData.showToken(colon)}`);\n        }\n\n        const nbt = snbtToNbt(snbtData);\n        nbt.name = name;\n        data.push(nbt);\n        token = snbtData.token();\n    }\n\n    return new NbtCompound(data);\n}\n\nfunction snbtToNbtDouble(token: SnbtToken): NbtDouble {\n    return new NbtDouble(parseFloat(token.content.slice(0, -1) || ''));\n}\n\nfunction snbtToNbtFloat(token: SnbtToken): NbtFloat {\n    return new NbtFloat(parseFloat(token.content || ''));\n}\n\nfunction snbtToNbtInt(token: SnbtToken): NbtInt {\n    return new NbtInt(parseInt(token.content || ''));\n}\n\nfunction snbtToNbtIntArray(_token: SnbtToken, snbtData: SnbtData): NbtIntArray {\n    const ints: number[] = [];\n    let token = snbtData.token();\n\n    while (token && token.type === 'INT') {\n        ints.push(parseInt(token.content || ''));\n\n        try {\n            token = snbtData.token();\n        } catch (err) {\n            throw new Error(`${err} - Unexpected end of SNBT data while parsing int array`);\n        }\n\n        if (token.type !== 'COMMA') {\n            throw new Error(`Expecting a comma but found ${snbtData.showToken(token)}`);\n        }\n\n        token = snbtData.token();\n    }\n\n    return new NbtIntArray(ints);\n}\n\nfunction snbtToNbtList(_token: SnbtToken, snbtData: SnbtData): NbtList<any> {\n    const list: NbtBase<any>[] = [];\n    let token;\n\n    try {\n        token = snbtData.token();\n    } catch (err) {\n        throw new Error(`${err} - Unexpected end of SNBT data while parsing list at beginning`);\n    }\n\n    while (token.type !== 'LIST_END') {\n        snbtData.step(-1);\n        let nbt;\n\n        try {\n            nbt = snbtToNbt(snbtData);\n        } catch (err) {\n            throw new Error(`${err} - Error parsing list element`);\n        }\n\n        list.push(nbt);\n        token = snbtData.token();\n\n        if (token.type === 'COMMA') {\n            try {\n                token = snbtData.token();\n            } catch (err) {\n                throw new Error(`${err} - Unexpected end of SNBT data while looking for comma or end of list`);\n            }\n        } else if (token.type !== 'LIST_END') {\n            throw new Error(`Expecting a comma or list end but found ${snbtData.showToken(token)}`);\n        }\n    }\n\n    if (!list.length) {\n        throw new Error('Empty list not allowed in SNBT because the type cannot be inferred');\n    }\n\n    const firstType = list[0].type;\n\n    for (let i = 1; i < list.length; i++) {\n        if (list[i].type !== firstType) {\n            throw new Error(`List contains mixed types: ${firstType} and ${list[i].type}`);\n        }\n    }\n\n    return new NbtList(list, firstType);\n}\n\nfunction snbtToNbtLong(token: SnbtToken): NbtLong {\n    return new NbtLong(BigInt(token.content.slice(0, -1) || ''));\n}\n\nfunction snbtToNbtLongArray(_token: SnbtToken, snbtData: SnbtData): NbtLongArray {\n    const longs: bigint[] = [];\n    let token = snbtData.token();\n\n    while (token && token.type === 'LONG') {\n        longs.push(BigInt(token.content.slice(0, -1) || ''));\n\n        try {\n            token = snbtData.token();\n        } catch (err) {\n            throw new Error(`${err} - Unexpected end of SNBT data while parsing long array`);\n        }\n\n        if (token.type !== 'COMMA') {\n            throw new Error(`Expecting a comma but found ${snbtData.showToken(token)}`);\n        }\n\n        token = snbtData.token();\n    }\n\n    return new NbtLongArray(longs);\n}\n\nfunction snbtToNbtShort(token: SnbtToken): NbtShort {\n    return new NbtShort(parseInt(token.content || ''));\n}\n\nfunction snbtToNbtString(token: SnbtToken): NbtString {\n    return new NbtString(token.content);\n}\n"]}

package/dist/types/coords.d.ts

@@ -0,0 +1,3 @@
+export type Coords2d = [number, number];
+export type Coords3d = [number, number, number];
+//# sourceMappingURL=coords.d.ts.map

package/dist/types/coords.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"coords.d.ts","sourceRoot":"","sources":["../../src/types/coords.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,QAAQ,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AACxC,MAAM,MAAM,QAAQ,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC"}

package/dist/types/coords.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=coords.js.map

package/dist/types/coords.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"coords.js","sourceRoot":"","sources":["../../src/types/coords.ts"],"names":[],"mappings":"","sourcesContent":["export type Coords2d = [number, number]; // X and Z\nexport type Coords3d = [number, number, number]; // X, Y, and Z\n"]}

package/package.json

@@ -0,0 +1,28 @@
+{
+    "name": "mca-json",
+    "version": "1.0.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",
+        "mca-json": "dist/bin/mca-json.js"
+    },
+    "scripts": {
+        "build": "rm -rf dist && npm run build-index && tsc",
+        "build-index": "cd src; for F in $(grep '^export' -r . -l --include \\*.ts --exclude index.ts); do echo \"export * from '${F%.ts}';\"; done | LC_ALL=C sort > index.ts",
+        "reinstall": "rm -rf node_modules package-lock.json && npm install"
+    },
+    "type": "module",
+    "main": "dist/index.mjs",
+    "dependencies": {
+        "@types/node": "^25.2.3",
+        "debug": "^4.4.3",
+        "get-stdin": "^10.0.0",
+        "neodoc": "^2.0.2",
+        "pako": "^2.1.0"
+    },
+    "devDependencies": {
+        "@types/debug": "^4.1.12",
+        "@types/pako": "^2.0.4",
+        "typescript": "^5.9.3"
+    }
+}

package/src/bin/mca-chunks.ts

@@ -0,0 +1,54 @@
+#!/usr/bin/env node
+
+import getStdin from 'get-stdin';
+import neodoc from 'neodoc';
+import { Anvil } from '../lib/anvil';
+import { readFile, writeFile } from 'node:fs/promises';
+
+async function readInput(filename: string | undefined) {
+    if (!filename || filename === '-') {
+        return await getStdin.buffer();
+    }
+
+    return readFile(filename);
+}
+
+const args: {
+    '<input>'?: string;
+    '<output>'?: string;
+} = neodoc.run(
+`Usage: mca-chunks [OPTIONS] [<input> [<output>]]
+
+Lists the chunk coordinates in a Minecraft MCA file, one set of coordinates per
+line. Each line will have "X,Z", such as "-23,14". Both input and output are
+optional.  If input is not provided, this reads from stdin. If output is not
+provided, this writes to stdout.
+
+Options:
+    -h, --help      Show this message.
+`,
+    {
+        argv: [...process.argv].slice(2),
+        laxPlacement: true,
+    }
+);
+
+readInput(args['<input>'])
+    .then((inputBuffer) => {
+        if (inputBuffer.length === 0) {
+            console.error('No input provided. Use --help for usage.');
+            process.exit(1);
+        }
+
+        const anvilParser = Anvil.fromBuffer(inputBuffer.buffer as ArrayBuffer);
+        let chunks = anvilParser.getAllChunks();
+
+        return chunks.map((chunk) => chunk.chunkKey()).join('\n');
+    })
+    .then((output: string) => {
+        if (args['<output>']) {
+            writeFile(args['<output>'], output);
+        } else {
+            console.log(output);
+        }
+    });

package/src/bin/mca-find-chunks-with-signs.ts

@@ -0,0 +1,109 @@
+#!/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';
+
+const debugLog = debug('mca-find-chunks-with-signs');
+const args: {
+    '--verbose'?: boolean;
+    MCA_FILE?: string[];
+} = neodoc.run(
+    `Usage: mca-trim-chunks-without-signs [OPTIONS] MCA_FILE...
+
+Displays chunk X and Z coordinates, separated by a tab, for all chunks in MCA
+files that contain a sign block. Signs need to have at least one letter or
+number on them to differentiate them from naturally generated signs.
+
+Options:
+    -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);
+}
+
+for (const file of args.MCA_FILE) {
+    try {
+        await processFile(file);
+    } catch (e) {
+        console.error(`Error processing file ${file}: ${e}`);
+
+        process.exit(1);
+    }
+}
+
+async function processFile(filename: string) {
+    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();
+
+    for (const chunk of chunks) {
+        const chunkKey = chunk.chunkKey() || '';
+
+        if (processChunk(chunk)) {
+            const coords = chunk.chunkCoordinates();
+
+            if (!coords) {
+                throw new Error(`Chunk ${chunkKey} has no coordinates.`);
+            }
+
+            console.log(`${coords[0]}\t${coords[1]}`);
+        }
+    }
+}
+
+function processChunk(chunk: Chunk): boolean {
+    const blockNames = chunk.uniqueBlockNames();
+
+    for (const blockName of blockNames) {
+        if (blockName.match(/^minecraft:.+_sign$/)) {
+            debugLog(`Found sign: ${blockName}`);
+
+            for (const coords of chunk.findBlocksByName(blockName)) {
+                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();
+                debugLog(`Front: ${JSON.stringify(front)}`);
+                debugLog(`Back: ${JSON.stringify(back)}`);
+
+                if ([...front, ...(back || [])].join('').match(/[a-z0-9]/i)) {
+                    debugLog(`Found a user-created sign. Preserving chunk.`);
+
+                    if (args['--verbose']) {
+                        console.log(
+                            `Found a user-created sign: ${JSON.stringify(front)} and ${JSON.stringify(back)}`
+                        );
+                    }
+
+                    return true;
+                }
+            }
+        }
+    }
+
+    return false;
+}

package/src/bin/mca-json.ts

@@ -0,0 +1,96 @@
+#!/usr/bin/env node
+
+import getStdin from 'get-stdin';
+import neodoc from 'neodoc';
+import { Anvil } from '../lib/anvil';
+import { readFile, writeFile } from 'node:fs/promises';
+
+async function readInput(filename: string | undefined) {
+    if (!filename || filename === '-') {
+        return await getStdin.buffer();
+    }
+
+    return readFile(filename);
+}
+
+const args: {
+    '--chunk-coords'?: string | string[];
+    '--compact'?: boolean;
+    '--condense'?: boolean;
+    '<input>'?: string;
+    '<output>'?: string;
+} = neodoc.run(
+`Usage: mca-json [OPTIONS] [<input> [<output>]]
+
+Converts a Minecraft MCA file to JSON. Both input and output are optional. If
+input is not provided, this reads from stdin. If output is not provided, this
+writes to stdout.
+
+Because MCA files can contain a tremendous amount of information, the tool
+might run out of memory. When that happens, you can dump specific chunks by
+specifying the --chunk-coords option.
+
+Options:
+    --chunk-coords=COORDS
+                    Only write out the chunk at the specified chunk coordinates.
+                    Chunk coordinates are absolute chunks from the world origin.
+                    Can be specified multiple times. Coordinates are specified
+                    as "x,z". Highly recommended to limit the size of the JSON
+                    that's generated.
+    --compact       Do not use pretty-printing in the JSON output.
+    --condense      Condense arrays of bytes, ints, and longs to a single line.
+                    This significantly cuts down on the size of the generated
+                    JSON.
+    -h, --help      Show this message.
+`,
+    {
+        argv: [...process.argv].slice(2),
+        laxPlacement: true,
+    }
+);
+
+readInput(args['<input>'])
+    .then((inputBuffer) => {
+        if (inputBuffer.length === 0) {
+            console.error('No input provided. Use --help for usage.');
+            process.exit(1);
+        }
+
+        const anvilParser = Anvil.fromBuffer(inputBuffer.buffer as ArrayBuffer);
+        let chunks = anvilParser.getAllChunks();
+
+        if (args['--chunk-coords']) {
+            if (!Array.isArray(args['--chunk-coords'])) {
+                args['--chunk-coords'] = [args['--chunk-coords']];
+            }
+
+            const wanted = new Set<string | undefined>(args['--chunk-coords']);
+            chunks = chunks.filter((chunk) => wanted.has(chunk.chunkKey()));
+        }
+
+        let jsonObjects = chunks.map((chunk) => chunk.toObject());
+
+        if (args['--compact']) {
+            return JSON.stringify(jsonObjects);
+        }
+
+        let content = JSON.stringify(jsonObjects, null, 4);
+
+        if (args['--condense']) {
+            content = content.replace(
+                /: \[(\n\s*"?-?\d+"?,?)*\n\s*\]/g,
+                (match) => {
+                    return match.replace(/\n\s*/g, ' ');
+                }
+            );
+        }
+
+        return content;
+    })
+    .then((output: string) => {
+        if (args['<output>']) {
+            writeFile(args['<output>'], output);
+        } else {
+            console.log(output);
+        }
+    });

package/src/bin/mca-trim-chunks-without-signs.ts

@@ -0,0 +1,146 @@
+#!/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, writeFile } from 'node:fs/promises';
+
+const debugLog = debug('mca-trim-chunks-without-signs');
+const args: {
+    '--dry-run'?: boolean;
+    '--preserve'?: string[];
+    '--verbose'?: boolean;
+    'MCA_FILE'?: string[];
+} = neodoc.run(
+`Usage: mca-trim-chunks-without-signs [OPTIONS] MCA_FILE...
+
+Removes chunks from MCA files that do not contain a matching sign block. Signs
+need to have at least one letter or number on them to differentiate them from
+naturally generated signs.
+
+This does not change the file size. Similar to deleting a file on a hard drive,
+the space is marked as free but not overwritten.
+
+Options:
+    -h, --help      Show this message.
+    -n, --dry-run   Do not write changes to the file.
+    --preserve CHUNK_COORDINATES...
+                    Do not remove chunks with these coordinates. Coordinates
+                    are in the format "x,z". May be specified multiple times.
+    -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['--preserve']) {
+    args['--preserve'] = [];
+}
+
+if (args['--preserve'].length) {
+    console.log(`Preserving coordinates: ${args['--preserve'].join(' ')}`);
+}
+
+for (const file of args.MCA_FILE) {
+    try {
+        await processFile(file);
+    } catch (e) {
+        console.error(`Error processing file ${file}: ${e}`);
+
+        process.exit(1);
+    }
+}
+
+async function processFile(filename: string) {
+    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;
+    const preservedCoordinates = new Set(args['--preserve']);
+
+    for (const chunk of chunks) {
+        const chunkKey = chunk.chunkKey() || '';
+
+        if (preservedCoordinates.has(chunkKey)) {
+            debugLog(`Preserving chunk (via command-line): ${chunkKey}`);
+
+            if (args['--verbose']) {
+                console.log(`Preserving chunk (via command-line): ${chunkKey}`);
+            }
+        } else if (processChunk(chunk)) {
+            debugLog(`Preserving chunk (sign detected): ${chunkKey}`);
+
+            if (args['--verbose']) {
+                console.log(`Preserving chunk (sign detected): ${chunkKey}`);
+            }
+        } else {
+            debugLog(`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 processChunk(chunk: Chunk): boolean {
+    const blockNames = chunk.uniqueBlockNames();
+
+    for (const blockName of blockNames) {
+        if (blockName.match(/^minecraft:.+_sign$/)) {
+            debugLog(`Found sign: ${blockName}`);
+
+            for (const coords of chunk.findBlocksByName(blockName)) {
+                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();
+                debugLog(`Front: ${JSON.stringify(front)}`);
+                debugLog(`Back: ${JSON.stringify(back)}`);
+
+                if ([...front, ...(back || [])].join('').match(/[a-z0-9]/i)) {
+                    debugLog(`Found a user-created sign. Preserving chunk.`);
+
+                    if (args['--verbose']) {
+                        console.log(`Found a user-created sign: ${JSON.stringify(front)} and ${JSON.stringify(back)}`);
+                    }
+
+                    return true;
+                }
+            }
+        }
+    }
+
+    return false;
+}