Arnis 故障排除10 分钟修好 Minecraft 世界生成的坑【免费下载链接】arnisGenerate any location from the real world in Minecraft with a high level of detail.项目地址: https://gitcode.com/GitHub_Trending/ar/arnisArnis 是把现实地点生成高细节 Minecraft 世界的开源工具。如果你遇到 CLI 参数报错、地图空白、建筑缺失或世界被锁等 Arnis 故障排除场景别急。本文按你从启动到导出的真实流程排坑跟着走就能定位问题。Arnis 图形界面用矩形工具圈出区域点 Start Generation 即可生成先做这3件事确认版本号。CLI 启动横幅会打印当前版本自编译旧版先换最新 release 再谈别的。先看完整日志再下结论。GUI 日志落在磁盘Windows 在%LOCALAPPDATA%\com.louisdev.arnis\logsCLI 直接打终端加--debug信息更全。先关 Minecraft、再查磁盘。Java 世界被游戏打开时 Arnis 拿不到锁目标磁盘至少要 3GB 空闲。大多数小问题在这三步就拦下来了后面的内容留给还没解决的情况。第一次启动CLI 与 GUI 都跑起来CLI 报 Failed to parse bounding box 或坐标超范围现象cargo run刚启动就Error: ...退出没生成任何世界。原因--bbox必须按min_lat,min_lng,max_lat,max_lng顺序纬度在前经度在后。处理按正确顺序写坐标例如--bbox39.9042,116.4074,39.9092,116.4124。Java 版还要带上--output-dir目录不存在会自动创建。cargo run --release --no-default-features -- --output-dirC:/path/to/world --bboxmin_lat,min_lng,max_lat,max_lng参数定义在 src/args.rs。还不行把终端Error:那行原文读一遍它写明了具体卡在哪一步。GUI 地图空白、瓦片不显示现象窗口打开了但选区地图是灰色或瓦片缺失没法框区域。原因选区地图依赖远端瓦片服务网络受限时瓦片主机不响应前端已把错误写进日志文件。处理打开上面的日志文件找[map]或webview前缀的行。有瓦片报错就先检查网络或代理再重启应用。仍不行就在设置面板点 Clean tile cache清掉旧瓦片缓存重新下载。日志桥接逻辑见 src/gui/js/logging.js。还不行带着整份日志换网络环境重试。地图加载正常后用矩形工具圈出生成区域跑起来了但结果不对世界全是平地没有建筑和道路现象生成显示成功进世界却只有地形房屋道路全缺。原因世界比例低于 0.30 格/米时建筑道路小到无法表达程序会直接跳过对象生成生成时打印过一行提示。处理把 World Scale 调到 0.30 以上1.0 为真实尺寸重新生成。检查模式terrain-only本来就只出地形默认geo-terrain才是对象地形。阈值定义见 src/args.rs。还不行加--debug重跑看终端里有没有 skipping OpenStreetMap 那行。报错 Failed to acquire session lock现象生成刚开始就失败提示获取锁失败。原因Arnis 会在 Java 世界目录写session.lock并加独占锁防止游戏开着世界时写入。处理完全退出 Minecraft包括后台进程再重试。仍失败就删掉该世界目录里的session.lock文件再来一次。锁的逻辑在 src/gui.rs。还不行确认没有其它工具比如区块编辑器正开着这个世界目录。No world selected 或 Failed to create new world现象GUI 里点 Create World 或 Start Generation弹出错误提示。原因所选保存路径不是一个已存在的目录是文件、或路径不存在。处理在设置面板重新选择 saves 目录例如%USERPROFILE%\.minecraft\saves。想存到别处先把那个目录建好再选。还不行手动新建一个子目录重新选一次确认不是路径拼写问题。生成成功的世界应包含真实地形、道路与建筑结果对了但太慢或太吃资源出现黄色 Large area selected 警告现象生成前终端或界面弹出Note: Large area selected (~X km²)。原因区域超过 250 km² 时生成耗时和内存占用都会明显上升也会给公共 OSM 服务带来压力。处理优先把区域拆成几块分开生成。确实要整块做就取消建筑内部生成CLI 不加--interior。该警告打印在 src/main.rs。还不行把 scale 调小重跑内存占用会同步下降。Not enough disk space available.现象生成开始前就弹错进度条没动过。原因Arnis 启动前检查磁盘剩余空间低于 3GB 直接拦截。处理给世界所在磁盘腾出至少 3GB 空闲。或把输出路径换到另一个磁盘重试。检查逻辑在 src/gui.rs。还不行空间够却仍报错先排查目标路径是否网络盘。换配置或换平台Linux 下 GUI 空白或渲染错乱现象Linux 上窗口内容空白、地图撕裂。原因这是 WebKit2GTK 与部分显卡驱动的渲染问题程序启动时已自动设置软件渲染相关环境变量。处理终端里先export LIBGL_ALWAYS_SOFTWARE1再启动应用。仍不行可尝试重装显卡驱动后重试。环境变量处理见 src/gui.rs。还不行附日志文件和显卡驱动版本提反馈。Bedrock 版报 Path does not exist现象CLI 加--bedrock后提示路径不存在。原因Bedrock 输出要求指定目录必须已存在和 Java 版可自动建目录的规则不同。处理先把目标目录建好再运行。或者不传--output-dir默认把.mcworld存到桌面。校验规则在 src/args.rs。还不行加--debug运行对照报错行确认。速查表报错/现象关键词大概率原因跳到哪一节Failed to parse bounding boxbbox 格式或顺序写错第一次启动 · CLI 报 bounding box地图空白、瓦片不显示瓦片服务不可达第一次启动 · 地图空白Failed to acquire session lock世界被 Minecraft 占用结果不对 · session lock只有地形没有建筑道路scale 低于 0.30 或模式为 terrain-only结果不对 · 全是平地No world selected保存路径不是有效目录结果不对 · No world selectedLarge area selected区域过大太慢或太吃资源 · 区域警告Not enough disk space available.磁盘剩余不足 3GB太慢或太吃资源 · 磁盘空间Linux GUI 空白WebKit2GTK 渲染问题换配置 · Linux 渲染错乱Path does not existBedrock输出目录未创建换配置 · Bedrock 路径求助指南日志在哪GUI 写日志到用户日志目录Windows 为%LOCALAPPDATA%\com.louisdev.arnis\logsCLI 直接打印在终端两种方式都可以加--debug拿更详细信息。提反馈时务必附这3样完整日志文件别只贴一行你用的生成参数bbox、scale、mode、世界格式系统版本和现象截图。齐了这三样维护者通常很快就能复现问题。【免费下载链接】arnisGenerate any location from the real world in Minecraft with a high level of detail.项目地址: https://gitcode.com/GitHub_Trending/ar/arnis创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 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/arnisArnis 是把现实地点生成高细节 Minecraft 世界的开源工具。如果你遇到 CLI 参数报错、地图空白、建筑缺失或世界被锁等 Arnis 故障排除场景别急。本文按你从启动到导出的真实流程排坑跟着走就能定位问题。Arnis 图形界面用矩形工具圈出区域点 Start Generation 即可生成先做这3件事确认版本号。CLI 启动横幅会打印当前版本自编译旧版先换最新 release 再谈别的。先看完整日志再下结论。GUI 日志落在磁盘Windows 在%LOCALAPPDATA%\com.louisdev.arnis\logsCLI 直接打终端加--debug信息更全。先关 Minecraft、再查磁盘。Java 世界被游戏打开时 Arnis 拿不到锁目标磁盘至少要 3GB 空闲。大多数小问题在这三步就拦下来了后面的内容留给还没解决的情况。第一次启动CLI 与 GUI 都跑起来CLI 报 Failed to parse bounding box 或坐标超范围现象cargo run刚启动就Error: ...退出没生成任何世界。原因--bbox必须按min_lat,min_lng,max_lat,max_lng顺序纬度在前经度在后。处理按正确顺序写坐标例如--bbox39.9042,116.4074,39.9092,116.4124。Java 版还要带上--output-dir目录不存在会自动创建。cargo run --release --no-default-features -- --output-dirC:/path/to/world --bboxmin_lat,min_lng,max_lat,max_lng参数定义在 src/args.rs。还不行把终端Error:那行原文读一遍它写明了具体卡在哪一步。GUI 地图空白、瓦片不显示现象窗口打开了但选区地图是灰色或瓦片缺失没法框区域。原因选区地图依赖远端瓦片服务网络受限时瓦片主机不响应前端已把错误写进日志文件。处理打开上面的日志文件找[map]或webview前缀的行。有瓦片报错就先检查网络或代理再重启应用。仍不行就在设置面板点 Clean tile cache清掉旧瓦片缓存重新下载。日志桥接逻辑见 src/gui/js/logging.js。还不行带着整份日志换网络环境重试。地图加载正常后用矩形工具圈出生成区域跑起来了但结果不对世界全是平地没有建筑和道路现象生成显示成功进世界却只有地形房屋道路全缺。原因世界比例低于 0.30 格/米时建筑道路小到无法表达程序会直接跳过对象生成生成时打印过一行提示。处理把 World Scale 调到 0.30 以上1.0 为真实尺寸重新生成。检查模式terrain-only本来就只出地形默认geo-terrain才是对象地形。阈值定义见 src/args.rs。还不行加--debug重跑看终端里有没有 skipping OpenStreetMap 那行。报错 Failed to acquire session lock现象生成刚开始就失败提示获取锁失败。原因Arnis 会在 Java 世界目录写session.lock并加独占锁防止游戏开着世界时写入。处理完全退出 Minecraft包括后台进程再重试。仍失败就删掉该世界目录里的session.lock文件再来一次。锁的逻辑在 src/gui.rs。还不行确认没有其它工具比如区块编辑器正开着这个世界目录。No world selected 或 Failed to create new world现象GUI 里点 Create World 或 Start Generation弹出错误提示。原因所选保存路径不是一个已存在的目录是文件、或路径不存在。处理在设置面板重新选择 saves 目录例如%USERPROFILE%\.minecraft\saves。想存到别处先把那个目录建好再选。还不行手动新建一个子目录重新选一次确认不是路径拼写问题。生成成功的世界应包含真实地形、道路与建筑结果对了但太慢或太吃资源出现黄色 Large area selected 警告现象生成前终端或界面弹出Note: Large area selected (~X km²)。原因区域超过 250 km² 时生成耗时和内存占用都会明显上升也会给公共 OSM 服务带来压力。处理优先把区域拆成几块分开生成。确实要整块做就取消建筑内部生成CLI 不加--interior。该警告打印在 src/main.rs。还不行把 scale 调小重跑内存占用会同步下降。Not enough disk space available.现象生成开始前就弹错进度条没动过。原因Arnis 启动前检查磁盘剩余空间低于 3GB 直接拦截。处理给世界所在磁盘腾出至少 3GB 空闲。或把输出路径换到另一个磁盘重试。检查逻辑在 src/gui.rs。还不行空间够却仍报错先排查目标路径是否网络盘。换配置或换平台Linux 下 GUI 空白或渲染错乱现象Linux 上窗口内容空白、地图撕裂。原因这是 WebKit2GTK 与部分显卡驱动的渲染问题程序启动时已自动设置软件渲染相关环境变量。处理终端里先export LIBGL_ALWAYS_SOFTWARE1再启动应用。仍不行可尝试重装显卡驱动后重试。环境变量处理见 src/gui.rs。还不行附日志文件和显卡驱动版本提反馈。Bedrock 版报 Path does not exist现象CLI 加--bedrock后提示路径不存在。原因Bedrock 输出要求指定目录必须已存在和 Java 版可自动建目录的规则不同。处理先把目标目录建好再运行。或者不传--output-dir默认把.mcworld存到桌面。校验规则在 src/args.rs。还不行加--debug运行对照报错行确认。速查表报错/现象关键词大概率原因跳到哪一节Failed to parse bounding boxbbox 格式或顺序写错第一次启动 · CLI 报 bounding box地图空白、瓦片不显示瓦片服务不可达第一次启动 · 地图空白Failed to acquire session lock世界被 Minecraft 占用结果不对 · session lock只有地形没有建筑道路scale 低于 0.30 或模式为 terrain-only结果不对 · 全是平地No world selected保存路径不是有效目录结果不对 · No world selectedLarge area selected区域过大太慢或太吃资源 · 区域警告Not enough disk space available.磁盘剩余不足 3GB太慢或太吃资源 · 磁盘空间Linux GUI 空白WebKit2GTK 渲染问题换配置 · Linux 渲染错乱Path does not existBedrock输出目录未创建换配置 · Bedrock 路径求助指南日志在哪GUI 写日志到用户日志目录Windows 为%LOCALAPPDATA%\com.louisdev.arnis\logsCLI 直接打印在终端两种方式都可以加--debug拿更详细信息。提反馈时务必附这3样完整日志文件别只贴一行你用的生成参数bbox、scale、mode、世界格式系统版本和现象截图。齐了这三样维护者通常很快就能复现问题。【免费下载链接】arnisGenerate any location from the real world in Minecraft with a high level of detail.项目地址: https://gitcode.com/GitHub_Trending/ar/arnis创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考