跳到正文
本頁目錄

LeviLamina 的報錯與崩潰

錯誤碼

錯誤碼 126 是什麼意思?

缺少 LeviLamina 或模組的依賴項。請確保 LeviLamina 或模組已完整安裝。日誌中的依賴診斷(Dependency diagnostic)會列出缺少的依賴項。

錯誤碼 127 是什麼意思?

LeviLamina 或模組的依賴項版本不正確。日誌中的依賴診斷(Dependency diagnostic)會指出哪些依賴項的版本不對。

錯誤碼 1114 是什麼意思?

Visual C++ 運行庫(vcredist)版本太舊。更新 vcredist 即可解決。

服務器報錯

LeviLamina 啟動時報錯 Failed to load Runtime Data / 缺少 bedrock_runtime_data,這個文件怎麼來的?服務器訪問 GitHub 慢、lip 下載不動怎麼辦?

bedrock_runtime_data 不是運行時生成的,它是 LeviLamina 的依賴包 bedrock-runtime-data,用 lip 安裝 LeviLamina 時會自動下載;報錯通常是安裝不完整。處理:執行 lip cache clean 清理緩存,然後在新的空目錄裡重新安裝。如果服務器訪問 GitHub 慢或下載卡住,用 lip config set github_proxy <代理地址> 設置 GitHub 代理/鏡像後重試。面板服用戶請聯繫服務商處理。

適用版本:LeviLamina 1.x 至當前 26.60.x(通過 lip 安裝)

安裝或啟動 LeviLamina(BDS 服務端)時報缺少 VC 運行庫 / DLL(如 MSVCP140.dll、VCRUNTIME140.dll)、錯誤碼 1114、提示 vcredist 版本過舊,或 lip 安裝時 PeEditor.exe 報錯、LeviLamina 沒有加載,怎麼辦?

這是系統裡缺少或版本過舊的 Microsoft Visual C++ 運行庫(vcredist)導致的。安裝/更新最新的 Microsoft Visual C++ 可再發行組件包 x64 版本即可:https://aka.ms/vc14/vc_redist.x64.exe(官方文檔當前使用的鏈接;舊鏈接 https://aka.ms/vs/17/release/vc_redist.x64.exe 也是同一系列)。注意:

  1. 必須裝 x64 版本,並且要是最新版;只裝最新的一個即可,不需要裝 2005 起的所有舊版本。DirectX 修復工具等附帶的運行庫往往不是最新版,可能仍然報錯。已安裝過的可以運行安裝程序選擇“修復”,裝完可重啟電腦再試。
  2. 需要的是 VC++ 運行庫,不是 Visual Studio(VS 只在開發 mod 時需要),裝 .NET 運行時也解決不了這個問題。
  3. 裝好運行庫後重新執行 lip 安裝命令(或重新運行 BDS 目錄下的 PeEditor.exe 生成 bedrock_server_mod.exe)。如果之前安裝中途失敗留下了殘留文件導致衝突,建議在空文件夾重新安裝或按提示刪除衝突文件,必要時用 lip cache clean 清理 lip 緩存。
  4. 如果運行庫已是最新仍然報錯(例如錯誤碼 126/127),則多半是 LeviLamina 或 mod 未完整安裝、或 mod 與 LeviLamina/BDS 版本不匹配,請按依賴診斷(Dependency diagnostic)的提示處理,推薦用 lip 安裝以自動匹配版本。
  5. 新版 lip 在 Windows 上安裝服務器時會自行檢測 VC++ 運行庫(註冊表 HKLM\SOFTWARE\Microsoft\VisualStudio\14.0\VC\Runtimes\x64 的 Installed=1),缺失時自動下載 vc_redist.x64.exe 並以管理員身份靜默安裝,會彈出用戶帳戶控制(UAC)提示,請選擇“是”;若選了“否”會報 The Microsoft Visual C++ Redistributable was not installed: Windows did not allow its installer to run as an administrator.,重新運行命令並允許,或自行從上述鏈接安裝即可。

參見官方文檔“問題排除”:https://levilamina.liteldev.com/zh/user_guides/troubleshooting/

適用版本:當前所有 LeviLamina 版本(Windows 服務端,含 26.60.x)

雙擊 bedrock_server_mod.exe 啟動 LeviLamina 服務端,窗口一閃就關(沒有任何輸出、沒有 CrashLogger 崩潰日誌,刪掉插件也一樣),怎麼排查?

LeviLamina 服務端用 bedrock_server_mod.exe 啟動(由 PeEditor 從 bedrock_server.exe 生成)。閃退時不要雙擊,先在服務端目錄打開終端再運行,窗口就不會關閉、能看到退出前的報錯:在資源管理器地址欄輸入 cmd 回車,或“文件 -> 打開 Windows PowerShell”,然後執行 bedrock_server_mod.exe(PowerShell 中寫作 .\bedrock_server_mod.exe;可輸入 bed 後按 Tab 補全);用 lip 管理的服務端也可在服務端目錄執行 lip run,它會在控制台輸出服務端日誌。常見原因:

  1. 缺少或過舊的 VC++ 運行庫(例如提示缺少 VCRUNTIME140_1.dll、CONCRT140.dll,或報 1114):安裝最新 x64 運行庫 https://aka.ms/vc14/vc_redist.x64.exe。服務器上閃退、本機正常的情況大多是這個原因。
  2. 配置文件寫錯(如 server.properties 或 JSON 配置裡把 true 寫成 ture):按報錯修正。
  3. LeviLamina 的舊配置文件導致異常:可先備份後刪除 mods/LeviLamina/config 文件夾(舊安裝若使用 plugins/ 目錄,則為 plugins/LeviLamina/config),重新啟動讓 LL 生成新配置。
  4. 文件解壓損壞或安裝不完整:重新解壓/用 lip 重新安裝,並保持 LeviLamina 與 BDS 版本對應,不要使用舊版本。

