在服務器上安裝 LeviLamina
LeviLamina
LeviLamina 支持 Linux(或 macOS、ARM)嗎?在 Linux 上怎麼運行裝有 LeviLamina 的服務器?
LeviLamina 沒有原生 Linux 版,只能加載進 x64 的 Windows 版 BDS,官方 release 也只提供 windows-x64 的包。維護者給出的原因:Linux 版 BDS 現在沒有符號;線程、異常、hook 等機制和 Windows 不同,mod 還得重寫一遍;而且實測在 wine 下跑 Windows 版 BDS 的性能反而比原生 Linux 版 BDS 更好。所以短期內沒有原生 Linux 版的計劃。
在 Linux 上的做法是用 Wine 運行 Windows 版 BDS + LeviLamina:
- 直接用 lip(推薦):lip 現在有 Linux x64 和 macOS 版。它自帶 Wine(Linux 上來自 Kron4ek/Wine-Builds),會自動裝進 VC++ 運行庫,不需要你另裝 Wine。命令和 Windows 上一樣:
lip setup --game <版本>(會同時裝好遊戲和支持它的最新 LeviLamina,無需再單獨 install LeviLamina;腳本/容器里加--accept-eula),然後lip run。 - 用官方 Docker 鏡像:
docker run -d -it --name levilamina -e EULA=TRUE -p 19132:19132/udp -p 19132:19132/tcp -v levilamina-server-data:/data ghcr.io/liteldev/levilamina-server:latest-wine(必須設EULA=TRUE,宿主機得是 x64)。教程見 https://levimc.org/zh-Hant/tutorials/server/docker/。如果要用 LeviStone(在 LeviLamina 上運行 Python 寫的 Endstone 插件),有ghcr.io/liteldev/levistone-server:latest-wine鏡像。 - 也可以先在 Windows 上把服務端目錄裝好,再整個拷到 Linux 用 wine 運行;同一個服務器文件夾可以在不同系統之間搬。自己裝 Wine 的話請用較新版本。
其他平臺:
- x64 macOS:可以通過 lip 的 Wine 運行。
- Apple 芯片的 macOS:要用 lip 的 Wine 加 Rosetta 2。
- arm64 Windows:由系統模擬 x64,可以運行。
- arm64 Linux:官方不支持。box64、FEX、Hangover 等方案都不能可靠地運行 LeviLamina 服務器,建議換 x64 機器。
- Android、iOS:不支持。
- 32 位:BDS 本身就不支持。
商家的 Linux 面板服一般裝不了,需要有 Docker 權限或者能自己運行 lip 的機器。如果一定要在 Linux 上原生運行帶插件的服務器,可以考慮 Endstone 等其他加載器,但它和 LeviLamina 生態不兼容(反過來,LeviStone 可以讓 Endstone 插件跑在 LeviLamina 上,但仍需 Wine)。
適用版本:當前所有版本(LeviLamina 26.x,lip 0.41.x,docker-levilamina-server latest-wine)
LeviLamina(LL3)服務端怎麼安裝 addon(行為包/資源包、.mcpack/.mcaddon)?LL2(LiteLoaderBDS)的 AddonsHelper 還有嗎?
LL2 的 AddonsHelper(addonshelper 文件夾)在 LeviLamina 中已不存在,放進去不會有任何反應。LeviLamina 服務端和原版 BDS 一樣支持 addon,可選方式:
- 原版方式:把解壓後的包放到
./behavior_packs、./resource_packs(或worlds/<存档>/behavior_packs、resource_packs),再在worlds/<存档>/world_behavior_packs.json、world_resource_packs.json中寫入包manifest.json裡header的uuid(pack_id)和version。判斷是資源包還是行為包要看manifest.json中modules的type(resources為資源包,data/script為行為包),不要看文件名。 - LeviLamina 1.9.6 起,服務端會從 mod 目錄下的
resource_packs/、behavior_packs/子目錄(如plugins/<Mod名>/behavior_packs,LeviLamina 自身為plugins/LeviLamina/behavior_packs)加載已解壓的包,其中行為包會被自動加入行為包棧,無需編輯存檔的 json(主要供 mod 自帶包使用)。 - 想直接丟
.mcaddon/.mcpack/.zip自動加載:安裝社區 mod GMEssentials(lip install github.com/GroupMountain/GMEssentials-Release,依賴 GMLIB 等),在其配置features中把addon_loader的enable改為true,然後把包放到服務端根目錄的./addons(目錄可在addon_loader.directory中修改)。GMEssentials 的addon_loader默認關閉(其他部分功能如chat_formatter、dynamic_motd默認開啟),改配置後需ll reactivate GMEssentials或重啟;它也帶有清理未知方塊(cleaner_unknown_block)功能。 - 獨立 CLI 工具 https://github.com/harry-xi/addon-manager 也可管理 BDS addon。
注意:LiteLDev/LegacyAddonsManager 和 pingguo114514/AddonsManager 均已歸檔,且依賴的 7-zip 包已無法解析,當前 lip 無法正常安裝,不要再用。
適用版本:LeviLamina 當前版本(26.60.x);第 2 種方式需 LeviLamina 1.9.6 及以上
如何在 Minecraft 基岩版(Windows)客戶端上安裝 LeviLamina 客戶端版?能手動安裝嗎?
不建議手動安裝(步驟比想像中麻煩得多)。當前推薦用 LeviLauncher 安裝:在“下載”頁選“加載器”一欄顯示 LeviLamina 的受支持 GDK 版本,安裝實例時保持“安裝 LeviLamina”打開並選擇最新 LeviLamina 版本即可;已有實例可在“實例設置”→“加載器”標籤頁安裝/更新/移除 LeviLamina;之後可在“LeviMC 模組”裡安裝客戶端模組(或在“管理模組”中導入 .mcmod)。LeviLauncher 自動安裝 LeviLamina 僅限受支持的 GDK 版本。注意當前的 lip 只管理服務器(lip 文檔 FAQ:“Can lip install client mods? No. lip manages servers only.”),客戶端的 LeviLamina 和模組由 LeviLauncher 這類啟動器管理。從 LeviLamina 26.60.8 起包已移除 #client 變體,默認變體同時含服務端和客戶端構建,舊包在 tooth.json 中聲明的 #client 依賴會由 LeviLauncher 解析到默認變體。服務端 mod 可能需要重新編譯適配客戶端才能使用。
適用版本:LeviLamina 1.8.0 及以上(客戶端支持);LeviLauncher Windows 版
遷移 LeviLamina 服務器時只拷貝存檔(worlds)夠嗎?LeviLamina 及經濟、領地等 mod 的玩家數據存在哪裡?
不夠。LeviLamina 自身的數據(如玩家信息庫 playerinfo,基於 LevelDB 的 KeyValueDB,記錄 UUID/XUID/玩家名對應關係)存放在 mods/LeviLamina/data/ 目錄(舊版為 plugins/LeviLamina/data/),遷移時需一併複製。各 mod 的數據在各自目錄下,例如 LegacyMoney 的經濟數據是 mods/LegacyMoney/economy.db,領地等其他 mod 的數據把對應 mod 目錄下的數據文件一起打包遷移即可。玩家信息庫默認按需啟動(有 mod 使用時才加載),如需始終啟用可在 mods/LeviLamina/config/Config.json 中設置 targeted.playerInfo.alwaysLaunch 為 true。mod 目錄為 mods/,早期 0.x 版本為 plugins/。
適用版本:LeviLamina 當前版本
安裝 LeviLamina 只能用 lip 嗎?能不能手動把 GitHub Release 的 zip 解壓到 BDS 目錄?網上教程手動安裝後報錯/缺 DLL 怎麼辦?
官方推薦、也是官方文檔唯一給出的方式是用 lip 安裝,不建議手動解壓拼裝。
推薦做法:從 https://github.com/LiteLDev/lip/releases/latest 下載 lip-<version>-win-x64.msi 安裝,新建一個空文件夾,在其中運行 lip(圖形化終端界面,選「創建服務器」),或用命令行:lip setup --game 1.26.60(也可 lip install LeviLamina / lip install github.com/LiteLDev/LeviLamina@<版本>)。lip 會自動下載對應版本的 BDS 及全部依賴,並生成 bedrock_server_mod.exe。啟動時要用 lip run 或 bedrock_server_mod.exe,而不是原版 bedrock_server.exe。連不上 GitHub 時在 lip 中配置代理/鏡像。
若堅持手動安裝(不受官方支持,容易出錯):需要把 lip 做的事全部手工做一遍——閱讀包根目錄的 lip.toml(舊版為 tooth.json),按其中 deps 下載對應版本的依賴(bds、CrashLogger、levilamina-loc、PeEditor、PreLoader、bedrock-runtime-data),按 place 字段放置文件(LeviLamina 的 levilamina-v<版本>-server-release-windows-x64.zip 中的 LeviLamina/ 放到 mods/LeviLamina/),最後在服務器目錄執行 PeEditor.exe -mb 生成 bedrock_server_mod.exe。普通用戶下載 release 版,debug 版僅供開發調試。手動安裝的細節以各包的 lip.toml 為準。
注意:網上提到 LiteLoader.dll、LLMoney.dll、.lib 文件、直接把 dll 丟進 plugins 的教程屬於已歸檔的 LiteLoaderBDS(LL2)時代,已過時,與 LeviLamina 不兼容(經濟插件現為 LegacyMoney)。請以官方教程 https://levimc.org/zh-Hant/tutorials/server/first-server/ 為準。
適用版本:LeviLamina 當前版本(26.60.x);lip v0.4x
LeviLamina 的模組/插件應該放在哪個目錄?手動解壓放進去後不加載、也沒有報錯,怎麼排查?
推薦用 lip 安裝模組:lip install <模组地址>(如 lip install github.com/LiteLDev/LeviOptimize,LiteLDev 的包可用短名 lip install LeviOptimize;LSE 用 lip install LegacyScriptEngine#lua 等),lip 會自動處理目錄結構和依賴。
手動安裝時注意:
- 目錄:模組放在服務器根目錄的
mods/下,每個模組一個獨立文件夾,即mods/<模组名>/manifest.json。安裝 LegacyScriptEngine 後,LSE 啟動時會把plugins/做成指向mods/的鏈接,所以舊教程中的plugins實際就是mods。 - 壓縮包要把裡面那個“含
manifest.json的文件夾”整體放進去,不能多套一層目錄(打開模組文件夾應直接看到manifest.json);沒有manifest.json的文件夾會被靜默跳過、不報錯。 - 文件夾名必須與
manifest.json裡的name一致(例如不要保留/添加“[MineBBS]-”前綴),否則會報Mod name ... do not match folder ...。 - 只有為 LeviLamina 開發的模組才能加載。單獨一個
.dll通常是 LiteLoaderBDS(LL2)插件,LeviLamina 無法使用;已停更的 LL2 時代插件也不行。單箇舊式.js/.lua/.py腳本(需已裝對應 LSE 引擎)丟進plugins/後,LSE 會在下次啟動時為它生成文件夾和清單,再重啟一次才會加載。 - 檢查前置依賴是否已安裝併成功加載(看控制台/
logs中的依賴報錯),可用ll list查看已加載的模組。 - 若
manifest.json中設置了"passive": true,該模組不會在啟動時自動加載(只在被依賴時加載),可用ll load <模组名>手動加載。 - 加載報錯時也可能是 VC 運行庫過舊,安裝最新的 Visual C++ 可再發行程序包 x64:https://aka.ms/vc14/vc_redist.x64.exe。
另外,addon(行為包/資源包)與服務端模組是兩回事,不要把模組放進行為包/資源包目錄。
適用版本:LeviLamina 1.x 及以上(當前 26.60.x);plugins 鏈接需安裝 LegacyScriptEngine
LL3(LeviLamina)是什麼、去哪裡下載和安裝?和 LiteLoaderBDS(LL1/LL2)什麼關係?新版 BDS 還能用 LL2 嗎?版本怎麼選?
LL1、LL2 都叫 LiteLoaderBDS,早已停止維護,新版 BDS 無法使用;LL3 就是 LeviLamina,是 LiteLDev(LeviMC)團隊的模組加載器,很多模組(如 CoralFans)都以它為前置。倉庫/發佈:https://github.com/LiteLDev/LeviLamina。
推薦用 lip 安裝:從 https://github.com/LiteLDev/lip/releases/latest 安裝 lip,在空文件夾裡運行 lip(界面中選“創建服務器”)或命令 lip setup --game <游戏版本>(如 lip setup --game 1.26.60),lip 會裝好對應的 BDS 和適配的 LeviLamina;lip install LeviLamina 則安裝最新 LeviLamina 及其支持的最新遊戲版本。
LeviLamina 版本與遊戲版本一一對應,不能隨便選:例如 LeviLamina 26.60.x 對應 1.26.60,26.10.x 對應 1.26.10,1.9.x 對應 1.21.132。對照表見官方文檔“支持的版本”頁。
文檔:教程 https://levimc.org/zh-Hant/tutorials/server/first-server/,LeviLamina 文檔 https://levimc.org/zh-Hant/LeviLamina/(舊地址 levilamina.liteldev.com、lamina.levimc.org 的安裝頁已遷移到 levimc.org 教程)。
適用版本:當前所有版本(LeviLamina 26.60.8;lip 0.41.x)
裝了 LeviLamina(及 LSE)的服務器怎麼升級到新的 BDS/LeviLamina 版本?必須全部重裝嗎?
升級前先備份整個服務器目錄,並確認用到的模組已有適配新版本的版本。
方式一(lip 工作區,推薦):停服後在服務器目錄運行 lip setup --game <新游戏版本>(可先加 --dry-run 查看計劃),或在 lip 界面的工作區菜單選“更改遊戲或加載器版本…”。lip 會卸載舊 BDS、安裝新 BDS 和適配的 LeviLamina,並保留 server.properties、allowlist.json、permissions.json、worlds/、mods/;沒有適配版本的模組會被列出並詢問是否卸載。注意 lip update 只更新模組,不會改變遊戲和 LeviLamina 版本。behavior_packs/、resource_packs/ 裡自己放的包會被刪除,需先在工作區外留副本。
方式二(全新安裝):新建空文件夾,用 lip 安裝新版服務端(lip setup --game <版本>,再用 lip install 安裝需要的模組,如 lip install LegacyScriptEngine#quickjs),然後把舊服的 worlds/、server.properties、allowlist.json、permissions.json 複製覆蓋過去,再把舊 mods/ 裡各模組的配置和數據複製過去(不要覆蓋新裝的模組文件),服務器層的資源包/行為包也一併複製。
LSE 的腳本插件一般可直接沿用;原生(C++)模組必須換成適配新版本的版本。升級後若報錯或崩潰,查看啟動日誌定位不兼容的模組。
適用版本:LeviLamina 當前版本;lip 0.41 及以上(lip setup);全新安裝遷移方式適用於所有版本
已經在運行的原版 BDS 服務器能否直接加裝 LeviLamina?需要重裝嗎?
可以,存檔不需要重做,但 LeviLamina 與 BDS 版本嚴格綁定:每個 LeviLamina 版本只適配特定的 BDS 版本(例如 LeviLamina 26.60.8 依賴 BDS 1.26.60),原版 BDS 版本不匹配時必須換成 LeviLamina 支持的版本。
推薦做法:新建一個空文件夾,安裝 lip 後在其中執行 lip install LeviLamina(會自動下載適配的 BDS、LeviLamina 及 PreLoader、PeEditor、bedrock-runtime-data 等依賴,並由 PeEditor 生成 bedrock_server_mod.exe),或用 lip setup --game <BDS版本> 指定遊戲版本(會自動選擇適配該版本的最新 LeviLamina)。然後把舊服務器的 worlds/、server.properties、allowlist.json、permissions.json 等複製過去,用 lip run 或雙擊 bedrock_server_mod.exe 啟動。
不建議手動拼裝(手動放入 bedrock_runtime_data、PeEditor、LeviLamina 本體再運行 PeEditor),容易漏依賴。
適用版本:當前所有 LeviLamina 版本(lip 0.41.x 的 install/setup 語義)
裝好 lip 後,如何從零安裝 LeviLamina 服務端(以及 LegacyScriptEngine)?
- 安裝 lip,新建一個空文件夾作為服務器目錄,在該目錄打開終端(cmd 或 PowerShell)。
- 執行
lip install LeviLamina(等同lip install github.com/LiteLDev/LeviLamina),lip 會自動下載 LeviLamina 支持的最新 BDS 並完成配置,期間需輸入 yes 同意 Minecraft EULA(腳本中可加--accept-eula)。也可用lip setup --game <版本>指定遊戲版本。 - 需要腳本插件時再安裝 LSE:
lip install github.com/LiteLDev/LegacyScriptEngine(默認變體含 QuickJS 和 Lua 引擎),或按需安裝單個引擎,如lip install github.com/LiteLDev/LegacyScriptEngine#nodejs/#python。 - 用
lip run或雙擊bedrock_server_mod.exe啟動。
網絡慢時可設置 GitHub 代理:lip config set github_proxy <URL>。不建議手動拼裝(易缺語言包、CrashLogger 等依賴);重裝時建議直接用新的空文件夾。官方教程:https://levimc.org/zh-Hant/tutorials/server/first-server/。
適用版本:LeviLamina 26.60.x;lip 0.41.x
在 Windows 上用 lip 安裝 LeviLamina 服務端時命令失敗/中途報錯(如 PeEditor.exe 報錯),如何排查?裝好後啟動哪個程序?
- 確認 lip 已安裝且命令寫法正確:在 cmd 中不能用
./前綴(用.\或直接寫命令)。 - 在新的空文件夾中執行
lip install LeviLamina,等進度完全結束。中途報網絡錯誤多為下載中斷或 GitHub 訪問問題,重試或設置lip config set github_proxy <URL>;失敗時查看提示和.lip/logs/下的完整報告。 - VC++ 運行庫:新版 lip 在 setup 時會自動安裝缺少的 Microsoft Visual C++ Redistributable(會彈出管理員權限請求,選“否”會導致失敗);如果運行庫過舊導致
PeEditor.exe報錯或錯誤碼 1114,請手動安裝最新版 https://aka.ms/vc14/vc_redist.x64.exe。 - 注意 LeviLamina 版本綁定特定 BDS 版本,不要自行指定不匹配的遊戲版本。
安裝完成後用 lip run 或雙擊 bedrock_server_mod.exe 啟動。
適用版本:當前所有 LeviLamina 版本(Windows);lip 0.41.x
租用的面板服(遊戲面板/雲服務商)能運行 LeviLamina 嗎?本機能運行、上傳到面板服後啟動失敗怎麼辦?
- 系統要求:LeviLamina 只能加載進 Windows 版 BDS。Windows 面板可以直接運行;x64 Linux 面板需要能運行 lip(lip 自帶 Wine 運行 Windows 版服務器)或使用官方 Docker 鏡像
ghcr.io/liteldev/levilamina-server:latest-wine,普通只能啟動原版 Linuxbedrock_server的面板無法直接使用。可從面板啟動的是.exe/.cmd還是.sh來判斷系統。 - 本機能跑、面板上啟動失敗(如提示缺少運行庫、錯誤碼 1114):通常是服務器缺少或版本過舊的 Microsoft Visual C++ 運行庫,安裝最新版 https://aka.ms/vc14/vc_redist.x64.exe 即可。服務商不允許安裝時,可以把服務端依賴的 VC++ 運行庫 DLL(如
msvcp140.dll、vcruntime140.dll、vcruntime140_1.dll等)放到服務端根目錄(bedrock_server_mod.exe所在目錄);具體依賴可用 MSYS2 MINGW64 終端裡的ldd bedrock_server_mod.exe或 VS 自帶的 dumpbin 等工具查看。 - 也可以在本地用 lip 裝好整個服務端再上傳,或請服務商代為安裝;社區另有第三方面板安裝腳本(如 MineBBS 上的 LeviBox),非官方維護。
適用版本:當前所有 LeviLamina 版本
LeviLamina 能在 Windows 7 / Windows Server 2016 / 2012 R2 等老系統上運行嗎?在這些系統上啟動閃退,或 PreLoader 報 Can't load ./plugins/LeviLamina\LeviLamina.dll, Error code: 127(找不到指定的程序),開服應該選什麼系統?
不能。LeviLamina 用到了較新的 Windows API 和新版 VC++ 運行庫,只支持 Windows 10、Windows 11 或 Windows Server 2019 及更高版本;Windows 7/XP、Windows Server 2012 R2、Windows Server 2016 都無法運行(原版 BDS 能在老系統上運行,但裝了 LeviLamina 就不行)。在老系統上加載 LeviLamina.dll 報錯誤碼 127“找不到指定的程序”,通常就是系統缺少所需 API 導致的,裝運行庫也解決不了,只能升級或重裝系統(在受支持的系統上出現 127,則多半是 LeviLamina 與模組的依賴版本不匹配,可查看日誌中的依賴診斷 Dependency diagnostic)。
另外,當前版本 LeviLamina 位於 mods/LeviLamina/ 下,報錯中的 plugins/LeviLamina 路徑屬於舊版佈局。
開服推薦 Windows Server 2022(或 2019 及以上),越新越好;也可以在 x64 Linux 或 macOS 上用 lip(lip 自帶 Wine 運行 Windows 版服務端)。用 lip 安裝時服務器所需的組件(含 VC++ 運行庫)由 lip 負責安裝。
適用版本:當前所有 LeviLamina 版本(含 26.60.x)
BDS 啟動後只有 PreLoader 在運行(提示 LeviLamina not found, PreLoader is running as DLL Loader...),LeviLamina 和模組都沒加載,是什麼原因?
說明 PreLoader 沒在模組目錄裡找到 LeviLamina 本體(加載鏈是 bedrock_server_mod.exe -> PreLoader.dll -> LeviLamina -> 其他模組)。只放 PreLoader.dll 不夠,還必須安裝 LeviLamina 本體;不要下載 GitHub 倉庫源碼,要用 Release 裡編譯好的文件,最推薦直接用 lip 安裝(lip install github.com/LiteLDev/LeviLamina),lip 會把 PreLoader、PeEditor、CrashLogger、bedrock-runtime-data 等依賴一起裝好並生成 bedrock_server_mod.exe。
當前版本 LeviLamina 本體應位於服務端的 mods/LeviLamina/ 目錄(文件夾名區分大小寫),而不是舊版的根目錄或 plugins/。手動安裝時注意:若存在 plugins/ 目錄,PreLoader 會優先把它當作模組根目錄,可在 PreLoaderConfig.json 的 modsPath 中指定。文件位置混亂時,最省事的辦法是刪掉舊文件後用 lip 重新安裝。
適用版本:LeviLamina 1.x 及以後(當前 26.60.x),服務端
LeviLamina 服務端放在含中文(非 ASCII)字符的目錄下,啟動或加載 mod 時報錯、日誌路徑亂碼、提示缺依賴或崩潰,怎麼辦?
把服務端整體放到純英文(僅 ASCII 字符)路徑下再啟動。部分 mod/腳本引擎(例如曾經的 GMLIB 的 zip 解壓邏輯、舊版 LSE NodeJS 引擎)沒有正確處理中文路徑,就會出現上述問題。server.properties 裡的 level-name 也建議只用英文;如果想讓存檔在遊戲裡顯示中文名,可以把地圖導出後在客戶端改名再導入,直接改 levelname.txt 無效。
適用版本:當前所有版本(是否出問題取決於所裝的 mod)。未能從源碼或文檔中直接證實,僅供參考。
mod 附帶的 .pdb 文件是什麼?應該放在哪裡,可以刪掉嗎?
.pdb 是調試符號文件,不是 mod 本體,可選。若要使用,把它放在對應 mod 的 .dll 同一目錄(即 mods/<模组名>/ 下,與 dll 同級),而不是服務器根目錄;這樣 CrashLogger 生成的崩潰堆棧能顯示可讀的函數符號,方便開發者分析崩潰。不在意崩潰日誌可讀性的話可以不放或刪掉,不影響運行。
安裝 mod 本身推薦用 lip(lip install <包名>),手動安裝則把壓縮包內的 mod 文件夾解壓到 mods/ 下。
適用版本:當前所有 LeviLamina 版本(mod 目錄為 mods/)
LeviLamina 服務器目錄裡的 runtimedata(bedrock_runtime_data)是什麼?需要安裝嗎,放在哪裡?
它是 LeviLamina 的必需依賴 bedrock-runtime-data(github.com/LiteLDev/bedrock-runtime-data),可理解為新形式的 PDB/符號數據(經過加密混淆),必須和 LeviLamina 一起安裝。用 lip 安裝 LeviLamina 時會自動作為依賴裝上,解壓到服務器根目錄下的 bedrock_runtime_data(與 bedrock_server.exe 同一層級),而不是 plugins/mods 目錄。
服務端和客戶端使用的運行時數據是分開發布的(版本號分別帶 -server / -client 後綴,例如 26.60.6-server.16 與 26.60.5-client.16),lip 會按安裝端自動選擇,不能混用。
適用版本:使用 bedrock-runtime-data 的 LeviLamina 版本(含當前 26.60.x)
BDS 服務端目錄裡沒有加載器,LegacyScriptEngine(LLSE)的 JS 插件丟進去也不加載,應該怎麼安裝 LeviLamina 和 LegacyScriptEngine?
插件需要先安裝加載器才能運行。推薦用 lip:安裝 lip 後,在服務器文件夾裡運行 lip(自帶圖形化終端界面,可直接裝好 BDS + LeviLamina),或參照官方教程用命令行開服。然後安裝 LSE:lip install LegacyScriptEngine#quickjs(JS 插件;其他變體為 #lua、#nodejs、#python,不指定變體時同時安裝 QuickJS 和 Lua 引擎),lip 會自動裝上 LegacyRemoteCall、LegacyMoney、iListenAttentively 等依賴。
插件放在 mods/ 中(LSE 0.23.0 起啟動時會把 plugins/ 做成指向 mods/ 的鏈接);直接放入的單箇舊式腳本在下次啟動時會被生成文件夾和 manifest,再重啟一次服務器才會加載。
適用版本:LeviLamina 26.x;LegacyScriptEngine 0.23.x;lip 0.41.x
Windows 上用 LeviLauncher 導入小地圖等客戶端 mod(dll)後進遊戲沒有效果、mod 列表也不顯示,是什麼原因?
這類客戶端模組依賴 LeviLamina 客戶端版。需要先給該實例安裝 LeviLamina:在 LeviLauncher 安裝實例時打開「安裝 LeviLamina」,或對已有實例在「啟動」頁實例選擇器旁的齒輪 →「實例設置」→「加載器」標籤頁中安裝(對應 release 中的 levilamina-v<版本>-client-release-windows-x64.zip)。
LeviLamina 只支持特定的 GDK 遊戲版本(下載頁「加載器」一欄顯示 LeviLamina 的版本),不支持時會提示「該遊戲版本不支持 LeviLamina」。同時模組必須是 client 變體、且與實例的遊戲版本和 LeviLamina 版本相對應;優先從啟動頁「LeviMC 模組」安裝,它只列出適用於該實例 LeviLamina 的模組,手動導入可在「管理模組」→「導入 .mcmod」(.zip/.dll 選「所有文件」)。
適用版本:LeviLauncher(Windows)當前版本;LeviLamina 客戶端版
在面板服(無法直接運行 lip 的託管服務器)上部署 LeviLamina,啟動時 PreLoader 報錯/頻繁崩服,是 PreLoader 壞了嗎?
通常是文件不完整導致,常見原因是缺少 bedrock-runtime-data(github.com/LiteLDev/bedrock-runtime-data),它是 LeviLamina 的必需依賴,且版本要與 LeviLamina 對應。建議在本地電腦用 lip 安裝(lip setup --game <版本> 或 lip install LeviLamina),lip 會自動裝齊 BDS、PreLoader、bedrock-runtime-data、CrashLogger、levilamina-loc 等依賴並對 exe 執行 PeEditor;在本地確認能正常啟動後,再把整個服務端目錄打包上傳到面板服,而不是手動拼裝文件。
適用版本:LeviLamina 1.x 起至當前版本
想給基岩版 BDS 服務器裝插件(如 CoralFans),需要裝 LeviLamina 還是 Endstone?
看插件屬於哪個平臺:要用 LeviLamina 模組就裝 LeviLamina;要用 Endstone 插件就裝 Endstone,或者在 LeviLamina 上安裝 LeviStone 來運行 Endstone 插件(LeviStone 只支持 Python 編寫的 Endstone 插件,安裝方式:在已裝 LL 的服務器目錄運行 pip install levistone --target mods/EndstoneRuntime)。
CoralFans 是 LeviLamina 模組,需要用 LeviLamina,並安裝與其適配版本一致的 LL;安裝文檔:https://coralfans-dev.github.io/CoralFans-doc/#/InstallDoc。
手動安裝 LeviLamina 時,依賴 bedrock-runtime-data 的版本號如 26.10.4-server.1 中的 -server.1 是什麼意思?和 bedrock_server 版本有關嗎?
-server 表示這是服務端(BDS)用的運行時數據(客戶端用的是 -client.N),後面的數字 N 是該數據包的發佈序號,每次重新發布遞增,與 bedrock_server 的版本號無關;前面的主版本號則對應遊戲構建,例如 26.60.6-server.N 對應 BDS 1.26.60.6,26.60.5-client.N 對應客戶端 1.26.60.5(見 LeviLamina 支持版本表)。
手動安裝時不要隨意挑,應使用 LeviLamina 的 lip.toml 中 deps 指定的確切版本,例如 LeviLamina 26.60.8 服務端依賴 "github.com/LiteLDev/bedrock-runtime-data" = "26.60.6-server.16";通常就是與該 LL 版本同期發佈的序號最大的那個。更推薦直接用 lip 安裝,會自動裝上正確版本。
適用版本:LeviLamina 26.x 當前版本
手動把多個插件/模組壓縮包解壓到服務器目錄時,README.md、CHANGELOG.md、LICENSE 文件重名衝突,怎麼處理?
README.md(說明)、CHANGELOG.md(更新日誌)、LICENSE(開源協議)都不是運行所需的文件,可以不放入或直接刪除,只保留插件本體文件即可。LeviLamina 模組應各自放在 mods/<模组名>/ 子目錄下(含 manifest.json),這樣一般不會互相沖突;LLSE 腳本插件可放在 plugins/(LSE 0.23.0 起它是指向 mods/ 的鏈接,啟動後會自動遷移並生成清單)。更推薦用 lip 安裝,避免手動解壓。
適用版本:當前所有版本(手動安裝場景)
用 LeviLamina 開插件服,需要安裝哪些組件?
推薦用 lip 安裝(文檔 https://levimc.org/zh-Hant/lip/)。在服務器目錄中:
lip install LeviLamina(或lip setup --game <版本>)安裝 BDS + LeviLamina;- 需要運行 LLSE 腳本插件時安裝 LegacyScriptEngine:
lip install LegacyScriptEngine(不指定變體時同時安裝 QuickJS 和 Lua 引擎),已能滿足絕大多數用途; - 有 NodeJS 插件再裝
lip install LegacyScriptEngine#nodejs;Python 插件對應#python變體,按需安裝。
然後用 lip run 啟動。
適用版本:lip 0.40 及以上;LegacyScriptEngine 當前版本
用 wine 在 Linux 上運行 LeviLamina 時控制台終端錯位、輸入命令顯示混亂或有編碼問題,怎麼處理?
手動用 wine 運行時,可以用一個簡單的中間層程序(如社區寫的 Go 程序 pts)轉發 stdin/stdout,例如:pts env WINEDEBUG=-all wine cmd /c bedrock_server_mod.exe,可解決終端錯位和部分編碼錯誤;WINEDEBUG=-all 用於屏蔽 wine 自身的調試輸出。運行 LL 只需 64 位 VC++ 運行庫(vcrun2022),不需要 32 位。
另外,當前 lip 已官方支持在 x64 Linux 和 macOS(Apple 芯片的 Mac 需 Rosetta 2)上運行:lip setup --game <版本> 後 lip run,lip 自帶 Wine 並自動安裝 VC++ 運行庫,默認設置 WINEDEBUG=-all(注意 lip 需要 glibc 2.27+,不支持 Alpine)。
適用版本:Linux 上通過 Wine 運行 LeviLamina 服務器。未能從源碼或文檔中直接證實,僅供參考。
運行 bdsdown.exe 時停在 Minecraft EULA / 隱私政策同意提示,輸入 y 無效,並且 LeviLamina 提示與 BDS 協議版本不匹配,如何下載指定版本的 BDS?
用命令行參數直接同意協議並指定版本:bdsdown.exe -y --source version://windows/x.x.x.x,其中 x.x.x.x 替換為當前 LeviLamina 版本所適配的 BDS 完整版本號(四段式完整構建號,可在 https://levimc.org/LeviLamina/versions/ 查詢,例如 LeviLamina 26.60.x 對應 1.26.60.6;LeviLamina 的 lip.toml 裡 github.com/LiteLDev/bds 依賴只寫到 1.26.60 三段)。
不過當前更推薦直接用 lip:lip setup --game <游戏版本>(腳本中加 --accept-eula)會自動下載匹配的 BDS 和 LeviLamina。
適用版本:bdsdown v1.x(當前 v1.2.1)
LeviLamina 用 lip 或手動安裝後無法加載(重啟電腦後只能正常開一次),可能是什麼原因?
LeviLamina 加載不了最常見的原因是 BDS 版本與 LeviLamina 不匹配;用 lip 安裝時會自動按依賴安裝匹配版本的 BDS。若版本正確仍加載失敗,檢查是否被 360 等殺毒軟件刪除或攔截了相關文件(如 PreLoader、PeEditor 生成的 bedrock_server_mod.exe 或 mods 目錄下的 dll),關閉殺毒軟件或將服務器目錄加入白名單後重新安裝。
適用版本:當前所有版本(Windows 服務端)。未能從源碼或文檔中直接證實,僅供參考。
兩個看似相同的 LeviLamina 服務端,一個 mod 加載成功但指令用不了,另一個正常,是什麼原因?
服務端路徑中含有中文等非 ASCII 字符可能導致各種奇怪問題(如 mod 加載成功但命令不能用),建議把服務端放到純英文、無空格的路徑下再試。
適用版本:通用排查建議。未能從源碼或文檔中直接證實,僅供參考。
教程說修改 plugins\LeviLamina\config\Config.json(simpleServerLogger、playerInfo 等),但下載的 LeviLamina 裡沒有這個配置文件,為什麼?
配置文件需要先啟動一次服務器並且 LL 正常加載後才會自動生成(找不到或讀取失敗時 LL 會按默認值重寫)。另外手動安裝教程多是舊版的,推薦按官方教程用 lip 安裝,例如在空目錄執行 lip install github.com/LiteLDev/LeviLamina(或 lip setup --game <版本>)一併裝好 BDS 與 LeviLamina。注意新版中這兩項位於 targeted.simpleServerLogger 和 targeted.playerInfo 下。
適用版本:LeviLamina 1.x 及以上;lip 寫法以當前 lip 0.41 為準
想看服務器報錯(如 addon 模型加載不出來)時,打開 CrashLogger 程序有用嗎?應該怎麼啟動服務器?
沒用。CrashLogger 只是 LeviLamina 在服務器啟動後自動拉起、用於崩潰時記錄崩潰信息的工具,不需要也不應該手動打開它。應啟動 bedrock_server_mod.exe(或用 lip run)運行服務器;addon 報錯一般不會導致崩服,相關錯誤會直接輸出在控制台和 logs 目錄的日誌中,去那裡查看即可。
適用版本:LeviLamina 當前所有版本
PreLoader 與 PeEditor
安裝 LeviLamina 後沒有生成 bedrock_server_mod.exe(或雙擊 PeEditor.exe 閃退 / 只輸出 No work to do, exiting...),怎麼手動用 PeEditor 生成?
PeEditor 正常情況下不需要手動運行:用 lip 安裝 LeviLamina 時會自動執行 .\PeEditor.exe -mb。若沒有生成 bedrock_server_mod.exe(或手動安裝 / 面板服),在 bedrock_server.exe 所在的服務端根目錄打開 cmd 或 PowerShell,執行:
.\PeEditor.exe -mb(只生成不備份可用 -m。)
說明:PeEditor 不帶參數運行什麼都不做,只輸出 No work to do, exiting...,雙擊運行也會一閃而過,因此必須在命令行裡帶 -m 參數。
-m生成bedrock_server_mod.exe。-b會把原版重命名為bedrock_server.exe.bak。--exe指定源 exe(默認./bedrock_server.exe)。-o指定輸出目錄。--verbose輸出詳細日誌。
之後用 bedrock_server_mod.exe 啟動服務器(建議在命令行裡啟動以便看報錯)。
PeEditor 本身運行報錯多為 VC++ 運行庫過舊,安裝 https://aka.ms/vc14/vc_redist.x64.exe 後重試。手動安裝時 PeEditor/PreLoader 版本必須與 LeviLamina 版本匹配(以 LeviLamina 包中 lip.toml/tooth.json 寫的依賴版本為準),因此官方更推薦用 lip 安裝。
適用版本:LeviLamina 1.x 及以上(PeEditor 3.8+,當前 3.9.3)
安裝 LeviLamina 時在 PeEditor 步驟報錯,或手動運行 PeEditor.exe 打不開/無法運行,怎麼解決?
通常是系統缺少或安裝了過舊的 Microsoft Visual C++ 運行庫(例如剛重裝過系統)。安裝最新的 VC++ 2015-2022 x64 運行庫 https://aka.ms/vc14/vc_redist.x64.exe 後,重新安裝 LeviLamina,或在 BDS 目錄用命令行手動運行 .\PeEditor.exe -mb(必須帶參數,雙擊無效)。
注意:如果之前 LeviLamina 實際沒裝成功,後續安裝 LSE 等依賴 LeviLamina 的包也會報錯,需要先把 LeviLamina 重新裝好(可用 lip list 檢查已安裝的包)。
適用版本:LeviLamina 當前所有版本
LeviLamina 文件都放好了,但啟動 BDS 時沒有加載 LL(或啟動就閃退),怎麼回事?
手動安裝時需要在 BDS 目錄用命令行運行一次 PeEditor.exe -m(lip 安裝時執行的是 PeEditor.exe -mb,會額外把原文件改名為 bedrock_server.exe.bak),它會從 bedrock_server.exe 生成 bedrock_server_mod.exe;之後必須啟動 bedrock_server_mod.exe 而不是原來的 bedrock_server.exe,才會經由 PreLoader 加載 LeviLamina。
更推薦直接用 lip 安裝 LeviLamina(lip setup / lip install LeviLamina),它會自動安裝 PreLoader、PeEditor 等依賴並執行修補,之後用 lip run 啟動服務器即可。
適用版本:LeviLamina 服務端當前所有版本
使用第三方論壇(如 MineBBS)上的 LeviLamina+LSE 整合包時,自帶的 PeEditor.bat 修補失敗怎麼辦?
不要使用第三方整合包裡的 PeEditor.bat。改用 lip 安裝 LeviLamina(lip setup,或 lip install LeviLamina 再 lip install LegacyScriptEngine),它會自動安裝依賴並執行 PeEditor.exe -mb 生成 bedrock_server_mod.exe;或按官方教程手動安裝(在 BDS 目錄運行 PeEditor.exe -m 後啟動 bedrock_server_mod.exe)。
適用版本:LeviLamina 服務端當前版本。未能從源碼或文檔中直接證實,僅供參考。
在 Linux 服務器上用 wine 運行 LeviLamina,PeEditor 生成 bedrock_server_mod.exe 失敗,怎麼處理?
現在推薦直接用 Linux 版 lip:在 x64 Linux 上 lip setup 會自行下載並配置 Wine 與 Visual C++ 運行庫,安裝 LeviLamina 時自動執行 PeEditor,之後用 lip run 啟動,不需要自己裝 wine/winetricks;也可以使用官方 Docker 鏡像 ghcr.io/liteldev/levilamina-server:latest-wine。
若仍要用自己的 wine 手動安裝:用 wine PeEditor.exe -m 生成,wine 前綴需為 64 位(WINEARCH=win64),並用 winetricks 安裝 VC 運行庫:
sudo wget -O /usr/local/bin/winetricks https://raw.githubusercontent.com/Winetricks/winetricks/master/src/winetricks
sudo chmod +x /usr/local/bin/winetricks
winetricks dlls vcrun2022不想看 wine 報錯可 export WINEDEBUG=-all。另外要確認 BDS 版本與所裝 LeviLamina 對應。
適用版本:LeviLamina 服務端當前版本,x64 Linux(lip 0.41.x)
手動安裝 LeviLamina 時安裝沒完成(或 lip 安裝失敗後改手動),接下來該怎麼做?啟動後又提示缺少 CrashLogger.exe 怎麼辦?
手動安裝時需要在 BDS 目錄運行一次修補程序 PeEditor.exe(PeEditor.exe -m),生成 bedrock_server_mod.exe 後用它啟動,LL 才算裝好。
啟動後若報找不到 CrashLogger.exe,需要把 CrashLogger.exe 放到 LeviLamina 模組目錄下(默認 mods/LeviLamina/CrashLogger.exe);該路徑由 mods/LeviLamina/config/Config.json 中 modules.crashLogger.externalpath 指定,是相對於 LeviLamina 模組目錄的路徑,默認值為 CrashLogger.exe。不需要外部崩潰日誌時也可把 crashLogger.enabled 設為 false。
建議儘量用 lip 安裝,它會自動裝好 CrashLogger 等依賴,否則 LSE NodeJS 等依賴也得手動找。
適用版本:LeviLamina 服務端當前版本(CrashLogger 1.4.x)
升級 LeviLamina 後又單獨升級/覆蓋了 BDS,服務器無法啟動且沒有報錯,怎麼解決?
bedrock_server_mod.exe 是 PeEditor 從 bedrock_server.exe 生成的,覆蓋或升級 BDS 文件後必須重新運行一次 PeEditor.exe -m 重新生成 bedrock_server_mod.exe,舊的不會自動更新。
另外 LeviLamina 每個版本只支持特定的 BDS 版本(其 lip.toml 中 bds 依賴精確到版本,如 LL 26.60.8 對應 1.26.60),不要單獨升級 BDS;推薦用 lip update LeviLamina 一起升級,lip 會安裝匹配的 BDS 並自動執行 PeEditor.exe -mb。
適用版本:LeviLamina 服務端當前所有版本
用 lip 單獨安裝了 PeEditor,卻沒有 PreLoader,PeEditor 和 PreLoader 不是在一起的嗎?
PeEditor 不等於 PreLoader:PeEditor 是把 PreLoader 注入遊戲可執行文件的修補工具(生成 bedrock_server_mod.exe 或原地修補 Minecraft.Windows.exe),PreLoader 是運行時加載 LeviLamina 的庫(PreLoader.dll),二者是各自獨立的 lip 包(github.com/LiteLDev/PeEditor、github.com/LiteLDev/PreLoader)。
不要單獨安裝這些依賴,應直接用 lip 安裝 LeviLamina 本體,它會自動拉取 PreLoader、PeEditor、CrashLogger 等全部依賴並執行修補。
適用版本:LeviLamina 當前所有版本