Skip to content

FAQ

Jump to bottom
Louis Erbkamm edited this page Sep 3, 2025 · 3 revisions

❓ FAQ

This page collects frequently asked questions about Arnis — covering project history, technical details, data sources, troubleshooting, and generation settings.

📜 Project History

Wasn't this written in Python before?

Yes! Arnis was initially developed in Python, which benefited from Python's open-source friendliness and ease of readability.
To improve performance and scalability, the project was later ported to Rust. The old Python implementation is still available in the python-legacy branch.

🌍 Data Sources

Where does the data come from?

Geographic data is sourced from OpenStreetMap (OSM) — a free, collaborative mapping project.
Data is accessed via the Overpass API, which queries the OSM database.
Services like Google Maps do not provide equivalent open data, making OSM the ideal choice for this project.

🗺️ World Generation

How does the Minecraft world generation work?

Arnis uses the fastnbt Rust crate to interact with Minecraft world files.
The full Processing Pipeline is described in the README and at the Codebase Architecture & Workflow Wiki section, covering data fetching, parsing, sorting, block generation, and world saving.

Where does the name come from?

The project is named after Arnis — the smallest city in Germany.
Its small size made it an ideal test case during early development.

I don't have Minecraft installed but want to generate a world for my kids. How?

When selecting a world, click on "Select existing world" and choose a directory. The world will be generated there.

🐞 Troubleshooting & Common Issues

Arnis instantly closes again or the window is empty!

What Minecraft version should I use?

Minecraft version 1.16.5 and below is currently not supported. For the best results, please use the newest Minecraft version.

The generation finished, but there's nothing in the world!

  1. Teleport to the generation starting point: /tp 0 0 0.
  2. If still empty, try moving into the positive X and positive Z directions — the area may be offset.

Why does Windows Defender SmartScreen warn me about an unrecognized app when opening Arnis?

This is because the application is not signed. Signatures are a way to confirm with a third party issuer that programs are not malicious. However, signing an application is quite expensive and not feasible for me since I work on this project for free. This is why Microsoft Defender automatically warns everyone with this screen. You can safely click on 'Run anyway' if you downloaded Arnis from this Github page and not from any other fake website.

⚙️ Generation Settings

What features are in the world generation settings?

  • Terrain: Enable to include elevation data.
  • Scale Factor: Determines the size of the generated world.
  • Custom BBOX Input: Manually input bounding box coordinates.
  • Floodfill-Timeout (Sec): Max allowed runtime for the floodfill algorithm (affects water areas).
  • Ground Height: Sets the base Y-level of the generated world (controls terrain height).

If your question isn’t answered here, feel free to open a GitHub Issue!

Clone this wiki locally