{"id":15058937,"url":"https://github.com/louis-e/arnis","last_synced_at":"2026-04-02T14:30:46.172Z","repository":{"id":60648458,"uuid":"535010087","full_name":"louis-e/arnis","owner":"louis-e","description":"Generate any location from the real world in Minecraft Java Edition with a high level of detail.","archived":false,"fork":false,"pushed_at":"2025-05-11T22:29:35.000Z","size":88209,"stargazers_count":7204,"open_issues_count":120,"forks_count":451,"subscribers_count":37,"default_branch":"main","last_synced_at":"2025-05-11T23:24:46.445Z","etag":null,"topics":["maps","minecraft","openstreetmap","osm","overpass-api","rust","tauri"],"latest_commit_sha":null,"homepage":"","language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/louis-e.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null},"funding":{"buy_me_a_coffee":"louisdev"}},"created_at":"2022-09-10T13:42:29.000Z","updated_at":"2025-05-11T23:07:42.000Z","dependencies_parsed_at":"2023-01-20T23:46:13.238Z","dependency_job_id":"247c7d7f-20c3-456c-9778-5b3ce14dfc60","html_url":"https://github.com/louis-e/arnis","commit_stats":null,"previous_names":[],"tags_count":10,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/louis-e%2Farnis","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/louis-e%2Farnis/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/louis-e%2Farnis/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/louis-e%2Farnis/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/louis-e","download_url":"https://codeload.github.com/louis-e/arnis/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253850381,"owners_count":21973661,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["maps","minecraft","openstreetmap","osm","overpass-api","rust","tauri"],"created_at":"2024-09-24T22:33:49.746Z","updated_at":"2026-04-02T14:30:46.162Z","avatar_url":"https://github.com/louis-e.png","language":"Rust","funding_links":["https://buymeacoffee.com/louisdev"],"categories":["Applications","Maps","Rust","Repos","minecraft"],"sub_categories":["Games","Map Games"],"readme":"\u003cimg src=\"assets/git/banner.png\" width=\"100%\" alt=\"Banner\"\u003e\n\n# Arnis [![CI Build Status](https://github.com/louis-e/arnis/actions/workflows/ci-build.yml/badge.svg)](https://github.com/louis-e/arnis/actions) [\u003cimg alt=\"GitHub Release\" src=\"https://img.shields.io/github/v/release/louis-e/arnis\" /\u003e](https://github.com/louis-e/arnis/releases) [\u003cimg alt=\"GitHub Downloads (all assets, all releases\" src=\"https://img.shields.io/github/downloads/louis-e/arnis/total\" /\u003e](https://github.com/louis-e/arnis/releases) [![Download here](https://img.shields.io/badge/Download-here-green)](https://github.com/louis-e/arnis/releases) [![Discord](https://img.shields.io/discord/1326192999738249267?label=Discord\u0026color=%237289da)](https://discord.gg/mA2g69Fhxq)\n\nArnis creates complex and accurate Minecraft Java Edition (1.17+) and Bedrock Edition worlds that reflect real-world geography, topography, and architecture.\n\nThis 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.\nGenerate your hometown, big cities, and natural landscapes with ease!\n\n_**Want to generate on mobile or want larger maps?** [MapSmith](https://arnismc.com/mapsmith/) generates worlds in your browser, no install required._\n\n![Minecraft Preview](assets/git/preview.jpg)\n\u003ci\u003eThis Github page and [arnismc.com](https://arnismc.com) are the only official project websites. Do not download Arnis from any other website.\u003c/i\u003e\n\n## :keyboard: Usage\n\u003cimg width=\"60%\" src=\"assets/git/gui.png\"\u003e\u003cbr\u003e\nDownload the [latest release](https://github.com/louis-e/arnis/releases/) or [compile](#trophy-open-source) the project on your own.\n\nChoose your area on the map using the rectangle tool and select your Minecraft world - then simply click on \u003ci\u003eStart Generation\u003c/i\u003e!\nAdditionally, you can customize various generation settings, such as world scale, spawn point, or building interior generation.\n\n## 📚 Documentation\n\n\u003cimg src=\"assets/git/documentation.png\" width=\"100%\" alt=\"Banner\"\u003e\n\nFull documentation is available in the [GitHub Wiki](https://github.com/louis-e/arnis/wiki/), covering topics such as technical explanations, FAQs, contribution guidelines and roadmaps.\n\n[backgroundvid.webm](https://github.com/user-attachments/assets/420acc19-a850-418e-8397-1a45b05582ab)\n\n## :trophy: Open Source\n#### Key objectives of this project\n- **Modularity**: Ensure that all components (e.g., data fetching, processing, and world generation) are cleanly separated into distinct modules for better maintainability and scalability.\n- **Performance Optimization**: We aim to keep a good performance and speed of the world generation process.\n- **Comprehensive Documentation**: Detailed in-code documentation for a clear structure and logic.\n- **User-Friendly Experience**: Focus on making the project easy to use for end users.\n- **Cross-Platform Support**: We want this project to run smoothly on Windows, macOS, and Linux.\n\n#### How to contribute\nThis 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.\n\nCommand line Build: ```cargo run --no-default-features -- --terrain --path=\"C:/YOUR_PATH/.minecraft/saves/worldname\" --bbox=\"min_lat,min_lng,max_lat,max_lng\"```\u003cbr\u003e\nGUI Build: ```cargo run```\u003cbr\u003e\n\nAfter your pull request was merged, I will take care of regularly creating update releases which will include your changes.\n\nIf you are using Nix, you can run the program directly with `nix run github:louis-e/arnis -- --terrain --path=YOUR_PATH/.minecraft/saves/worldname --bbox=\"min_lat,min_lng,max_lat,max_lng\"`\n\n## :star: Star History\n\n\u003ca href=\"https://star-history.com/#louis-e/arnis\u0026Date\"\u003e\n \u003cpicture\u003e\n   \u003csource media=\"(prefers-color-scheme: dark)\" srcset=\"https://api.star-history.com/svg?repos=louis-e/arnis\u0026Date\u0026theme=dark\" /\u003e\n   \u003csource media=\"(prefers-color-scheme: light)\" srcset=\"https://api.star-history.com/svg?repos=louis-e/arnis\u0026Date\u0026type=Date\" /\u003e\n   \u003cimg alt=\"Star History Chart\" src=\"https://api.star-history.com/svg?repos=louis-e/arnis\u0026Date\u0026type=Date\" /\u003e\n \u003c/picture\u003e\n\u003c/a\u003e\n\n## :newspaper: Academic \u0026 Press Recognition\n\n\u003cimg src=\"assets/git/recognition.png\" width=\"100%\" alt=\"Banner\"\u003e\n\nArnis has been recognized in various academic and press publications after gaining more attention in December 2024.\n\n[Building realistic Minecraft worlds with Open Data on AWS: How Arnis uses elevation datasets at scale](https://aws.amazon.com/de/blogs/publicsector/building-realistic-minecraft-worlds-with-open-data-on-aws-how-arnis-uses-elevation-datasets-at-scale/)\n\n[Floodcraft: Game-based Interactive Learning Environment using Minecraft for Flood Mitigation and Preparedness for K-12 Education](https://www.researchgate.net/publication/384644535_Floodcraft_Game-based_Interactive_Learning_Environment_using_Minecraft_for_Flood_Mitigation_and_Preparedness_for_K-12_Education)\n\n[Hackaday: Bringing OpenStreetMap Data into Minecraft](https://hackaday.com/2024/12/30/bringing-openstreetmap-data-into-minecraft/)\n\n[TomsHardware: Minecraft Tool Lets You Create Scale Replicas of Real-World Locations](https://www.tomshardware.com/video-games/pc-gaming/minecraft-tool-lets-you-create-scale-replicas-of-real-world-locations-arnis-uses-geospatial-data-from-openstreetmap-to-generate-minecraft-maps)\n\n[XDA Developers: Hometown Minecraft Map: Arnis](https://www.xda-developers.com/hometown-minecraft-map-arnis/)\n\nFree to use press assets, including screenshots and logos, can be found [here](https://drive.google.com/file/d/1T1IsZSyT8oa6qAO_40hVF5KR8eEVCJjo/view?usp=sharing).\n\n## :copyright: License Information\nCopyright (c) 2022-2025 Louis Erbkamm (louis-e)\n\nLicensed under the Apache License, Version 2.0 (the \"License\");\nyou may not use this file except in compliance with the License.\nYou may obtain a copy of the License at\n\nhttp://www.apache.org/licenses/LICENSE-2.0\n\nUnless required by applicable law or agreed to in writing, software\ndistributed under the License is distributed on an \"AS IS\" BASIS,\nWITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\nSee the License for the specific language governing permissions and\nlimitations under the License.[^3]\n\nDownload 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.\n\nThe logo was made by @nxfx21.\n\n\n[^1]: https://en.wikipedia.org/wiki/OpenStreetMap\n\n[^2]: https://en.wikipedia.org/wiki/Arnis,_Germany\n\n[^3]: https://github.com/louis-e/arnis/blob/main/LICENSE\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flouis-e%2Farnis","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flouis-e%2Farnis","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flouis-e%2Farnis/lists"}