企业官网建设流程全解析

Arnis《我的世界》地图生成工具实操指南：如何快速还原真实城市

【免费下载链接】arnisGenerate any location from the real world in Minecraft with a high level of detail.项目地址: https://gitcode.com/GitHub_Trending/ar/arnis

Arnis 是一款免费开源的《我的世界》地图生成工具，面向想把地图做得"像真的"的玩家与服务端管理员：它拉取指定区域的 OpenStreetMap 数据与真实高程数据，直接产出可加载的 Minecraft（Java/Bedrock）或 Luanti 世界。想把真实城市导入 Minecraft 的人，不再需要一块方块一块地手绘地形。

操作入口很短：框选区域、选择目标游戏版本、点击 Start Generation，下载、坐标换算、方块写入都由工具完成。下面按"装好 → 首张图 → 原理 → 调参"的顺序走一遍。

📍 上手路径：第一次生成《我的世界》城市地图

下载与启动图形界面

最简单的方式是从项目 Release 页面下载对应平台的预编译包，双击运行即可。如果你已安装 Rust 工具链，也可以自行编译：

cargo run --release

启动后左侧是地图，右侧是世界配置与生成按钮，整个界面就这两个部分。

如何把真实城市导入 Minecraft：首次生成步骤

1. 在搜索框输入城市名，或直接缩放定位到目标区域；
2. 用矩形工具框选一块约 1~2 平方公里的区域，首次使用不建议更大；
3. 选择版本（Java/Bedrock）与世界名，点击 Start Generation；
4. 进度条走完后，世界会直接出现在 Minecraft 的世界列表里。

如果需要手填边界坐标，官方文档里提到过地图工具可一键取到包围盒（min_lat, min_lng, max_lat, max_lng），这正是命令行方式的 bbox 参数。

不靠界面：一条命令批量生成

脚本化或重复生成时，可以跳过 GUI，直接给边界和输出目录：

cargo run --release --no-default-features -- \ --output-dir="<你的 .minecraft/saves/worldname 路径>" \ --bbox="min_lat,min_lng,max_lat,max_lng"

默认生成模式是 geo-terrain：把 OSM 对象（建筑、道路）放在真实高程地形上，其余模式用--mode切换。

原理速览：经纬度如何变成方块坐标

整条链路可以拆成三段，数据拉取逻辑在 src/retrieve_data.rs：

• 输入：你框选的经纬度边界，以及下载下来的 OSM 对象数据和高程瓦片；
• 处理：先把经纬度差换算成米（Haversine 公式），乘以世界缩放得到整片区域的方块尺寸，再把每个点的相对位置映射到方块坐标，核心逻辑在 src/coordinate_system/transformation.rs；
• 输出：按方块坐标把建筑、道路、地形、树木写入对应版本的游戏世界文件，写盘实现见 src/world_editor/。

本地模式下的线性映射，简化成伪代码大约是这样：

x = (经度 − 区域最小经度) / 经度跨度 × 区域总长(方块) # 东西向偏移，经度映射到 Minecraft X 轴 z = (1 − (纬度 − 区域最小纬度) / 纬度跨度) × 区域总深(方块) # 南北向偏移，纬度映射到 Z 轴 y = 地面基准高度 + 高程(米)折算的方块高度 # 高程数据决定每列方块的地形高度

除了默认的本地映射，还支持 Web Mercator 投影模式，让多次框选生成的区域共用同一套全局坐标，方便把大片世界拼到一起。

⚙️ 调优与避坑：三个关键参数怎么调

世界缩放（scale）：1 米生成几个方块

• 推荐值：1.0（1 方块 = 1 米），默认值；允许范围 0.05~4.0。
• 适用场景：城区用 1.0，街道宽度和楼高接近真实；大面积自然地形可用 0.3~0.5 压低方块总量。
• 常见错误：调得过高，1 平方公里就会吃掉数 GB 数据与数小时时间；调得过低，低于 0.3 时道路和建筑细节会塌缩，工具会直接跳过对象放置（见 src/args.rs 中OBJECT_SKIP_SCALE的注释）。

生成模式：geo-terrain / geo-only / terrain-only

• 推荐值：首次使用保持默认 geo-terrain（对象 + 真实地形）。
• 适用场景：geo-only 把对象放在平地上，适合快速对比或机器资源有限时试跑；terrain-only 只生成高程地形，速度最快。
• 常见错误：以为地形是"额外功能、默认不开"。现行版本真实高程默认开启，想要平地必须显式指定--mode geo-only。

细节开关：树木、3D 模型与建筑内部

• 推荐值：保持默认——schematic 树木开启、卫星辅助补楼（overture）开启、建筑内部关闭、3D 模型开启。
• 适用场景：大面积生成可用--no-3d关掉 3D 模型提速；用--max-tree-size限制树木尺寸（small/medium/big/tall/giant）；确有需要时再开--interior，它会明显拖慢进度。
• 常见错误：10 平方公里以上区域一次打开全部细节。建议拆成多块分批生成，再在同一个世界里拼接。

延伸与边界：这个开源工具不擅长哪些活

Arnis 适合：把某片真实区域按正确地形与建筑分布还原成可游玩世界，作为服务器底图、教学演示或规划可视化的素材；数据源质量决定了还原度，OSM 覆盖好的城区效果最稳。

不太适合：单一地标的高精度建模（建筑按 OSM 轮廓生成，而非按图纸）；整座超大城市的连续生成（方块量随面积快速膨胀）；车流、行人这类动态内容。

想要更大范围或免安装，可以关注项目提到的浏览器端 MapSmith；想继续本地调参，从 README.md 的模块说明和命令行参数入手即可。

仓库地址（开源，Apache 2.0 协议）：

git clone https://gitcode.com/GitHub_Trending/ar/arnis </output>

【免费下载链接】arnisGenerate any location from the real world in Minecraft with a high level of detail.项目地址: https://gitcode.com/GitHub_Trending/ar/arnis