Arnis:把 OpenStreetMap 真实城市一键生成进 Minecraft 世界
2026/9/9 15:33:03 网站建设 项目流程

Arnis:把 OpenStreetMap 真实城市一键生成进 Minecraft 世界

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

Arnis 用 Rust 编写,读取 OpenStreetMap(OSM,全球众包地图数据)与真实高程数据,把划定范围内的现实城市生成成 Minecraft 世界。

📍 手动建城会卡在哪

在 Minecraft 里逐格建城市,一条街就要花上一个周末,还搭不出真实的样子。照着在线地图手动复现,地形只有平地,房屋位置也只能凭感觉摆。想把家乡做成可以给朋友演示的版本,先要解决一件事:地图上的城市怎么变成方块。

🚀 快速安装与首次运行

装好 Rust(自带 cargo 构建工具)后克隆仓库,一条命令启动图形界面:

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

编译完成会弹出窗口:在地图上搜索城市、框选区域,选择 Java 或 Bedrock,点击 Start Generation,进度条走完就能在 Minecraft 的存档目录里看到新世界。

🧩 核心能力:真实地形、精确选区与多版本输出

真实高程地形,而不是平地

Arnis 会拉取真实高程数据(Mapterhorn 及区域高分辨率高程源)来塑造地形,山地城市和滨江街区都保留实际起伏。GUI 下拉菜单或命令行--mode三选一:geo-terrain(建筑+地形,默认)、geo-only(平地上的建筑)、terrain-only(仅地形)。

边界框选区:画个矩形就锁定范围

GUI 的地图上可以直接画矩形,也就是边界框(BBox,由两个对角点坐标确定的矩形范围),生成的坐标能直接以--bbox="min_lat,min_lng,max_lat,max_lng"的形式传给命令行。仓库还提供了一个独立的选区页面,专门用来读取框选坐标。

同一座城市,三个版本输出

同一次生成可以输出 Minecraft Java 版(1.17+)、基岩版(.mcworld 文件)和 Luanti(Minetest 引擎)世界,命令行加--bedrock--luanti即可切换。建筑会带车辆、船只、吊车等 3D 模型和 schem(预先建模好的方块结构)道具,加--no-3d可全部关闭。

🛠️ 进阶用法:生成范围与细节参数怎么调

放大看大范围。--scale控制"每米对应多少方块",1.0 表示与真实世界 1:1,允许范围 0.05 到 4.0。低于 0.3 时建筑和道路已经无法表达,程序会自动跳过对象只生成地形,这时要么调大 scale,要么接受纯地形的结果。

加细节。--interior会生成建筑内部(默认关闭);--signage full把路牌从默认basic(街道名、公交站)升级到建筑级店铺名和门牌号。想控制出生点,--spawn-lat--spawn-lng必须成对出现,--world-time 6000则是正午。

全部参数定义在src/args.rs,建筑、道路等对象的生成逻辑分散在src/element_processing/下按类型分文件(如buildings.rshighways.rs),想扩展就从这两处读起。

❓ 常见问题:两个最容易踩的参数坑

Java 版启动时报缺少--output-dir原因是 Java 版必须指定世界写入的目录(目录不存在会自动创建),而基岩版和 Luanti 不要求。解法:命令里补上--output-dir=你的存档目录,路径可以新指定。

出生点校验失败。现象是报 "Both --spawn-lat and --spawn-lng must be provided together" 或 "must be within the bounding box"。原因是这两个参数必须成对提供,且坐标要落在--bbox范围内。解法:两个参数一起传,并把出生点挪进框选范围。


适合想用真实地图数据复现家乡、地标或山地的玩家和地图作者。建议先用 GUI 生成一个 10 分钟内的小区域,确认效果后再熟悉--scale--mode这些命令行参数。

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

创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询