Arnis 入门实战：把家门口的真实街景变成《我的世界》方块世界
【免费下载链接】arnisGenerate any location from the real world in Minecraft with a high level of detail.项目地址: https://gitcode.com/GitHub_Trending/ar/arnis
Arnis 是能把真实地理数据转换成 Minecraft 世界的开源工具：在地图上框一个区域，它输出一座可以走动的方块城市。建筑布局、路网、桥梁铁轨，甚至地形起伏，都来自 OpenStreetMap 和实际高程数据。本文讲三件事：怎么跑起来、参数怎么调不出错、拿它做什么。
先看看产出：一座能走动的方块城市
第一次生成完成后，结果可以直接进游戏走一圈：
- 建筑按 OSM 街道级数据生成外立面，细节档位下还能生成室内
- 道路、铁路、桥梁、水域按真实布局排布
- 地面高程来自真实高程数据，而不是一马平川
- 支持 Java 版（1.17 及以上）、基岩版和 Luanti（Minetest）
要明白出问题时在哪一环断了，只需要知道这条链：src/osm_parser.rs 解析 OSM 里的道路与建筑，src/coordinate_system/geographic/ 把经纬度换算成投影坐标，src/elevation/ 拉取并处理真实地形，最后由 src/world_editor/ 写入对应版本的游戏世界。这是坐标转换与地理数据转换的主流程，排错时照它定位即可。
5 分钟完成首次生成的 3 个动作
动作一：编译并启动
先装好 Git 和 Rust 工具链，然后拉取源码编译 release 版：
git clone https://gitcode.com/GitHub_Trending/ar/arnis cd arnis cargo build --release运行./target/release/arnis即可打开主界面（Windows 下是 target 目录里对应的 exe）。
动作二：框选区域
顶部搜索框输入城市名，放大到街道可见，用左侧矩形工具拖出要生成的范围。框选完成时，右侧会显示 "Selection confirmed"。
动作三：选版本，点生成
右侧选择 Java 或 Bedrock，确认世界保存位置，点击 Start Generation。进度条走到 100% 后，打开 Minecraft 加载对应世界，家门口的街区已经在方块世界里了。
参数怎么调才不出错
BBOX 选多大合适
生成耗时和内存占用都随面积增长。首次尝试建议矩形边长控制在 2 公里以内，太大容易长时间等待甚至内存不足退出。也可以先用选框工具找出目标区域的 BBOX（由最小/最大经纬度围成的边界框），它既是坐标转换的核心输入，也能直接填进命令行参数：
生成太慢怎么办
- 缩小框选区域，最直接有效
- 在右上角设置齿轮里，可尝试关闭建筑室内生成这类重选项
- 命令行可先用
terrain-only模式只生成地形，排除 OSM 数据环节的问题
地形太平或建筑缺失
- 地面一马平川时，检查生成模式：默认
geo-terrain基于真实高程，geo-only则把对象放在平地上；也可在设置里适当调大高程缩放，让起伏更明显 - 结果里建筑、道路偏少，多半不是工具的错，而是该区域 OpenStreetMap 覆盖不全，先在 OSM 网站上核对原始数据
- 场景整体偏离真实位置时，检查投影设置，默认使用 Web Mercator（EPSG:3857）
它能帮你解决哪类问题
可以走动的地理课
教师框选学校周边或历史城市的地形，学生在游戏里"走"真实的河流、桥梁和高差。讲洪涝风险时，可以直接观察不同海拔对应的水位线，比看等高线地图直观。
关卡设计的真实地形底图
做游戏的同学可以快速拿到山区、海岸或城区的地形作为关卡底子，再往上叠加自己的内容。布局来自真实地理数据的坐标转换结果，不必手绘底图。
项目持续更新中，生成后的世界还可以旋转、平移到既有地图里继续使用。从家门口的街区开始，5 分钟后你就有一座能走动的真实城市。
【免费下载链接】arnisGenerate any location from the real world in Minecraft with a high level of detail.项目地址: https://gitcode.com/GitHub_Trending/ar/arnis
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
