louis-e/arnis
GamesGenerate detailed Minecraft worlds of real locations from OpenStreetMap data and elevation datasets.
What it does
Arnis turns a selected real-world area into a Minecraft world, using OpenStreetMap for roads, buildings and land use plus elevation data for terrain. Output targets Minecraft Java Edition 1.21.4+, Bedrock Edition, Luanti (Minetest) and Hytale. It is aimed at players who want their hometown, a city or a landscape recreated block by block, and at people studying procedural world generation from geospatial data.
The project is a Rust/Tauri application with a map-based GUI and a separate command-line mode. Generation settings include world scale, spawn point and building interiors; the full option list is in the wiki.
Quick start
- Download the latest release from the releases page.
- Open the app, use the rectangle tool to select an area on the map, and adjust settings such as scale or spawn point.
- Set the output directory to your Minecraft saves folder and click Start Generation.
- Launch the matching Minecraft version and open the generated world.
To build from source, use cargo run --release for the GUI, or the headless CLI form:
cargo run --release --no-default-features -- --output-dir="C:/YOUR_PATH/.minecraft/saves" --bbox="min_lat,min_lng,max_lat,max_lng"
With Nix, nix run github:louis-e/arnis -- --output-dir=YOUR_PATH/.minecraft/saves --bbox="min_lat,min_lng,max_lat,max_lng" runs the same CLI. Command-line generation modes (winter, One World and others) are documented on the Command Line Usage page. A browser-based alternative for mobile or larger maps is offered separately at MapSmith, outside this repository.
Constraints
- The target Minecraft version is Java Edition 1.21.4+; Bedrock, Luanti and Hytale are also listed as output formats, but check version compatibility before loading a world.
- Output lands in your Minecraft saves directory, so the selected folder must be the one the game reads.
- The tool depends on OpenStreetMap coverage and elevation datasets: areas with sparse OSM data or missing elevation will produce correspondingly incomplete or flat terrain.
- Large areas mean large worlds and longer generation; the README points to the browser service for larger map sizes.
- The Windows executable is signed through SignPath after maintainer approval; only the GitHub releases and arnismc.com are official download sources.
- Licensed Apache-2.0, with the Luanti block mapping derived from MC2MT under LGPL-2.1-or-later.
HotRepo's take
Arnis was discussed on Hacker News at the end of 2024, with the thread collecting 476 points and 70 comments HN discussion. The comments show the practical pull of the idea: one user describes using it to build their neighborhood in Minecraft for their 8-year-old comment, another asks for street signs at intersections to help kids learn the area comment, and a commenter who previously built a similar OSM-based generator for another game highlights how much the OSM tooling ecosystem enables projects like this comment. In HotRepo's recorded Rust daily list for 2026-11-18 the repository added 23 stars and reached position 11 on that list. The appeal is concrete rather than abstract: select a real place, get a playable map of it.
Written by AI from the project's README, updated . The project's own docs are the source of truth.
Hacker News
You might also like
- LiteLDev/LeviLauncher-AndroidAn open-source Android launcher that manages multiple Minecraft Bedrock versions, native mods, Xbox accounts, worlds and resource packs.
- MCRcortex/voxyA Minecraft mod that renders distant chunks at lower detail, so large worlds load and display without harsh draw-distance cutoffs.
- PojavLauncherTeam/PojavLauncherRuns Minecraft: Java Edition on Android phones, including old and new versions and Forge/Fabric mods, for players without a PC.
- HMCL-dev/HMCLA cross-platform Minecraft launcher for players who manage many modded instances and obscure OS/CPU combos.
- LiteLDev/LeviLaunchroidAn Android launcher for Minecraft Bedrock that imports your official APK, runs it without system install, and isolates multiple versions and accounts.