From a school-break prototype to a mapping tool

Arnis is the name of both the smallest town in Germany and the open source project maintained by Louis Erbkamm, which converts real-world data from OpenStreetMap and other sources into Minecraft worlds. Erbkamm has never visited the town itself, though he says he knows where the shops and boats are. Since he started the project in 2022, Arnis has drawn close to 900,000 downloads from GitHub and roughly 70 contributors.

Erbkamm grew up playing Minecraft and began coding at 13, often looking for ways to fold code into the game. Arnis started as a diversion pairing Minecraft with geospatial data, and it landed on GitHub where he already kept his side projects. The first prototype was finished within two weeks during a break from school: hand-written Python built only on OpenStreetMap, slow enough that generating a town took a while. He looked up towns in his home country to find a test case, and a small one suited the slow early generation.

Arnis has a lot of buildings, it has streets, it has waters, it has all kinds of different elements that are useful to test with.

Louis Erbkamm, maintainer of Arnis

The project had no name yet, so it borrowed the town's.

Contribution patterns in an open project

Adding elevation ended Arnis's flat worlds and attracted geospatial specialists from around the world, who brought their own ideas on how to integrate it and started discussions among themselves — which Erbkamm says was exactly what he needed. Larger decisions follow the same open pattern: before porting the project from Python to Rust, he opened discussions on GitHub to gather different perspectives. Contributors have translated Arnis into about 20 languages and built major features independently.

The best thing that has happened to me is essentially this big community on GitHub to see actually people from all kinds of different fields coming together to work on something that I started as a side project.

How real-world objects reach the game

Some features originate on a walk. Erbkamm noticed how many trash bins stood in his city and that none appeared in his generated worlds. Because Minecraft has no dedicated bin, he raised the question with the community and together they settled on a fitting block.

Placement follows one path for everything. For the area a user selects, Arnis queries OpenStreetMap for every mapped element, then resolves each one's coordinates and type. If an element isn't mapped, Arnis cannot place it. Structures too detailed for the map to describe — the Statue of Liberty in New York, Christ the Redeemer in Rio de Janeiro — are handled by converting 3D models into Minecraft blocks.

Review capacity and AI assistance

Erbkamm is the sole maintainer and reviews every pull request himself, so they stack up. He typically works on Arnis in the evenings or on weekends, which means contributors wait until his workday is over. Since bringing AI into the project, he says code reviews and documentation have both increased.

He uses GitHub Copilot to survey open issues and bugs from the latest release, see how many people hit them, trace a bug's origin in the codebase and create a fix.

I could delegate those annoying and boring tasks to Copilot, while I could still have a look at those really cool topics that are related to the development of it.

Large features arrive as large pull requests. He opens them in the GitHub Copilot app for an initial overview and a performance review, with Copilot running in the background to find small changes that would reduce memory usage or generation time.

It takes just one wrong calculation in street lights, for example, to make the generation time of an entire city much slower.

He also keeps a mental list of codebase areas that need extra care whenever someone changes them, and had written the same warnings out by hand repeatedly. Now he starts a few sub-agents in the GitHub Copilot app to examine those cases specifically and to propose corner cases for testing, guarding against regressions in new releases. He values having the terminal, his files, the code changes and the pull request alongside the chat in a single app.

Classroom use and future direction

His favorite application of Arnis is in schools, where teachers have generated their own city or a neighborhood park. Some run it as a contest: every student starts from the same generated area, improves a nearby park or playground with Arnis and Minecraft, and the class reviews the results together.

Recent releases have moved beyond Earth, adding the Moon and Mars. Going forward, Erbkamm wants Arnis to remain easy to use while moving closer to reality — more detail in less time — and to appear in more schools.

Getting started

Download Arnis from github.com/louis-e/arnis, select a location on the map, choose a spawn point and click Start Generation; within a few minutes the world is ready to open in Minecraft. Erbkamm recommends somewhere familiar or memorable, such as a hometown, the Grand Canyon or Niagara Falls, and then looking for what's missing.

So maybe you see a bench that was not generated even though it is there.

Map the object on OpenStreetMap, or report it to Erbkamm if it's a bug and he will fix it.