Arnis 教程：把现实地点 1:1 生成到 Minecraft，新手只需一次框选

【免费下载链接】arnisGenerate any location from the real world in Minecraft with a high level of detail.项目地址: https://gitcode.com/GitHub_Trending/ar/arnis

Arnis 是一个免费开源工具，能把真实世界的任意地点生成到 Minecraft：它读取 OpenStreetMap（OSM，开放街道地图）的建筑、道路、水系数据，再叠加高程数据（地形高度信息），输出可以直接进游戏的 Java Edition（1.21.4+）、Bedrock 或 Luanti 世界。地形起伏、道路走向、楼房轮廓都按真实坐标摆放，你不用手动摆一块方块。

快速上手：下载即用，或从源码编译

两种方式任选。不想折腾环境，直接去 releases 下载对应系统的预编译版本；想自己编译，克隆仓库后用 Cargo 构建：

git clone https://gitcode.com/GitHub_Trending/ar/arnis cd arnis && cargo run --release

cargo run --release --no-default-features -- \ --output-dir="C:/YOUR_PATH/.minecraft/saves" \ --bbox="min_lat,min_lng,max_lat,max_lng"

前者启动图形界面，后者是纯命令行生成。参数不多：--bbox是区域的经纬度边界框，--output-dir指向世界的保存位置（Java 版直接填.minecraft/saves）。

图形界面的操作路径更直观：在地图上搜索城市，用矩形工具框选范围，选择 Java 或 Bedrock，点击 Start Generation 即可。进度条走完就能在游戏里进入这个新生成的世界。

原理速览：数据从经纬度到方块坐标走了三步

1. 数据采集：OSM 提供建筑轮廓、道路网络、水体边界；缺数据的区域可默认补上 Overture Maps 的建筑足迹；
2. 坐标转换：经纬度先解析为地理坐标（src/coordinate_system/geographic/），再经笛卡尔几何运算（src/coordinate_system/cartesian/）落到 Minecraft 方块网格，尺度调整在 src/map_transformation/ 完成；
3. 世界生成：高程数据撑起地形，建筑、道路、植被按元素分类处理，如 src/element_processing/buildings.rs 和 src/element_processing/highways.rs，最终写成游戏世界文件。

进阶参数：四个最值得试的开关

用--scale缩放大城市。世界比例以"每米多少方块"为单位，1.0 是真实尺寸；生成超大范围时调小 scale 即可等比缩小整个场景，坐标关系保持不变。

--height-multiplier控制地形夸张程度。2.0 让山丘变两倍高，0.5 则更平缓；建筑和树木不受影响，超出建造高度上限的起伏会被自动压缩。

风格开关：--winter与--post-apocalyptic。前者给地面、屋顶和树木加雪并冻结河湖；后者把世界变成废墟——建筑坍塌破损、道路开裂、灯光熄灭。

按需选--mode。四档：geo-terrain（地形加 OSM 元素，默认）、geo-only（平地加 OSM 元素）、terrain-only（只留真实地形和自然要素）、blueprint（建筑只画地面轮廓）。加--interior可生成建筑室内结构。

其他实用项：--file指定本地 OSM 文件（.osm/.xml 或 Overpass JSON）离线生成，不再走网络下载；--one-world把多次运行追加进同一个持续世界，适合一个区域一个区域地把整个城市拼起来。

常见问题：数据稀疏、版本限制与生成速度

Q：为什么有的地区建筑稀疏？A：Arnis 的精度依赖 OSM 当地数据完整度，偏远地区覆盖少。可确认--overture保持开启（默认开启），用 Overture Maps 补充 OSM 缺失的建筑足迹。

Q：生成的世界进不去游戏？A：Java Edition 需要 1.21.4 以上版本；Bedrock 版输出 .mcworld 文件，Luanti（Minetest）则是 map.sqlite，按各自启动方式加载即可。

Q：生成要多久？A：主要取决于区域大小和范围里的元素数量，命令行没有固定的时间选项。先用小 bbox 试跑，再逐步扩大区域是最稳的做法。

适用场景：谁会用得上 Arnis

• 地理教学：学生直接走进按真实坐标生成的城市，理解地形与路网布局；
• 方案预览：把规划区域生成到游戏里做直观展示；
• 社区地图：多人协作在一个真实地点里建设和游玩。

完整的参数清单和更多说明在仓库的 Wiki 中。项目仓库：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