Arnis 完整指南：用 OpenStreetMap 真实地理数据快速生成 Minecraft 城市地图

Arnis 完整指南用 OpenStreetMap 真实地理数据快速生成 Minecraft 城市地图【免费下载链接】arnisGenerate any location from the real world in Minecraft with a high level of detail.项目地址: https://gitcode.com/GitHub_Trending/ar/arnisArnis 是一款免费的开源工具读取 OpenStreetMap 地理数据与真实高程数据把它们转换为带地形、道路和建筑的 Minecraft 世界让使用者得以在 Minecraft 重建家乡。它解决的核心问题是真实世界的城市、街道与山丘如何按 1 米对 1 方块的精度搬进游戏里。适合地理教师、城市规划从业者、想复刻家乡与景点的玩家以及需要真实感自定义地图的服务器运营者。项目一览Arnis 的主要数据源是 OpenStreetMap高程栅格来自 Matterhorn 与 AWS Terrain Tiles 等多级来源另有 USGS 3DEP 等区域高精度补充建筑轮廓可由 Overture Maps 补全 OSM 中缺失的图斑植被覆盖参考 Meta 全球树冠高度地图。代码主体用 Rust 编写桌面端图形界面基于 Tauri同时提供完整的命令行模式。工具覆盖 Windows、macOS 与 Linux 三大系统生成结果支持 Minecraft Java 版1.17、基岩版.mcworld以及 LuantiMinetest。项目采用 Apache-2.0 许可由 Louis Erbkammlouis-e创建与维护。图中四格分别是自由女神像、埃菲尔铁塔、巴西利亚城区与山地峡谷展示了 OSM 地理数据转换到 Minecraft 后的实际细节水平。适用场景与人群地理课堂按真实高程与植被分布生成区域讲解地形、气候与水系时比平面地图更直观。城市规划可视化用 OSM 道路、水系与建筑叠加真实高程快速搭出方案比对的 3D 底图。家乡与景点复刻玩家可在 Minecraft 中按真实尺寸重走街道、辨认地标。游戏服务器自定义地图运营者把真实城市区域作为出生点地图或活动场景导入。完成你的第一次转换获取 Arnis 生成器工具从官方发布页下载对应系统的可执行文件是最省事的办法。若需要源码编译克隆仓库后用 Rust 工具链构建git clone https://gitcode.com/GitHub_Trending/ar/arnis cd arnis cargo run --release选区域与基础参数首次生成的最小设置启动后在地图上用矩形工具框选目标区域右侧面板设置世界版本Java / Bedrock、世界名称与生成参数确认后点击 Start Generation。首次生成建议按下面的起步值走14 km² 的面积在细节与耗时之间比较平衡。参数建议值说明区域面积14 km²起步规模过大易超时世界比例--scale1.01 方块 1 米可用范围 0.05–4.0生成模式--modegeo-terrain默认真实地形 OSM 对象geo-only为平地terrain-only仅地形输出目录--output-dir你的 saves 目录Java 版必填上图为区域选择工具用矩形框住目标范围后底部会直接给出经纬度 bbox可用于命令行模式的--bbox参数。生成与导入从数据到世界文件点击开始生成后Arnis 会依次拉取 OSM 与 Overture 数据、把经纬度换算成 Minecraft 坐标、按高程栅格生成地形并放置建筑与设施最终写出完整世界文件。Java 版生成目录会直接放入 saves启动游戏即可选择基岩版输出 .mcworld 文件双击或导入即可。默认还会在玩家物品栏给一张锁定地图方便在生成区域内导航。界面左侧为地图选区右侧面板切换 Java / Bedrock 版本、填写世界名并触发生成底部进度条实时显示生成状态。参数调优与优化参数常见误区建议取值世界比例--scale调得过低小于 0.3 时建筑、道路全部被跳过只剩地形默认 1.0放大细节可试 2.0建筑内部--interior一上来就开启生成时间大幅拉长默认关闭确需室内体验时再启用树木档位--max-tree-size默认 giant植被占比高时生成偏慢细节敏感区域用 small / medium光照烘焙--bake-lighting误开导致耗时明显增加仅使用 Voxy、Chunky 等 LOD 模组时开启Overture 补全--overture在稀疏地区产生卫星误识别建筑OSM 数据稀疏的区域保留城市区域可关闭标牌级别--signagefull 模式会额外生成门牌与店铺招牌默认 basic 即可追求真实再上 full大区域生成有两条实用技巧一是把大区域拆成若干相邻子区域分别生成再用--projection web-mercator让多次生成落在同一坐标系内避免拼接时坐标漂移二是在时间或内存紧张时优先砍掉建筑内部生成与 3D 模型--no-3d这两项是主要开销。原理速览地理数据如何变成方块坐标转换经纬度先换算为 Minecraft 的 XZ 方块坐标。默认 local 模式下每次生成从 (0,0) 开始web-mercator 投影则保证跨区域坐标一致pub fn llbbox_to_xzbbox( llbbox: LLBBox, scale: f64, ) - Result(CoordTransformer, XZBBox), String { if scale 0.0 { return Err(...); } let (scale_factor_z, scale_factor_x) geo_distance(llbbox.min(), llbbox.max()); // 按 scale 把真实距离映射为方块尺寸构造 XZ 包围盒 }地形与生物群系高程栅格叠加到方块高度之后代码按 Koppen 气候分类与土地利用数据把每个区块写入对应生物群系——沙漠变 desert、寒带森林变 taiga、热带水域变 warm_ocean见 biome.rs 与 气候分类。建筑与设施识别OSM 元素按 tag 映射到具体结构涵盖住宅与公共建筑、道路桥梁、水系和交通工具等逻辑集中在 element_processing高程数据源的选择在 elevation/providers。避坑与支持生成时间过长把区域缩小到 2–4 km²关闭--interior并把--max-tree-size降到 medium 或 small。建筑比例失调检查--scale是否过接近下限低于 0.3 时对象会被整体跳过保持 1.0 或 2.0 即可。地形不平滑或起伏异常确认--mode为geo-terrain而非geo-only后者输出平地。内存占用过高拆小区域、关闭 3D 模型与建筑内部避免单次生成覆盖过大 bbox。想要室内空间在较小区域上启用--interior生成完成后逐栋验收。官方文档见仓库根目录 README.md核心源码包括 坐标转换、高程数据源 与 地形后处理。社区交流可在 Discord 进行入口见官方页面。从一个小区域开始第一次生成是最快的上手方式。【免费下载链接】arnisGenerate any location from the real world in Minecraft with a high level of detail.项目地址: https://gitcode.com/GitHub_Trending/ar/arnis创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考