企业官网建设流程全解析

如何把真实城市搬进 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（Minetest）都支持。下面用「下载 → 选区域 → 选世界 → 生成 → 进游戏」五个步骤带你跑通一遍，全程不需要自己下载地图数据——Arnis 会自动从 OpenStreetMap 和公开高程服务拉取所需数据。

Arnis 能做什么，以及它的数据从哪里来

先说清楚两件事，后面配置才不会迷路：

• 它生成的是「真实比例的地理副本」。你框选巴黎某街区，Minecraft 里就会出现对应的路网、建筑底面和真实地形起伏；著名地标（比如埃菲尔铁塔）还会从社区 3D 模型库里调用精细模型。
• 地图数据不需要你准备。Arnis 内置了数据获取流程：城市对象（路、楼、绿地）来自 OpenStreetMap——一个全球志愿者协作维护的地图数据库；地面高低起伏来自高程数据服务；乡村地区如果 OSM 画得稀疏，还可以叠加 Overture Maps 补充建筑轮廓（默认开启）。

换句话说，你要做的只有三件事：选地点、指路径、点开始。

Arnis 安装：下载发布版或从源码编译

有两种装法，新手建议第一种。

方法一：直接下载发布版（推荐）

到项目仓库的 Releases 页面下载对应系统（Windows / macOS / Linux）的安装包，解压运行即可，得到的是带图形界面的程序。

方法二：从源码编译（需要 Rust 环境）

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

cargo run --release会编译并启动图形界面。以后想反复用，可先cargo build --release得到可执行文件。

步骤一：在 Arnis 地图上框选你的城市区域

打开 Arnis，界面左边是一张可搜索的交互地图，右边是控制面板。

1. 在左上角搜索框输入城市或地标名称（如你的家乡街道名），地图会跳转过去。
2. 选择矩形工具，在地图上拖出一个方框。这个方框就是bbox（bounding box，边界框），即「最小纬度, 最小经度, 最大纬度, 最大经度」围成的矩形区域，Arnis 只生成这个范围内的内容。
3. 方框越大，生成的城市越大，耗时也越长。第一次使用建议框一个 1~2 公里见方的街区试水。

本节收获：你会得到一个明确的生成范围。如果之后想用命令行，把界面上显示的四个坐标数抄下来即可。

步骤二：指定 Minecraft 世界路径

点右侧面板的目录选择，告诉 Arnis 生成的世界写到哪。

• Java 版：选一个已有的世界目录，即 Minecraft 存档文件夹里那个含region子文件夹（存区块数据的文件夹）的世界目录。选好后 Arnis 会把现实城市叠加进这个世界。也可以选saves下新建的空目录，它会替你创建世界，但已有世界必须包含region文件夹。
• 基岩版：不要求填路径，生成的.mcworld文件默认放在桌面，导入基岩版游戏即可。

安全习惯：动老世界之前先备份整个目录，生成过程会写入大量区块文件。

本节收获：路径指向正确，生成结果才会出现在你的游戏存档里，而不是一个找不到的目录中。

步骤三：开始生成，观察进度

一切就绪后点Start Generation（开始生成）。进度条会分阶段显示：拉取 OSM 数据、拉取高程数据、逐区块写入世界。城市数据是现拉现用的，所以首次生成需要稳定的网络；被限流（界面提示 Rate limited）时稍等几分钟重试即可。

命令行玩家对应一条命令，参数含义与 GUI 完全一致（完整参数定义见 src/args.rs）：

arnis --output-dir="C:/Users/你/.minecraft/saves/我的世界" \ --bbox="48.858,2.294,48.862,2.306" --scale 1.0

基岩版加--bedrock参数即可，--output-dir可省略。

本节收获：进度条走完且没有红色报错，说明世界文件已经写入完毕。

步骤四：打开 Minecraft 世界验证

启动 Minecraft，进入选好的世界。出生点默认落在城市中心附近；想让出生点落在某个具体位置，生成前在设置里改Spawn point（出生点坐标），或命令行用--spawn_lat/--spawn_lng。

验证清单：

1. 抬头看天空，确认建筑朝向与现实一致（北方向）。
2. 找一条你认识的主街，对比街边建筑轮廓。
3. 走到山丘或河流位置，看地形起伏是否还原。

本节收获：游戏里跑一圈，确认城市位置、朝向、地形三处都符合预期，这一步才算真正完成。

Arnis 参数调优：scale、ground_level 与 bbox

三个最常用的参数，每个只记住「改它会发生什么 + 建议值」：

另外两个开关值得知道：

• --mode：生成模式。geo-terrain（默认）= 建筑+真实地形；geo-only= 只建东西、地面是平的（生成快）；terrain-only= 只生成地形。
• --interior：给建筑加室内（房间、家具、箱子），效果有趣但明显拖慢生成速度，小区域再开。

进阶技巧与常见坑

• 生成慢：先开geo-only模式或降低--scale排除是数据量问题；大范围生成时关掉--interior和 3D 模型开关（命令行--no-3d）。
• 结果出现奇怪的建筑：多半来自 Overture 补充数据，关掉「Additional Buildings」开关（--overture置反）即可只保留 OSM 内容。
• 想反复调试同一片区域：用--file指向本地导出的 OSM 数据文件，Arnis 不再走网络请求，迭代更快。
• 命令行排错：加--debug输出详细日志；拉数据卡住时用--timeout调长超时时间。
• 树木风格：默认使用内置的立体树库（按树种和地区分类，见 assets/tree-packs/），想要旧版程序化树木加--legacy-trees。
• 多次生成拼接大地图：加--projection web_mercator，各次生成会按统一投影对齐到世界同一位置，而不是各自从 (0,0) 开始。

动手前记住这四件事

1. 首次生成框一个 1~2 公里的街区，--scale 1.0，其他参数全用默认，先把流程跑通。
2. 老世界动手前备份；基岩版用户不需要操心region目录。
3. 网络不稳定就先--mode geo-only或改用--file本地数据，减少对外部服务的依赖。
4. 细节不满意时按「区域 → 比例 → 模式」的顺序调整，一次只改一个参数，便于定位原因。

完整背景与 FAQ 见项目 README.md。现在就打开 Arnis，框选你家附近的街区，用 scale 1.0 生成你的第一张 Minecraft 城市地图吧。

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