故障排查
出问题时先看启动器里的提示，大部分提示本身就说了该怎么做。下面按出问题的环节列出常见情况。
启动出错时，启动器状态栏会出现 查看日志 ›，也可以随时点 日志 打开 启动日志。点 复制全部 就能把整段日志粘贴给别人。
其他日志在这些位置：
| 内容 | 位置 |
|---|---|
| 游戏日志 | %APPDATA%\.soarclient-abc\logs\，最新的一份是 latest.log |
| 崩溃报告 | %APPDATA%\.soarclient-abc\game\crash-reports\，游戏崩溃过才会有 |
| 启动器更新记录 | %LOCALAPPDATA%\SoarLauncherData\update-apply.log |
在启动器 设置 → 游戏目录 里改过位置的话，游戏日志和崩溃报告在新位置下面。
提示要更新启动器
Section titled “提示要更新启动器”标着“此更新为必需更新”的版本要先更新才能启动游戏，点 立即更新 即可，启动器会自动下载、校验并重启。
更新失败时点 重试。还是不行，就到官网下载区下载最新的安装器重新安装。失败原因记在上面的 update-apply.log 里，反馈问题时一起带上。
下载很慢或卡住
Section titled “下载很慢或卡住”第一次启动要下载完整的游戏文件，花的时间最长。下载支持断点续传，网络断了或者关掉启动器，下次打开会接着下。网络不稳定时，换个网络或者晚点再试。
启动失败，提示缺少文件或 Java
Section titled “启动失败，提示缺少文件或 Java”比如“缺少 …”“libraries 目录中没有可用的 jar 文件”“缺少游戏自带的 Java”。这说明游戏文件不完整，可能被安全软件隔离了，或者手动删改过游戏文件夹。
点 重试启动 就行。启动器每次启动都会逐个校验游戏文件，缺失或损坏的会重新下载。如果文件反复丢失，检查一下安全软件有没有隔离游戏文件夹里的文件。
C 盘空间不够
Section titled “C 盘空间不够”游戏文件可以搬到别的盘：先关掉游戏，在启动器 设置 → 游戏目录 点 更改，选一个空文件夹，再选 迁移现有文件（推荐）。存档和设置会一起搬过去，过程中不要关闭启动器。
| 提示 | 怎么办 |
|---|---|
| 缺少 Microsoft Edge WebView2 运行时 | 到微软官网安装 WebView2 运行时，再重新登录 |
| 该微软账号没有 Minecraft Java 版授权 | 这个微软账号没买 Java 版，换成拥有游戏的那个账号 |
| 尚未创建 Xbox 玩家档案 | 先用这个账号登录一次 xbox.com 完成创建 |
| 需要先加入微软家庭并完成家长授权 | 未成年账号要家长在微软家庭里同意后才能玩 |
| 该账号所在地区暂不支持 Xbox 服务 | 账号所在地区用不了 Xbox 服务，只能换账号 |
| 登录凭据已失效 | 点账号右侧的重新登录按钮 |
| 登录的账号与 … 不一致 | 重新登录时，选这个游戏账号对应的那个微软账号 |
| 登录超时、窗口意外退出、请检查网络 | 检查网络后重新登录，登录窗口要在两分钟内完成 |
| 缺少微软登录窗口组件 | 重新安装启动器 |
先打开 crash-reports 里最新的崩溃报告，或启动日志的最后几十行，反馈问题时一起带上。常见原因：
- 内存不够：在启动器 设置 → 游戏内存 调高分配的内存（1–8 GB），电脑本身内存够才有用。
- 刚装了资源包或光影：先在游戏里关掉它们，看还会不会崩。
卡顿、帧数低
Section titled “卡顿、帧数低”打开 FPS 提升、忽视实体 这类模块，见模块与 HUD。在启动器里适当调高游戏内存也有帮助。
设置乱了，想恢复
Section titled “设置乱了，想恢复”- 单个模块：进入模块设置，点右上角的 重置。
- 整套配置：在配置文件页对这份配置点 重置，或者新建一份配置重新调。
别人看不到我的披风
Section titled “别人看不到我的披风”Linux 版启动器还是预览版，可以登录和管理账号，但还不能启动游戏，会显示“Linux 游戏支持准备中”。
到 Discord 找我们。带上这些会快很多：
- 出问题前做了什么，能不能每次都复现；
- 启动日志（日志 → 复制全部）；
- 游戏崩溃的话，
crash-reports里最新的崩溃报告； - 启动器更新失败的话，
update-apply.log； - 启动器版本，在启动器的 关于 页能看到。