3 步在 Minecraft 里生成真实城市:Arnis 世界生成实操指南
【免费下载链接】arnisGenerate any location from the real world in Minecraft with a high level of detail.项目地址: https://gitcode.com/GitHub_Trending/ar/arnis
Arnis 是一款免费开源的世界生成工具,把 OpenStreetMap 地理数据和真实高程变成可玩的 Minecraft 世界,支持 Java 1.17+、基岩版和 Luanti,解决你一块一块手动搭地形和建筑的麻烦。想把家乡或大城市搬进游戏,用它就够了。
一、你想在 Minecraft 里逛自己的家乡吗 🌍
如果你也想在 Minecraft 里重建某座城市或某片山地,纯手工搭基本不现实。Arnis 让你只需给一个经纬度范围,它自动从 OpenStreetMap 拉取道路、建筑、水体,再叠上真实高程,输出一个能直接走进去的世界。下面四张都是它体素化出来的真实地点:自由女神像、埃菲尔铁塔和山地河谷。
二、最快上手路径:3 步生成你的第一个 Arnis 世界
准备:装好 Rust 工具链,克隆仓库并编译。
git clone https://gitcode.com/GitHub_Trending/ar/arnis cargo run --release首次编译要几分钟。完成标志:弹出窗口,左边是一张地图,右边有 "Start Generation" 按钮。
操作:在地图上框选你想生成的区域,右侧选 Java 或 Bedrock,点 "Start Generation"。
完成标志:底部进度条走到 100%,出现绿色 "Done! World generation completed."。
验证:把世界放进.minecraft/saves(命令行可用--output-dir直接指定目录),进游戏对照真实地点,看道路、建筑和地形起伏是否对得上。
不想用图形界面,一条命令也能跑:
cargo run --release --no-default-features -- \ --output-dir="/path/to/.minecraft/saves/worldname" \ --bbox="min_lat,min_lng,max_lat,max_lng"完成标志:结尾打印绿色的Done!。
三、原理速览:地图数据是怎么变成方块的
数据流走三步。
第一步是取数。程序以--bbox为范围,从 OpenStreetMap 拉道路、建筑、水体等要素;地图数据稀疏的地区,默认开启的--overture会用 Overture Maps 的卫星探测结果补上缺失的建筑占地。
第二步是地形。高程源的选择在src/elevation/里按区域自动完成,之后做异常值剔除和空洞填补,最后把真实海拔映射到 Minecraft 的 Y 轴。所以真实的山坡、河谷在游戏里都看得见。
第三步是元素建模。标签解析与建模集中在src/element_processing/,道路宽度、水体轮廓、建筑占地都从 OSM 标签映射为方块。树木是还原度最高的部分之一:assets/tree-packs/按气候分区内置了上千棵.schem格式的真实树模,程序按生成地点自动选树种;地标建筑经 3D 模型体素化(src/models_3d/),汽车、起重机、喷泉等道具来自assets/structures/的模板。
四、参数调优:最影响最终效果的 4 个参数 ⚙️
--scale— 默认 1.0 — 控制"一个方块对应几米"的比例,有效范围 0.05 到 4.0,1.0 是真实大小 — 想放大一条街区看细节调大(如 2.0),想俯瞰整座城市调小(如 0.5)。低于 0.3 会自动跳过建筑等物体。
--mode— 默认geo-terrain—geo-terrain是建筑加真实地形,geo-only是平地上只放建筑,terrain-only只出纯地形、完全不查地图数据 — 只要自然景观地形,或不想让地形干扰建筑摆放时用。
--no-3d— 默认不开(即 3D 道具开启) — 加上后关掉外部 3D 模型和汽车、起重机、喷泉等道具,生成明显变快 — 想要低配版、或生成大区域时加。
--signage— 默认basic—none全关,basic保留路名、交通标志和公交站,full再加店招和门牌号 — 想让街道更有生活感时选full。
五、常见坑:内存、缺楼与坐标错位 ⚠️
- 区域大、内存爆或生成巨慢:
--scale偏大是主因。缩小 scale 或把 bbox 切小分批生成 - 地图稀疏地区建筑不出来:OSM 数据本身缺失。保持默认的
--overture开启,用卫星探测补建筑占地 - 同一世界多次生成坐标错位:默认 local 投影每次从原点开始。加
--projection web_mercator;生成前再加--map-preview先渲染一张俯视 PNG 检查布局
六、下一步:Wiki、Issues 与社区
参数细节、生成模式说明和 FAQ 都在项目 Wiki 的技术文档里,查参数先看它。复现不了的生成问题(某片建筑没出来、坐标对不上),带上你的--bbox和完整参数去项目 Issues 页提问。GUI 里也有直达 Discord 社区的入口,生成完记得去晒图。
【免费下载链接】arnisGenerate any location from the real world in Minecraft with a high level of detail.项目地址: https://gitcode.com/GitHub_Trending/ar/arnis
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考