如何把真实城市搬进 Minecraft:Arnis 从框选到生成的完整流程
【免费下载链接】arnisGenerate any location from the real world in Minecraft with a high level of detail.项目地址: https://gitcode.com/GitHub_Trending/ar/arnis
在地图上圈出一块几平方公里的城市,几分钟后,Minecraft 里就出现了同样布局的街道、楼宇与河床,你可以直接走进去。这就是 Arnis,一个把 OpenStreetMap 与高程数据转成可进入世界的 Minecraft 城市生成工具。
它能做到什么
- 复刻家乡街道:建筑轮廓与路网来自真实的 OSM 数据
- 地标按城市尺度生成:埃菲尔铁塔、自由女神像这类场景会落成可穿行的 Minecraft 城市
- 真实地形加双端支持:高程数据负责山峦与水系,Java 1.17+ 与 Bedrock 都能生成
准备:环境要求与安装方式
| 项目 | 要求 |
|---|---|
| 系统 | Windows / macOS / Linux |
| 客户端 | Minecraft Java 1.17 以上,或最新版 Bedrock |
| 存储 | 至少 10 GB 可用空间,区域越大占得越多 |
三种安装方式,各留一行最短可用命令:
- 预编译包:从官方发布页下载对应系统的安装包,解压即用,无需编译
- Nix:一行命令直接运行,适合已装好包管理器的环境
- 源码:克隆仓库后用 cargo 构建,适合开发者
git clone https://gitcode.com/GitHub_Trending/ar/arnis nix run github:louis-e/arnis主流程:框选区域生成世界
🗺️ GUI 四步完成一次生成:
- 搜索城市:顶部搜索框输入城市名,地图跳转过去,也可以用加号逐级放大
- 框选区域:左侧工具栏选矩形工具,拖出一个蓝色选区
- 填世界名:右侧输入世界名称,选 Java 或 Bedrock,点齿轮还能调比例尺、出生点等选项
- 开始生成:点击 Start Generation,等进度条走到 100%
等价的命令行写法与 GUI 做的事相同,只是把选区换成 bbox 参数:
cargo run -- --output-dir=~/saves/MyCity --bbox="35.65,139.70,35.72,139.80"进阶调参:bbox 参数怎么写与生成选项
🧩 Arnis bbox 参数是四元组,顺序为“西南角纬度、西南角经度、东北角纬度、东北角经度”。示例 35.65,139.70,35.72,139.80 对应东京市中心的一个矩形。
- --mode:默认 geo-terrain 把 OSM 对象放在真实高程上;geo-only 只放平地;terrain-only 只出地形、不放对象
- 水体与道路:OSM 里的湖泊河流会自动变成 Minecraft 水体,路网按真实道路数据铺设
- 室内生成:加
--interior会在建筑内部生成房间分隔与家具,适合想进楼里看看的场景
cargo run -- --output-dir=~/saves/MyCity --bbox="35.65,139.70,35.72,139.80" --interior排障:生成慢、建筑缺失、版本不兼容
- 生成慢
- 现象:进度条半天不动,或比预期慢很多
- 原因:首次生成要下载地理与高程数据,区域越大耗时越长
- 处理:初次区域控制在 2 km × 2 km 以内,更大的范围拆成几次生成
- 建筑缺失
- 现象:城市里某些街区只有空地
- 原因:OSM 在偏远地区的覆盖偏稀疏,缺少建筑轮廓
- 处理:先在 OSM 地图上核对覆盖情况;默认的 Overture Maps 补充会填回一部分
- 版本不兼容
- 现象:世界打不开,或个别方块显示不对
- 原因:方块与特性在不同版本之间有差异
- 处理:Java 用 1.17 以上,Bedrock 用最新稳定版;先升级客户端再试
性能:硬件配置与三个提速点
| 组件 | 最低 | 推荐 |
|---|---|---|
| 处理器 | 四核 2.0GHz | 六核 3.0GHz 以上 |
| 内存 | 8 GB | 16 GB |
| 存储 | 10 GB 可用空间 | 50 GB 以上,优先 SSD |
⚡ 三个提速点:
- 分块生成:把大范围拆成几小块,分别生成后再合并,避免一次性卡住
- 数据缓存:地理数据下载后会缓存,重跑同一区域会快很多
- 多线程:程序并行处理多个区块,多核 CPU 能直接用上
还能怎么玩
- 教育:让学生在 Minecraft 里查看真实地形与城市布局,适合地理课
- 服务器地图:生成一座真实城市,直接作为多人服务器的底图
- 规划预览:按 1:1 尺度查看新建筑方案,评估它对街景的影响
资源导航
- 示例与逻辑:tests/map_transformation/ 有地图变换的输入输出样例;室内生成逻辑在 src/element_processing/subprocessor/buildings_interior.rs
- 项目配置:Cargo.toml 管理依赖,tauri.conf.json 管理桌面窗口与 GUI
- 社区与许可:问题与功能建议到项目 Issues 页提交;代码以 Apache 2.0 许可发布,详见 LICENSE
官方 wiki 提供更细的技术文档与 FAQ。建议你先拿家乡的一小块区域试起手,熟悉流程后再慢慢扩大范围。
【免费下载链接】arnisGenerate any location from the real world in Minecraft with a high level of detail.项目地址: https://gitcode.com/GitHub_Trending/ar/arnis
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考