Arnis 上手指南：5步把家乡地理转Minecraft
【免费下载链接】arnisGenerate any location from the real world in Minecraft with a high level of detail.项目地址: https://gitcode.com/GitHub_Trending/ar/arnis
想在游戏里走回上学的路，却发现 Minecraft 里只有平地？真实城市的地形、街道和建筑，其实都能按坐标搬进方块世界。
Arnis 是一款开源工具，把真实世界的地理转Minecraft 世界。它读 OpenStreetMap 数据和高程数据，输出可游玩的地图，Java 版、基岩版和 Luanti 都支持。
数据怎么变成方块：输入、处理、输出
输入：框选区域，自动拉两份数据
在内置地图上拉一个矩形框，工具就自动拉取两份原料。第一份是 OpenStreetMap 矢量数据，含建筑轮廓、道路、水域和用地类型。第二份是高程数据，可在 USGS、AWS Terrain 等数据源间切换，代码在src/elevation/providers/。
处理：投影、缩放、落格三步
地理转Minecraft 的核心逻辑在src/coordinate_system/，分三步走。
- 投影。经纬度无法直接算距离。用 Web Mercator 把区域摊平成平面坐标，平面距离才和真实一致。
- 缩放。区域宽高的米数先向下取整，再乘缩放系数，得到方块尺寸。X 轴和 Z 轴独立计算。
- 落格。高程数据定高度，高差直接映射为方块层数。OSM 数据定内容：建筑轮廓挤出墙体，道路桥梁用预制模块拼装，树木按树种从内置树包挑选。
输出：三种模式，三种客户端
生成结果按目标客户端写盘，Java 版、基岩版、Luanti 各自独立。模式共三种：地形加建筑的全量模式、平地放对象模式、只出地形模式。地形模式跳过 OSM 查询，出图最快。
5步上手：从获取程序到打开世界
- 获取程序。下载对应平台的压缩包运行，或用 cargo 从源码构建。
- 框选区域。地图上用矩形工具框一块地方，第一次建议 1 到 2 平方公里。
- 设置参数。定缩放系数、出生点、是否生成建筑内部，再选目标客户端。
- 点击 Start Generation。进度条依次走过抓数据、投影、方块生成，卡在哪一步都能看出来。
- 打开世界。生成结束后世界写入指定路径，用对应客户端加载，第一帧就能看到自己的城市。
命令行同样能完成地理转Minecraft：--bbox 参数填四个角的经纬度，--output-dir 指定输出目录即可。
适用场景与已知边界
- 家乡复刻：老房子和街道按坐标进游戏，做成彩蛋地图。
- 课堂教具：历史城市的街巷布局变成可步行讲解的场景。
- 方案沟通：规划用地加周边地形，快速出 3D 演示。
- 局限一：大范围生成慢且吃内存，建议分块生成。
- 局限二：偏远地区 OSM 数据不全，建筑还原会缺失。
一个周末，就能让家乡在方块世界里重新立起来。
git clone https://gitcode.com/GitHub_Trending/ar/arnis
【免费下载链接】arnisGenerate any location from the real world in Minecraft with a high level of detail.项目地址: https://gitcode.com/GitHub_Trending/ar/arnis
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
