Repolode
Submit
louis-e

louis-e/arnis

Generates Minecraft worlds from real-world locations using OpenStreetMap data and elevation terrain, for Java, Bedrock and Luanti.

View on GitHubWebsite
Stars
18,318
Forks
1,533
Open issues
102
Last commit
15 hours ago

What is it?

Arnis is a desktop tool that builds Minecraft worlds from real places. You select an area on a map, and it fetches geospatial data from OpenStreetMap along with elevation data, then turns buildings, roads and other map objects into blocks on terrain that follows the real topography. It targets Minecraft Java Edition (1.17+), Bedrock Edition and Luanti (formerly Minetest).

It can be used through a graphical interface or a command line. Users pick a bounding box, a Minecraft save folder and generation settings such as world scale, spawn point and building interiors. A mode option chooses between terrain with objects, objects on flat ground, or terrain alone. A one-world option lets later runs extend the same persistent world, with all areas placed in a shared Web Mercator frame so neighbouring areas join together.

The project is written in Rust and built with Tauri, and it runs on Windows, macOS and Linux. Its Windows executable is code-signed through SignPath.

Key features

  • 01Builds buildings, roads and other OpenStreetMap objects into Minecraft blocks.
  • 02Applies real elevation data so terrain matches actual topography.
  • 03Supports Minecraft Java Edition 1.17+, Bedrock Edition and Luanti.
  • 04Offers a GUI and a command-line interface with a bounding-box argument.
  • 05Provides generation modes for terrain with objects, flat objects, or terrain only.
  • 06One World mode extends a single persistent world across multiple areas.

Use cases

  • Recreating your hometown or a familiar neighbourhood in Minecraft.
  • Building large city models for games, maps or creative projects.
  • Using real-world terrain in educational or flood-preparedness Minecraft projects.

Quick start

  1. 1

    Download the latest release from the releases page

  2. 2

    Or build and run the GUI from source

    cargo run --release
  3. 3

    Or run from the command line with a bounding box

    cargo run --release --no-default-features -- --output-dir="C:/YOUR_PATH/.minecraft/saves/worldname" --bbox="min_lat,min_lng,max_lat,max_lng"

Things to know

  • The Windows executable is signed only after maintainer approval, and the README notes that only the GitHub page and arnismc.com are official download sources.
  • Large or detailed areas depend on OpenStreetMap and elevation data, so generation quality and speed vary with the area chosen.

Topics

#minecraft#openstreetmap#procedural-generation#geospatial#rust#tauri#world-generation#minecraft-world-generator#osm#overpass-turbo

FAQ

What is arnis?
Generates Minecraft worlds from real-world locations using OpenStreetMap data and elevation terrain, for Java, Bedrock and Luanti. Arnis is a desktop tool that builds Minecraft worlds from real places. You select an area on a map, and it fetches geospatial data from OpenStreetMap along with elevation data, then turns buildings, roads and other map objects into blocks on terrain that follows the real topography. It targets Minecraft Java Edition (1.17+), Bedrock Edition and Luanti (formerly Minetest).
Is arnis free to use? What license does it have?
arnis is open source under the Apache-2.0 license. Check the license terms before using it in commercial products.
Is arnis still maintained?
Actively maintained. The last commit to arnis was on Oct 19, 2026.
What can I use arnis for?
Recreating your hometown or a familiar neighbourhood in Minecraft. Building large city models for games, maps or creative projects. Using real-world terrain in educational or flood-preparedness Minecraft projects.
How do I install arnis?
Download the latest release from the releases page Or build and run the GUI from source: cargo run --release Or run from the command line with a bounding box: cargo run --release --no-default-features -- --output-dir="C:/YOUR_PATH/.minecraft/saves/worldname" --bbox="min_lat,min_lng,max_lat,max_lng"
Where can I get arnis?
The source code and installation instructions are on GitHub: https://github.com/louis-e/arnis

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects