# Terrain World Compiler 1.1.0 — standalone Linux release

This build targets **Linux x86_64 with glibc 2.38 or newer**. It was built and checked on Pop!_OS 24.04 LTS (glibc 2.39). Python 3.12.3, NumPy, Pillow, jsonschema and their required runtime components are bundled. No Python installation, pip setup, virtual environment or internet connection is needed to run it. Keep terrain-world-compiler and the complete _internal/ folder together.

Extract the complete archive and enter ready-to-run/terrain-world-compiler-linux-x86_64/. Start the interactive terminal launcher:

```sh
./launch.sh
```

The default layout uses the included examples/layout.json and its two actual input ZIPs. Choose a new output folder; the compiler refuses existing destinations. Alternatively:

```sh
./terrain-world-compiler compile --layout examples/layout.json --output generated/two-map-demo
./terrain-world-compiler validate --input generated/two-map-demo
```

To compile four maps with original local sea levels, use examples/four-map-demo.json. To normalize all four maps and their connectors to sea level 0 m, use examples/common-sea-level.json. Both use the included hv1test.zip through hv4test.zip. The original examples/4mapworld.json is retained as a template with placeholder paths.

Three existing compiled packages are included under examples/compiled-worlds/: my-world (v1, two sources), common-sea-world (v2, two sources), and 4world (v2, four sources). They were copied unchanged and all passed the bundled validator. Validate one without compiling anything:

```sh
./terrain-world-compiler validate --input examples/compiled-worlds/4world
```

In 3JHV, choose **Import compiled-world folder** and select examples/compiled-worlds/4world or your own newly compiled output. The previews/ directory contains existing terrain illustrations; the four-world previews correspond to that preserved 4world package. Rendering and scenery model availability are responsibilities of the viewer, not this compiler.

Use --help or --version for CLI information. PROJECT_README.md and docs/ retain the source application's format, coordinate and join contracts. Their Python --setup instructions apply to the source distribution; they are unnecessary for this executable. All source data and existing compiled examples are retained without regeneration.

Third-party licence/copyright texts are included in licenses/. The matching complete source, examples and native build recipe are in terrain-world-compiler-1.1.0-source-examples-2026-10-06.tar.gz. BUILD_MANIFEST.json records each packaged file and the build platform. VALIDATION.json records focused package checks.

The native executable was checked in a clean environment from another working directory, including tiny v1/v2 compilations, common sea-level normalization, validation, existing-output refusal and interactive terminal prompts. Other Linux distributions and interactive 3JHV viewing remain unverified. Windows and macOS executables are not included.
