如何将真实地点转换为 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 世界。一分钟速览Arnis 是什么项目说明定位将真实世界地理数据转换为 Minecraft 地图的开源生成器Rust TauriApache-2.0 协议解决什么问题免手工建模用 OpenStreetMap 高程数据自动生成带真实地形、道路、建筑的 1:1 世界输出格式Minecraft Java 版1.21.4Anvil 格式、基岩版.mcworld、Luanti/Minetestmap.sqlite适用人群Minecraft 玩家、地理/城市规划教学、游戏地图作者获取方式下载 Release 安装包或git clone后用 cargo 自行编译无需任何付费授权当前版本为 3.3.0支持 Windows、macOS、Linux 三平台默认带图形界面Tauri也提供完整的命令行模式。它能做到什么从真实地形到游戏城市真实高程地形拉取卫星级高程数据把丘陵、峡谷、海岸线原样搬进游戏可用--height-multiplier放大或压缩起伏1:1 比例还原默认 1 格 1 米街道宽度、建筑轮廓按 OSM 真实数据生成--scale支持 0.05~4.0 缩放完整城市要素建筑含可选室内生成、道路与立交桥梁、铁路与轨道、水系与岸线、行道树内置 3000 棵 Schematic 树木按全球植被分布选择树种真实立面接入 Mapillary 街景照片重建建筑外墙或使用内置立面贴图包见assets/building-facades/多种生成模式geo-terrain默认、geo-only平地、terrain-only纯地形、blueprint建筑只画轮廓线主题与玩法深冬雪景、废土废墟、Minecraft 原生洞穴矿物8 种洞穴生物群系、可行驶车辆与轨道列车、地标探索成就系统超出地球--body moon/mars可用 NASA PDS 数据生成月球/火星地形上手三步从安装到第一张地图第一步获取代码并编译先安装 Rust 工具链rustup然后克隆仓库并编译git clone https://gitcode.com/GitHub_Trending/ar/arnis cd arnis cargo build --release编译产物在target/release/arnis。如果只是想跑命令行版可用cargo build --release --no-default-features跳过 GUI 依赖。第二步运行图形界面./target/release/arnis界面左侧是地图区域右侧是生成参数面板生成模式、世界比例、地面高度、雪景开关等。第三步框选区域并生成世界用矩形选择工具在地图上框出目标区域下方会实时显示 bbox 经纬度坐标min_lat,min_lng,max_lat,max_lng设置输出目录为你的存档文件夹例如.minecraft/saves点击 Start Generation等待进度条走完世界文件夹即出现在存档目录中打开 Minecraft 就能进入。不想用 GUI 也可以一条命令完成Linux/macOS 示例./target/release/arnis \ --output-dir$HOME/.minecraft/saves \ --bboxmin_lat,min_lng,max_lat,max_lngWindows 上把输出目录换成C:/YOUR_PATH/.minecraft/saves即可。加--bedrock则输出基岩版.mcworld。参数与选项关键配置速查表命令行参数与 GUI 设置一一对应完整清单见 src/args.rs。参数推荐值作用--bbox必填*生成范围格式min_lat,min_lng,max_lat,max_lng--scale1.0每米对应格数1.0 为真实大小合法范围 0.05~4.0--output-dir存档目录世界输出位置Java 版必填基岩版默认桌面--ground-level-62世界地面所在 Y 坐标--modegeo-terrain生成模式geo-only平地/terrain-only纯地形/blueprint建筑轮廓--height-multiplier1.0地形高度倍率0.1~10山丘过高时建议 0.5 压缩--bedrock/--luanti关输出基岩版.mcworld或 Luantimap.sqlite--winter/--post-apocalyptic关深冬雪景 / 末日废墟风格--overture开用 Overture Maps 补齐 OSM 缺失的建筑轮廓--caves关在填充地面下雕刻原生洞穴、矿脉与主题洞穴群系--signagebasic可读标牌none/basic路牌、公交站/full含店招、门牌--moving-vehicles关车辆按限速行驶、列车按线路停靠仅 Java--map-preview关额外导出一张俯视 PNG 地图预览--mapillary-token—Mapillary API 密钥启用街景照片重建建筑立面* 若用--file提供本地 OSM 文件bbox 可从文件中自动推导。原理拆解地理数据如何变成方块Arnis 的生成管线在 src/data_processing.rs 中编排核心数据流为1. 数据获取— src/retrieve_data.rs 并行拉取三类数据OSM 路网与建筑优先走 OSM tile 归档src/osm_tiles.rs、Overture Maps 建筑轮廓src/overture/、高程栅格src/elevation/的 provider 体系Mapterhorn/AWS Terrain Tiles 可选。2. 坐标转换— src/coordinate_system/transformation.rs 的CoordTransformer把经纬度 bbox 换算为局部切平面笛卡尔坐标再按--scale映射为方块坐标--projection web_mercator可改用 Web Mercator 投影使真实经纬度与游戏坐标对齐。3. 高程整形— src/elevation/mod.rs 将原始海拔转换为 Minecraft Y 值postprocess阶段做离群点滤波、异常修复并按scale_to_minecraft_reserving把高差压缩进可用建高范围内。4. 要素处理— src/element_processing/ 按 OSM 标签分派buildings.rs处理建筑与室内、bridges.rs处理立交、railways.rs/waterways.rs处理轨道与水系、tree.rs配合src/trees/的树种库放置树木。5. 世界写入— src/world_editor/ 把方块分区section写入 Java Anvil、基岩版.mcworld或 Luanti 格式src/datapack/再注入成就、信号灯等功能数据包。进阶玩法从一张地图到持久世界One World 持续扩建--one-world让多次运行追加写入同一个 Java 世界配合--projection web_mercator可让各地块的坐标与真实经纬度保持一致逐步盖出一整座城市街景立面配置--mapillary-token后--mapillary-probe可先探测某区域街景覆盖率再生成照片级建筑外墙无密钥时可用--building-facades挂内置立面贴图本地数据复用--file读本地 OSM/Overpass JSON--save-json-file把本次拉取的数据存档离线重复生成洞穴调试--caves --cave-zone-map out.png先渲染洞穴生物群系分布图确认布局再正式生成--cave-biomes lush150,deepdark0可自定义主题占比远视渲染--voxy-lod预生成 Voxy mod 的 LOD 缓存进图即可见地平线--map-preview输出俯视图做快速验收避坑指南最常见的 3 个问题问题 1生成的地图里没有建筑只有地形表现世界只有路面和空地或建筑缩成 1 格小柱子解法检查--scale低于 0.3 时 OSM 对象会被整体跳过道路最小宽度限制同时确认该区域 OSM 数据本身是否完善必要时保持--overture开启补齐建筑问题 2参数组合报错生成直接退出表现如 Cannot use --bedrock and --luanti together解法--bedrock与--luanti互斥--discoveries、--traffic-lights、--moving-vehicles、--zombie-outbreak依赖 Java 版数据包仅对 Java 世界生效--one-world要求--rotation 0且仅限地球 Java问题 3大区域生成极慢或内存吃紧表现数小时不出结果或进程被系统杀掉解法先从小 bbox 验证参数高程网格按 f32 存储城市级区域轻松上千万格内存预留要充足用--no-tile-archive直连 Overpass 会显著变慢默认归档通道更快除非数据有更新需求否则保持默认落地场景谁在用 Arnis地理教学已有多项研究用 Arnis 生成的洪水地形世界做 K-12 防洪教育实验Floodcraft学生在游戏里直观理解水位与城市的关系城市规划可视化把规划区 OSM 数据直接生成 3D 场景向公众展示道路、建筑密度与地形关系的真实尺度效果个人与游戏创作复刻家乡街区作为生存基地或用--post-apocalyptic--caves一键生成末日探险地图结语Arnis 把用真实地理数据生成 Minecraft 地图这条链路完整打通开源、免费、命令行与图形界面双通道从一个小街区到整座城市都可按真实比例还原。下一步git clone仓库并cargo build --release运行 GUI框选一个 1~5 平方公里的熟悉区域输出到.minecraft/saves进游戏核对街道与地标用--scale、--height-multiplier微调比例与起伏尝试--one-world持续扩建你的城市【免费下载链接】arnisGenerate any location from the real world in Minecraft with a high level of detail.项目地址: https://gitcode.com/GitHub_Trending/ar/arnis创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考