適用版本:當前所有 LeviLamina 版本(Windows 服務端)

BDS 啟動後控制台只輸出 NO LOG FILE 之類內容,看不到 LeviLamina 的啟動 logo / 加載日誌(例如用 lip 升級後),怎麼排查?

“NO LOG FILE”那串是原版 BDS 自身的輸出,不是問題原因;關鍵是沒有出現 LeviLamina 的啟動 logo 和加載日誌,說明 LeviLamina 根本沒被加載。請確認運行的是 bedrock_server_mod.exe,且 mods/LeviLamina 目錄存在且完整(含 manifest.json 和 LeviLamina.dll),根目錄有 PreLoader.dll。新版 LeviLamina 調整過文件位置,舊版本殘留在根目錄或 plugins/ 中的文件可能導致加載異常(參見更新日誌)。最穩妥的做法是在乾淨的服務端目錄中用 lip 全新安裝 LeviLamina,而不是手動拷貝或在混亂的舊目錄上升級。

適用版本:LeviLamina 1.x 及以後(當前 26.60.x),服務端

加載 GMLIB-LegacyRemoteCallApi 等模組時報 Failed to load mod ... Missing dependency ModAPI(缺少依賴項 ModAPI),已經裝了 GMLIB 仍然不行,該裝什麼?

ModAPI 是 GroupMountain(GMLIB 系)單獨拆出來的基礎庫,不包含在 GMLIB 裡,需要另外安裝。最省事的是用 lip 安裝依賴它的模組(如 lip install github.com/GroupMountain/GMLIB-LegacyRemoteCallApi),lip 會按依賴聲明一併拉取 GMLIB-Release、ModAPI-Release、iListenAttentively 等前置;手動安裝則到 GroupMountain 的 GitHub(ModAPI-Release 倉庫)下載與當前 LeviLamina/GMLIB 版本對應的 ModAPI。

適用版本:GMLIB 拆分出 ModAPI 之後的版本(GMLIB-LegacyRemoteCallApi 1.13.0 要求 LeviLamina >=26.51.0)

啟動 LeviLamina 服務器時提示端口被佔用(或崩潰日誌顯示端口被佔用),但配置的端口理論上沒被其他程序使用,怎麼解決?

多半是後臺殘留了一個之前啟動的同路徑 BDS 進程。LeviLamina 啟動時會檢測到“存在另一個相同路徑的 BDS 進程,可能導致網絡端口和存檔被佔用”,並詢問是否結束該 PID 的進程(y=是,n=否,e=退出),輸入 y 即可;也可以在任務管理器中結束 bedrock_server_mod.exe / bedrock_server.exe。如果確實要在同一臺機器上開第二個服務器,需同時修改 server.properties 中的 server-port 和 server-portv6,並把 enable-lan-visibility 設為 false,否則仍可能衝突。

適用版本:當前所有 LeviLamina 版本

LeviLamina 服務器假死(無響應但進程不退出、沒有崩潰日誌),卸載插件也排查不出,怎麼定位卡在哪裡?

  1. 先確認 LeviLamina、LSE 和各 mod 都已是最新且互相匹配的版本。
  2. 用二分法卸載 mod/插件(含 addon、存檔因素)逐步排查。
  3. 用調試器抓調用堆棧:安裝 WinDbg 或 x64dbg,服務器卡住時 Attach(附加)到 bedrock_server_mod.exe 進程,暫停(Break)後查看 Call Stack,重點看 MC_SERVER 主線程卡在哪個模塊/函數,即可判斷是哪個 mod(或 LSE 腳本死循環)導致阻塞。要看到函數名需要配好對應的 pdb(LeviLamina release 提供 debug 包)。
  4. 把堆棧截圖/文本發給對應 mod 開發者或 LeviLamina 開發者分析。

適用版本:當前所有 LeviLamina 版本

LeviLamina 加載插件/模組時報缺少符號(Could not find symbol、API 丟失、LeviLamina.dll 導出缺失),已更新 dll 仍報錯,怎麼解決?

這是符號對不上:模組或其前置是針對別的 LeviLamina/BDS 版本編譯的,所需符號在當前版本中不存在(啟動日誌的依賴診斷中會顯示 missing content,錯誤碼通常為 127“依賴版本不正確”)。解決方法:把模組以及 GMLIB 等前置都更新到適配當前 LeviLamina 版本的版本(從各自 GitHub Releases 或 levimc.org/mods 下載),或把 LL/BDS 換到模組支持的版本;如果 BDS/LL 本身安裝不完整或版本不一致,用 lip 重新安裝匹配的 BDS 與 LeviLamina(如 lip install github.com/LiteLDev/bds@<版本> LeviLamina)。

