LeviLamina 在服務器上的功能與用法
LeviLamina 服務器不關服時,怎樣加載、卸載或重載單個插件/mod(包括 LSE 腳本插件)?/reload 可以嗎?
/reload 是原版命令,只重新加載行為包/addon 腳本,管不到 LeviLamina 的 mod。要管理 mod,在服務器控制台用 LeviLamina 自帶的 ll 命令:
ll list:列出已加載的 mod,確認名稱ll load <mod名>:熱加載新放進mods目錄的 modll unload <mod名>:卸載ll reload <mod名>:重載- 另有
ll enable|disable|reactivate <mod名>;這些命令末尾都可以加可選參數cascade,連同依賴它的 mod 一起處理。
<mod名> 就是 manifest.json 裡的 name,必須與 mods 目錄下該 mod 的文件夾名一致。不要寫成 .js/.dll 文件名或文件路徑,也不要寫成 legacy-script-engine-quickjs 這類引擎名。
ll 命令默認啟用、權限為 Admin,由 LeviLamina 配置 modules.command.modManageCommand 控制。
注意:
- 沒有一鍵重載全部 mod 的命令,命令要求指定 mod 名。
- 能不能卸載或重載取決於 mod 自己:C++ mod 要自己導出/註冊卸載函數(
ll_mod_unload,用LL_REGISTER_MOD時即類裡實現unload())才能卸載,否則會報"The mod does not register an unload function";卸載函數返回false時會報"The mod cannot be unloaded"。有的 mod 必須在開服前加載,熱加載會失敗;有的重載後註冊的命令會失效,甚至崩服。 - LeviLamina 開服很快,最穩妥的做法仍是重啟服務器。只需要重讀配置時,很多插件自帶
reload子命令。
適用版本:LeviLamina 0.8.4 及以上(當前 v26.60.8 仍適用)
在 LeviLamina 服務器控制台怎麼查看當前實際加載了哪些插件/mod,以及某個 mod 的版本等信息?
在服務器控制台執行 ll list,輸出形如 "There are N mods: a, b, c",可以用來確認 lip 安裝的插件是否真的被加載。查看單個 mod 的詳細信息用 ll show <mod名>,會顯示名稱、作者、描述、類型、版本、入口和額外信息;末尾加 cascade 還會列出它的依賴樹和被依賴樹。ll show 必須指定 mod 名,不支持一次顯示全部。在 LSE 腳本里可以用 ll.listPlugins() 獲取已加載插件列表。
ll 命令默認權限為 Admin,可在 LeviLamina 配置 modules.command.modManageCommand 中關閉或調整。
適用版本:LeviLamina 0.8.4 及以上(當前 v26.60.8 仍適用)
Endstone 和 LeviLamina 有什麼區別?Endstone 能運行 LeviLamina 的 dll 插件嗎?為什麼 Endstone 能在沒有完整 PDB 的情況下快速適配新版 BDS?
兩者都是注入 BDS 並 hook 的方式,但定位不同:Endstone 是插件加載器(plugin loader),類似 Bukkit,在 BDS 外包一層穩定 API,不直接暴露 BDS 內部接口,插件支持 C++ 和 Python;LeviLamina 是 mod loader,類似 Forge/Fabric,目標是暴露 BDS 的全部內部接口。實現上 Endstone 只需要很少量的符號(十幾個級別),手動處理符號、手寫頭文件,少量符號可以靠人工逆向獲得;LeviLamina 需要二十多萬個符號,其符號表和頭文件依賴 Mojang 提供的調試信息自動生成,因此 API/頭文件覆蓋面更全,但適配新版本必須等 Mojang 給出調試信息並跑完自動生成流程。兩者 API/ABI 完全不同,Endstone 不能運行 LeviLamina 的 dll 插件(就像 Fabric 不能運行 Forge 的 jar)。
適用版本:當前所有版本(Endstone 為第三方項目,其細節以 Endstone 官方為準)。未能從源碼或文檔中直接證實,僅供參考。
LeviLamina 服務端可以直接按 Ctrl+C 關服嗎?直接點窗口 X 關閉會怎樣?
可以按 Ctrl+C。LeviLamina 會捕獲 Ctrl+C,調用正常關服流程,效果等同於輸入 stop,不會丟數據(關服過程中再按一次 Ctrl+C 會直接強制結束,所以按一次後耐心等待)。如果是通過 .bat 啟動的,關服完成後命令行會詢問是否終止批處理,這時再關閉窗口即可。不建議直接點窗口 X:雖然 LeviLamina 也會對關閉窗口事件嘗試執行 stop,但 Windows 只給關閉事件很短的處理時間,進程可能在存檔保存完成前被強制結束,導致回檔到最近一次保存的狀態。
適用版本:當前所有版本(Windows 服務端;Linux/Wine 下對應 SIGINT/SIGTERM)
LeviLamina 和以前的 LiteLoaderBDS 是什麼關係?LL3 指什麼?現在開服還用 LiteLoaderBDS 嗎?
LiteLoaderBDS(縮寫 LL,有 LL1、LL2 兩個大版本)因代碼難以維護已停止維護並歸檔。LeviLamina 是其繼任者,是完全重寫的新項目(計劃名曾為 LiteLoader3,所以也被稱為 LL3),不包含 LiteLoaderBDS 的代碼,也不兼容舊版原生插件,並非簡單改名。現在開服應使用 LeviLamina(https://github.com/LiteLDev/LeviLamina,推薦用 lip 安裝);舊的 LLSE 腳本插件改由 LegacyScriptEngine 在 LeviLamina 上運行。
LeviLauncher 啟動器和 LeviLamina 客戶端版(LL 客戶端)是什麼關係?和服務端 LL 有什麼區別?
兩者不是一回事。LeviLauncher 是 Minecraft 基岩版啟動器,用於下載/安裝/隔離/啟動遊戲版本和管理 mod,類似 Java 版的 PCL2。LeviLamina 客戶端版是 mod 加載器,類似 Java 版的 Fabric:它由服務端移植而來,不依賴 BDS,提供響應輸入、自定義渲染等客戶端接口,同樣可以開發 mod。用 LeviLauncher 安裝實例時打開“安裝 LeviLamina”就會裝上 LL,不打開就是原版客戶端(類似 PCL 下載時勾不勾 Fabric)。服務端 mod 若要在客戶端(如局域網聯機)生效,需要針對客戶端適配並監聽相應的客戶端事件。
適用版本:LeviLamina 1.8.0 起(支持客戶端)至當前版本;LeviLauncher Windows 版
LeviLamina 支持用哪些語言開發插件/模組?“插件”和“模組(mod)”有區別嗎?官方會支持 Ruby、TypeScript、Go 等其他語言嗎?
“插件”和“模組(mod)”只是叫法不同,中文文檔稱“模組”,現在都安裝在服務端的 mods 目錄(舊版是 plugins 目錄)。開發方式:
- C++:原生 LeviLamina mod。
- LegacyScriptEngine(LSE):可以用 JavaScript(QuickJS 或 Node.js)、Lua、Python 編寫腳本插件,其中 JS 文檔最全,推薦;可用
lip install LegacyScriptEngine#quickjs(或#lua、#nodejs、#python)安裝對應引擎。 - Python 也可以用 LeviStone,在 LeviLamina 上運行 Endstone 的 Python 插件。
- 社區另有基於 .NET 的加載器,可用 C# 等 dotnet 語言開發(非官方)。
官方不會再像 LL2 那樣親自支持更多語言,只提供底層支持,其他語言由社區自行實現。
為什麼服務器沒有開啟作弊(或用插件強制啟用 Xbox 成就),裝了 LeviLamina 後作弊類命令仍然可以使用?
LeviLamina 默認開啟“強制啟用作弊命令”:它在註冊命令時給所有命令加上 NotCheat flag,並去掉枚舉值上“需要開啟作弊”的限制、允許選擇器展開,所以世界不開作弊也能執行這些命令,同時可以保留存檔成就。不足之處是客戶端在不開作弊時可能無法對命令名(第一層)做 Tab 補全,參數仍可補全。該功能可以在 mods/LeviLamina/config/Config.json 的 targeted.forceEnableCheatCommands 中關閉(默認 true)。
適用版本:LeviLamina 0.8 前後至當前 26.60.x,服務端和客戶端默認開啟
LeviLamina 的模組(mod,舊稱插件)加載機制是怎樣的?能支持其他語言寫的模組嗎?
LeviLamina 支持加載模組,並允許模組向 ModManagerRegistry 註冊自己的模組管理器(ModManager),因此可以為其他語言實現 runner(例如 LegacyScriptEngine 就是這樣加載腳本模組的)。LL 根據模組 manifest.json 中的 type 字段把模組分配給對應的管理器:type 為 native 時由內置的原生 DLL 模組管理器(NativeModManager)加載;其他 type 由為該類型註冊的管理器加載,未註冊則報 "Unrecognized mod type"。源碼中 ll/api/mod 是對外接口(Mod、ModManager、ModManagerRegistry、Manifest、NativeMod),ll/core/mod 裡實現了原生模組管理器 NativeModManager 和加載流程(ModRegistrar、ModLoadPlanner)。
適用版本:LeviLamina 1.x 及以上(含當前 26.60.x)
在下界等維度無法用 tp 命令跨維度傳送到指定座標,有什麼辦法?
LeviLamina 自帶跨維度傳送命令 teleportdim(別名 tpdim),可定點跨維度傳送,支持可選的座標換算參數(主世界/下界按比例換算)。該命令可在 LeviLamina 配置的 modules.command.tpdimCommand 中開關並設置權限(默認啟用,權限 GameDirectors)。原版也可以用 execute in <维度> run tp ... 的方式實現。
適用版本:當前所有 LeviLamina 版本(含 26.60.x)
BDS 原版服務端權威移動/方塊校驗(移動過快被拉回、放置/破壞方塊過快導致方塊回彈或吞方塊)能關閉嗎?有沒有 LeviLamina mod 可以禁用?
1.21.70 之後原版的該機制無法通過 server.properties 等設置關閉(老版本可以)。可使用第三方 LeviLamina mod FuckMovementAuthority(https://github.com/kuangby/FuckMovementAuthority/releases),放置相關的限制也已有對應處理;作者提示可能導致某些奇怪的 bug。安裝前請確認其 release 與你的 LeviLamina 版本匹配。LeviLamina mod 可在 https://levimc.org/mods/(原 pkg.levimc.org)查找。
適用版本:BDS 1.21.70+;FuckMovementAuthority 最新 release v26.51.5(適配 LeviLamina 26.51)。未能從源碼或文檔中直接證實,僅供參考。
GroupMountain 的服務端 FreeCamera(靈魂出竅)mod 很久沒更新還能用嗎?有什麼替代?
舊版 FreeCamera 已不適配當前版本(最新 release 停在 2025 年),其功能已(經 GroupMountain 同意)移植進 CoralFans(https://github.com/CoralFans-Dev/CoralFans),安裝與服務端版本匹配的 CoralFans 即可使用 freecamera 命令。
適用版本:LeviLamina 26.x;CoralFans v26.60.0 已適配 LeviLamina 26.60
LeviLamina 模組能不能做出網易版那種自定義 UI,比如在遊戲 HUD 上放控件?
做不了網易那種直接在 HUD 上常駐自定義控件的效果。不過現在除了傳統表單(ll/api/form 的 SimpleForm/ModalForm/CustomForm),LeviLamina 還提供了基於 Bedrock 數據驅動 UI(DDUI)的 ll::ui 接口:ll/api/ui/form 的 CustomForm、MessageBox 支持表單打開期間實時更新文本、可見性、數值和輸入值;底層的 ScreenSession、Property、Binding<T> 可以打開資源包中提供的自定義 DDUI 界面並綁定數據。也就是說,自定義界面需要配合資源包,且只限於 DDUI 屏幕,而不是任意 HUD 控件。
適用版本:LeviLamina 26.x(ll::ui 對應 @minecraft/server-ui 2.1.0 穩定功能)
LeviLamina 有沒有好用的定時執行指令的 mod?
可以使用 GroupMountain 的 GMEssentials(發佈倉庫 https://github.com/GroupMountain/GMEssentials-Release,也可在 https://levimc.org/mods/ 搜索 GMEssentials),功能較多,其中 schedule_task 功能支持用 Cron 表達式定時執行命令(配置 enable 與 tasks 列表,每項含 cron 表達式、commands 命令列表和 output;enable 默認為 false,需手動開啟)。
適用版本:GMEssentials v26.60.0 適配 LeviLamina 26.60
LeviLamina mod 需要配套資源包時,能否把資源包內置在 mod 裡自動加載?
可以。把資源包放進 mod 目錄下的 resource_packs 文件夾(mods/<mod名>/resource_packs/<资源包>)即可,LeviLamina 會自動把它註冊為資源包來源並加載(同理行為包放 mods/<mod名>/behavior_packs)。發佈時可以在 xmake.lua 打包步驟裡把資源包複製進 mod 壓縮包,或在 lip 的 tooth.json 裡讓資源包解壓/放置到 mods/<mod名>/resource_packs。若資源包修改的是主界面,可能仍需在全局資源中開啟。
適用版本:LeviLamina 服務端與客戶端當前版本(26.60.x)
LeviLamina 以前內置的 ImGui 還在嗎?
不在了。LeviLamina 曾內置 ImGui,但因為在 1.21.132 上會崩潰,已在 2026-01 被移除(提交 refactor: remove imgui);當前版本的 xmake.lua 也不再依賴 imgui。
適用版本:LeviLamina 1.21.132 適配之後的所有版本(含當前 26.60.x)
LeviLamina 客戶端上加載 Java 版光影(JE shader)的 mod 支持哪些光影、哪些遊戲版本?性能如何?
這個 mod 是 LiteLDev 官方的 Arke(github.com/LiteLDev/Arke),基於 LeviLamina 客戶端實現,可在基岩版 Direct3D 12 渲染器上運行為 Iris / OptiFine 編寫的 Java 版光影包,官方 README 宣稱“0 性能損失”。目前僅支持 Windows x64 客戶端,依賴 LeviLamina client 26.60.*(即 MC 1.26.60),不支持 26.51 等舊版本;Android 支持在計劃中。安裝後通過遊戲畫面左上角的設置按鈕加載光影包;若運行了幀生成等軟件,該按鈕可能不出現甚至導致崩潰。
適用版本:Arke 0.1.x,LeviLamina client 26.60.*,Windows x64
LeviLamina 客戶端有沒有去除/強制關閉 OreUI 的功能?
LeviLamina 本身沒有該功能。可以使用第三方項目 ForceCloseOreUI(https://github.com/QYCottage/ForceCloseOreUI)。它是獨立的 DLL(Windows)/ so(Android),並不依賴 LeviLamina:可放進 QYCottage/mc-w10-version-launcher 的 mods 目錄,或用其他啟動器/注入器加載;在 LeviLauncher 中也可以通過“導入 .dll”把它作為 preload-native 類型模組加入實例。
適用版本:當前 LeviLamina 客戶端;ForceCloseOreUI 為第三方項目,兼容性以其自身 release 為準。未能從源碼或文檔中直接證實,僅供參考。
LeviLamina 客戶端的回放 mod(Playback/replay)如何開始和停止錄製?
Playback(第三方 mod,github.com/wo55555/Playback)使用命令控制錄製:/record start 開始(或繼續)、/record pause 暫停、/record stop 停止並導出回放;另有 /record rate [20-120] 設置本地玩家視角採樣率、/record indicator [on/off] 切換錄製指示器。新版本暫停菜單的圖標行也提供開始、暫停、結束、取消按鈕,從暫停菜單結束時會要求輸入回放名稱。導出的回放存放在 Playback 的 data/replays 目錄。
適用版本:Playback 當前版本(LeviLamina 客戶端,Windows x64)
LeviLamina 插件的 manifest.json 有文檔嗎?把腳本插件和 manifest.json 打成壓縮包直接丟進 plugins 能被加載嗎?
有。manifest.json 的字段(entry、name、type、platform、passive、version、author、description、extraInfo、dependencies、optionalDependencies、conflicts、loadBefore)現已在官方文檔 LeviLamina API 參考的 mod 頁說明,也可直接參考源碼 src/ll/api/mod/Manifest.h。腳本插件的 manifest 會由 LSE 自動生成:把散裝的 .js/.lua/.py 放到 mods(plugins 是指向 mods 的鏈接)根目錄,LSE 會把它遷移到 mods/<名称>/ 並生成 manifest.json,重啟後加載。隨意打包成的壓縮包(插件+manifest)直接放進去不會被加載,LeviLamina 只從 mods 下的子目錄讀取 manifest.json,需要解壓成目錄(Node.js 後端的舊版 .llplugin 包是例外,會被 LSE 自動解壓遷移)。manifest 的目的是規範依賴聲明和自定義引擎(type),而不是統一打包格式。
適用版本:LeviLamina 1.x 及以上至當前 26.60.x,LSE 當前版本
LeviLamina 是不是隻能用於服務端(BDS)?客戶端單人存檔能用嗎?
不是。LeviLamina 是非官方的 Minecraft 基岩版模組加載器,既能加載到基岩版專用服務器(BDS),也能加載到 Windows 上的 Minecraft 客戶端中。客戶端可通過 LeviLauncher 啟動器安裝遊戲版本、LeviLamina 和客戶端模組,然後在單人存檔中使用客戶端模組(見官方教程“在 Windows 上玩模組”)。LeviLauncher 只是啟動器,加載器是 LeviLamina。
適用版本:LeviLamina 當前版本(26.60.x),LeviLauncher 1.x
LeviLamina 是否內置了 iInvalidNAKFix 的修復,還需要單獨安裝嗎?
沒有內置。LeviLamina 自帶的漏洞修復(vulnerabilityFixes:itemReadUserData、disconnectClient、subChunkRequest、limitIPFrequency 等)不包含無效 NAK 的修復,需要的話仍需單獨安裝 iInvalidNAKFix(MiracleForest/iInvalidNAKFix)。
適用版本:LeviLamina 服務端當前版本(26.60.x)
LeviLamina 是怎樣讓基岩版客戶端加載模組的?服務端能否讓進服玩家的客戶端自動啟用某些模組?
不能由服務端推送。客戶端模組需要玩家自己在本機安裝客戶端版 LeviLamina(通常通過 LeviLauncher 安裝並啟動:LeviLauncher 會在遊戲可執行文件中加入自己的加載器 LeviLauncher.dll,啟動時加載 LeviLamina 與模組),裝什麼模組由玩家自己決定,服務端無法控制,性質上類似客戶端注入。服務端能下發給客戶端的仍只有原版的資源包/行為包。
LeviLamina 服務器有沒有可以提高下界(地獄)高度上限的插件?
可以使用 GroupMountain 的 FuckNetherHeight 模組(適用於 LeviLamina):https://github.com/GroupMountain/FuckNetherHeight。使用前請確認其 release 支持你的 LeviLamina/BDS 版本。
適用版本:第三方模組,版本兼容性以其 release 為準。未能從源碼或文檔中直接證實,僅供參考。
LeviLamina 的統計數據會收集哪些信息?用的是什麼統計平臺?
LeviLamina 使用 bStats 統計(提交到 bstats.org 的 server-implementation 接口),上報內容包括服務器 UUID、系統類型(Windows 或 Linux(wine))、架構、CPU 核心數,以及自定義圖表:LeviLamina 版本、Minecraft 版本、在線玩家數、是否開啟正版驗證(online-mode)和玩家設備平臺分佈;不會上報已加載的其它模組列表。公開數據見 https://bstats.org/plugin/server-implementation/LeviLamina/21245。地區信息只是 bStats 根據請求 IP 推斷的。不想上報可在 LeviLamina 配置中把 targeted.enableStatistics 設為 false。
適用版本:當前 LeviLamina 服務端
LeviLamina、PreLoader 和 Endstone 分別對應 Java 版生態中的什麼角色?
類比 Java 版:PreLoader 相當於 Fabric Loader(負責注入/加載),LeviLamina 相當於 Fabric API(提供 mod 開發接口);Endstone 相當於 Spigot(插件 API 風格)。PreLoader 現在同時用於服務端和客戶端,LeviLamina 客戶端版本也依賴它。
LeviLamina 模組能訪問 BDS 目錄以外的文件嗎?需要用 ../../.. 這樣的相對路徑嗎?
可以。LeviLamina 模組是加載進 BDS 進程的原生 DLL,沒有文件系統沙箱,既可以用 ../ 形式的相對路徑(相對於進程工作目錄,即 BDS 根目錄)向上訪問,也可以直接使用絕對路徑;只要運行 BDS 的系統賬戶有對應權限即可。
適用版本:當前所有 LeviLamina 版本
LeviLamina 有假人插件嗎?假人插件和 addon(腳本 API)不兼容的問題解決了嗎?
有,可以使用 CoralFans 團隊的假人模組 CFSP(CoralFans SimulatedPlayer),安裝:lip install github.com/CoralFans-Dev/CFSP。以前假人與 addon/腳本 API(SAPI/GameTest)存在兼容問題,LeviLamina 已在 26.20.x 起陸續修復(26.20.3 保留 GameTest 來源信息,26.51.2 解決 SAPI 與 SimulatedPlayer 的兼容問題),使用最新版 LeviLamina 即可。
適用版本:LeviLamina 26.51.2 及以上
LeviLauncher 可以開服務器和朋友一起玩並用服務器插件嗎?
不能。LeviLauncher 是 Minecraft 基岩版客戶端啟動器(Windows 版支持 GDK/UWP,另有 Android 版),不是服務端。普通聯機用遊戲自帶的好友/局域網功能即可。如果要開能加載模組/插件的服務器,請部署 BDS 並安裝 LeviLamina(BDS 的 mod 加載器,可用 lip install github.com/LiteLDev/LeviLamina 安裝,教程見 https://levimc.org/zh-Hant/tutorials/server/first-server/)。啟動器裡也可以給客戶端安裝 LeviLamina(僅限受支持的 GDK 版本),但客戶端可用的模組較少。
適用版本:LeviLauncher 當前版本(v1.1.0);LeviLamina 當前版本
Minecraft Realms 能裝 LeviLamina 嗎?
不能。LeviLamina 需要運行在你自己部署的 BDS(bedrock_server)或自己的 Windows 客戶端上,Realms 是微軟託管的服務器,無法安裝任何第三方加載器。
為什麼 LeviLamina 把“插件(plugin)”改稱為“模組(mod)”?
LeviLamina 提供的是底層原生 API,模式更接近 Fabric/Forge 這類模組加載器,而 Endstone 等才是類似 Bukkit 的插件模式,因此改名為 mod。詳細討論見 https://github.com/LiteLDev/LeviLamina/issues/1551([Proposal]: Rename Plugin to Mod,已關閉)。現在 LeviLamina 自稱 mod loader,模組放在 mods/ 目錄下。
適用版本:LeviLamina 0.13.x 及以上
為什麼查詢 LeviLamina 服務器的 MOTD(pong)時末尾會出現 LeviLamina 標識?能否修改?
LeviLamina 會 hook RakNet 的 RakPeer::SetOfflinePingResponse,在以 MCPE; 開頭的 pong 數據末尾追加 LeviLamina; 字段,用於標識服務端為 LeviLamina(1.0.0-rc.1 起加入,當時還帶版本號,1.0.0-rc.3 起只保留標識)。LeviLamina 本身沒有提供關閉它的配置項;如需自定義或偽造 MOTD/pong 內容(如合併人數等),可以由模組自行 hook 該函數或修改相關數據。
適用版本:LeviLamina 1.0.0-rc.3 及以上(服務端)
剛裝好的 LeviLamina 啟動後顯示加載了 0 個插件(模組),以前 LL2 默認就帶幾個插件,這正常嗎?
正常。LiteLoaderBDS(LL2)默認會裝上所有前置插件,LeviLamina 採用按需安裝,本體不附帶任何模組(CrashLogger 等依賴裝在 mods/LeviLamina/ 內部,不算模組),所以顯示 0 個。需要什麼模組用 lip 安裝,例如 lip install <模组仓库地址>。
適用版本:當前所有 LeviLamina 版本
基岩版有沒有顯示結構邊框(Structure Outline)的功能?安卓能用嗎?
CoralFans(基於 LeviLamina 的第三方技術生存模組)提供 HSA 顯示和結構顯示,命令如 /hsa show 和 /hsa structure show(命令名可在配置中修改)。安裝:lip install github.com/CoralFans-Dev/CoralFans,也可以在 PC 版 LeviLauncher 中安裝。CoralFans 只有 Windows x64 版本,安卓不能直接使用,可以加入裝有 CoralFans 的服務器使用。源碼:https://github.com/CoralFans-Dev/CoralFans/,文檔:https://coralfans-dev.github.io/CoralFans-doc/
適用版本:LeviLamina 服務端/Windows 客戶端;CoralFans 當前版本(v26.60.0)
基岩版有沒有能解鎖世界建築高度上限的模組(用於導入幾千格高的地形圖)?
可以用 MiracleForest 的 LeviLamina 模組 iHigherWorld(https://github.com/MiracleForest/iHigherWorld),可分別調整主世界、下界、末地的最低/最高高度。安裝:服務端 lip install github.com/MiracleForest/iHigherWorld-Release,客戶端 lip install github.com/MiracleForest/iHigherWorld-Release#client。主世界範圍超出 -512~512(下界/末地超出 0~256)時,客戶端也必須安裝客戶端版本(配置由服務端下發)。有用戶反饋最高大約到 4096,再大遊戲會崩潰(該上限未見文檔說明)。Addon 無法做到。注意其 README 標註的運行環境為 LeviLamina 26.51.x,需確認與所用 LeviLamina 版本匹配。
適用版本:iHigherWorld v1.4.0;LeviLamina 26.51.x(Windows x64)
如何查看當前服務器安裝的 LeviLamina 版本?
在服務器控制台輸入 version 命令,會輸出類似 Game version <游戏版本> with LeviLamina-<版本> 的信息。LeviLamina 客戶端對應的命令是 cliversion。該命令可在 LeviLamina 配置的 modules.command.versionCommand 中開關並設置權限等級;若被關閉則不會註冊。
適用版本:當前所有 LeviLamina 版本
如何讓客戶端在服務器列表中顯示自定義的服務器 logo/橫幅等信息?有沒有去掉精選服務器的模組?
LeviLamina 倉庫有一個實驗分支 feat/custom-server-readme(https://github.com/LiteLDev/LeviLamina/tree/feat/custom-server-readme),實現了服務端側完全自定義服務器展示信息。該分支不會合並進 LeviLamina 主線,可參考其實現自行做成模組。去掉精選服務器可使用社區模組 NoAdServers:https://github.com/MarmieQi/NoAdServers/releases/tag/v26.60.0。第三方模組需與遊戲版本匹配。
適用版本:MC 26.60;LeviLamina 26.60.x
有哪些適用於 Windows 客戶端 LeviLamina 的開源 mod(生電、輔助、小地圖、回放、投影等)?
部分已可通過 LeviLauncher / lip 安裝:生電端 CoralFans(類似 Java 版 carpet)https://github.com/CoralFans-Dev/CoralFans;客戶端輔助 Stipuleroo(類似 tweakeroo)https://github.com/FeixiangTMC/Stipuleroo;客戶端小地圖 ChiyanMap https://github.com/qing85566/ChiyanMap;回放 Playback https://github.com/wo55555/Playback;客戶端投影 LHolo https://github.com/MarmieQi/LHolo。使用前請確認 mod 支持你的遊戲版本。
適用版本:LeviLamina 客戶端(Windows);具體版本以各 mod 發佈為準
服務器下發加密的資源包後客戶端無法使用 Vibrant Visuals(VV),LeviLamina 能解決嗎?
這是原版客戶端行為:加密資源包會被視為市場包,而市場目前的策略不支持 VV,服務端無法解決。只能通過修改客戶端繞過,例如使用 LeviLamina 客戶端 mod 強制開啟 VV。
適用版本:原版 Minecraft 基岩版客戶端行為,取決於 Mojang 當前策略。未能從源碼或文檔中直接證實,僅供參考。
能否用 LeviLamina 以 1ms 精度高頻給玩家發包(如發 PlaySound 包做 MIDI 播放器)?試過會導致服務端或客戶端直接崩潰。
做不到。這是 BDS/遊戲本身的限制,不是 LeviLamina 的問題:客戶端處理包也要同步到主線程,網絡延遲的波動本身就超過 1ms,高頻小包還可能堵塞玩家的網絡。要在服務器裡放音樂,建議把音頻做成資源包下發,或參考 NBS 播放器那類按 tick 精度播放的方案。
適用版本:當前所有版本(BDS/網絡層面的限制)。未能從源碼或文檔中直接證實,僅供參考。
能否在 BDS(LeviLamina)進程內部直接重啟 BDS?
進程內部無法自己重啟自己,LeviLamina 也沒有提供重啟 API,需要藉助 BDS 之外的外部程序(守護進程/啟動腳本)。可以自己寫外部程序,在模組中用 std::system 等方式調用它來關閉並重新拉起 BDS。若用 lip 運行服務器,可開啟自動重啟:lip config set restart on-failure --workspace(或在 lip 界面「服務器」頁打開“自動重啟”),之後用 lip run 啟動;服務器以非 0 退出碼退出時 lip 會等待 5 秒後重新啟動(10 分鐘內最多 5 次)。
適用版本:當前所有版本;lip 自動重啟需較新的 lip(文檔對應 v0.41)
裝了 LeviLamina 客戶端 mod 後還能進入別人的服務器嗎?兩人用相同啟動器和 mod 能聯機嗎?
可以。LeviLamina 客戶端可以正常進入他人服務器(例如開著 Playback 進 Hive 錄製);兩人裝相同 mod 也能正常聯機。服務端的 LeviLamina 模組不需要客戶端安裝。具體某個 mod 是否被服務器允許,需遵守對方服務器規則。
適用版本:LeviLamina 客戶端 / LeviLauncher,當前版本。未能從源碼或文檔中直接證實,僅供參考。
LeviLamina 本體是否支持 Data-Driven UI(DDUI)?從哪個版本開始?LSE 腳本插件能用嗎?
支持。LeviLamina 從 26.20.7 起加入 DDUI 支持(命名空間 ll::ui,頭文件如 ll/api/ui/form/CustomForm.h、ll/api/ui/form/MessageBox.h),與舊的 ll::form 是兩套獨立接口。使用文檔:https://levimc.org/zh-Hant/LeviLamina/developer_guides/how_to_guides/data_driven_ui_guide/,API 參考見 api_reference/data_driven_ui。目前只提供 native(C++)API,需要用 C++ mod 實現;LSE 暫未導出相關接口。
適用版本:LeviLamina 26.20.7 及以上
為什麼新版 BDS(26.20 起)的 LeviLamina 適配這麼難?舊的 mod 還能用嗎?
Mojang 把 BDS 的編譯器從 MSVC 換成了 clang-cl,LeviLamina 以及所有原生 mod 都必須改用 clang-cl 重新編譯,否則會崩潰;舊的 MSVC 編譯的 mod 不能直接用。mod 模板的 xmake.lua 已使用 set_toolchains("clang-cl")。另外適配期間曾出現 clang-cl 編譯 LSE 時編譯器自身崩潰的問題,拖慢了進度。
適用版本:LeviLamina 26.20 及以上
服務器經常崩潰,怎樣在崩潰日誌中看到崩潰時 BDS 的內存佔用?
CrashLogger 自 1.2.1 起在 trace 日誌中輸出內存信息(系統總/可用物理內存,以及 BDS 進程的 workingset、pagefile、private 等峰值/當前值的 Memory Info 段),內置 CrashLogger 也有可用內存顯示。當前版本(CrashLogger 1.4.x,隨 LeviLamina 自動安裝)已包含該功能,只需保持更新:在服務器目錄執行 lip update(或 lip update github.com/LiteLDev/LeviLamina),然後到 logs/crash/trace_*.log 中查看。
適用版本:CrashLogger 1.2.1 及以上(當前 1.4.0)
LeviLamina 宣佈對 PreLoader(及其加載的符號數據)加密,這對普通服主和 mod 開發者有什麼影響?
背景:自 BDS 1.21.20 起官方不再隨 BDS 發佈 PDB。LeviLamina 的做法是倉庫只公開頭文件(函數簽名、結構體),函數地址以哈希符號表形式放在運行時數據(當時稱 magic blob,現以 bedrock-runtime-data 包分發)中,由 PreLoader 在運行時加載解析,供 mod 調用/hook BDS 函數。由於有人濫用 PreLoader dump 數據生成並公開分發 PDB,為符合微軟要求,維護者在 2025-03 宣佈對 PreLoader 加密(只加密 PreLoader,LeviLamina 本體等不變)。影響:普通服主、LSE 腳本插件開發者、只基於 LeviLamina 公開頭文件和接口開發的 mod 都不受影響;受影響的只有依賴從 PreLoader 生成 fake PDB 在 IDA 裡逆向的原生開發,之後只能靠 bindiff 等方式。
適用版本:LeviLamina 1.1.x(BDS 1.21.60/1.21.70)之後的版本。未能從源碼或文檔中直接證實,僅供參考。
LeviLamina 客戶端(client mod)怎麼啟動?還需要 PreLoader 嗎?
需要。客戶端同樣是 PeEditor 修補遊戲可執行文件、PreLoader 在遊戲啟動時加載 LeviLamina 的機制:安裝 LeviLamina 客戶端時會執行 PeEditor.exe -mb --exe Minecraft.Windows.exe --inplace,原地修改 Minecraft.Windows.exe(原文件保留為 Minecraft.Windows.exe.bak),並同時安裝 PreLoader 依賴。
目前推薦用 LeviLauncher 完成:
- 在其中下載受支持的 GDK 正式版。
- 創建實例並打開“安裝 LeviLamina”。
- 從 LeviLauncher 啟動即可,不需要手動操作 lip。
需要該 Microsoft 賬號已購買基岩版並至少從 Microsoft Store 安裝過一次。客戶端 LeviLamina 僅支持 Windows x64(Android 端是另外的 LeviLauncher-Android 方案)。
適用版本:LeviLamina 客戶端當前版本(GDK 版 Minecraft for Windows)
客戶端 native mod 能否不依賴 LeviLamina API?PreLoader 和 LeviLamina 是什麼關係?同時運行多個客戶端是否需要複製整個遊戲實例?
LeviLamina 由 PreLoader 加載。PreLoader 負責在遊戲啟動前加載 LeviLamina,並提供符號解析(把原版符號映射給 LeviLamina 與模組使用)等底層服務;hook、事件、命令等其餘基礎設施由 LeviLamina 提供。
若想不依賴 LeviLamina,需要把用到的 LL API 和符號全換成特徵碼並自行實現對應功能(可去掉 LL 依賴後查看導入表確認還依賴了哪些符號)。
多開不一定要複製約 1G 的遊戲本體:可讓 mod 的 entry 使用相對路徑,或通過 PreLoaderConfig.json 的 modsPath 在加載前重定向模組目錄,只需把 mod 文件另複製一份防止文件佔用,並且不要同時打開同一個存檔。也可以直接用 LeviLauncher 的實例(開啟實例隔離)管理多個遊戲實例。
適用版本:LeviLamina 客戶端當前版本。未能從源碼或文檔中直接證實,僅供參考。
Level 等多繼承類的虛函數在 LL 頭文件裡沒有 vIndex,反編譯看到虛調用、又沒有 full PDB 時,怎麼知道調用的是哪個函數?
可以在運行時自己 dump:從對象虛表取出對應槽位的函數地址,再用 PreLoader 提供的地址反查符號接口得到函數名。接口位於 pl/SymbolProvider.h:pl::symbol_provider::pl_lookup_symbol_disp(addr, &length, &disp) 返回該地址對應的符號名數組(length 為個數,disp 為偏移),用完需調用 pl::symbol_provider::pl_free_lookup_result 釋放。LeviLamina 的堆棧符號化(ll::utils::stacktrace_utils::getInfo)內部也是這樣做的。
適用版本:LeviLamina 當前版本(PreLoader 1.x)