Arnis 完整指南：把真实城市一键搬进 Minecraft 的 4 个核心能力

Arnis 完整指南把真实城市一键搬进 Minecraft 的 4 个核心能力【免费下载链接】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 地理数据和地形高程在你本地直接生成一份可以打开的 Java、基岩或 LuantiMinetest存档。不用手搭不用对地图选定一块区域剩下的它自己跑。一句话定位Arnis 是一个免费开源、用 Rust 写的生成器当前版本 3.1.0Apache-2.0 协议。它的输入是一个经纬度范围输出是一个完整的 Minecraft 世界文件——地形按真实海拔起伏街道和建筑按地图数据摆放再配上树木、车辆和地标等细节。你既可以用图形界面点着玩也可以用命令行脚本化地批量生成。快速上手下载、构建、跑通分两条路看你要界面还是要命令行。图形界面推荐新手git clone https://gitcode.com/GitHub_Trending/ar/arnis cd arnis cargo run --release默认带guifeature跑起来会弹出窗口。在地图上用一个矩形框住你想要的区域选一个世界保存位置点「Start Generation」即可。界面里还能调世界比例、出生点、是否生成建筑内部等选项。命令行推荐批量 / 服务器cargo run --release --no-default-features \ -- --output-dirC:/你的路径/.minecraft/saves/世界名 \ --bbox最小纬度,最小经度,最大纬度,最大经度--bbox用「最小纬度,最小经度,最大纬度,最大经度」四个数。想生成基岩版就加--bedrock想生成 Luanti 世界就加--luanti。用 Nix 的话甚至不用手动装nix run github:louis-e/arnis -- ...。能力拆解它到底还原了什么1. 真实地形 卫星地表Arnis 不是给你一块平地。它按区域拉取高程数据塑造起伏再叠加 ESA WorldCover 2021 的 10 米分辨率卫星地表分类树木覆盖、灌木、草地、农田、建成区等 11 类来决定地面该放什么方块。相关逻辑在 src/elevation/ 和 src/land_cover/。2. 街道与建筑还原地图对象来自 OpenStreetMap走 Overpass 查询解析在 src/osm_parser.rs。如果 OSM 里缺了建筑轮廓它还会从 Overture Maps 补一批见 src/overture.rs并尝试补齐 OSM 建筑缺失的高度。各类地物怎么建模拆在 src/element_processing/ 下建筑、道路、桥梁、水体各占一个文件。3. 细节装饰生成结果里有一整箱现成的立体物件按真实纬度分区打包的几百种树assets/tree-packs/含非洲、亚洲、欧洲、北美等分区、汽车、船只、灯塔、直升机、起重机以及慕尼黑奥林匹克等真实地标结构src/structures/。路牌、门牌、广告牌这类文字标识由 src/decals/ 用字体贴图绘制。4. 三种生成模式--mode对应界面里的下拉框定义在 src/args.rsgeo-terrain默认真实高程地形 OSM 对象geo-only真实对象但地面是平的terrain-only只要地形不查任何 OSM / Overture 数据最快进阶玩法把世界调成你要的样子几个常用开关够你把生成结果往预期方向推--scale块/米比例1.0是真实大小范围 0.05–4.0。比例太大一平方公里就要几 GB 内存跑几小时太小则物体失真。--interior生成建筑内部默认关。--rotation整体旋转世界角度在 -90 到 90 之间。--map-preview生成后额外输出一张俯视 PNG 地图--signage full则把店铺招牌、门牌号这类标识也画上。--disable-height-limit装一个加高数据包把建高上限拉到 Y2031需 Java 1.21.4属实验特性。--bedrock/--luanti分别产出.mcworld或map.sqlite一个命令行三种游戏都能出。想更精细地挪动、旋转整片地图可以配合 src/map_transformation/ 的 JSON 操作文件有现成示例在 tests/map_transformation/。踩坑指南现象 → 原因 → 解法现象选了一片很大的区域程序给出黄色提示生成极慢甚至吃满内存。原因src/main.rs 对超过约 250 km² 的选区会主动告警大数据量同时压你的内存和公共服务器。 解法把 bbox 收小先生成一个街区验证效果再逐步扩大。现象生成完只有地形一栋房子、一条路都没有。原因--scale低于 0.3 时道路会被压到 1 块宽、建筑塌成 1×1 的柱子程序会主动跳过 OSM / Overture 对象阈值定义在 src/args.rs 的OBJECT_SKIP_SCALE。 解法把--scale调回 ≥0.3一般用1.0。现象命令行报 Path exists but is not a directory。原因Java 版要求--output-dir指向一个目录若该路径已存在且是个文件就会报错。 解法换成一个目录路径或让程序去一个不存在的目录它会自动创建。现象--mode terrain-only时加了本地文件却仍报缺--bbox。原因terrain-only 模式完全不看 OSM 对象本地--file会被忽略所以永远需要一个显式 bbox。 解法直接传--bbox。现象同时加--bedrock和--luanti直接报错。原因两种输出格式互斥。 解法只保留其中一个。谁适合用以及下一步如果你是服务器管理员、地图创作者、教育或科研里需要真实场景的人或者单纯想把「老家那条街」搬进游戏Arnis 都能直接用图形界面点点就能出结果命令行则适合脚本化和批量生产。下一步建议先用默认geo-terrain模式、--scale 1.0框一个 1–2 km² 的街区跑通确认地形、道路、建筑都对得上再往上叠加--interior、--signage full、--map-preview这些开关把细节一点点补齐。【免费下载链接】arnisGenerate any location from the real world in Minecraft with a high level of detail.项目地址: https://gitcode.com/GitHub_Trending/ar/arnis创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考