適用版本:當前所有 LeviLamina 版本

LeviLamina 加載模組時報錯 Failed to load manifest for XXX-1.1.0 / Mod name XXX do not match folder XXX-1.1.0,改名後又報找不到入口(entry)文件,怎麼解決?

  1. LeviLamina 要求模組文件夾名與 manifest.json 中的 name 完全一致。例如把 mods/LLBlackBEEx-1.1.0 改名為 mods/LLBlackBEEx(去掉版本號)。
  2. 改名後報入口加載失敗,通常是解壓時多套了一層目錄(mods/LLBlackBEEx/LLBlackBEEx/...),導致 manifest 裡 entry 指向的文件找不到。把最裡層文件夾裡的所有文件移動到 mods/LLBlackBEEx/ 下(manifest.json 應直接位於 mods/<模组名>/ 中),刪除多餘的內層文件夾,然後重啟服務器。

用 lip 安裝模組可以避免這類目錄問題。

適用版本:當前所有 LeviLamina 版本(模組目錄為 mods/)

26.40 服務端使用地獄門需要等很久才能傳送、進末地門卡在加載界面,是什麼原因?

是第三方插件 FuckMovementAuthority(反服務端移動校驗)導致的,卸載後即可正常傳送;作者已修復並以 FuckPlayerActionsAuthority 重新發布,更新到新插件即可。

適用版本:BDS 26.40 + 該第三方插件舊版。未能從源碼或文檔中直接證實,僅供參考。

server.properties 設置了 language=zh_CN 後,控制台和插件中的方塊、物品名稱都顯示成翻譯鍵名(翻譯失效),或啟用教育版/存在模組物品後翻譯系統異常,是什麼原因?

是第三方前置庫 GMLIB 的問題:部分版本 GMLIB 的接口會導致翻譯系統失效。如果沒有依賴 GMLIB 的插件,直接刪除 GMLIB 即可恢復;否則更新 GMLIB 或向其作者反饋。刪除 language 配置本身無效。

適用版本:BDS 26.40.x + LeviLamina 26.40.x 時期的 GMLIB 版本。未能從源碼或文檔中直接證實,僅供參考。

BDS 裝上 LeviLamina 後 list 命令的回覆出現異常,而原版 BDS 正常,是什麼原因?

是第三方前置庫 GMLIB 導致的,刪掉 GMLIB 即可恢復,與 LeviLamina 本身無關;GMLIB 方面表示已修復,更新 GMLIB 新版本或向其提 issue。

適用版本:2026 年 10 月前後的 GMLIB 版本。未能從源碼或文檔中直接證實,僅供參考。

BDS(裝有 LeviLamina/LSE)啟動時報錯並崩潰,日誌顯示內存分配失敗(bad_alloc),是什麼原因?

報錯和崩潰都是因為內存分配失敗,即物理內存(RAM,不是硬盤空間)不足。案例中機器只剩約 1.5GB 可用內存。需要關閉其他佔用內存的程序或增加服務器內存。

適用版本:當前所有版本(與運行環境相關)。未能從源碼或文檔中直接證實,僅供參考。

LeviLamina 服務器開服正常,但玩家進入時服務端崩潰(stack overflow,trace 顯示在 BDS 內部邏輯如隨機游泳目標獲取區塊時崩潰),怎麼排查?

這類 trace 只能看出崩潰發生在 BDS 內部邏輯中,通常由某個 mod/插件干擾引起,存檔一般沒問題。應逐個移除插件排查。案例中定位到是第三方插件 FixCopyItem(通用防刷物品)引起,移除即可。注意號稱“全版本通用”的插件也可能在新版本出問題。另外升級 LeviLamina 時必須同時升級到其對應的 BDS 版本。

適用版本:當前所有版本(排查思路)。未能從源碼或文檔中直接證實,僅供參考。

LeviLamina 啟動時出現一條與 bedrock-runtime-data 相關的報錯(其他功能正常),原因是什麼?

原因是 bedrock-runtime-data 版本過舊,與當前 LeviLamina 不匹配。LeviLamina 每個版本都依賴特定版本的 bedrock-runtime-data(服務端與客戶端各自不同),手動安裝時需一併更新;用 lip 安裝/更新 LeviLamina 會自動安裝對應版本。

LeviLamina 下某個 mod(如 GMLIB)用 lip 安裝後加載失敗,提示 manifest 可能有問題,應檢查什麼?

加載失敗通常是 mod 本體文件缺失或 manifest.json 有問題。manifest.json 中 entry 必須與實際 dll 文件名一致;mods 下該 mod 所在文件夾名必須與 manifest.json 中的 name 一致,否則無法加載。排查時可只保留該前置和單個依賴它的 mod 逐個加載,以排除其他 mod 衝突(案例中最終是另一個插件衝突導致)。

LeviLamina 啟動時報 LeviLamina 自身玩家信息數據庫(LevelDB)打不開的錯誤,怎麼修復?

通常是數據殘留/異常關閉導致 LevelDB 目錄裡的 CURRENT 文件指向了不存在的 MANIFEST。當前版本該數據庫位於 mods/LeviLamina/data/playerinfo(舊版為 plugins/LeviLamina/data/playerdata)。解決:用記事本打開該目錄下的 CURRENT,把內容改成目錄中實際存在的 MANIFEST-xxxxxx 文件名;或者直接刪除該數據庫目錄(會丟失 LeviLamina 記錄的玩家 UUID/XUID/名稱映射,服務器運行後會重新記錄)。

