3步从现实地图到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 生成一座与家乡同比例尺的 Minecraft 城市。
📋 开篇速览：Arnis 是什么
Arnis 是一个免费开源工具（Apache-2.0 协议），它读取真实世界的 OpenStreetMap 地理数据和数字高程数据，直接生成 Minecraft Java 1.21.4+、Bedrock 或 Luanti（Minetest）世界，建筑、道路、水体、植被和地形一次到位。适合想在游戏中重建真实地点的玩家，也适合想体验 Minecraft 地图生成流程、又不想动手写代码的新手。
🧭 快速上手：3 步拿到你的第一个世界
第一步：获取项目。从源码编译的话：
git clone https://gitcode.com/GitHub_Trending/ar/arnis cd arnis也可以直接下载官方编译好的 release 安装包，省掉下面两步编译。
第二步：启动图形界面。
cargo run --release打开后是一张地图，用矩形工具框选想生成的区域，点击 Start Generation 即可。世界比例尺、出生点、建筑内部生成等选项都可以在开始前调整。
第三步：进游戏。生成出的文件夹直接放进 Minecraft 存档目录，Java 版或 Bedrock 版打开即玩。不想用图形界面也可以走命令行：
cargo run --release --no-default-features -- --output-dir="/path/to/.minecraft/saves" --bbox="min_lat,min_lng,max_lat,max_lng"--bbox填区域对角点的经纬度（最小纬度, 最小经度, 最大纬度, 最大经度），--output-dir指向你的存档文件夹。
🧩 原理拆解：现实数据如何变成方块世界
- 数据采集：程序下载所选区域的 OpenStreetMap 数据（建筑、道路、水体、植被）和高程瓦片，默认高程源是 Mapterhorn，也可切换到 AWS Terrain Tiles 或月面、火星的行星数据源。
- 坐标转换：经纬度经过 Web 墨卡托或局部投影换算成 Minecraft 方块坐标，所有元素走同一套换算逻辑，位置不会互相错位。
- 元素生成与写入：每个 OSM 元素被转成方块结构后，再按目标版本（Java/Bedrock/Luanti）写出世界文件，地形、道路、建筑逐层填充。
⚙️ 参数配置：Arnis 生成参数速查表
GUI 里的每个设置项都有对应命令行参数，新手最常碰到的有：
| 参数 | 作用 | 推荐值 |
|---|---|---|
--bbox | 生成区域，格式 min_lat,min_lng,max_lat,max_lng | 先选约 1 平方公里的小区域 |
--mode | 生成模式：geo-terrain（物体+地形）/ geo-only（平地）/ terrain-only（仅地形）/ blueprint（建筑轮廓） | geo-terrain（默认） |
--scale | 每米对应的方块数，1.0 为真实比例，范围 0.05–2.5 | 1.0 |
--height-multiplier | 地形高度倍数，2.0 让山丘变两倍高 | 1.0 |
--ground-level | 地表所在的 Y 值 | -62（默认） |
--max-tree-size | 树木最大尺寸：small（≤6 格）/ medium（≤12）/ big（≤20）/ tall（≤28）/ giant | giant（默认） |
--overture | 用卫星识别的轮廓补充 OSM 缺失的建筑 | 开（默认），出现幽灵建筑再关 |
--interior | 生成建筑内部房间和家具，速度更慢 | 首次先关 |
--caves | 开凿地下洞穴、矿脉（会带上 --fillground） | 首次先关 |
--signage | 路牌图片等级 none / basic / full，仅 Java | basic（默认） |
--gamemode | 游戏模式 creative / survival / spectator | creative（默认） |
--world-type | 生成区之外：虚空 void 或平坦草地 | void（默认） |
--winter | 积雪、冻结水体、生物群系变雪原 | 按需 |
--one-world | 追加到已有存档，持续扩展同一个 Java 世界 | 首次先关 |
⚠️ 避坑指南：新手高频问题
进游戏找不到城市，四周一片空白？默认会给你一张展示整个世界的锁定地图物品，打开看一眼；或用--spawn-lat/--spawn-lng把出生点指定在区域内部。
区域太大，生成卡住或内存紧张？先缩小--bbox；确实要生成大区域时，把--scale调低（比如 0.5）减少总方块数。
出现了现实中不存在的建筑？默认开启的--overture会用卫星识别的轮廓补 OSM 的空缺，偶尔会误判，关掉该开关即可去掉。
地形太平，或者山太陡？调--height-multiplier（0.25–4）：0.5 让起伏减半，2.0 让山丘翻倍。
🛠 进阶玩法：三个方向继续折腾
主题世界：加--winter得到积雪和冻结水体的深冬版本，加--post-apocalyptic得到建筑残破、道路开裂的废墟版，--caves再加一套地下洞穴系统，可以组合。
真实感立面：--building-facades按建筑类型贴上预制真实立面照片（仅 Java 1.21.4+）；有 Mapillary 账号的话，--mapillary-facades能直接用街景照片还原墙面颜色、窗户和门。
连续扩建：--one-world把多次生成追加进同一个 Java 存档，可以按街区一块块把整座城市建完；注意第一次运行会固定比例尺和地形模式，旋转角度必须为 0。
👨💻 开发者路标：代码从哪读起
- src/coordinate_system/：地理坐标（经纬度包围盒、点位）与 Minecraft 笛卡尔方块网格的定义，是坐标换算的核心
- src/projection/：Web 墨卡托与局部投影的转换，保证所有模块用同一套映射
- src/elevation/：高程瓦片数据源（Mapterhorn、AWS Terrain Tiles、行星体数据）与缓存
- src/element_processing/：把建筑、道路、水体、树木等 OSM 元素逐一转成方块
- src/world_editor/：Java、Bedrock、Luanti 三个版本的存档文件写入
写在最后
Arnis 把现实地理数据变成可玩的 Minecraft 世界，你要做的只是框选一个区域并点击生成。现在打开地图，框出你的家乡，跑第一次生成吧。
【免费下载链接】arnisGenerate any location from the real world in Minecraft with a high level of detail.项目地址: https://gitcode.com/GitHub_Trending/ar/arnis
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
![[workbuddy] 文献综述](http://pic.xiahunao.cn/yaotu/[workbuddy] 文献综述)
