Arnis 将真实城市数据转成 Minecraft5 个关键参数与一份能直接用的配置清单【免费下载链接】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 数据和真实高程数据把城市原样建进 Java、Bedrock 或 LuantiMinetest世界默认 1 方块 1 米。会用命令行的人今天就能跑起来。 先跑通一次两个参数加一条命令Arnis 的 GUI 和命令行共用同一套参数CLI 里真正必需的只有两个--bbox告诉它生成真实世界的哪个范围--output-dir告诉它写进哪个世界旧脚本里的--path别名仍有效。其余参数都有合理默认值缩放 1.0、地面高程 -62、模式 geo-terrain。# 拉取源码并构建 CLI 版本 git clone https://gitcode.com/GitHub_Trending/ar/arnis cd arnis cargo run --release --no-default-features -- \ --output-dir ~/mc/worlds/arnis-test \ --bbox 48.1370,11.5755,48.1420,11.5850--output-dir必须是一个已存在的 Minecraft 世界Java 版会校验目录里是否有 region 文件夹路径不合格直接报错不会在半路才失败。示例 bbox 是慕尼黑一小块约 550×900 米的区域。想跑 GUI 的话则不用碰任何配置文件tauri.conf.json里窗口已是 1000×650 的深色主题capabilities/default.json管权限特性开关在Cargo.toml里预置好了。 按用途读懂参数定位、还原、数据源文档里的参数不少但日常用到的可以归成三类比必需/可选的分类更好记。圈定区域与尺度--bbox、--scale、--rotation、--projection参数管什么怎么设设错了会怎样--bbox真实世界的生成范围min_lat,min_lng,max_lat,max_lng纬度在前顺序写反生成位置直接飞走--scale每米多少方块默认 1.0 即真实大小有效范围 0.05–4.0低于 0.3 会跳过所有物体只剩裸路--rotation整个区块顺时针旋转-90 到 90 度只影响朝向不改形状--projection坐标投影方式local默认每次生成从 (0,0) 开始多块拼进同一个世界时改用 web_mercator底层坐标系分三个模块geographic/管经纬度与边界框cartesian/管平面几何计算transformation.rs负责两者换算细节看 src/coordinate_system/。调节视觉还原--mode、--ground_level、--interior--mode取值结果geo-terrain默认OSM 物体 真实地形geo-only只有物体平地terrain-only只有地形不查 OSM 和 Overture注意旧教程里的--terrain是已弃用的空操作想要平地请用--mode geo-only。其余视觉参数各说一句话--ground_level默认 -62地面基准高程。与本地地形不匹配会出现悬空建筑或埋进地里的道路设得过低还会掉进虚空。--interior默认关闭加上才生成建筑内部。--fillground默认关闭填充地形下方地面。--signagenone / basic / fullfull 额外加商铺招牌和门牌号。--max_tree_sizesmall / medium / big / tall / giant限制示意树的最大尺寸。--no-3d一个开关关掉外部 3D 模型和汽车、船只等道具。控制数据源与性能--file、--timeout、--map_preview场景参数行为复用已有 OSM 数据--file data.json读本地数据不联网bbox 可省略从文件自动解析缓存下载的数据--save_json_file data.json把下载的 OSM 数据存成 JSON下次免下载两者互斥二选一。网络层面可用--downloader换 curl 或 wget--timeout以秒为单位设定洪水填充超时--debug打开排查日志。验证结果时加一个--map_preview生成完会直接渲染一张俯视 PNG不进游戏也能先看个大概。️ 跑完整条流程选区、配参、运行、验证第 1 步选区域。在地图工具里画矩形圈住目标街区读出四角坐标按固定顺序写进--bbox。为什么要在地图上画框而不是硬抄坐标能顺便目测框的大小第一次试 500 米到 1 公里足够。第 2 步配参数。首跑保持默认想看建筑内部再加--interior。--scale越大细节越多但内存和时间是超线性上涨的2.0 以上跑一平方公里要掂量一下机器。第 3 步运行。cargo run --release --no-default-features -- \ --output-dir ~/mc/worlds/arnis-paris \ --bbox 48.8566,2.3522,48.8600,2.3660 \ --scale 2.0 \ --interior第 4 步验证。依次三查打开--map_preview出的 PNG 看路网和建筑轮廓进游戏看出生点可用--spawn_lat/--spawn_lng钉住对照真实街区的几个地标核对是否一致。想知道某个 OSM 标签是怎么变成方块的看 src/element_processing/建筑、桥梁、公路、水域、铁路各有独立处理器。⚠️ 修掉常见问题5 个高频症状与取舍症状生成位置全错或 bbox 解析失败。原因顺序写反。解法顺序固定min_lat,min_lng,max_lat,max_lng纬度在前别把 lat/lng 和 lng/lat 搞混。症状世界里只有马路没有楼物体全糊。原因--scale低于 0.3物体被自动跳过。解法提高 scale真要大范围生成就接受地形 道路别期待细节。症状数据下载反复超时。原因无外网或默认 downloader 被拦。解法用--file直接喂已有数据或--downloader换成 curl/wget成功后用--save_json_file缓存避免重复下载。症状输出路径被拒。原因目录不是合法世界。解法Java 版必须指向含 region 的已存在世界Bedrock加--bedrock输出 .mcworld 包不走这个校验。症状建筑悬空或陷地。原因--ground_level与地形不匹配。解法按本地地形高程调整配合--map_preview先看全貌再定。还有一笔取舍要交代--interior、--bake_lighting这类参数都是越好越慢。建议先用 200×200 米的默认参数试一轮确认结果符合预期再逐项加选项——每轮生成前顺手备份原世界出错时不用心疼。【免费下载链接】arnisGenerate any location from the real world in Minecraft with a high level of detail.项目地址: https://gitcode.com/GitHub_Trending/ar/arnis创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考