常见问题与排错

游戏启动失败时，先看日志和崩溃分析，大多数问题能直接定位到 Java、模组或网络。

先看日志

1. 在首页点「游戏日志」，查看本次启动的完整输出，尤其是最上面的 Java 版本和最后的报错。
2. 游戏崩溃时启动器会自动截取日志并做一次崩溃分析，指出可能的原因（Java 版本不对、模组冲突、内存不足等）。
3. 需要把日志发给别人时，可以直接从日志页复制或保存文件。

更新启动器

在「设置 → 其他 → 更新」里可以切换更新通道、开关启动时自动检查，也可以点「检查」手动检查。三个通道：

• 正式版：最稳定，推荐日常使用。
• 预览版：包含测试中的版本。
• Nightly：main 分支的每次更新，可能不稳定。

Windows 安装版和便携版都可以在启动器内下载并更新；macOS 会下载 dmg，由你把新版本拖进「应用程序」覆盖；安卓会下载 apk 交给系统安装。

常见问题

Windows 提示「Windows 已保护你的电脑」

这是 SmartScreen 对没有签名或下载量较少的程序的提示。点「更多信息」→「仍要运行」。安装包来自 GitHub Releases，可以在那里核对来源与 SHA-256。

macOS 提示无法验证开发者

Pixel World 没有经过 Apple 公证。打开「系统设置 → 隐私与安全性」，在页面下方点「仍要打开」；或者右键 App 选择「打开」。

安卓提示禁止安装未知应用

安卓版不在应用商店上架。按系统提示，允许浏览器或文件管理器安装应用，然后重新点 apk 安装。覆盖安装会保留游戏与设置。

微软正版登录提示需要填写 Client ID

找不到 Java，或提示 Java 版本不对

「设置 → Java」里会列出检测到的 Java，并标明每个版本需要什么 Java。可以直接点「下载」让启动器安装 Mojang 提供的 Java，或者点「手动选择」指定本机的 javaw.exe。改完在版本设置里确认该版本使用的是「自动选择」还是某个手动指定的 Java。

下载很慢、失败或卡住

• 在「设置 → 其他 → 下载」里把下载源换成 BMCLAPI；失败时会自动回退到官方源。
• 启动器会多线程下载并校验每个文件，结尾连接卡住时会自动换节点重试，稍等一会儿。
• 更新文件、Apple 芯片专用的库等只能从 GitHub 下载，网络不通时请换网络或开启代理后重试。
• 启动器本身可以到 竹纸软件下载站 下载。

游戏启动就崩溃

• 先换回原版、不装模组启动一次，确认是游戏本身还是模组的问题。
• 在版本的文件列表里禁用最近装的模组，再逐个启用排查。
• 确认模组与游戏版本、加载器匹配（Fabric 模组不能用在 Forge 上）。
• 看崩溃分析给出的原因，例如内存不足、Java 版本过低、缺少前置模组。

安卓上装不了 Forge、NeoForge、Cleanroom 或 OptiFine

这些加载器需要运行安装器，安卓版暂时还不支持。可以先用 Fabric、Quilt 等不需要安装器的加载器，或者在电脑上装好后用局域网互传把版本传到手机。

检查更新没有提示

确认「设置 → 其他 → 更新」里的通道选对了，并且没有跳过这个版本；如果之前点过「跳过这个版本」，手动检查或等下一个版本即可。Nightly 的本地构建没有提交号，不会自动提示更新。

AI 排障（可选）

在「设置 → AI 排障」里可以填写自己的 AI 接口（OpenAI 兼容接口或 Anthropic），游戏崩溃后让 AI 结合日志分析原因。支持查看日志、搜索并安装模组、修改配置文件、备份与恢复，但每次修改都需要你确认。费用由你的 AI 服务商收取，API Key 只保存在本机。

反馈问题

还是解决不了的话，请到 GitHub Issues 反馈，并附上：

• 启动器版本（「设置 → 关于与致谢」里可以看到）、系统和平台；
• 做了什么操作、期望的结果和实际的结果；
• 游戏日志或崩溃分析的内容；如果是界面问题，最好附截图。

Pixel World 是第三方作品，请不要就本软件的问题打扰 PCL 作者。