arnis README

The project's README from github.com/louis-e/arnis. As one markdown file: README.md.

Banner

Arnis CI Build Status GitHub Release GitHub Downloads (all assets, all releases Download here Discord

Arnis creates complex and accurate Minecraft Java Edition (1.17+), Bedrock Edition, and Luanti (Minetest) worlds that reflect real-world geography, topography, and architecture.

This free and open source project is designed to handle large-scale geographic data from the real world and generate detailed Minecraft worlds. The algorithm processes geospatial data from OpenStreetMap as well as elevation data to create an accurate Minecraft representation of terrain and architecture. Generate your hometown, big cities, and natural landscapes with ease!

Want mobile generation or larger map sizes? MapSmith generates worlds in your browser, no install required.

Minecraft Preview This GitHub page and arnismc.com are the only official project websites. Do not download Arnis from any other website.

:keyboard: Usage


Download the latest release or compile the project on your own.

Choose your area on the map using the rectangle tool and select your Minecraft world - then simply click on Start Generation! Additionally, you can customize various generation settings, such as world scale, spawn point, or building interior generation.

📚 Documentation

Banner

Full documentation is available in the GitHub Wiki, covering topics such as technical explanations, FAQs, contribution guidelines and roadmaps.

backgroundvid.webm

:trophy: Open Source

Key objectives of this project

How to contribute

This project is open source and welcomes contributions from everyone! Whether you're interested in fixing bugs, improving performance, adding new features, or enhancing documentation, your input is valuable. Simply fork the repository, make your changes, and submit a pull request. Please respect the above-mentioned key objectives. Contributions of all levels are appreciated, and your efforts help improve this tool for everyone.

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

--mode selects what gets generated, mirroring the GUI's generation mode dropdown:

Mode Result
geo-terrain (default) Buildings, roads and other OSM objects on real elevation terrain
geo-only OSM objects on flat ground
terrain-only Real elevation terrain, no objects at all (skips the OpenStreetMap query and the Overture fetch entirely, so --overture has no effect)

After your pull request is merged, I will take care of regularly creating update releases which will include your changes.

If you are using Nix, you can run the program directly with nix run github:louis-e/arnis -- --output-dir=YOUR_PATH/.minecraft/saves/worldname --bbox="min_lat,min_lng,max_lat,max_lng"

:star: Star History

Star History Chart

:newspaper: Academic & Press Recognition

Banner

Arnis has been recognized in various academic and press publications after gaining more attention in December 2024.

Building realistic Minecraft worlds with Open Data on AWS: How Arnis uses elevation datasets at scale

Floodcraft: Game-based Interactive Learning Environment using Minecraft for Flood Mitigation and Preparedness for K-12 Education

Hackaday: Bringing OpenStreetMap Data into Minecraft

TomsHardware: Minecraft Tool Lets You Create Scale Replicas of Real-World Locations

XDA Developers: Hometown Minecraft Map: Arnis

Free to use press assets, including screenshots and logos, can be found here.

Copyright (c) 2022-2026 Louis Erbkamm (louis-e)

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.^3

The Luanti block-name mapping in src/luanti_block_map.rs is derived from MC2MT by rollerozxa and is licensed under the GNU Lesser General Public License v2.1 or later. The full attribution and license header are preserved in that file.

Download Arnis only from the official source https://arnismc.com or https://github.com/louis-e/arnis/. Every other website providing a download and claiming to be affiliated with the project is unofficial and may be malicious.

The logo was made by @nxfx21.

NOT AN OFFICIAL MINECRAFT PRODUCT. NOT APPROVED BY OR ASSOCIATED WITH MOJANG OR MICROSOFT.

arnis (louis-e/arnis)

Searching Database…

18.3K ·GitHub
Arnis
Что это такое?Arnis создаёт подробные миры Minecraft (Java Edition 1.17+, Bedrock Edition и Luanti/Minetest), которые повторяют реальную географию, загружая данные из OpenStreetMap и источников высот.
Это приложение для рабочего стола или консольная утилита?И то, и другое: графическое приложение для рабочего стола (на базе Tauri) и консольная утилита с собственными флагами. Можно выбрать область на карте или запустить генерацию без интерфейса через командную строку.
Как сгенерировать мир?Скачайте последний релиз или соберите программу сами, затем выберите область инструментом «прямоугольник» на карте, укажите папку с миром Minecraft и нажмите «Начать генерацию».
Нужно ли что-то устанавливать помимо самого приложения?Никакие внешние учётные записи не нужны: приложение само загружает данные OpenStreetMap и высот. Пользователи Nix могут также запустить его напрямую командой 'nix run'.
Что меняют разные режимы генерации?Флаг --mode определяет, что именно будет построено: 'geo-terrain' размещает здания и дороги на реальном рельефе местности (по умолчанию), 'geo-only' ставит объекты OSM на ровную поверхность, а 'terrain-only' создаёт только реальный рельеф без каких-либо объектов OSM.
На каких операционных системах работает программа?Arnis в первую очередь рассчитан на Windows, macOS и Linux.
Безопасно ли скачивать Arnis только с GitHub?Да: в проекте прямо предупреждают, что официальны только эта страница GitHub и arnismc.com, а любой другой источник загрузки может быть вредоносным.
Можно ли пользоваться Arnis без установки?Да, есть вспомогательный инструмент MapSmith: он создаёт миры прямо в браузере без установки, а также поддерживает генерацию с мобильных устройств и карты большего размера.
Можно ли настроить что-то, кроме самой области?Да, можно изменить такие параметры, как масштаб мира, точка появления игрока и то, генерировать ли внутренние помещения зданий.
Получал ли Arnis признание за пределами проекта?Да: о нём писали Hackaday, Tom's Hardware и XDA Developers, а также его использовали в научных работах, включая кейс AWS о наборах данных высот и обучающую игру Floodcraft о наводнениях для школьников (K-12).
Что делает флаг --overture?Это дополнительный вариант загрузки данных, но он не действует в режиме terrain-only, так как этот режим полностью пропускает и запрос к OpenStreetMap, и загрузку Overture.
What are similar projects?escrcpy, spacedrive, SwitchHosts, dbx, BongoCat, ooosplat, omnyssh, photosuite
Which topics is it in?mapping, openstreetmap, minecraft, procedural-generation, geospatial, tauri, rust, gui, desktop-app, apache-2.0, cross-platform, windows
Creator
louis-e
Size
120.6 MB
Stars
18.3K
Updated
CommitOct 17Releasev3.3.0Oct 05
Age
4y
Commits · 90 Days