Arnis教程：三步把地球上的任意城市变成Minecraft世界
【免费下载链接】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 的地理数据和真实高程数据，把它们变成细节丰富的地形、道路与建筑，再直接写进你的本地 Minecraft 世界。无论是你生活多年的家乡，还是只在愿望清单里的都市，都能被生成出可进入、可漫游的版本。这篇教程按操作顺序带你走完整流程——从在地图上框出一块区域，到最终进世界验收，最后附上一张你会最常用的参数速查表。
它能为你做哪些事
不需要你手动摆一块方格。Arnis 把真实世界的地理数据作为输入，产出可以直接进入的世界：
- 三大版本通吃：Minecraft Java 版（1.17+）、基岩版，以及 Luanti（Minetest）；
- 数据来自现实：OpenStreetMap 的建筑、道路、水系，加上真实高程数据撑起地形的起伏；对测绘稀疏的区域，还能用 Overture 数据补上缺失的建筑轮廓；
- 交付的是一个成品：地形、路网、建筑轮廓、树木、车辆与地标 3D 模型，甚至连可读的路牌都会一并生成。
30 秒看懂它是怎么工作的
Arnis 的活儿分三步：你先告诉它"要哪一片"——用坐标框，或在地图上直接画框；它去下载这一片对应的 OpenStreetMap 数据和高程数据，把现实体素化；最后把结果写进你指定的世界目录。数据下载之后，处理都在你本机完成，生成完就能玩。
记住一句话就够：你给它一片区域，它还你一个世界。
第一步：用矩形工具在地图上框出你的城市
我们先打开程序。地图顶部的搜索框里输入目标城市，比如 München 或者你家所在的小镇，回车，地图直接缩放到市中心。
接着点左侧工具栏的矩形工具（第二个图标）。按住鼠标在地图上拖一圈，框住你想生成的范围。松手后，屏幕底部会出现一条蓝色坐标栏——"Box" 那一行的四个数字，按 纬度 / 经度 排列，正是--bbox可以直接使用的值，格式为 最小纬度,最小经度,最大纬度,最大经度。
如果这里卡住了，通常是两种情况：选错了工具（第一个图标是点标记，不是框选），或者框得太大——范围越大，下载的数据越多，生成也越久。第一次用，建议先在市中心附近小框一块试试水。
第二步：选好版本，把世界目录指过去
这一步做完，看向右侧的 "Create World" 面板。Java 和 Bedrock 两个按钮是版本切换（Luanti 版则通过命令行参数--luanti选择），下面的世界名默认叫 "Arnis World 1"。
关键是填对世界所在目录。Java 版这个路径必填——可以是已有的世界，也可以是不存在的目录，程序会帮你建好；基岩版则可以省略，默认输出到桌面。如果你的世界很珍贵，动手前先复制一份备份，因为生成是往目录里直接写入的。
第三步：点下 Start Generation，细节随你调
现在点右侧的 "Start Generation" 按钮。进度条会出现在右下角，状态提示变成 "Selection confirmed!"，接下来就是安静等待：小城镇很快，大都会就要久一些。
点击之前，可以先点齿轮图标调几个选项：
- 世界缩放（scale）：1.0 表示 1 格方块等于 1 米，即真实大小；2.0 细节翻倍，耗时也翻倍；0.5 则更粗略、更快；
- 建筑内部（interior）：默认只生成外壳，打开后建筑才有可进入的室内；
- 出生点（spawn）：设定你进世界后出现在哪里，必须在框选的坐标范围内。
习惯命令行的话，跳过界面一行搞定同样的事：
arnis --output-dir="/path/to/your/.minecraft/saves/worldname" --bbox="48.8566,2.3522,48.8600,2.3660"这条命令只做一件事：指定世界目录，再交出坐标框。想从源码构建的话，在仓库根目录执行cargo run --release即可直接启动图形界面。
最常用的参数速查
全部参数定义在 src/args.rs 里，界面设置和命令行共用同一套选项：
| 参数 | 作用 | 默认值 / 范围 |
|---|---|---|
--bbox | 地理范围，格式 最小纬度,最小经度,最大纬度,最大经度 | 必填（用--file时可选） |
--output-dir | 世界放置的目录，别名--path | Java 版必填 |
--scale | 世界缩放，每米多少格方块，1.0 为真实大小 | 1.0，范围 0.05–4.0 |
--mode | 生成模式 | geo-terrain |
--ground_level | 基础地面高度 | -62 |
--interior | 生成建筑内部 | 关 |
--file | 用本地 .osm/.xml 文件，不联网下载 | 可选 |
--debug | 输出详细日志，方便定位问题 | 关 |
--timeout | floodfill 超时，单位秒 | 默认值 |
--mode有三个取值：geo-terrain（默认）在真实高程地形上生成建筑、道路等 OSM 对象；geo-only把 OSM 对象放在平整地面上；terrain-only只生成真实高程地形、不生成任何对象，该模式下--file会被忽略，--bbox必填。
世界打开后，验收这三点
进度条走到 100% 后，在 Minecraft 里打开对应世界。玩家默认会拿到一张锁定地图物品，先用它看整体布局，再放大细看。
按三层来查：
- 地形：起伏是否与现实对得上，河流、湖泊、海岸线最容易核对；
- 路网：道路与路口是否连续；
- 建筑：重要建筑的位置和体量是否符合真实情况。
如果效果不对，对照这几条排查：
- 缩放给小了：
--scale低于 0.3 时道路和建筑已经画不出来，程序会直接跳过对象，只剩地形； - 出生点错了：
--spawn-lat与--spawn-lng必须成对给出，且落在--bbox之内； - 路径给错了：
--output-dir必须指向目录，指到文件上会直接报错； - 生成太慢：先缩小范围或调低
--scale；想定位卡在哪一步就加上--debug，再用--timeout控制 floodfill 的等待上限。
三点都通过，你的现实城市就算成了。不妨从框选家附近那一小块开始，看看它长什么样。
【免费下载链接】arnisGenerate any location from the real world in Minecraft with a high level of detail.项目地址: https://gitcode.com/GitHub_Trending/ar/arnis
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
