跳到正文
本頁目錄

LeviLamina 的性能與其他問題

LeviLamina 服務器只有一兩個人在線 TPS 也很低(MSPT 很高、飛行卡頓),如何排查是哪個插件導致的?

用控制變量/二分法:先把 mods 目錄中除 LeviLamina 及其必需組件外的 mod 全部移出,進服測試 MSPT;若純 LeviLamina 不卡,說明是 mod 導致,再分批(二分)加回逐個排查,或先懷疑最近新裝的 mod。已定位到的高開銷插件案例有:通過監聽方塊變化記錄告示牌的 playerlogger、CustomMap(地圖畫)等,移除後 TPS 明顯恢復。此外紅石/活塞機器、實體堆積也是常見原因(可限制紅石頻率、檢查實體數量),雲服務器超售導致的性能不足也要排除。

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

LeviLamina 服務器內存持續上漲(幾小時到十幾 GB)直至崩潰,或頻繁隨機崩潰,怎麼排查?

內存持續上漲基本可以斷定是某個 mod/插件內存洩漏(原生 C++ mod 嫌疑較大)。排查步驟:

  1. 先備份存檔;只開純 LeviLamina(不裝 mod),或乾脆運行原版 BDS,確認是否仍洩漏。
  2. 若純淨環境正常,用排除法:先卸載 LSE 腳本插件觀察,再逐個加回 mod(有前置的先裝前置),每加一個觀察一段時間內存,定位洩漏者。
  3. 若卸載所有 mod 後仍洩漏,再考慮 BDS 本身或存檔問題(例如末地被大量凋零破壞後的存檔)。

LeviLamina 沒有查看單個 mod 內存佔用的命令。CrashLogger 崩潰日誌中會輸出 Memory Info(進程工作集/提交大小等),可用來判斷崩潰時內存情況;用 lip update github.com/LiteLDev/CrashLogger 更新到最新。另外 Intel 13/14 代(Raptor Lake)CPU 不穩定也會導致大量每次不同的隨機崩潰(堆棧中常見 AVX 相關函數),應檢查 CPU 微碼/電壓穩定性。

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

LeviLamina 服務器加載某些插件(如領地插件)時啟動時間明顯變長,為什麼一個插件會多花幾百毫秒?

主要是事件監聽導致的:LeviLamina 的事件發射器(emitter,即對應的 hook)是懶加載的,某個事件第一次被監聽時才會創建並安裝 hook,這需要時間。如果某個插件監聽了大量其他插件都沒監聽過的事件,這些 hook 的安裝開銷就都會計入它的加載時間;已經被監聽過的事件,後續插件再監聽會非常快。所以這部分加載時間並不完全是該插件自身造成的。

適用版本:LeviLamina 當前所有版本(含 26.60.x)

LeviLamina 服務端啟動非常慢怎麼辦?

可能是 Windows Defender 等殺毒軟件在掃描服務端文件導致,可嘗試把服務器目錄加入 Defender 排除項;若無效,則可能與運行環境性能有關(如 PVE 虛擬機、老舊 CPU)。另外,插件首次監聽大量事件時需安裝 hook,也會拉長啟動時間。

適用版本:當前所有版本,Windows 環境。未能從源碼或文檔中直接證實,僅供參考。

LeviLamina 的 TPS 表現會比 LiteLoaderBDS(LL2)好嗎?

差不多,TPS 主要取決於 BDS 本身,加載器不會帶來明顯提升。LiteLDev 另外提供了性能優化模組 LeviOptimize(優化區塊發送、實體廣播、紅石更新、隨機刻、異步任務調度等,各功能可用 /lo 單獨開關),可按需安裝:lip install github.com/LiteLDev/LeviOptimize。

適用版本:LeviLamina 當前版本;LeviOptimize 當前版本(要求 LeviLamina 26.60.x)

裝上 LeviLamina 後 BDS 內存佔用異常高(啟動瞬間就到 10GB),該怎麼排查?

排查方法:先直接啟動純 bedrock_server.exe 對比;然後備份存檔,模組目錄(服務端通常為 plugins/,不存在時為 mods/)裡只保留 LeviLamina 及其前置,逐個移回其他 mod 定位問題(多半是某個原生 mod 內存洩漏)。可用 Windows Performance Recorder 記錄內存使用,Mem Reduct 之類只能臨時緩解。

