Minecraft World Builder

Generate deterministic Minecraft-style voxel worlds from explicit scene specifications and validate them without installing Minecraft.

Current scope

Phase 1 provides an offline Python kernel, canonical JSON, structural and navigation reports, and SVG projections. Browser exploration, image constraints, the Codex skill, and WorldEdit compatibility follow in separate phases.

Quick start

Python 3.12 or newer is required.

uv venv --python 3.12 .venv
uv pip install --python .venv/bin/python -e '.[dev]'
.venv/bin/mc-world-builder compile examples/landmark-district/scene.json --output build/landmark-district

Open build/landmark-district/top.svg and the two section SVGs, then inspect validation.json for required routes and provenance warnings.

Guarantees

• deterministic output for a fixed scene, seed, and compiler version;
• bounded block placement with visible conflicts;
• Minecraft-like two-block clearance and one-block step navigation;
• explicit inferred versus reconstructed interior provenance.

Non-affiliation

This is an independent open-source project. It does not include Minecraft or WorldEdit code or assets and is not affiliated with Mojang, Microsoft, or EngineHub.