Arnis：1条命令把真实街区的OpenStreetMap数据搬进Minecraft，10分钟出第一个世界

Arnis：1条命令把真实街区的OpenStreetMap数据搬进Minecraft，10分钟出第一个世界

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

Arnis 把现实世界的 OpenStreetMap 数据和高程地形转换成 Minecraft 世界。你只需要给一个边界框和一个输出目录，10 分钟内就能在自己的游戏里走进一条真实的街道。照下面的顺序操作，先跑通，再按需调 3 组参数。

动手前：装好环境，确认能联网

• 已安装 Minecraft Java 版 1.17+
• 已从 https://link.gitcode.com/i/85f9c87e11b90b5b27d16f77fdaff043 克隆仓库，并安装 Rust 工具链（cargo可用）
• 网络可访问——运行时要在线拉取 OSM 数据和地形高程

最小可用配置：只给2个参数就生成

最短的一条命令长这样：

cargo run --release --no-default-features -- \ --output-dir ~/minecraft_world \ --bbox 53.0750,8.8000,53.0800,8.8100

• --output-dir（必需）：世界写入的目录，不存在会自动创建；它决定你进哪个世界。
• --bbox（必需）：按最小纬度,最小经度,最大纬度,最大经度给出矩形范围，它决定生成多大一片。

上面这个框大约覆盖 0.3 平方公里。默认模式是geo-terrain，即 OSM 对象+真实高程，所以什么都不加也能直接出效果。

按你的目标调参：3组参数覆盖90%的需求

想要平地还是山地？改--mode

--mode默认geo-terrain，会在线下载高程数据生成起伏地形。改成geo-only就在平地上生成同样的建筑道路，跳过高程下载，生成更快；改成terrain-only则只留地形、不生成任何 OSM 对象，适合做纯地貌场景。

调大或调小整个城市，用--scale

--scale默认 1.0，即 1 格=1 米，保持真实比例，取值范围 0.05–4.0。改到 2.0 后街道、建筑同比例放大一倍，但相同 bbox 的方块数翻 4 倍，耗时明显上升；低于 0.3 则所有建筑道路会被自动跳过，只剩地形。

决定生成到什么精细度：--interior和--signage

• --interior：默认关闭。加上后建筑内部会生成房间和门，体量和生成时间都会增加，小街区建议保持关闭。
• --signage：默认basic，生成路名、公交站牌等公共标识；改full再加店铺招牌和门牌号，细节更多但同样更耗时。

配置没生效：3个高频报错

1. 现象：启动报Path exists but is not a directory。原因：--output-dir指向了一个已存在的文件。修复：指向一个目录，或换一个不存在的新路径让 Arnis 自行创建。

2. 现象：启动报 scale 必须在 0.05–4.0 之间。原因：--scale传了范围外的值，常见是写成 5.0；而 0.2 能通过校验，却是"假成功"——建筑道路全被跳过，世界只剩地形。修复：想要完整对象就用 0.3 到 4.0 之间的值。

3. 现象：报Invalid LLBBox，或生成的区域和预期相反。原因：四个数没按"纬度先于经度、最小值先于最大值"排，例如把经度放在纬度前面，或把48.85,48.86,2.35,2.36顺序颠倒。修复：核对成53.0750,8.8000,53.0800,8.8100这类"小大小大"顺序。另外--spawn-lat/--spawn-lng要成对出现，且坐标必须落在 bbox 内。

继续深入：从命令行升到GUI和调优

日常使用建议切到内置 GUI（cargo run --release）：在地图上直接画框选区，参数不用记。遇到生成异常，加--debug开调试模式定位问题；参数语义以仓库自带的 README.md 和 src/args.rs 为准。

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