# 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².

## 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).

## Source code

- [Arnis GitHub repository](https://github.com/louis-e/arnis): Source code for the desktop app, written in Rust. MIT licensed. 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.