適用版本:LeviLamina 1.x 及以上(路徑為 mods/LeviLamina/data/playerinfo)

LeviLamina 啟動時報錯,原因是 bedrock-runtime-data 版本太老,怎麼修復?是否需要升級 BDS?

這是服務器根目錄下 bedrock_runtime_data 數據與當前 LeviLamina 不匹配導致的,不是 BDS 本身的問題(BDS 版本只需與 LeviLamina 要求的一致)。bedrock-runtime-data 是 LeviLamina 的 lip 依賴(版本被精確固定),用 lip 重新設置遊戲與加載器即可自動裝上匹配版本,例如 lip setup --game 1.26.60 --loader levilamina@26.60.8(注意:當前 lip 的 lip update 會拒絕對 LeviLamina/bds 操作並提示改用 lip setup);也可以從 https://github.com/LiteLDev/bedrock-runtime-data 的 release 下載 LeviLamina 的 lip.toml 中要求的那個版本,替換根目錄的 bedrock_runtime_data 文件夾。

適用版本:當前所有版本(LeviLamina 26.60.8 依賴 bedrock-runtime-data 26.60.6-server.16)

LeviLamina 啟動時模組無法加載,報依賴缺失(... is missing / missing module),是什麼意思?

字面意思:該模組聲明的依賴模組沒有安裝(xxx will not be loaded because dependency yyy is missing),或其 dll 依賴的某個 DLL/符號不存在(missing module / missing content)。應使用 lip 安裝模組以自動補齊依賴(lip install <包>),或手動安裝缺少的依賴模組/運行庫;若是 missing content(缺符號),通常是模組與當前 LeviLamina/BDS 版本不匹配。

LeviLamina 日誌報 LOG FILE SINK: failed to archive ./logs/latest.log as ./logs\2026-10-28.log: The process cannot access the file because it is being used by another process., continuing in the new file 是什麼意思?

這表示按日期歸檔日誌(把 latest.log 重命名為日期文件)時,有另一個進程正在佔用該文件導致改名失敗;LeviLamina 會改為繼續寫入新的日誌文件,不影響服務器運行。檢查是否有其他程序(日誌查看器、面板、另一個服務端實例等)打開了 logs/latest.log。

適用版本:LeviLamina 26.x 當前版本

LeviLamina 服務器一有玩家進入就崩潰(附 trace 日誌和 minidump),是什麼原因?

本例根據崩潰日誌判斷是第三方插件 GMSidebar 導致,移除該插件後恢復正常,插件修復需聯繫插件作者。一般做法:查看 CrashLogger 生成的 trace 日誌中出錯模塊,定位到具體插件後移除/更新。

適用版本:安裝了 GMSidebar 的服務器(2026-07 前後版本)。未能從源碼或文檔中直接證實,僅供參考。

LeviLamina 服務器上玩家無法連續放置方塊、方塊被“吞”、走路回彈,原版 BDS 沒有問題,可能是什麼原因?

多半是某個插件引起的,應逐個移除插件排查。本例中刪除第三方插件 bcbk 後問題解決;也可檢查 server.properties 中與服務端權威移動相關的配置(如 server-authoritative-movement 等)是否被改動。

適用版本:當前所有版本(排查思路)。未能從源碼或文檔中直接證實,僅供參考。

LeviLamina 服務器加載 FAC(直接注入、不經過 LL 加載的原生 dll)後崩潰,原因是什麼、怎麼解決?

LeviLamina 用 mimalloc 替換了 BDS 的全局內存分配器(memory operator)。直接注入、不經 LeviLamina 加載的原生 dll 若不使用 LL 的 memory operator,與 BDS/LL 之間互相分配/釋放內存時會導致崩潰。解決:改為以 LeviLamina 模組形式加載的版本,或聯繫作者適配;維護者曾提到可使用不替換內存分配器的特殊構建,但會降低整體性能。

適用版本:LeviLamina 0.13.x 至今(內存分配器替換仍存在)。未能從源碼或文檔中直接證實,僅供參考。

LeviLamina 服務器同時裝了 TickGuard 和 GMLib,服務器“崩潰”卻沒有任何日誌(假死),是什麼原因?

這是假死,由 TickGuard 與 GMLib 衝突導致:TickGuard 在服務器卡頓時會清理過期的計劃刻(pt),清理後 GMLib 仍認為其存在,隨後發生違規訪問。解決辦法:卸載 TickGuard,等作者做兼容修復。

適用版本:同時安裝 TickGuard 與 GMLib 的服務器(2026-09 前後版本)。未能從源碼或文檔中直接證實,僅供參考。

LeviLamina 服務器啟動報 Could not load server.properties file,但 server.properties 文件明明存在,怎麼回事?

通常是通過面板/第三方“啟動器”啟動時,工作目錄(啟動目錄)不在 BDS 根目錄,導致 BDS 找不到 server.properties。檢查啟動腳本(如 start.cmd)或面板配置,確保以服務器所在文件夾為工作目錄啟動 bedrock_server_mod.exe;也可以在服務器文件夾中用 lip run 啟動。

