gitwtfhub

wtf is arnis?

louis-e/arnis — explained in plain English

Analysis updated 2026-06-24

15,698RustAudience · generalComplexity · 2/5LicenseSetup · easy

TL;DR

Desktop app that turns any real-world location from OpenStreetMap into a playable Minecraft world with terrain, roads, and buildings.

Mindmap

mindmap
  root((arnis))
    Inputs
      OpenStreetMap bbox
      Elevation data
      Minecraft save folder
    Outputs
      Java world
      Bedrock world
      Building blocks
    Use Cases
      Recreate your hometown
      Build city tours
      Teach geography
    Tech Stack
      Rust
      Tauri
      OpenStreetMap

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Generate a Minecraft replica of your hometown using OpenStreetMap data.

REASON 2

Build a school project that turns a famous city into a playable Minecraft map.

REASON 3

Generate small real-world maps from the browser using the MapSmith web build.

REASON 4

Tweak world scale and building interior settings before generating a custom landscape.

What's in the stack?

RustTauriOpenStreetMap

How it stacks up

louis-e/arnispyo3/pyo3iii-hq/iii
Stars15,69815,67115,623
LanguageRustRustRust
Setup difficultyeasymoderatemoderate
Complexity2/53/54/5
Audiencegeneraldeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · easy Time to first run · 30min

Prebuilt releases work out of the box, large bounding boxes can take a long time to process.

Apache 2.0 lets you use, modify, and redistribute the code for any purpose, including commercial, with attribution and a patent grant.

Wtf does this do

Arnis is a free, open-source desktop tool that converts real-world map data into a fully playable Minecraft world. You pick any location on Earth, your hometown, a major city, a natural landscape, draw a rectangle around it in the app's map view, point it at your Minecraft save folder, and click "Start Generation." The tool fetches geographic data from OpenStreetMap (a free, crowd-sourced map of the world, similar to Google Maps but open) and elevation data, then automatically builds that terrain, roads, buildings, and natural features as Minecraft blocks. The result is a Minecraft world (compatible with both Java Edition 1.17 and newer, and Bedrock Edition) that reflects the real layout and topography of the chosen area. You can customize settings like the world scale and whether to generate building interiors. The tool is built in Rust (a fast, low-level programming language) and uses Tauri for its graphical interface. It runs on Windows, macOS, and Linux. You can download a ready-made release from the project's GitHub page or compile it yourself. A web-based version called MapSmith is also available if you want to generate smaller worlds without installing anything. Arnis is aimed at Minecraft players and fans who want to explore or build in accurate real-world settings, it has been featured in press outlets and used in educational research for topics like flood awareness. The project is licensed under the Apache 2.0 license, meaning it is free to use and modify.

Yoink these prompts

Prompt 1
Walk me through downloading and running the latest Arnis release on macOS and generating my hometown into Minecraft Java.
Prompt 2
Show me how to build Arnis from source on Linux with Rust and Tauri set up.
Prompt 3
Help me pick the right bounding box size in Arnis so generation finishes under 10 minutes.
Prompt 4
Explain how to import an Arnis-generated world into Minecraft Bedrock Edition on Windows.
Prompt 5
Write a step-by-step guide for a classroom that uses Arnis to create a flood-risk map of a coastal town.

Frequently asked questions

wtf is arnis?

Desktop app that turns any real-world location from OpenStreetMap into a playable Minecraft world with terrain, roads, and buildings.

What language is arnis written in?

Mainly Rust. The stack also includes Rust, Tauri, OpenStreetMap.

What license does arnis use?

Apache 2.0 lets you use, modify, and redistribute the code for any purpose, including commercial, with attribution and a patent grant.

How hard is arnis to set up?

Setup difficulty is rated easy, with roughly 30min to a first successful run.

Who is arnis for?

Mainly general.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.