The real world, block by block.
Generate Minecraft Java Edition worlds from real-world geography.
Website • Download • Features • Screenshots • Changelog
Terravox generates Minecraft Java Edition worlds from real-world geographic data. Pick any rectangle on Earth — urban, rural, mountain, desert — and Terravox builds it block by block using open data from USGS and OpenStreetMap.
No mods required. No Java setup. Just download, run, and drop the output into your Minecraft saves folder.
| Feature | Details |
|---|---|
| LiDAR Elevation | USGS 3DEP at ~10m resolution (US), AWS Terrain Tiles as global fallback. 1:1 meter-to-block height scaling. |
| 11 Land Cover Types | Forest, conifer, scrub, sand, bare rock, farmland, wetland, park, meadow, industrial — each with unique surface materials. |
| Slope-Aware Terrain | Steep slopes get exposed stone and gravel. Moderate slopes get transitional materials. Flat areas get natural ground cover. |
| Roads & Infrastructure | Asphalt roads with sidewalks, yellow center lines, street lights, parking lots, fences, and guard rails. Width varies by road type. |
| Buildings | OSM footprints with glass curtain walls for commercial, brick for residential. Multi-story, roof parapets, interior lights. |
| Water | Rivers with carved channels, lakes with bowl-shaped basins. Sand beaches and graduated shoreline transitions. |
| Trees & Vegetation | 4 tree species with natural clustering. Density-varied ground cover with biome-appropriate flowers, grass, and ferns. |
| Pure Python | Three dependencies: requests, numpy, Pillow. No C++ compilers, no Gradle, no Java required. |
Pre-Alpha — Terravox is under very early active development. Expect rough edges.
Download the latest .exe from the Releases page.
git clone https://github.com/itstooslick/terravox-app.git
cd terravox-app
pip install -r requirements.txt
python main.py --bbox "36.1,-115.2,36.2,-115.1" --name "Las Vegas"terravox.exe --bbox "MIN_LAT,MIN_LNG,MAX_LAT,MAX_LNG" --name "World Name"
Options:
| Flag | Default | Description |
|---|---|---|
--bbox |
(required) | Bounding box: min_lat,min_lng,max_lat,max_lng |
--name |
Terravox World |
World name shown in Minecraft |
--output |
terravox_world |
Output directory |
--scale |
1.0 |
Blocks per meter (1.0 = real scale) |
Example — Las Vegas Strip:
terravox.exe --bbox "36.1080,-115.1800,36.1200,-115.1650" --name "Vegas Strip"
Then copy the output folder to your Minecraft saves directory:
%APPDATA%\.minecraft\saves\
Las Vegas Strip — auto-generated from USGS elevation and OpenStreetMap data.
Pre-alpha build. Roads, buildings, water, and terrain are all placed from real-world coordinates.
This is raw generation output with no manual editing.
| Source | Coverage | Resolution |
|---|---|---|
| USGS 3DEP | Continental US | ~10m (1/3 arc-second) |
| AWS Terrain Tiles | Global | Zoom 14 Terrarium PNG |
| OpenStreetMap | Global | Overpass API |
127 features planned across 10 phases. See the full roadmap on the website.
| Phase | Focus | Features | Status |
|---|---|---|---|
| 1 | Road & Infrastructure | 10 | In Progress |
| 2 | Water Overhaul | 10 | Planned |
| 3 | Building Quality | 16 | Planned |
| 4 | Transportation | 11 | Planned |
| 5 | Urban Details | 15 | Planned |
| 6 | Sports & Recreation | 9 | Planned |
| 7 | Natural World | 17 | Planned |
| 8 | Data Sources | 11 | Planned |
| 9 | Performance | 15 | Planned |
| 10 | GUI | 13 | Planned |
- OS: Windows 10/11
- Minecraft: Java Edition 1.20+
- RAM: 4 GB minimum (larger areas need more)
- Disk: Varies by area size (~50-200 MB per world)
This project was built entirely with Claude Code (Anthropic's AI coding agent). From the NBT writer to the terrain generator to this README — every line of code was written by Claude, directed and tested by a human.
All rights reserved. This software is provided for personal use only.