Arnis完整指南把真实城市1:1搬进Minecraft从框选区域到可玩世界【免费下载链接】arnisGenerate any location from the real world in Minecraft with a high level of detail.项目地址: https://gitcode.com/GitHub_Trending/ar/arnisArnis 是一个用 Rust 编写的开源工具Apache-2.0 协议它读取 OpenStreetMap 的街景级地理数据与真实高程数据把任意一片现实区域生成为可直接进游戏的 Minecraft 世界同时支持 Java 版1.17、基岩版和 LuantiMinetest三种格式面向想重建家乡、做地理教学或进行游戏内容创作的初学者与创作者。场景当想带朋友看家乡变成几千个方块的体力活假设你要把学校门口那条街搬进游戏。手工模式意味着查地图确认路宽、数格子摆方块、一栋楼一栋楼地捏外观一条几百米的街道就要耗掉整个周末而水面、坡度、树木这些背景基本只能放弃。Arnis 的做法相反你只需要在地图上框一个矩形工具自动去 OpenStreetMap 拉取道路、建筑、水体、植被的矢量数据从高程数据源如 Matterhorn、USGS 3DEP下载真实地形然后按比例把这些要素逐个落地为方块——道路有真实宽度建筑有楼层和朝向山坡按真实海拔起伏。它的定位不是地图插件而是一个独立运行的生成器GUI 版本适合普通用户点点鼠标命令行版本适合批量和自动化产物就是一个标准世界存档双击即可进游戏。能力总览输入一块区域输出一个世界项目内容数据来源OpenStreetMap道路/建筑/水体/地标、Overture Maps补充建筑轮廓、多源高程数据生成对象地形起伏、道路、桥梁、建筑可选室内结构、树木、水体、招牌与地面贴纸输出格式Java 版世界目录、基岩版 .mcworld 文件、Luanti 的 map.sqlite使用方式Tauri 图形界面 / 命令行参数 / Nix 一键运行可选天体地球之外还支持月球、火星的纯地形生成NASA PDS 数据几个值得注意的细节树木不是随机撒的仓库内置了 assets/tree-packs/ 目录按九个植被区欧洲、东亚、澳洲等提供数百棵真实树种的方块模型选到哪里就长哪里的树招牌系统src/decals/能把路名、公交站、广告牌渲染成游戏内可读的贴图。上手路径环境准备 → 执行生成 → 验证产出环境准备不需要自己写代码。普通用户从官方渠道下载对应系统的预编译版本即可想用源码或想改参数逻辑的读者装好 Rust 工具链后克隆仓库git clone https://gitcode.com/GitHub_Trending/ar/arnis源码构建有两条路径带 GUI 的完整构建或去掉 GUI 依赖的纯命令行构建cargo run --release --no-default-features。用 Nix 的话一条nix run命令也能直接跑仓库根目录的 flake.nix 已配好。执行生成打开 GUI 后左侧是一张可缩放的在线地图用矩形工具拖框选出目标区域框选时界面会实时显示经纬度边界。区域确定后右侧面板配置世界比例、生成模式对象地形 / 仅对象 / 仅地形、出生点等选项点击 Start Generation 开始。命令行等价操作只需要两个参数输出目录和包围盒格式为 最小纬度,最小经度,最大纬度,最大经度例如cargo run --release --no-default-features -- --output-dir~/saves/mytown --bbox48.13,11.55,48.15,11.58。参数定义在 src/args.rs所有可选项及默认值都写在注释里直接看源码即可当文档用。验证产出Java 版会在输出目录生成完整世界文件夹把它放进 .minecraft/saves 就能启动基岩版产出一个 .mcworld 文件双击导入Luanti 则写入标准的 worlds 目录。生成完毕可以加--map-preview输出一张俯视 PNG 总览图不进游戏先检查布局是否符合预期。关键参数与取舍哪些选项值得动参数推荐值实际效果适用场景世界比例--scale1.01 米现实 1 方块建筑按真实尺寸城区重建世界比例0.1–0.3每方块代表数米到数十米覆盖大范围区域生成模式--modegeo-terrain真实地形 OSM 对象默认首选生成模式terrain-only只有地形跳过全部网络抓取快速看山形水系室内结构--interior关闭建筑只有外壳开启后生成楼层与房间想走进某栋楼时招牌--signagebasicbasic 为路名/公交站full 加店铺铭牌、门牌号街道还原度优先选 full树木尺寸--max-tree-sizegiant控制单棵树的方块上限越大越接近真实树冠自然景观旋转--rotation0顺时针旋转 -90 到 90 度可把道路摆正对齐出生点朝向原理一句话比例值决定一个方块等于几米它是全局唯一的缩放轴——地形起伏、道路宽度、建筑尺寸都乘它所以改这一个数字就能在细节丰富但区域小和覆盖大但细节简化之间滑动。效果展示与案例上图是不同区域生成的俯瞰效果密集街区、河岸绿地、道路网都来自同一套数据管线差异只在包围盒位置。地理课堂上的洪水教学。项目被一篇 K-12 教育研究Floodcraft采用研究者用 Arnis 生成真实河网与地形学生在 Minecraft 里体验水位上涨过程把课本上的流域概念变成可以亲自淹一次的场景。真实地形是这类教学成立的前提平面地图给不了坡度带来的汇水感。媒体验证的家乡复刻。Toms Hardware、Hackaday 等科技媒体在 2024 年底报道过该项目核心演示就是把某城市街区 1:1 搬进游戏连街名招牌都对得上。对普通玩家来说这是给朋友展示自己城市的最省事方式。地标与植被的内容化用法。仓库内置了大量可放置结构assets/structures/landmarks/ 下有慕尼黑奥林匹克体育场等标志性场馆的 schem 文件还有车辆、塔吊、风力发电机等道具。配合九大区树的树种模型创作者可以把真实地形当底图叠加这些地标做主题地图。常见坑与排查现象生成了地形但没有建筑道路。原因比例值低于 0.3 时道路宽度不足一个方块工具会自动跳过所有对象。解决把 --scale 提到 0.3 以上或接受纯地形--mode terrain-only的用法。现象一次生成耗时数小时甚至中断。原因大包围盒 × 1.0 比例下方块数量与下载量呈乘积关系。解决拆成 2–4 个包围盒分批生成或用 web_mercator 投影模式让多次生成拼进同一个大坐标空间。现象报错 Provide --bbox, or --file…。原因既没给包围盒也没给本地 OSM 文件。解决二选一注意 terrain-only 模式不读本地文件必须给 --bbox。现象Java 版启动后世界是空的或路径报错。原因--output-dir 对 Java 版是必填项且必须指向目录基岩版则要求目录已存在。解决按平台核对参数见 src/args.rs 中 validate_args 的校验逻辑。现象某些偏僻地区建筑比预期多。原因Overture 卫星检测默认开启会补上 OSM 缺失的轮廓偶尔混入误检。解决加 --overturefalse 回到纯 OSM 数据。现象出生点落在水面或墙里。原因--spawn-lat/--spawn-lng 只校验在包围盒内不校验地形高度。解决生成后看 --map-preview 的俯视图重新选一个开阔点。进阶与扩展源码里值得深挖的模块src/coordinate_system/分 geographic经纬度包围盒 llbbox.rs与 cartesianXZ 方块坐标两层transformation.rs 负责两者换算是理解一个经纬度如何变成一个方块位置的入口。src/elevation/providers/每种高程源一个文件aws_terrain.rs、mapterhorn.rs、usgs_3dep.rs 等selector.rs 决定区域用哪个源。想接自定义高程服务照着现有 provider 实现即可。src/element_processing/按要素类型拆文件buildings.rs 管楼房、bridges.rs 管桥梁、waterways.rs 管河道。新增一类要素比如给停车场画标线从这里入手。src/map_transformation/以 JSON 描述的旋转、平移算子链tests/map_transformation/example_transformations.json 是格式范例。src/world_editor/java.rs、bedrock.rs、luanti.rs 分别负责把方块写入三种格式想输出到别的引擎如 Minetest 之外的沙盒游戏在这里新增一个 writer 是清晰的切入口。收尾一条可以立刻跑通的最小路径下载最新版 Arnis或克隆仓库后执行cargo run --release启动 GUI在地图上框选一个约 1–2 平方公里的街区比例保持 1.0点 Start Generation等待完成后把输出目录放入我的世界存档文件夹进入世界从出生点沿一条你熟悉的街道走一圈做验收。之后想覆盖更大范围再回来对照参数表调比例和模式即可。仓库的完整文档技术原理、FAQ、路线图维护在官方 Wiki代码内的注释覆盖度也足够支持直接读源码改行为。【免费下载链接】arnisGenerate any location from the real world in Minecraft with a high level of detail.项目地址: https://gitcode.com/GitHub_Trending/ar/arnis创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考