Arnis 故障排除：10 分钟修好 Minecraft 世界生成的坑

Arnis 故障排除：10 分钟修好 Minecraft 世界生成的坑

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

Arnis 是把现实地点生成高细节 Minecraft 世界的开源工具。如果你遇到 CLI 参数报错、地图空白、建筑缺失或世界被锁等 Arnis 故障排除场景，别急。本文按你从启动到导出的真实流程排坑，跟着走就能定位问题。

Arnis 图形界面：用矩形工具圈出区域，点 Start Generation 即可生成

先做这3件事

1. 确认版本号。CLI 启动横幅会打印当前版本；自编译旧版先换最新 release 再谈别的。
2. 先看完整日志再下结论。GUI 日志落在磁盘（Windows 在%LOCALAPPDATA%\com.louisdev.arnis\logs），CLI 直接打终端；加--debug信息更全。
3. 先关 Minecraft、再查磁盘。Java 世界被游戏打开时 Arnis 拿不到锁；目标磁盘至少要 3GB 空闲。

大多数小问题在这三步就拦下来了，后面的内容留给还没解决的情况。

第一次启动：CLI 与 GUI 都跑起来

CLI 报 "Failed to parse bounding box" 或坐标超范围

现象：cargo run刚启动就Error: ...退出，没生成任何世界。原因：--bbox必须按min_lat,min_lng,max_lat,max_lng顺序，纬度在前经度在后。处理：

1. 按正确顺序写坐标，例如--bbox="39.9042,116.4074,39.9092,116.4124"。
2. Java 版还要带上--output-dir，目录不存在会自动创建。

cargo run --release --no-default-features -- --output-dir="C:/path/to/world" --bbox="min_lat,min_lng,max_lat,max_lng"

参数定义在 src/args.rs。还不行：把终端Error:那行原文读一遍，它写明了具体卡在哪一步。

GUI 地图空白、瓦片不显示

现象：窗口打开了，但选区地图是灰色或瓦片缺失，没法框区域。原因：选区地图依赖远端瓦片服务，网络受限时瓦片主机不响应，前端已把错误写进日志文件。处理：

1. 打开上面的日志文件，找[map]或webview前缀的行。
2. 有瓦片报错就先检查网络或代理，再重启应用。
3. 仍不行就在设置面板点 "Clean tile cache"，清掉旧瓦片缓存重新下载。

日志桥接逻辑见 src/gui/js/logging.js。还不行：带着整份日志换网络环境重试。

地图加载正常后，用矩形工具圈出生成区域

跑起来了但结果不对

世界全是平地，没有建筑和道路

现象：生成显示成功，进世界却只有地形，房屋道路全缺。原因：世界比例低于 0.30 格/米时建筑道路小到无法表达，程序会直接跳过对象生成，生成时打印过一行提示。处理：

1. 把 World Scale 调到 0.30 以上（1.0 为真实尺寸）重新生成。
2. 检查模式：terrain-only本来就只出地形，默认geo-terrain才是"对象+地形"。

阈值定义见 src/args.rs。还不行：加--debug重跑，看终端里有没有 "skipping OpenStreetMap" 那行。

报错 "Failed to acquire session lock"

现象：生成刚开始就失败，提示获取锁失败。原因：Arnis 会在 Java 世界目录写session.lock并加独占锁，防止游戏开着世界时写入。处理：

1. 完全退出 Minecraft（包括后台进程）再重试。
2. 仍失败就删掉该世界目录里的session.lock文件再来一次。

锁的逻辑在 src/gui.rs。还不行：确认没有其它工具（比如区块编辑器）正开着这个世界目录。

"No world selected" 或 "Failed to create new world"

现象：GUI 里点 Create World 或 Start Generation，弹出错误提示。原因：所选保存路径不是一个已存在的目录（是文件、或路径不存在）。处理：

1. 在设置面板重新选择 saves 目录，例如%USERPROFILE%\.minecraft\saves。
2. 想存到别处，先把那个目录建好再选。

还不行：手动新建一个子目录重新选一次，确认不是路径拼写问题。

生成成功的世界应包含真实地形、道路与建筑

结果对了但太慢或太吃资源

出现黄色 "Large area selected" 警告

现象：生成前终端或界面弹出Note: Large area selected (~X km²)。原因：区域超过 250 km² 时，生成耗时和内存占用都会明显上升，也会给公共 OSM 服务带来压力。处理：

1. 优先把区域拆成几块分开生成。
2. 确实要整块做，就取消建筑内部生成（CLI 不加--interior）。

该警告打印在 src/main.rs。还不行：把 scale 调小重跑，内存占用会同步下降。

"Not enough disk space available."

现象：生成开始前就弹错，进度条没动过。原因：Arnis 启动前检查磁盘剩余空间，低于 3GB 直接拦截。处理：

1. 给世界所在磁盘腾出至少 3GB 空闲。
2. 或把输出路径换到另一个磁盘重试。

检查逻辑在 src/gui.rs。还不行：空间够却仍报错，先排查目标路径是否网络盘。

换配置或换平台

Linux 下 GUI 空白或渲染错乱

现象：Linux 上窗口内容空白、地图撕裂。原因：这是 WebKit2GTK 与部分显卡驱动的渲染问题，程序启动时已自动设置软件渲染相关环境变量。处理：

1. 终端里先export LIBGL_ALWAYS_SOFTWARE=1再启动应用。
2. 仍不行可尝试重装显卡驱动后重试。

环境变量处理见 src/gui.rs。还不行：附日志文件和显卡驱动版本提反馈。

Bedrock 版报 "Path does not exist"

现象：CLI 加--bedrock后提示路径不存在。原因：Bedrock 输出要求指定目录必须已存在，和 Java 版可自动建目录的规则不同。处理：

1. 先把目标目录建好再运行。
2. 或者不传--output-dir，默认把.mcworld存到桌面。

校验规则在 src/args.rs。还不行：加--debug运行，对照报错行确认。

速查表

求助指南

日志在哪：GUI 写日志到用户日志目录（Windows 为%LOCALAPPDATA%\com.louisdev.arnis\logs），CLI 直接打印在终端；两种方式都可以加--debug拿更详细信息。

提反馈时务必附这3样：

1. 完整日志文件（别只贴一行）；
2. 你用的生成参数：bbox、scale、mode、世界格式；
3. 系统版本和现象截图。

齐了这三样，维护者通常很快就能复现问题。

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