Arnis 教程：3 个参数搞定 Minecraft 城市生成-开发者社区

Arnis 教程：3 个参数搞定 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 数据和真实高程（地表海拔高度信息），把你框选的城市、山地和街道还原成能直接进游戏的方块世界。这篇 Arnis 安装教程从 clone、build 讲到选区出图，顺带说清几个关键参数各自影响什么。

它是怎么工作的

整条数据流其实不长。你先框一个区域，Arnis 就去 OpenStreetMap 的 Overpass 接口要这个范围内的矢量数据——道路、建筑轮廓、水系都在里面。拿到后，osm_parser.rs 把每条要素裁剪到框内、按标签归类。地形是另一条线：elevation/ 会根据你的范围自动挑一个最合适的海拔源（不同地区精度不同，挑不到就逐级降级），把真实起伏换算成方块的 Y 轴高度，再铺到平地上。两条线汇合后，建筑算风格和楼层、道路算车道和材质，最终按你选的客户端写进存档。一句话：地图数据进，方块世界出。

🚀 上手实践：从 clone 到出图

把仓库拉下来编译，就能得到可执行文件：

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

编译完，运行target/release里的程序就有图形界面：左边是一张可搜索、可缩放的地图，用矩形工具框一个街区，右侧选 Java 或基岩、点"Start Generation"即可。如果你更习惯命令行，同一套逻辑也能一条命令批处理，省去逐次点选：

cargo run --release -- --output-dir=你的存档路径 --bbox=最小纬,最小经,最大纬,最大经

✨ 功能亮点

真实地形还原

Arnis 内置了多个海拔数据源，按你框的范围自动选最准的那个，再融合成方块地形。山脉、河谷、海岸线都按真实海拔起伏，飞过去能看到山脊的走向和河谷的弯折。

建筑与路网重建

建筑依据 OpenStreetMap 的标签分配风格和材料，稀疏区域还能靠 Overture Maps 的卫星轮廓补位，处理逻辑集中在 element_processing/；道路按车道数、路面材质和交叉口重建。楼群高低错落、主路与人行道分明，而不是贴一排色块了事。

三种客户端输出

同一份数据可以写成 Java 版、基岩版或 Luanti（Minetest）三种存档，格式处理都在 world_editor/ 里。换平台不用重新生成，选一次导出到对应客户端就行。

配置与调优

真正常用得上的就这几个，其余都有合理默认值：

--bbox：框选范围，越小越快，格式是"最小纬,最小经,最大纬,最大经"。
--scale：世界比例（方块/米），1.0 即真实大小，范围 0.05~4.0，想覆盖更大区域就往小调。
--mode：geo-terrain（默认，真实地形加要素）、geo-only（平地加要素）、terrain-only（只要地形）。
--interior：是否生成建筑内部，默认关，开了更精细也更耗时。
--overture：补 OSM 里缺失的建筑，默认开，稀疏地区尤其有用。

输出端想换平台，加--bedrock或--luanti即可。

⚠️ 踩坑指南

现象：下载阶段反复卡在"Rate limited / Server overloaded"。大概率原因：短时间连发请求 Overpass，或框选范围太大导致超时。解决：等几分钟重试，同时把范围缩到几个街区。
现象：大城市生成慢、内存吃紧甚至中途失败。大概率原因：区域过大，又叠加了--interior室内或超大树。解决：先关室内、把树调小，分块生成再拼合。
现象：某地生成出来建筑很少、大片空地。大概率原因：该地 OSM 数据本身稀疏。解决：保持--overture默认开启，让卫星轮廓补位。