曾有案例最終定位為 CustomSkin(發包改玩家皮膚)插件配合含幾十個 4D 皮膚的資源包導致,刪除該皮膚資源包後恢復正常。

適用版本:LeviLamina 1.x 及以上(服務端 mod 目錄為 plugins/)

升級 LeviLamina 後開服明顯變慢,卡在 [PreLoader] Loading records from data...,是什麼原因?

據維護者解釋,自 LeviLamina 1.2.0 / BDS 1.21.70 起 PreLoader 使用的符號/記錄數據經過加密,加載時需要解密,所以 Loading records from data... 階段會比以前慢;多數機器上只需約兩秒,屬正常現象,耐心等待即可。

適用版本:LeviLamina 1.2.0-rc.1 及以後(PreLoader 1.13+)。未能從源碼或文檔中直接證實,僅供參考。

在哪裡查看 LeviLamina 的全網使用統計(服務器數量、玩家數等)?需要另裝 bStats 嗎?

LeviLamina 自帶 bStats 統計上報(0.9.1 起加入),無需另外安裝 bStats。統計頁面:https://bstats.org/plugin/server-implementation/LeviLamina/21245(也可在 bstats.org 搜索 LeviLamina)。如不想上報,可在 LeviLamina 的配置文件 Config.json 中將 targeted.enableStatistics 設為 false。

適用版本:LeviLamina 0.9.1 及以上(服務端)

LeviLamina 服務器有什麼 QQ 群服互通(QQ 群與服務器消息互通)方案?

LiteLDev 官方不提供群服互通插件,需使用社區方案,例如:HuHoBot(群服互通機器人);或基於 WebSocket 的 CoordinationWSS(ws/wsserver),下載:https://www.minebbs.com/resources/coordinationwss-ws-wsserver.9637/。使用前請確認其支持你當前的 LeviLamina/BDS 版本。

適用版本:LeviLamina 1.x 及以上(取決於第三方插件的適配情況)。未能從源碼或文檔中直接證實,僅供參考。

LeviLamina 服務器卡死時,按 Ctrl+C 為什麼關不掉服務器?

LeviLamina 通過 SetConsoleCtrlHandler(以及 SIGINT/SIGTERM 信號處理)攔截了控制台的 Ctrl+C/關閉事件,改為調用 DedicatedServer 的 stop() 請求正常關服。當前版本中,如果服務器已經進入關服流程(GamingStatus::Stopping,即已執行到 ServerInstance::leaveGameSync)後再按 Ctrl+C,會直接 std::terminate 強制結束進程,因此“關服過程中卡住”可以再按一次 Ctrl+C 強制退出。但如果服務器在進入關服流程之前就卡死(例如主線程死鎖),stop() 請求不會被處理,狀態也不會變成 Stopping,此時多按 Ctrl+C 也沒用,只能用任務管理器等方式強制結束進程。

適用版本:LeviLamina 26.60.x(服務端)

LeviLamina 的文檔能否離線下載?

可以。LeviLamina 文檔的源文件現在位於 LiteLDev/liteldev.github.io 倉庫的 docs/LeviLamina/ 目錄(Markdown,含中英文),克隆該倉庫即可離線查看;也可在該目錄下執行 npm ci && npm run build 本地構建站點。LeviLamina 主倉庫的 docs/ 目錄現在只剩 contributing(構建與代碼風格指南)。在線文檔地址為 https://levimc.org/LeviLamina/(簡體中文 https://levimc.org/zh-Hant/LeviLamina/)。

適用版本:當前版本(2026-11-16 起文檔統一遷移到 liteldev.github.io)

想給 LeviLamina 的開發文檔/教程提 PR 修改錯誤,文檔源文件在哪裡?

文檔源文件在 LiteLDev/liteldev.github.io 倉庫的 docs/LeviLamina/ 目錄,修改後向該倉庫提交 PR 即可;教程在同倉庫的 tutorials/ 目錄。文檔站點為 https://levimc.org/LeviLamina/(簡體中文 https://levimc.org/zh-Hant/LeviLamina/)。LeviLamina 主倉庫 docs/contributing/ 只存放參與 LeviLamina 開發本身的指南(構建、代碼風格)。

適用版本:當前版本(2026-11-16 起)

LeviLamina 的官網/文檔地址是什麼?

文檔:https://levimc.org/LeviLamina/(簡體中文 https://levimc.org/zh-Hant/LeviLamina/);源碼倉庫:https://github.com/LiteLDev/LeviLamina