Arnis 教程：三步生成真实地点的 Minecraft 城市

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 城市：路网沿真实道路走，建筑轮廓取自实地数据，地面起伏来自公开高程服务。默认以创造模式进入，时间停在正午，生成区外围是虚空，不会迷路跑丢。验收标准：进游戏后你站在真实街面上，街道格局和地图一致，手里默认拿着一张锁定全图的小地图。

🚀 最短路径：两个参数跑通第一次生成

环境上二选一：下载对应系统的 release 二进制，或用 cargo 在本地编译最小版；没有 Rust 环境就用二进制。唯一要准备的是边界框，顺序为"最小纬,最小经,最大纬,最大经"，在 OpenStreetMap 的坐标选择页可直接读出。

arnis --output-dir=/path/to/.minecraft/saves/MyCity \ --bbox=48.8566,2.3522,48.8600,2.3660

运行后终端先输出版本号，再依次进入 OSM 数据、Overture 足迹、高程数据三个阶段，末行给出世界目录位置。验证方式：该目录里应有标准 Java 世界结构（level.dat 与 region 文件），并在游戏世界列表里正常进入。

🖥️ 按用途选入口：GUI 试水，CLI 干正事

按场景选：第一次上手开 GUI 窗口，省得记参数名；目标是可复现、脚本化或上服务器，就用命令行。

入口	用途	适合场景
GUI 窗口	地图上框选区域，滑杆和开关配置后一键生成	首次试用、一次性任务
命令行	同一套参数写成 shell 命令	批量、定时任务、无人值守
本地数据文件	--file指向已保存的 .osm/.xml 或 JSON 缓存	离线环境重复生成

GUI 不带参数运行 release 版即可打开（本地编译则用cargo run --release）。它没有独立参数集，界面上的每一项都能写成命令行参数，两个入口共用 src/args.rs 里的同一套校验逻辑。根目录的 tauri.conf.json 只描述窗口与打包信息，日常生成不用碰。

📋 参数速查：位置、大小、跑法三组表

按你实际做决定的顺序排：先定世界放在哪、输出哪个版本，再看尺寸与位置，最后才是细节与运行方式。表中默认值都是不传参数时生效的取值，只改与需求不符的项即可。工具升级后，用--help的输出核对一遍。

在哪生成

参数	默认值	作用
--bbox	必需，可由--file推导	生成区域，顺序"最小纬,最小经,最大纬,最大经"
--output-dir	Java 版必需	世界输出目录，不存在会自动创建；旧名--path
--mode	geo-terrain	对象+真实高程 /geo-only平地 /terrain-only仅高程
--bedrock、--luanti	关（默认 Java）	切换目标版本；基岩版默认把 .mcworld 放到桌面

多大

参数	默认值	作用
--scale	1.0（区间 0.05–4.0）	每米对应方块数；低于 0.3 整体跳过对象
--ground-level	-62	地面基础高度
--spawn-lat、--spawn-lng	自动	出生点，必须成对给出且在 bbox 内
--max-tree-size	giant	图块树尺寸上限，small 到 giant 五档

细节与性能

参数	默认值	作用
--interior	关	生成建筑内部，需显式开启
--signage	basic	none / basic（路名、公交站）/ full（加店招、门牌）
--overture	开	补 OSM 缺失的建筑足迹
--downloader	requests	网络不稳时换curl或wget
--debug	关	详细日志，另输出解析数据与地表调试图
--file、--save-json-file	—	读本地 OSM 数据 / 把下载缓存落盘离线复用
--timeout	内置	洪水填充超时，单位秒

📦 可直接套用的组合：三条现成命令行

每条都是在"最短路径"那条两参数命令上多改两三个开关，粘贴即可执行。

• 高细节市区散步：开内部与全部路牌，出生点钉在街口——arnis --output-dir=~/saves/OldTown --bbox=48.8566,2.3522,48.8600,2.3660 --interior --signage=full --spawn-lat=48.8583 --spawn-lng=2.3575。结果：带内部结构和门牌的街区，出生就在该路口。
• 纯地形预览：arnis --output-dir=~/saves/Ridge --bbox=46.20,12.10,46.23,12.14 --mode=terrain-only。该模式同时跳过 OSM 查询与 Overture 拉取，是三种模式里最快的。
• 离线再生成：首次追加--save-json-file=area.json把 OSM 数据落盘，之后--file=area.json指向它，同一区域的联网请求即可降为零。

🛠️ 出问题速查：四个高频情形

1. 现象：启动即报缺少输出目录。原因：Java 版必须显式给目录，基岩版与 Luanti 才可省略。处理：补--output-dir；目录可不存在、会自动创建，但不能指向已有文件。
2. 现象：下载阶段长时间卡住或报网络错误。原因：默认下载器 requests 在部分环境连通性差。处理：换--downloader=curl或wget；离线就用--file加载本地 .osm/.xml。
3. 现象：大面积生成耗时长、内存占用高。原因：面积乘 scale 的平方超过 200 km² 时程序给出提示，方块量随面积平方增长。处理：先缩小 bbox；确需大范围就调低--scale，注意低于 0.3 后建筑与道路对象不再放置。
4. 现象：无法确认某元素是否被解析。原因：常规运行只打印阶段进度，没有元素级明细。处理：用--file加--debug复现，对照它输出的解析数据文件和调试图，判断元素在哪一步丢失。

记住两件事：--bbox和--output-dir先备好（前者仅在传--file时才可省），其余参数不确定就回"参数速查"三张表里查。现在就能做的一步：打开坐标选择器框选你家那条街，按"最短路径"的两参数命令跑第一次。

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