適用版本:當前所有版本(取決於啟動方式/環境)。未能從源碼或文檔中直接證實,僅供參考。

LeviLamina 服務器更新到最新版後玩家一直進不去(連接失敗),可能是什麼原因?

新版本基岩版使用 NetherNet 傳輸,除 server-port(默認 19132,TCP 和 UDP)外還使用 server-udp-ports(默認 19132,UDP)。服務器在 NAT 後(端口映射/服務商指定端口/內網穿透)時,需按官方教程配置:開放 TCP+UDP 端口;STUN 獲取公網 IP 失敗(客戶端報錯代碼 Door)時手動告訴服務器公網地址(格式 <公网 IP>:<外部端口>:<本机端口>);端口由服務商決定或使用 frp 等內網穿透時,在 mods/LeviLamina/config/Config.json 的 targeted 部分關閉 LeviLamina 的 NetherNet 補丁。教程地址:https://levimc.org/zh-Hant/tutorials/server/let-friends-join/

適用版本:LeviLamina 26.x(BDS 1.26.60 等使用 NetherNet 的版本)

LeviLamina 服務器玩家點擊“下載必要資源包並進入”後一直卡在定位服務器,最後超時斷開;同時後臺提示 addon 數據“超過閾值”,怎麼辦?

“超過閾值”只是 addon 存儲數據過多的警告,不會導致崩潰,可以忽略。資源包下載卡住可以安裝 GMEssentials(gme),在其配置中開啟資源包下載修復功能 resource_pack_download_fix(設為 true);或者安裝 CoResourcePack 插件(https://www.minebbs.com/resources/coresourcepack.16185/)。

適用版本:LeviLamina 26.x,GMEssentials v26.60.0 等適配當前版本的版本

LeviLamina 服務器運行中崩潰,trace 日誌顯示存檔(world/db)被佔用,是什麼原因?

存檔文件被佔用,常見原因是同一個服務端(同一個存檔目錄)被啟動了兩次(一服兩開),或上一個進程沒有完全退出仍佔著存檔。檢查是否有殘留的 bedrock_server_mod.exe 進程,結束後重啟服務器即可。

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

LeviLamina 服務器頻繁崩潰,崩潰日誌顯示在處理 ItemStackRequestPacket 時崩潰,是 addon 導致的嗎?

這類崩潰發生在網絡層處理 ItemStackRequestPacket 時,與 addon 無關;自 2026 年 6 月起出現、8 月報告增多,疑似外掛客戶端發送惡意數據包的崩服手段。

適用版本:2026 年中以後的 LeviLamina/BDS 版本。未能從源碼或文檔中直接證實,僅供參考。

LeviLamina 服務器控制台不顯示中文、也看不到 LeviLamina 及 mod 的加載日誌,但服務器能進、能被 motd,是怎麼回事?

說明 LeviLamina 沒有被正常加載,實際運行的是原版 BDS(所以能進服、能 motd,但沒有 LL 的日誌和 mod 加載)。先確認啟動的是安裝時由 PeEditor 生成的 bedrock_server_mod.exe(PreLoader 會把 LeviLamina 加載進它),而不是原版 bedrock_server.exe;然後把控制台日誌翻到最上面,查看 PreLoader/LeviLamina 加載階段的報錯(如錯誤碼 126/127/1114)並據此修復。

適用版本:LeviLamina 服務端當前所有版本

LeviLamina 服務器某個維度裡堆積了海量實體(如幾十萬個凋靈頭顱、刷沙機掉落物),區塊一加載服務器就卡死或內存爆滿,無法進遊戲執行 kill,怎麼清理?

不要等區塊加載後再 kill,應離線清理存檔中的實體。可以使用提供離線實體清理功能的第三方插件(如 Cleaner),注意下載與當前 LeviLamina/BDS 版本匹配的版本(以 GitHub release 為準,MineBBS 上可能是舊版);也可以自己寫一個在服務器啟動時遍歷存檔、按維度/座標範圍刪除指定實體的一次性 mod,清理完後卸載。如果還能進入存檔,也可以用命令方塊循環執行 execute in the_end run kill @e[...] 之類的命令。

適用版本:通用思路;第三方插件需匹配當前版本。未能從源碼或文檔中直接證實,僅供參考。

啟動 LeviLamina 服務器時控制台提示檢測到另一個同路徑的 BDS 進程(顯示 PID),詢問是否結束,這是什麼意思,該怎麼選?

LeviLamina 檢測到同一路徑的 BDS(bedrock_server.exe / bedrock_server_mod.exe)已有另一個進程在運行,這會導致端口和存檔被佔用。提示為 Do you want to terminate the process with PID xxx? (y=Yes, n=No, e=Exit):輸入 y 結束舊進程後繼續啟動;n 不處理繼續啟動;e 退出當前啟動。通常選 y,或先手動關掉另一個 BDS 窗口。該檢測可通過 LeviLamina 配置中的 checkRunningBDS 關閉(默認開啟);無控制台輸入(如服務化運行)時會自動跳過。

適用版本:LeviLamina 服務端當前版本

客戶端裝上 LeviLamina 後(未裝任何 mod)遊戲一啟動就彈報錯,卸掉 LeviLamina 又能正常進入,怎麼解決?

大概率是 VC++ 運行庫(vcredist)過舊:LeviLamina 使用了很新的 C++ 特性,需要新版運行庫(典型錯誤碼 1114)。從微軟官方下載最新版安裝:https://aka.ms/vc14/vc_redist.x64.exe(不要用第三方來源的運行庫合集,可能版本更舊);安裝時如提示已安裝,可選擇修復,或先卸載再安裝新版。使用 LeviLauncher 時,啟動器會為原生模組加載器檢查桌面版 VC++ 運行庫(x64)並提示安裝。

適用版本:當前所有 LeviLamina 版本(客戶端/服務端均適用)

LeviLamina 服務端啟動時出現黃色警告 AuthHelper could not find cert,需要處理嗎?

這是 Mojang/BDS 原版自身輸出的提示,不影響服務器運行,可以忽略。

適用版本:BDS 原版行為,與 LeviLamina 版本無關。未能從源碼或文檔中直接證實,僅供參考。

服務器崩潰,trace 中顯示 LeviLamina.dll -> ll::event::player::PlayerInteractBlockEventHook::detour [PlayerInteractBlockEvent.cpp],是 LeviLamina 的問題嗎?

該 Hook 掛在 GameMode::$useItemOn 上,先發布 PlayerInteractBlockEvent,未被取消時再調用原函數。棧停在這裡通常表示崩潰發生在事件分發過程中(某個訂閱了 PlayerInteractBlockEvent 的 mod/插件回調出錯),或發生在其後調用的原函數鏈中(其他 mod 對同一函數的 hook 或遊戲本身),一般不是 LL 本身的問題。應提供完整的 trace 日誌和 minidump,並逐個排查監聽玩家交互方塊事件、或 hook 了使用物品/交互邏輯的插件。

適用版本:LeviLamina 1.x 及以上

服務器踩到“錯誤方塊”(原模組/addon 已移除導致的未知方塊)後幾秒內卡死、日誌提示 BDS crashed,如何清除這些未知方塊?

未知方塊可能導致服務器假死/崩潰。可以安裝社區開發者提供的 LeviLamina 原生模組 CleanerUnknownBlock,放入後重啟即可自動清除未知方塊;也可以離線用 Chunker 等存檔編輯工具把錯誤方塊替換為空氣,或刪除出問題的區塊讓其重新生成(操作前先備份存檔)。

適用版本:取決於第三方模組 CleanerUnknownBlock 對當前版本的適配。未能從源碼或文檔中直接證實,僅供參考。

服務端沒有任何報錯,客戶端卻提示數據包破損/斷開,服務端和客戶端版本一致,怎麼排查?

先卸掉所有插件再逐個開啟,定位出問題的插件(案例中是 AntiXray 假礦插件導致)。數據包破損的常見原因:插件在非主線程/多線程發包;Glacie 等協議轉換插件轉換數據包格式出錯;插件開發者寫 BinaryStream 時格式錯誤。

適用版本:當前所有版本(第三方插件問題)。未能從源碼或文檔中直接證實,僅供參考。

正版客戶端連接自己電腦上搭的 LeviLamina 服務器(經 frp 穿透)時提示“您必須通過 Microsoft 服務驗證”,關掉 online-mode 也不行,怎麼解決?

檢查服務器機器的系統時間:案例中服務器時鐘與標準時間相差 6 分鐘,導致 Xbox Live/Microsoft 身份驗證失敗。將服務器系統時間同步為準確時間後即可正常進入(之後若卡在“定位服務器”,多等一會通常可以進入)。

適用版本:BDS 原版身份驗證行為,與 LeviLamina 版本無關。未能從源碼或文檔中直接證實,僅供參考。

LeviLamina 服務端啟動時報錯無法正常啟動(更新插件/手動混裝組件後出現),可能是什麼原因?

PreLoader 版本、bedrock-runtime-data 版本、BDS 版本三者中任意一個與當前 LeviLamina 不匹配就會出現這種啟動錯誤,手動把不同版本的組件混在一起也能復現。應保證三者版本對應,推薦用 lip 統一安裝/更新:lip install LeviLamina(即 lip install github.com/LiteLDev/LeviLamina,會作為一次 setup 執行,安裝最新 LeviLamina 及其支持的最新 BDS)或 lip setup --game <BDS版本>(自動選擇適配該 BDS 的最新 LeviLamina),lip 會按 LeviLamina 的 lip.toml 依賴聲明安裝匹配版本的 PreLoader、bedrock-runtime-data 等組件。

適用版本:當前所有 LeviLamina 版本(服務端)

崩潰日誌(CrashLogger)

LeviLamina 啟動時報 ERROR [CrashLogger] Couldn't Create CrashLogger Daemon Process 並拋出 std::system_error [0x00000002:system] 系统找不到指定的文件(或提示缺少 CrashLogger / crashlogger.exe),是怎麼回事?怎麼裝 CrashLogger?

這是 LeviLamina 找不到外置的 CrashLogger 守護進程程序(CrashLogger.exe)導致的,常見於手動安裝、用別人的開服包/整合包解壓(exe 被殺軟刪掉)或文件不完整。該報錯不影響服務器運行:創建守護進程失敗後 LeviLamina 會自動退回使用內置 CrashLogger,但內置模式在進程內捕獲,信息和可靠性不如外置版。修復方法:

  1. 推薦用 lip 安裝/重裝 LeviLamina(已有服務器的工作區執行 lip install github.com/LiteLDev/LeviLamina;新建服務器用 lip setup --game <BDS版本>,Windows 下默認帶 LeviLamina),CrashLogger 是 LeviLamina 的依賴,會自動裝好;官方文檔已不再提供手動安裝說明。
  2. 手動補文件:從 https://github.com/LiteLDev/CrashLogger/releases 下載 CrashLogger-windows-x64.zip,把其中的 CrashLogger.exe 放到服務端目錄下的 mods/LeviLamina/CrashLogger.exe(舊版本是 plugins/LeviLamina 下,現已改為 mods)。也可在 mods/LeviLamina/config/Config.json 的 modules.crashLogger.externalpath 指定其相對路徑。
  3. 不想用外置版時,可在同一配置文件中把 modules.crashLogger.builtin 設為 true 直接使用內置 CrashLogger;把 modules.crashLogger.enabled 設為 false 則完全關閉(此時崩潰不會生成任何崩潰日誌)。

適用版本:LeviLamina 26.60.x(mods 目錄佈局);CrashLogger 1.4.x

LeviLamina 服務器崩潰(控制台直接關閉/什麼都沒顯示)後,崩潰日誌和 dmp 文件在哪裡?求助時該發什麼?

由 CrashLogger 生成,位於服務端根目錄(bedrock_server_mod.exe 所在目錄)的 ./logs/crash/ 下,文件名帶崩潰時間,例如 trace_2026-11-13_23-30-29.log 和 minidump_2026-11-13_23-30-29.dmp。求助時把這兩個文件都發出來,優先看 trace 日誌(含調用棧、模塊列表、寄存器、內存信息)。原生 BDS 沒有這個功能。注意:進程被強制結束(如任務管理器結束、斷電)時不會有崩潰日誌;崩潰發生在 CrashLogger 初始化之前或 CrashLogger 被關閉時也不會生成。常見崩潰原因之一是插件版本與 LeviLamina/BDS 版本不匹配,換成與服務端版本對應的插件即可。

適用版本:LeviLamina 當前所有版本(外置與內置 CrashLogger 都寫到 logs/crash)

崩潰生成的 trace_xxx.log 和 minidump_xxx.dmp 怎麼看?怎麼判斷是哪個插件導致的?

先看 trace 日誌裡的 Stacktrace 調用棧,找出不屬於 BDS 本體(bedrock_server_mod.exe)和系統 DLL 的模塊。例如棧中出現 vanish.dll -> PlayerInteractBlockHook::detour+0xA4 [Hook.cpp:846L],說明崩潰發生在 vanish 插件的 hook 裡,應找該插件作者處理或移除該插件。需要更深入分析時,可用 WinDbg 打開 minidump_xxx.dmp,執行 !analyze -v 查看異常和崩潰堆棧(配好對應模塊的 pdb 符號路徑效果更好)。

適用版本:LeviLamina + CrashLogger 當前所有版本

BDS 崩潰後 CrashLogger 生成的 minidump .dmp 文件大小為 0B,無法分析怎麼辦?

0B 說明崩潰時 dump 沒能寫出(常見於內存耗盡等嚴重崩潰)。先看同目錄的 trace_*.log 是否有調用棧和 Memory Info;如需完整 dump,可以用 Sysinternals 的 procdump 附加到 bedrock_server_mod.exe 進程(如 procdump -e -ma <pid>)抓取完整 dmp 再分析。注意外置 CrashLogger 已作為調試器附加在進程上時,procdump 的異常監視可能附加失敗,需先關閉 CrashLogger(modules.crashLogger.enabled=false)或結束 CrashLogger 進程。

適用版本:LeviLamina 當前版本(procdump 為第三方工具)。未能從源碼或文檔中直接證實,僅供參考。

LeviLamina 服務器崩潰後沒有 CrashLogger 的崩潰日誌,只靠內置的崩潰捕獲夠用嗎?

建議安裝外置 CrashLogger(https://github.com/LiteLDev/CrashLogger)。用 lip 安裝 LeviLamina 時會作為依賴自動裝到 mods/LeviLamina/CrashLogger.exe;手動安裝或用整合包往往缺這個組件,這也是官方推薦 lip 的原因之一(模塊化、不易缺組件)。LeviLamina 內置 CrashLogger 現在也會在 logs/crash 下生成 trace_*.log 和 minidump_*.dmp,但它在崩潰的進程內部運行,嚴重崩潰(如棧溢出、堆損壞)時可能寫不出或信息不全;外置版在獨立進程中以調試器方式捕獲,更可靠、信息更完整。

適用版本:LeviLamina 當前版本

LeviLamina 服務器頻繁崩潰,CrashLogger 日誌只顯示 Code: 0xC0000409、Module: ucrtbase.dll,堆棧全是十六進制地址看不出原因,怎麼定位?

0xC0000409 落在 ucrtbase.dll 通常是某個模組(mod)裡觸發了 abort/快速失敗(如未捕獲異常、std::terminate),並不是 ucrtbase 本身的問題。把相關模組對應的 .pdb 符號文件放到模組 dll 旁邊(服務端目錄下任意子目錄均可),外置 CrashLogger 會遞歸掃描服務端目錄加載這些 pdb,堆棧就能解析出函數名和源碼行號,從而定位出問題的模組。也可以用排除法逐個移除模組復現。

適用版本:LeviLamina 當前所有版本(外置 CrashLogger 1.x)

在 wine 環境(面板服)下運行 LeviLamina 服務器崩潰時,CrashLogger 無法輸出有效堆棧(讀不到 pdb / 缺少模塊),怎麼處理?

可能是 wine 的 bug 導致外置 CrashLogger 讀不到 pdb,或 wine 環境不完整缺少 CrashLogger 所需的 dll(dbghelp.dll / symsrv.dll)。可以在 LeviLamina 配置文件 mods/LeviLamina/config/Config.json(舊安裝為 plugins/LeviLamina/config/Config.json)中把 modules.crashLogger.builtin 設為 true,改用內置 CrashLogger,再等崩潰復現:

json
"modules": {
  "crashLogger": {
    "enabled": true,
    "builtin": true
  }
}

另外,進服一分鐘左右就崩一般是裝了與當前版本不兼容的模組;全新安裝、不加模組不崩,則說明是模組問題,應排查/移除不匹配的模組。

適用版本:LeviLamina 當前版本(wine/Linux 面板服環境)

PreLoader 與 PeEditor

啟動 BDS 時 PreLoader 報錯 Can't load ./plugins/LeviLamina\LeviLamina.dll、Error code: 127、“找不到指定的程序”,怎麼解決?

錯誤碼 127 表示 LeviLamina 或模組依賴的某個函數/版本對不上(找不到指定的程序入口)。按順序排查:

  1. 先確認 LeviLamina 版本與 BDS 版本嚴格對應(推薦用 lip 安裝/切換,lip setup --game <BDS版本> 會自動選適配的 LeviLamina、PreLoader、PeEditor),並查看 PreLoader 輸出的依賴診斷(Dependency diagnostic)裡是哪個依賴版本不對。
  2. 從微軟官網(不要用第三方整合包)下載安裝最新的 VC++ 運行庫 https://aka.ms/vc14/vc_redist.x64.exe 並重啟。
  3. 檢查操作系統版本:維護者明確表示 LeviLamina 不支持 Windows Server 2016,至少需要 Windows Server 2019(或較新的 Windows 10/11),系統太舊會缺少所需的系統函數而報 127。雲服務器可在面板重裝為 Server 2019/2022;不方便重裝時可用虛擬機,或改用 Linux 讓 lip 通過 Wine 運行 Windows 版 BDS。

適用版本:LeviLamina 當前所有版本(Windows 版 BDS)

啟動 bedrock_server_mod.exe 時 PreLoader 報 Can't load LeviLamina.dll, Error code: 126 然後閃退,是什麼原因?

錯誤碼 126 表示缺少 LeviLamina 或模組依賴的 DLL(找不到指定的模塊)。PreLoader 報錯後會繼續輸出依賴診斷(Dependency diagnostic / Analyzing dependency),等它輸出並查看具體缺少的是哪個文件。

常見原因:LeviLamina 或其依賴沒有完整安裝(PreLoader、PeEditor、CrashLogger、bedrock-runtime-data 等與 LeviLamina 版本不匹配或缺失)、缺 VC++ 運行庫。

解決:用 lip 在純淨 BDS 上重新安裝 LeviLamina(lip 會帶上匹配版本的依賴),其餘模組再裝回去、存檔複製過去;並安裝最新 VC++ 運行庫 https://aka.ms/vc14/vc_redist.x64.exe。若偶發且重啟即好,多半是文件被佔用或殺毒軟件攔截等環境問題。

適用版本:LeviLamina 當前所有版本(Windows 版 BDS)

LeviLamina 服務器突然開不起來,發現 PreLoader.dll 被 Windows Defender 當作病毒刪除了,怎麼辦?

這是殺軟誤報(官方已向微軟提交誤報)。從隔離區恢復或重新安裝 PreLoader.dll(例如重新執行 lip install github.com/LiteLDev/LeviLamina 或 lip install github.com/LiteLDev/PreLoader),並把服務端目錄加入 Windows Defender 排除項。

在 Windows Server 上 Windows Defender 是一項服務器功能,也可以在“服務器管理器”中刪除該功能(注意 Windows Server 安裝其他殺軟後默認不會自動禁用 WD)。

適用版本:當前所有版本(Windows)

更新 vcredist 後裝了 LeviLamina 的遊戲/服務器仍啟動報錯,如何進一步調試定位?

下載 x64dbg,在環境變量中設置 PL_DEBUG=1 後啟動遊戲/服務器:PreLoader 在加載完 Runtime Data 後會輸出 PL_DEBUG is set to 1, waiting for debugger to attach... 並暫停等待。此時打開 x64dbg,點“文件 -> 附加”,雙擊 MC(或 bedrock_server_mod)進程進行調試。

不要一開始就用調試器直接啟動,否則可能導致 Runtime Data 加載失敗。如果 PreLoader 都起不來(看不到進程),可能是系統問題(如精簡版/非官方 Windows),建議檢查 Windows 版本。

適用版本:當前 PreLoader(1.16.x)