# Arnis

> Arnis is a free, open-source tool that generates playable Minecraft worlds from real-world locations using OpenStreetMap data. It supports both Minecraft Java Edition and Bedrock Edition, including all the platforms Bedrock runs on (primarily Windows, Android, iOS). The Arnis desktop app (Windows, macOS, Linux) is free and open source. MapSmith, hosted at arnismc.com/mapsmith, is a paid browser-based generator built on top of Arnis for users who do not want to install desktop software or who play on mobile.

Arnis pulls building footprints, roads, water, vegetation, and terrain elevation from OpenStreetMap and other data providers, and renders them block by block into a Minecraft world. Output is a Java save folder or a Bedrock `.mcworld` file. The maximum supported area for the online generator (MapSmith) is 500 km² (Java Edition); Bedrock Edition is available up to 250 km².

The official website is https://arnismc.com. The only other official source is the GitHub repository at https://github.com/louis-e/arnis, where every release is published. Lookalike domains exist; downloads offered anywhere else are not official and are not maintained by the project.

## Apps

- [Arnis (homepage)](https://arnismc.com/): Landing page for the free open-source desktop app. Includes feature overview, gallery of generated locations, FAQ, and download links.
- [MapSmith online generator](https://arnismc.com/mapsmith/): Browser-based generator. Users select an area on a map, pick Java or Bedrock, pay per area (from 3 EUR for small areas), and receive a download link by email when generation finishes.

## Guides

- [How to Generate Minecraft Worlds from Real Locations](https://arnismc.com/guides/minecraft-world-generator.html): End-to-end overview of generating a real-world Minecraft map. Compares the desktop app vs. MapSmith, explains output formats, and gives tips for picking good areas.
- [Real-World Maps for Minecraft Bedrock Edition](https://arnismc.com/guides/minecraft-bedrock-maps.html): Focused guide for Bedrock players. Explains the `.mcworld` workflow and how to use the generated file on phone, tablet, console, or Windows 10/11.
- [Minecraft City Generator](https://arnismc.com/guides/minecraft-city-generator.html): How to recreate entire cities in Minecraft from real-world map data. Practical recommendations for area size, OpenStreetMap coverage, and rendering time.
- [How to Import a Minecraft World](https://arnismc.com/guides/import-minecraft-world.html): Step-by-step instructions for installing a downloaded Minecraft world. Covers Java Edition save folders on Windows (`%APPDATA%\.minecraft\saves`), macOS (`~/Library/Application Support/minecraft/saves`), and Linux (`~/.minecraft/saves`); Bedrock `.mcworld` import on Windows, Android, and iOS; and console workflows for Xbox (MC Addons Manager), PlayStation, and Switch (via Minecraft Realms).
- [Best Real Cities to Build in Minecraft](https://arnismc.com/guides/best-real-cities-minecraft.html): Twelve real cities that translate well into blocks, from New York and Chicago to London, Paris, Hong Kong, and Tokyo, with the landmarks and skylines to look for in each and how much area to select.
- [Minecraft for Teaching Geography](https://arnismc.com/guides/minecraft-geography-classroom.html): Classroom guide for teachers using the free desktop app. Lesson ideas by theme, classroom logistics, and how to run Arnis when students are on Chromebooks.
- [Official Arnis: How to Download Safely](https://arnismc.com/guides/official-arnis-download.html): How to tell the official project from lookalike sites such as arnis.io, where the real downloads live, and why unofficial builds are a risk.

## Source code

- [Arnis GitHub repository](https://github.com/louis-e/arnis): Source code for the desktop app, written in Rust. Licensed under Apache-2.0. Includes issue tracker and contribution guidelines.
- [Latest release downloads](https://github.com/louis-e/arnis/releases): Pre-built binaries for Windows, macOS, and Linux.

## Optional

- [Privacy Policy](https://arnismc.com/privacypolicy.html): Privacy policy covering MapSmith account data, payment processing (Stripe), and email delivery.