跳到正文
本頁目錄

Windows 版 LeviLauncher 的報錯與崩潰

在 LeviLauncher(PC)中使用 BetterRenderDragon(更好的渲染龍)後遊戲閃退、白屏、不生效或進世界畫面異常,怎麼排查?

BetterRenderDragon 是第三方 preload 類模組(目前由 QYCottage 分支維護:https://github.com/QYCottage/BetterRenderDragon/releases),啟動器不再內置,需要作為模組自行導入。排查順序:

  1. 確認 BetterRenderDragon 版本與遊戲版本對應(Release 說明裡寫有適配的遊戲版本)。
  2. 版本對應仍一啟動就閃退時,改用 no-imgui 版本(沒有左上角 UI),多數閃退可解決;A 卡(AMD)和部分 N 卡設備存在兼容問題。
  3. 與其他模組衝突:已知小地圖 mod、4dskin、BetterResourcePackManager 等與它同時使用可能崩潰或不生效,逐個禁用排查;同時查看啟動器日誌。
  4. 白屏/畫面異常:關閉顯卡驅動的幀生成/AI 幀生成、驅動疊加層等任何修改遊戲畫面的程序。
  5. 進世界畫面異常還可能是光影包未適配當前遊戲版本,或誤用了安卓版光影,需要換用適配當前版本的 Windows 版渲染龍光影包。

適用版本:LeviLauncher 1.0.0 及以上(PC)。未能從源碼或文檔中直接證實,僅供參考。

LeviLauncher 的“註冊到系統”有什麼用?註冊失敗(無法註冊 appx)怎麼解決?

註冊就是把啟動器安裝的版本註冊為系統中的 Minecraft 應用包(會替換當前註冊的微軟商店版本)。部分沒有自定義版本檢測的客戶端(如 Onix)需要在已註冊的版本上運行,雙擊 .mcpack 導入等也需要已註冊的版本。

註冊失敗最常見的原因是沒有開啟 Windows 開發者模式(報 ERR_DEV_MODE_REQUIRED / ERR_UWP_DEVELOPER_MODE,或 0x80073CFF 等):在 Windows 設置 > 系統 > 開發者選項中打開「開發者模式」後重試,也可以運行 LeviLauncher.exe doctor --fix developer-mode。

若報 ERR_UWP_PACKAGE_CONFLICT,說明有啟動器以外的 Minecraft 安裝(如其他啟動器註冊的版本)佔用了註冊,需要先卸載或取消那個註冊。

新版的註冊失敗彈窗會列出可能原因,並有打開日誌文件夾的按鈕;已註冊的實例可以用 LeviLauncher.exe instance unregister 取消註冊。新版不再需要安裝 Microsoft GDK 開發套件。不要直接雙擊安裝出的遊戲文件,應通過啟動器啟動。

適用版本:LeviLauncher(Windows)1.1.0 及以上

Windows 版 LeviLauncher 安裝遊戲後(沒裝任何 mod)點啟動就報 ERR_LAUNCH_GAME 或無法啟動,換版本也一樣,怎麼辦?需要哪些依賴?

適用於 GDK 版基岩版;doctor / self-update 命令為 1.1.0 現行 CLI。按順序排查:

  1. 先確認 LeviLauncher 是最新版(啟動器自帶自更新,也可執行 LeviLauncher.exe self-update),舊版啟動器出錯無需重裝,更新即可。
  2. 運行 LeviLauncher.exe doctor 檢查依賴:Visual C++ 運行庫、GameInput、Gaming Services(GDK 版必需)等;LeviLauncher.exe doctor --fix 可自動修復 VC 運行庫和 GameInput(需管理員確認),Gaming Services 需從微軟商店安裝(ms-windows-store://pdp/?ProductId=9MWPM2CQNLHN)。
  3. 最常見的解決辦法:先通過微軟商店 / Xbox App 安裝一次原版基岩版併成功啟動一次(商店會自動拉取 Xbox App、Gaming Services 等依賴,之後可卸載商店版),同時在商店裡更新 Xbox App;重裝系統後常見此問題。
  4. LTSC/精簡版系統可能缺少微軟商店和 Gaming Services,可參考 https://www.mcappx.com/help/gdk-install/#windows 手動安裝 Gaming Services,裝好後聯網重啟。
  5. 開代理時微軟商店可能卡住,可關代理或把含 microsoft、bing 的域名設為直連。
  6. 仍不行可刪除該實例重新下載安裝;用 LeviLauncher.exe play -v 查看詳細日誌後帶日誌到 GitHub Issues 反饋。

只裝 DirectX、.NET Framework 不能解決該問題。

適用版本:LeviLauncher(Windows)1.x

LeviLauncher 啟動 GDK 版 Minecraft 時提示缺少 Gaming Services(遊戲服務)或檢測失敗,微軟商店裝不上或系統是 LTSC 沒有商店,怎麼辦?

適用於 GDK 版基岩版。

  1. 確認是否已安裝:在 PowerShell(不是 cmd)執行 Get-AppxPackage -Name Microsoft.GamingServices,有輸出即已安裝;也可運行 LeviLauncher.exe doctor 查看 gaming-services 檢查結果。GDK 版運行需要 VC 運行庫 + GameInput + Xbox 應用 + Gaming Services。
  2. 未安裝時按啟動器彈出的引導安裝,或從微軟商店安裝 Gaming Services(ms-windows-store://pdp/?ProductId=9MWPM2CQNLHN)。
  3. LTSC/精簡版系統缺 Microsoft Store、App Installer、Xbox 組件:可在 https://store.rg-adguard.net/ 粘貼商店應用鏈接下載 appx/msixbundle,用 PowerShell 的 Add-AppxPackage 安裝;或從 MCAPPX 下載 Xbox Gaming Services 等組件(https://www.mcappx.com/download/xbox-gaming-services/,教程 https://www.mcappx.com/help/gdk-install/#windows),缺啥補啥;LTSC 上 Xbox 相關服務默認禁用,需在“服務”中設為自動。新手更建議換完整版 Windows。
  4. 系統組件異常可執行 sfc /scannow。
  5. 確認已安裝但啟動器仍誤報時,可在提示中選擇忽略繼續啟動(該檢測不再強制退出);只使用 UWP 實例時啟動器不會檢查 Gaming Services。

適用版本:LeviLauncher(Windows)1.x

PC 版 LeviLauncher 雙擊後閃退或沒反應(界面出現前就退出,任務管理器裡也沒有進程),怎麼排查?

日誌路徑自 v1.1.0 起變更。排查步驟:

  1. 運行庫:啟動器啟動時會檢測 Visual C++ 2015-2022 x64 運行庫和 WebView2 Runtime,缺失時會彈窗提示下載安裝。若檢測通過仍閃退,多數是運行庫損壞或版本過舊:安裝最新 VC++ x64(https://aka.ms/vc14/vc_redist.x64.exe),並重新下載安裝 Microsoft Edge WebView2 Runtime(實際案例中 WebView2 安裝程序提示“已安裝”但只是註冊表殘留,重裝後解決)。不要刪除 Edge/WebView2。
  2. 日誌:界面出現前失敗時會寫入 %LOCALAPPDATA%\LeviLauncher\Logs\startup.log(v1.1.0 之前的舊版在 %APPDATA%\levilauncher.exe\logs\startup.log),求助或提 Issue 時直接發該文件而不是截圖。
  3. 調試輸出:在命令行運行 LeviLauncher.exe --debug(也接受 /debug、-debug),或在快捷方式“目標”末尾加 /debug,可看到控制台輸出。
  4. 不依賴 WebView2 的命令行自檢(v1.1.0 起):LeviLauncher.exe doctor(檢查 VC++ 運行庫、GameInput、Gaming Services、WebView2 等),LeviLauncher.exe doctor --fix vcruntime 可修復運行庫。
  5. 以上無效時,有用戶通過 DirectX 修復工具“檢測並修復”運行庫,或在管理員 CMD 中把 EventLog / 任務計劃(schedule)服務設為自動並重啟後解決(個例,僅供參考)。

適用版本:LeviLauncher(Windows)1.1.0

LeviLauncher 下載完 Minecraft 後點“安裝”啟動器就閃退(版本文件夾已創建但為空),怎麼解決?

大概率是系統缺少或損壞 Visual C++ 2015-2022 x64 運行庫。下載安裝最新版 https://aka.ms/vs/17/release/vc_redist.x64.exe(或 https://aka.ms/vc14/vc_redist.x64.exe)後重試即可。

新版啟動器啟動時會檢測 VC++ 運行庫並提示安裝,v1.1.0 起也可以用 LeviLauncher.exe doctor 檢查、LeviLauncher.exe doctor --fix vcruntime 修復。其他報錯彈窗提示類似問題時也優先檢查 VC++ 運行庫。

很久沒玩後,LeviLauncher 裡的 MC 版本全部啟動即閃退(沒有日誌、控制台一閃而過),但官方方式啟動正常,怎麼辦?

先用微軟商店/官方方式啟動一次 Minecraft(商店下載不了時可安裝一個官方 appx 包啟動一次),再用 LeviLauncher 啟動即可恢復。

開發者分析:啟動器為阻止 GDK 版自動遷移(並刪除)UWP 數據,攔截了遊戲對 LocalAppData 的讀取,而 MC 在 LocalAppData 保存了類似登錄 token 的數據,長時間未登錄需要刷新時找不到就閃退,與是否開啟版本隔離無關。當前版本仍攔截 LocalAppData。

若仍不行,檢查 Gaming Services(遊戲服務)是否損壞:卸載/刪除 Gaming Services 後重啟電腦,再從微軟商店重裝;可用 LeviLauncher.exe doctor 檢查 Gaming Services 狀態。此類問題無日誌時可給 MC 掛 VS 調試器排查。

適用版本:LeviLauncher(Windows)0.3.x 起。未能從源碼或文檔中直接證實,僅供參考。

LeviLauncher(PC)遊戲崩潰後,崩潰日誌在哪裡找?

適用於當前 LeviLamina 客戶端。裝了 LeviLamina 的遊戲,崩潰日誌在該遊戲版本(實例)目錄下的 logs/crash 裡,文件名是 trace_<时间>.log 和 minidump_<时间>.dmp;同一目錄 logs 下還有 latest.log。這不是 MC 自己的崩潰目錄。反饋問題時請發最新的 trace 和 minidump。

啟動器自身的日誌在 %LOCALAPPDATA%\LeviLauncher\Logs(啟動器還沒顯示界面就退出時,看其中的 startup.log),出錯對話框裡也有打開日誌文件夾的按鈕。

適用版本:LeviLauncher 1.1.0

PC 版 LeviLauncher 啟動 MC 時報錯(看起來像要求正版),或啟動後立即崩潰,怎麼處理?

適用於 GDK 實例。這不是強制正版檢測。先檢查 Xbox 遊戲服務(Gaming Services)、GameInput、Visual C++ 運行庫等系統組件是否正常:GDK 版本必須有 Gaming Services,缺失或損壞時按啟動器的引導去 Microsoft Store 安裝或修復,必要時從 Xbox App / 微軟商店裝一次官方 MC 並啟動一次。

也可以運行 LeviLauncher.exe doctor 統一檢查,doctor --fix 能修復 VC 運行庫、GameInput 等(Gaming Services 要按提示去商店頁安裝)。如果組件都正常但一開遊戲就崩,還要檢查顯卡驅動,有用戶反饋重裝 GPU 驅動後恢復正常。

適用版本:LeviLauncher 1.x

使用 LeviLauncher 時彈出缺失 dll / 文件缺失的錯誤,更新 vcredist 後仍然進不去,怎麼辦?

通常是系統缺少 Visual C++ 運行庫。現在的啟動器會檢測 VC 運行庫,缺失時會彈窗提示,確認後從 https://aka.ms/vc14/vc_redist.x64.exe 下載並運行安裝程序;也可以手動安裝,或者運行 LeviLauncher.exe doctor --fix vcruntime。

還是不行的話,從微軟商店裝一遍原版 Minecraft,商店會補全遊戲需要的系統庫。如果商店版也運行不了,就是系統本身缺庫或文件損壞(比如非官方精簡系統鏡像),需要修復或重裝系統。

適用版本:LeviLauncher 1.x

在 LeviLauncher 中裝了某個 mod(如去除 OreUI 的 mod)後遊戲閃退,怎麼回事?

是否出現該問題取決於具體的第三方 mod。先檢查 mod 列表,同一個 mod 的新舊多個版本同時啟用會導致閃退,關掉舊版本就行;另外要確認啟動器是從官方渠道(GitHub Releases / 官網)下載的,不是來路不明的修改版。

還有問題的話,附上崩潰日誌(實例目錄下的 logs/crash)和復現視頻去反饋。

未能從源碼或文檔中直接證實,僅供參考。

用 LeviLauncher 安裝遊戲後提示存儲不足,存檔、模組丟失(開啟了版本隔離),曾安裝過 BedrockBoot,是什麼原因?

適用於同時使用 BedrockBoot 等會創建軟鏈接的第三方工具時。檢查 %APPDATA% 下的 Minecraft Bedrock 目錄。這個案例裡,該目錄被 BedrockBoot 做成了軟鏈接,跟 LeviLauncher 的版本隔離衝突。

可以在 BedrockBoot 設置裡關掉它的版本隔離,或者卸載 BedrockBoot、刪掉軟鏈接後再試。改動前先備份存檔。

未能從源碼或文檔中直接證實,僅供參考。

通過 LeviLauncher 安裝的基岩版(GDK 版)從開始菜單、快捷方式或啟動器都無法啟動,任務管理器裡進程卡住,怎麼辦?

適用於 GDK 實例。GDK 版基岩版依賴 Microsoft Gaming Services(Xbox 遊戲服務)正常運行,遊戲服務缺失或損壞時就無法啟動。到 Microsoft Store 更新/重裝 Gaming Services 後即可恢復。

可用啟動器的引導檢查,或在命令行運行 LeviLauncher.exe doctor 檢查 Gaming Services、GameInput、VC 運行庫等(Gaming Services 需按提示到 Store 頁面安裝)。

適用版本:LeviLauncher 所有版本