LeviStone
LeviLamina 和 Endstone 能同時使用嗎?能在 LeviLamina 上運行 Endstone 插件,或在 Endstone 上運行 LL/LSE 插件嗎?
不要把兩個加載器直接一起裝(會衝突)。應使用 LiteLDev 的 LeviStone(https://github.com/LiteLDev/LeviStone,中文說明見 README.zh.md):它是一個 LeviLamina 模組(模組名 EndstoneRuntime),把 Endstone 運行時作為 LL 模組運行,從而在 LeviLamina 上加載 Endstone 的 Python 插件,LL 模組/LSE 插件照常運行。反過來不行:Endstone 無法加載 LeviLamina 原生模組(LL 依賴完整的 BDS 頭文件/符號),也沒有現成的加載 LSE 插件的兼容層。
適用版本:LeviStone v0.11.15-post.1;LeviLamina >=26.60.4 <26.70.0
LeviStone(Endstone 運行時)能和 LSE 的 Python 引擎(legacy-script-engine-python)同時安裝嗎?兩者有什麼區別?
維護者表示兩者的 Python 運行時不能共存,同時安裝會導致 LSE Python 加載報錯/崩潰,只能二選一;如果沒用到 LSE Python 插件,直接卸載 LSE Python 引擎即可。區別:LeviStone 運行的是 Endstone 插件(.whl 包,可方便地依賴第三方 Python 庫);LSE Python 運行的是 LSE API 風格的插件。另外加載的腳本引擎越多,服務器開銷越大。當前版本未見修復說明。
適用版本:LeviStone 0.10.x 起。未能從源碼或文檔中直接證實,僅供參考。
LeviStone 支持哪些 Endstone 插件?能運行 Endstone 的 C++(native)插件嗎?Endstone 插件怎麼裝,能用 lip 裝嗎?
LeviStone 只支持用 Python 編寫的 Endstone 插件,不支持 Endstone 的原生(C++/native)插件——兩者的內存分配器(memory operator)等不同,原生插件常帶 hook,強行加載容易崩潰;真要用不如直接做成 LL 模組。LeviStone 本身用 pip 安裝(pip install levistone --target mods/EndstoneRuntime),不是通過 lip。Endstone 插件把對應平臺/Python 版本的 .whl 文件放進服務端 plugins/ 文件夾即可(也可以 pip 安裝)。
適用版本:LeviStone 0.11.x
LeviStone、Endstone、Endweave 分別是什麼關係?裝 LeviStone 能讓 LeviLamina 支持更新版本的客戶端嗎?
Endstone 是另一個 BDS 插件加載器(提供 Bukkit 式的穩定封裝 API)。LeviStone 是 LeviLamina 模組(EndstoneRuntime),把 Endstone 運行時跑在 LL 上,讓 Endstone 的 Python 插件在 LL 上運行(不支持 Endstone 的 C++ 插件),LL 模組照常運行。Endweave 是一個 Endstone 插件,在網絡層改寫數據包,讓不同協議版本的客戶端進入服務器(類似 ViaVersion/Glacie),服務端本身版本不變。所以思路是 LL + LeviStone + Endweave。Docker 用戶可用 https://github.com/LiteLDev/docker-levistone-server。注意 Endweave 只在其 README 表格列出的協議之間轉換(當前為 26.40–26.60),LeviStone 版本需與 LeviLamina 版本匹配。
適用版本:LeviStone 0.11.15;LeviLamina 26.60.x;Endweave 0.5.0 及以上
如何在 LeviLamina 上安裝 LeviStone 來運行 Endstone 插件?Endstone 插件放在哪?有什麼限制?
在已安裝 LeviLamina 的 BDS 目錄執行:
pip install levistone --target mods/EndstoneRuntime指定版本可用 pip install levistone==0.11.15 --target mods/EndstoneRuntime(版本列表見 PyPI)。0.11.15 之前的舊版本要裝到 plugins/EndstoneRuntime。LeviStone 版本需與 LeviLamina 版本匹配(參見 CHANGELOG 中每個版本對應的 LeviLamina 版本)。Endstone 插件的 .whl 文件放進服務端 plugins/ 目錄(0.11.15 起 LeviStone 加載時會自動創建 plugins 指向 mods 的目錄鏈接;若服務端目錄下已存在名為 plugins 的文件夾,則不會創建鏈接而是在日誌報錯,此時需先移走原有 plugins 文件夾)。只支持 Endstone 的 Python 插件,不支持 C++(native)插件。
適用版本:LeviStone 0.11.15 及以上;LeviLamina >=26.60.4 <26.70.0;更早版本安裝目錄為 plugins/EndstoneRuntime
想在 LeviLamina 上運行 Endstone 插件,裝了 LeviStone 後還需要再裝 Endstone 本體嗎?裝上後服務端一啟動就閃退怎麼辦?
不需要另外安裝 Endstone 本體:LeviStone 本身就是基於 Endstone 的運行時(以 LeviLamina 模組 EndstoneRuntime 的形式加載),裝好即可運行 Endstone 的 Python 插件(不支持 Endstone 原生/C++ 插件)。啟動閃退多數是 Python 環境問題:LeviStone 的 wheel 是按 Python 版本分別構建的,運行時需要與安裝時所用 pip 對應版本的 pythonXY.dll。請確認安裝 levistone 時用的 Python 與系統 PATH 中能找到的 Python 是同一版本(當前支持 Python 3.11~3.15 正式版);如果裝了多個 Python,用 py -3.x -m pip install levistone --target mods/EndstoneRuntime 明確指定版本,或者處理掉衝突的版本,再確保該版本的安裝目錄在 PATH 中。
適用版本:LeviStone 0.11.15 及以上;更早版本安裝目錄為 plugins/EndstoneRuntime
安裝 LeviStone(EndstoneRuntime)後加載失敗,報 [0x0000007E:system] The specified module could not be found … module: endstone_runtime.dll missing module: python3XX.dll(如 python312.dll / python313.dll),已經裝了 C++ 運行庫,怎麼解決?
原因是找不到與 LeviStone 對應版本的 Python dll(pythonXY.dll),通常是 Python 安裝目錄沒加進 PATH,或者安裝 levistone 時用的 pip 和 PATH 裡的 Python 不是同一個版本。解決方法:
- 安裝 Python(3.11~3.15 正式版),安裝時勾選 “Add python.exe to PATH”;沒勾選的話手動把 Python 安裝目錄加入 PATH,或者重新安裝。可以用
where python313.dll(換成你的版本號)檢查。 - 在 BDS 根目錄(有
bedrock_server_mod.exe的目錄)裡用同一個 Python 的 pip 安裝:pip install levistone --target mods/EndstoneRuntime(0.11.15 之前的版本用--target plugins/EndstoneRuntime)。 - 也可以把對應的
pythonXY.dll複製到服務器根目錄作為臨時辦法。 - 在 Docker/Wine 下,pip 用 Linux 版 Python 安裝時不會有 Windows 版的 dll,服務器運行時需要 Windows 版 Python 的 dll;建議直接使用官方鏡像
ghcr.io/liteldev/levistone-server:latest-wine,它會把 Python 裝進 Wine 前綴並自動安裝 LeviStone。
適用版本:當前版本(Windows 原生 / Wine)
LeviStone 啟動時 EndstoneRuntime 長時間卡住,之後突然開始下載,服務器啟動很慢甚至起不來,怎麼解決?
LeviStone 本身和 Endstone 插件(.whl)的依賴都是通過 pip 從 PyPI 下載的(Endstone 加載插件時會調用 python -m pip install <插件.whl>),沒配置鏡像時直連 PyPI 很慢,甚至會失敗。可以先配置國內鏡像,再在 BDS 根目錄手動安裝:
pip config set global.index-url https://mirrors.tuna.tsinghua.edu.cn/pypi/web/simple
pip install levistone --target mods/EndstoneRuntime要裝指定版本就寫 levistone==<版本>,並與 LeviLamina 版本匹配;0.11.15 之前的版本要把 mods 改成 plugins。然後運行 bedrock_server_mod.exe。用 Docker 鏡像的話,可以設置環境變量 PYPI_MIRROR_URL。
適用版本:LeviStone 0.11.15 及以上
想在 LeviLamina 上運行 Endstone 的 Python 插件(如 endweave 的 .whl),是否需要先安裝 LSE Python(legacy-script-engine-python)?安裝 LSE Python 卡住怎麼辦?
不需要。LeviStone 本身不是 Python 插件,而是讓 LeviLamina 能運行 Endstone Python 插件的模組(EndstoneRuntime),不依賴 LSE Python。而且據維護者說明,LeviStone 和 LSE Python 衝突,只能二選一,需要刪掉 LSE Python。安裝 LeviStone 後,把 Endstone 插件(.whl)放到 plugins 目錄即可(0.11.15 起 LeviStone 會自動把 plugins 創建為指向 mods 的目錄鏈接)。注意 Python 版本要與安裝 LeviStone 時所用的版本一致(當前支持 3.11~3.15)。
服務器同時安裝 EndstoneRuntime(endstone_runtime.dll,LeviStone)和某個懸浮字 mod 後一直崩潰,崩潰堆棧裡出現這兩個 dll,是它們衝突嗎?
不一定。本例從崩潰日誌看,實際是 ScriptAPI(使用了腳本 API 的 addon,SAPI)崩潰。Endstone 和該 mod 只是 hook 了 tick,任何 hook 了 tick 的 mod 都會出現在調用棧中,與崩潰本身無關。排查方法:看崩潰 trace 中真正出錯的模塊,排查並移除使用了 SAPI 的 addon(本例是某個農場類 addon),或向 Mojang 反饋。這是通用的崩潰排查經驗,當前版本仍可參考。
未能從源碼或文檔中直接證實,僅供參考。
Endweave 改成 C++ 實現後,還能在 LeviStone 上使用嗎?
可以。Endweave 目前是 Python+C++ 混合實現,以 Python 插件(.whl)的形式加載,能在 LeviStone 上運行。注意要用 LeviStone 0.11.15-post.1 及以上版本:該版本專門修復了 endweave 無法工作的問題。LeviStone 不支持純 Endstone 原生(C++)插件。
適用版本:LeviStone 0.11.15-post.1 及以上
使用 LeviStone 時想關閉某個功能,找到的配置文件其實是 endweave 的配置,LeviStone(Endstone)的配置文件在哪裡?
LeviStone 的 Endstone 配置文件是 endstone.toml,位於 BDS 根目錄(服務端工作目錄)下;首次加載時 LeviStone 會從 mods/EndstoneRuntime/endstone/config/endstone.default.toml 複製生成。在 endstone.toml 中修改對應功能開關即可。endweave 的配置是另一個組件的配置,不是 endstone 的。
適用版本:LeviStone v0.11.15-post.1