疑難排解
出問題時先看啟動器裡的提示，大部分提示本身就說了該怎麼做。下面按出問題的環節列出常見情況。
啟動出錯時，啟動器狀態列會出現 查看日誌 ›，也可以隨時點 日誌 開啟 啟動日誌。點 全部複製 就能把整段日誌貼給別人。
其他日誌在這些位置：
| 內容 | 位置 |
|---|---|
| 遊戲日誌 | %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； - 啟動器版本，在啟動器的 關於 頁能看到。