企业官网建设流程全解析

Arnis 使用教程：3 步在 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 的地理数据和真实高程数据，把现实世界的街道、建筑、地形原样搬进游戏，支持 Java 版（1.17+）、Bedrock 版和 Luanti（Minetest）。适合想复刻家乡、大城市或自然地貌的玩家，也适合第一次接触"数据驱动世界生成"的开源工具新手——按下面的流程走，从装好到生成第一座城，熟练的话十几分钟就够。

它凭什么值得试 🏙️

• 不是套模板，是真数据：建筑轮廓、道路走向来自 OpenStreetMap，山丘和地势来自真实高程数据集，生成的世界和地图上能对照上。
• 三个版本都能出：Java 版、Bedrock 版、Luanti 版都能生成，朋友用什么端就能联什么端。
• 图形界面开箱即用：不用碰命令行也能框选区域、填世界名、点按钮出世界；进阶玩家则可以用 CLI 精确控参。

从零到第一座城 🗺️

1. 装好 Minecraft（Java 1.17+ 或 Bedrock）。
2. 拉取仓库（自行编译需要 Rust 工具链；如果不想编译，也可以直接下载官方 release 的打包程序）：git clone https://gitcode.com/GitHub_Trending/ar/arnis
3. 在仓库目录里启动图形界面：cargo run --release
4. 在界面里搜索城市 → 用矩形工具框选区域 → 填写世界名并选择 Java / Bedrock → 点击Start Generation。
5. 生成完成后打开对应的存档目录（Bedrock 是.mcworld文件，导入即可），你的城已经在世界里了。

框选工具是这个界面里最值得先认识的一块：

两种开法：图形化 / 命令行

新手：走图形界面

• 顶部搜索框输入城市或地点名，地图自动定位
• 用矩形工具在地图上拖出要生成的范围（也可以手动输入lat,lng,lat,lng边界框）
• 填写世界名称，勾选 Java 或 Bedrock，需要的话再调 World Scale、出生点等设置
• 点Start Generation，等进度条走完

进阶：走命令行

适合要复现结果、批量生成或写脚本的场景。核心就两条参数：--output-dir（世界输出到哪）和--bbox（生成哪块区域）：

cargo run --release -- --output-dir="C:/YOUR_PATH/.minecraft/saves/myworld" --bbox="min_lat,min_lng,max_lat,max_lng"

常用开关：

• --bedrock：生成 Bedrock 的.mcworld文件（此时不需要--output-dir）
• --mode：geo-terrain（默认，建筑+真实地形）/geo-only（建筑+平地）/terrain-only（只出地形）
• --scale：世界缩放，1.0 即真实大小
• --spawn-lat/--spawn-lng：指定出生点（两个必须同时给，且要在 bbox 内）
• --interior：生成建筑内部结构
• --gamemode：生存/创造/旁观
• --signage：路牌、店招等可读图块标牌等级（none / basic / full）

全部参数的定义和默认值在 src/args.rs 里查得到，GUI 的控件逻辑在 src/gui/。

把城市调"像"的参数 🎛️

真正影响观感的就这几个：

• World Scale（--scale，0.05–4.0）：调大后同样的现实范围会占更多方块，单栋楼内部细节更完整；但注意低于 0.3 时建筑和道路小到无法表达，只会生成地形和地表覆盖。想要"和真城一样大"就保持 1.0。
• 区域大小（bbox 范围）：框得越大越像真实城市，但生成时间和存档体积成倍上涨，界面对过大的区域会主动警告。第一座城建议先选一个城区（几平方公里内）。
• 版本（Java / Bedrock / Luanti）：Java 版支持的功能最全（如--signage标牌、地图物品），Bedrock 方便导入便携设备联机。
• 建筑内部生成（--interior/ Interior Generation）：默认关闭，打开后建筑不是空心壳子，可以走进去，观感差距很大，代价是生成更慢。
• 细节开关（--overture、--max-tree-size、3D 模型）：Overture 会补上 OSM 缺失的建筑轮廓（稀疏地区有用）；树木上限可从 Small 调到 Giant；车辆、起重机等 3D 道具可用--no-3d一键关掉省时间。

一句话建议：想要更真实，就用 1.0 缩放 + 打开--interior+ 开启 Full 级标牌；追求出图速度就关掉 interior 和 3D 道具。

生成翻车自查 ✅

• Minecraft 版本不够新：Java 端需要 1.17+，低于这个版本直接换新版或换 Bedrock 端
• 区域选太大：界面提示"area too large"时缩小 bbox 再试，先从城区开始
• 缩放低于 0.3：此时建筑被自动跳过，只会有地形——把 scale 拉回 0.3 以上
• Java 没给--output-dir：Java 端输出目录是必填项，且已存在的同名路径必须是文件夹
• 出生点不在框内：--spawn-lat/--spawn-lng落在 bbox 外会被直接拒绝，把出生点挪进区域内
• 世界正在被占用：生成前关掉已打开的同名存档

具体报错信息对照项目 Wiki 的 FAQ 排查，数据抓取逻辑可以看 src/retrieve_data.rs。

结语

第一座城跑通之后，玩法就开放了：把 bbox 挪到另一座城市生成"双城记"，同一区域切 Bedrock 版发给手机上的朋友，或者开一个terrain-only的纯地形世界当跑酷图。下次打开 Arnis，试着把你的出生地一比一搬进游戏吧。

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