MCBE-LevelDB-reader

Reads a MCBE LevelDB database from a .mcworld file. Can also extract all structure files from a world. Powered by Mojang's code from Mojang/minecraft-creator-tools. Works in the browser and in Node.

View full docs here.

Browser usage

import { readMcworld } from "https://esm.sh/mcbe-leveldb-reader";

let file = await fetch("./hermitcraft9.mcworld").then(res => res.blob());
let levelDb = await readMcworld(file);
console.log(levelDb);
Copy

Node usage

npm i mcbe-leveldb-reader
Copy

import { readMcworld } from "mcbe-leveldb-reader";
import { readFile } from "fs/promises";

const fileBuffer = await readFile("./hermitcraft9.mcworld");
const levelDb = await readMcworld(fileBuffer);
console.log(levelDb);
Copy

Changes from minecraft-creator-tools

Most files are taken from the LevelDb reader implementation in from https://github.com/Mojang/minecraft-creator-tools I have taken LevelDb.ts and necessary related files, relocated them around, and changed imports. Most notably, logging has been extracted from relying on the Log static class to be configurable in the constructor. It defaults to console logs if nothing is provided. The first parameter in the init() method, originally a log callback function, has been extracted into a property in the logger passed in the constructor. No idea why Mojang decided to not use the regular logger originally. I have also removed unused methods, interface members etc. in order to keep this library minimal. I also made some methods and fields annotated with "private" actual private properties (e.g. private _isLazyMode -> #isLazyMode) so that bundlers can minify their names.