3分钟把现实城市搬进我的世界: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 数据和真实高程数据,把地球上任意地点生成为我的世界世界。你圈一个区域,它就输出建筑、道路、地形都与真实一致的 playable 世界。
01|三个真实场景:Arnis 帮你解决什么问题
把自家街巷搬进游戏,和朋友在熟悉的地方见面
你玩我的世界,却只能在随机生成的荒野里打滚。手动照着地图一块块复刻城市,一座街区就要花上几个晚上。Arnis 让你直接在地图界面框选家附近的区域,建筑、街道自动落在真实位置,你和朋友可以站在"你家楼门口"集合。
把真实地形带进地理课堂,让等高线不再抽象
地理老师讲坡度、走向,学生对着纸质等高线图很难有体感。用 Arnis 生成你所在城市周边的真实高程地形,学生走进游戏,用脚丈量起伏,再回头对照地图上的等高线,概念一下就具体了。
快速搭出地标场景与方案原型,省掉从零建模
内容创作者和游戏开发者常需要还原真实地标或对比多个空间方案。传统 3D 建模耗时耗力,而 Arnis 从真实地理数据直接产出可进场的方块场景,换一处区域、调一个参数就能再来一版。
02|从克隆到第一次生成,只需四步
- 克隆仓库,拿到完整源码与图形界面代码。
git clone https://gitcode.com/GitHub_Trending/ar/arnis- 用一条命令启动图形界面,默认功能就是 GUI,无需额外配置。
cargo run --release- 在界面里用矩形工具框选目标区域,选 Java 或 Bedrock 版本,点击 Start Generation。框选时底部会实时显示经纬度,帮你确认范围。
- 想走脚本或服务器流程,用命令行模式指定输出目录和边界框,跳过界面直接生成。
cargo run --release --no-default-features -- --output-dir="你的世界目录" --bbox="最小纬,最小经,最大纬,最大经"03|原理篇:经纬度数字是怎么变成方块坐标的
可以把整个过程想象成做城市比例模型:OpenStreetMap 数据是图纸,高程数据是地形浮雕,Arnis 是那个拿尺子按 1:1 缩放制作模型的人。
难点在于图纸和模型用的是两种"格子纸"——地理坐标是弯在地球表面的经纬网格,我的世界是平直的方块网格。Arnis 先算出选区四角对应多少米,再按统一比例尺把它们铺到方块网格上,核心转换逻辑在 src/coordinate_system/ 目录里,CoordTransformer负责把地理边界框换算成方块边界框。
换算关系可以压缩成一个简化公式:
方块距离 = 真实距离(米) × 缩放因子(块/米)缩放因子为 1.0 时,现实 500 米的街道就是游戏里 500 格长的街道,即 1:1 等比模型。换算完成后,建筑、道路、桥梁这些要素分别在 src/element_processing/ 里逐个"拼上模型",最终由 src/world_editor/ 写出对应版本的世界文件。
04|参数推荐与常见坑:生成前先看这张表
| 参数 | 推荐值 | 效果说明 |
|---|---|---|
--scale | 1.0(滑块范围 0.05–2.5) | 1.0 即 1:1 真实比例;低于 0.3 时建筑、道路会被自动跳过 |
--mode | geo-terrain(默认) | 真实地形+建筑;geo-only 平地+建筑;terrain-only 仅地形 |
--max-tree-size | giant | 树木尺寸上限,从 small 到 giant 共五档 |
--signage | basic | 基础路牌路名;full 额外生成店铺招牌与门牌 |
--rotation | 0 | 整张地图顺时针旋转,范围 -90 到 90 度 |
常见坑:
- Java 版忘写
--output-dir:直接报错退出,参数名和目录路径都要给全;Bedrock 版加--bedrock后可以省略。 - 出生点只写一半:
--spawn-lat和--spawn-lng必须成对出现,且坐标要落在你框选的区域内。 - 区域框得太大:数据量和生成时间随面积迅速增长,大城市建议分块多次生成。
- 只要地形不想要楼:用
--mode terrain-only,它会跳过地图数据查询,速度最快。
05|适用人群篇:Arnis 适合哪三类人
- 如果你是我的世界玩家,可以把老家、学校或喜欢的城市生成出来,和朋友在熟悉的街角跑图。
- 如果你是地理教师,可以把真实高程地形搬进课堂,让等高线、坡度从纸面变成脚下能走的路。
- 如果你是Rust 开发者,可以顺着坐标变换、要素处理、世界写出的模块划分,学习一条"地理数据到游戏世界"的完整流水线。
Arnis 把"看地图"变成了"走进地图",剩下的只差你敲下第一条命令。
- 克隆仓库:
git clone https://gitcode.com/GitHub_Trending/ar/arnis - 通读 README.md,再翻 src/coordinate_system/ 的源码注释看懂坐标变换
- 第一次生成选 1 平方公里左右的小区域,缩放 1.0,模式保持默认
你的城市,只差一条命令就能在方块世界里立起来 🚀
【免费下载链接】arnisGenerate any location from the real world in Minecraft with a high level of detail.项目地址: https://gitcode.com/GitHub_Trending/ar/arnis
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考