跳到正文
本頁目錄

安裝 lip 與部署服務器

用 lip 安裝的插件/模組怎麼卸載?直接刪掉插件文件夾為什麼不行?

在服務器目錄執行 lip uninstall <包>,包可以寫 lip list 顯示的身份(如 lip uninstall github.com/LiteLDev/LegacyScriptEngine#lua),也可以寫安裝時的來源(如 ./package.zip);可先加 --dry-run 查看會刪除什麼。lip 會運行卸載鉤子、刪除該包擁有的文件,並自動卸載不再被需要的依賴。不要手動刪除文件夾:lip 在 .lip/state.json 中記錄已安裝的包,手動刪除後 lip 仍認為它已安裝,再執行 lip install 同一版本也不會重裝。出現這種情況時,先 lip uninstall 再 lip install。若重裝後仍異常,可在一個新的空目錄裡用 lip 純淨安裝 LeviLamina 服務器來判斷是服務端還是插件的問題。更多子命令見 lip --help 或界面(直接運行 lip)。

適用版本:當前所有 lip 版本(狀態文件路徑為 lip v0.40+ 的 .lip/state.json)

怎麼用 lip 更新已安裝的插件?能一鍵更新所有包嗎?依賴會跟著更新嗎?LeviLamina 本身怎麼更新?

現在用 lip update(舊的 lip install --upgrade / -U 已不存在)。在服務器目錄執行:

  • lip update 不帶參數會按安裝時的來源重新請求所有顯式安裝的包(按 <repo> 安裝的會升到最高版本標籤,固定了 @版本 的保持不變);
  • lip update github.com/user/repo 只更新這一個包;
  • lip update github.com/user/repo@1.2.0 換到指定版本(可升可降)。

可先加 --dry-run 預覽。依賴只在新版本需要時才隨之更新,能否變動由插件 lip.toml 中 deps 的版本範圍決定。lip update 不會改動遊戲(BDS)和加載器(LeviLamina),也不接受它們作為參數:要更換 LeviLamina 或遊戲版本請用 lip setup。命令需在服務器(工作區)目錄中執行(資源管理器中打開服務器目錄後在地址欄輸入 cmd 或 powershell 回車即可),也可以直接運行 lip 在界面的“模組”頁更新。

適用版本:lip v0.40 及以上

用 lip 安裝插件後提示缺少依賴(前置),為什麼 lip 沒自動裝上?

lip 會自動安裝包在 lip.toml 的 deps 中聲明的依賴(<包 ID> 或 <包 ID>#<变体> = 版本範圍)。沒自動裝上通常有兩種原因:

  1. 插件作者沒在 deps 中聲明該依賴,只能聯繫作者補上,或自己找到對應包手動 lip install(報錯裡一般寫明瞭缺的包 ID 和版本範圍,可在 https://levimc.org/zh-Hant/mods/ 搜索)。
  2. 缺的是遊戲或 LeviLamina 本身:lip install 從不安裝、卸載或替換遊戲和加載器,若模組需要別的 LeviLamina 版本,命令會失敗並提示 lip setup,需先用 lip setup 設置該模組支持的遊戲和 LeviLamina 版本再裝模組。

舊版 tooth.json 的 prerequisites 字段已不再存在。手動安裝的插件請確認依賴插件確實在 mods 目錄裡。

適用版本:lip v0.40 及以上;LeviLamina 1.x 及以上(模組目錄為 mods/)

如何用 lip 一次性裝好 LeviLamina(含 BDS)以及 LSE、反作弊、優化、多維度等常用組件?

在一個新建的空文件夾中執行(可一條命令裝多個包,作為一次操作完成):

shell
lip install LeviLamina github.com/LiteLDev/LegacyScriptEngine github.com/LiteLDev/LeviAntiCheat github.com/LiteLDev/LeviOptimize github.com/LiteLDev/MoreDimensions

安裝 LeviLamina 時會自動裝上它適配的 BDS(期間需輸入 yes 同意 Minecraft EULA,腳本中可加 --accept-eula)。LSE 默認變體包含 QuickJS 與 Lua 引擎,其他引擎用變體安裝:github.com/LiteLDev/LegacyScriptEngine#nodejs、github.com/LiteLDev/LegacyScriptEngine#python。之後在已有 BDS 的工作區裡再裝模組只需 lip install <包>。第三方包(如 GMLIB 等)同樣用 lip install github.com/<作者>/<仓库> 安裝,需確認其支持當前 LL 版本。

適用版本:當前 lip(v0.41.x)與 LeviLamina 26.60.x

lip 默認裝的是最新 LeviLamina 和對應的最新 BDS,客戶端/存檔/插件只支持舊版本,怎麼用 lip 安裝指定版本的 LeviLamina 或 BDS(以及指定版本的其他包)?

lip install 不帶版本時安裝最新版本,安裝 LeviLamina 會連帶安裝它適配的 BDS(客戶端版本須與服務端匹配,可在 BDS 控制台輸入 version 查看)。指定版本的方法(在新建的空文件夾中執行):

  1. 按 LeviLamina 版本:lip install LeviLamina@<版本号>(即 github.com/LiteLDev/LeviLamina@<版本号>),會裝上該 LL 支持的最新 BDS。版本號到 LeviLamina GitHub Releases 查。
  2. 按 BDS 版本:lip setup --game <BDS版本>(如 --game 1.21.60,會自動選擇適配的最新 LeviLamina,也可加 --loader levilamina@<版本号> 指定 LL),或者把兩者寫在同一條命令裡:lip install github.com/LiteLDev/bds@<BDS版本> LeviLamina。注意不要分兩條命令先裝 bds 再裝 LeviLamina,後一條會按 LL 重新選擇遊戲版本。
  3. 已有服務器想換版本:在該文件夾再次運行 lip setup --game <版本>,worlds、server.properties 等會保留,其他模組會被換成兼容的版本。降級前務必備份存檔,高版本存檔降級可能損壞。
  4. 其他包同樣在包名後加 @版本号,可帶變體,例如 lip install github.com/LiteLDev/LegacyScriptEngine#nodejs@0.22.4,並選擇與所裝 LL 版本兼容的版本。

GitHub 訪問慢時可先執行 lip config set github_proxy <代理URL>;lip cache clean 可清理下載緩存。

適用版本:當前 lip(v0.41.x);版本號以 LeviLamina/LSE Releases 為準

國內網絡(或雲服務器、校園網)下用 lip 安裝 LeviLamina、LegacyScriptEngine 等包時下載很慢、卡住或報網絡錯誤,怎麼配置鏡像/代理?

這是訪問 GitHub 的網絡問題。lip 的大多數包都從 GitHub 下載,可以給 lip 設置 GitHub 代理(URL 前綴式的 GitHub 鏡像):

shell
lip config set github_proxy https://v4.gh-proxy.org/https://github.com/

鏡像地址可換成其他可用的、你信任的 GitHub 前綴代理;使用 0.41.1 及更早的 lip 時,有些服務需要在地址後帶完整的 https://github.com/(0.41.1 之後的 lip 會自己加上,帶著也可以)。

要點:

  1. 當前版本的 lip 只有 github_proxy 這一項網絡配置。舊版的 GoModuleProxyURL / GitHubMirrorURL / ProxyURL、go_module_proxy / go_module_proxies / github_proxies 都已不存在,goproxy.cn 之類的 Go 模塊代理也不再用到,設置它們沒有作用。
  2. 只有發往 GitHub 的請求走 github_proxy(github.com;0.41.1 之後的 lip 還包括 *.github.com、*.githubusercontent.com 以及 lip self-update);BDS 本體從 minecraft.net 下載,不受它影響。
  3. 通過代理的請求失敗時,lip 會回退到直連 GitHub,所以命令成功不代表代理可用。可以這樣測試代理:curl.exe -s -o NUL -w "%{http_code}" "<代理地址>LiteLDev/LeviLamina.git/info/refs?service=git-upload-pack",返回 200 說明代理可用。鏡像失效(被牆)時換一個;如果報錯說代理不支持 git 倉庫,也要換掉。
  4. 如果有普通的 HTTP 代理(例如 Clash 本地端口 http://127.0.0.1:7890,注意端口要填對),不需要設置 github_proxy。在運行 lip 的終端裡設置 HTTPS_PROXY / HTTP_PROXY / ALL_PROXY / NO_PROXY 即可(PowerShell:$env:HTTPS_PROXY = "http://127.0.0.1:7890");沒有這些環境變量時,lip 會使用系統代理。也可以開啟代理軟件的 TUN 模式。
  5. 移除代理:lip config delete github_proxy;明確表示直連:lip config set github_proxy ""(PowerShell 裡寫 lip config set github_proxy --% "")。用 lip config list 查看當前配置。
  6. 如果之前下載失敗留下了殘缺的緩存,執行 lip cache clean 後重試。也建議先把 lip 更新到最新版。
  7. 實在不行,可以在網絡好的機器上裝好後打包上傳到服務器。

適用版本:lip v0.41.x(當前最新);舊版配置鍵僅適用於早期 Go 版 lip

Windows 上安裝 lip 後,命令行提示找不到 lip 命令(或提示缺少 .NET 運行時),怎麼辦?

推薦從 https://github.com/LiteLDev/lip/releases/latest 下載 lip-<版本>-win-x64.msi(ARM 設備用 win-arm64)安裝,安裝程序會自動把安裝目錄加入系統 PATH。安裝後必須關閉原來的 cmd/PowerShell 窗口重新打開,新的 PATH 才生效。如果用的是 zip 便攜版,需要自己把 lip.exe 所在目錄(不帶文件名)加入“編輯系統環境變量 → 環境變量 → Path”,同樣要重開終端;可以用 echo %PATH% 檢查。也可以不配 PATH,直接用 lip.exe 的完整路徑(含空格時加引號),或把 lip.exe 放在當前目錄下運行(cmd 中直接輸入 lip,PowerShell 中需寫 .\lip)。當前版本 lip 是單個自包含可執行文件,不需要另外安裝 .NET 運行時。

適用版本:當前 lip(v0.41.x),Windows

lip 的 Release 頁面有很多文件(x64/arm64、msi/zip 等),Intel/AMD 的 Windows 電腦或 Windows Server、面板服應該下載哪個?

x64/amd64 與 arm64 指 CPU 架構而不是品牌:普通 Intel 和 AMD 電腦、Windows Server 2022 等都是 x64;arm64 只給 ARM 設備用,下錯會提示與系統不匹配。當前 lip 發佈頁(https://github.com/LiteLDev/lip/releases/latest)的文件為:lip-<版本>-win-x64.msi / win-x64.zip(Windows x64)、win-arm64.msi / win-arm64.zip(Windows ARM)、linux-x64.tar.xz(x64 Linux)、osx-x64.zip / osx-arm64.zip(macOS)。Windows 一般下載 win-x64.msi 安裝即可(自動加入 PATH);面板服或無法運行 msi 的環境下載 win-x64.zip 解壓使用。所有版本都是自包含的單文件,無需額外裝 .NET。lip 本身跨平臺,在 Linux/macOS 上會通過自己下載的 Wine 運行帶 LeviLamina 的 Windows 服務器;沒有 arm64 Linux 版。

適用版本:當前 lip(v0.41.x)

lip 包管理器在哪裡下載、怎麼安裝?有沒有 winget 安裝方式?能否自更新?有沒有 Linux 版?

lip 的倉庫現為 https://github.com/LiteLDev/lip(原 futrime/lip),文檔在 https://levimc.org/zh-Hant/lip/。Windows 從 https://github.com/LiteLDev/lip/releases/latest 下載 lip-<版本>-win-x64.msi(ARM 用 win-arm64.msi)運行安裝,會自動加入 PATH;也可下載 zip 解壓後自行把目錄加入 PATH。Linux(x64)和 macOS 下載對應壓縮包,解壓出 lip 文件放到 PATH 中的目錄。lip 是單個可執行文件,無需另裝 .NET、git 或 Wine。官方文檔已不再提供 winget 安裝方式(舊的 futrime.lip winget 包已不可用);更新 lip 用 lip self-update(lip self-update --check 只檢查)。安裝後在服務器文件夾打開終端輸入 lip 即可使用界面,或用 lip install LeviLamina 等命令。

適用版本:當前 lip(v0.41.x)

在 x64 的 Windows(Win10/Win11/Windows Server)上下載的 lip 無法運行,是什麼原因?

最常見的原因是下錯了架構:x64 電腦應下載 Release 中的 win-x64 版本(lip-<版本>-win-x64.zip 或 lip-<版本>-win-x64.msi),而不是 win-arm64 版本。舊版 lip 的文件名用 amd64/arm64,現在改為 win-x64/win-arm64。若架構正確仍無法啟動,且使用的是精簡/魔改版 Windows 10,可能與 .NET 9 起默認啟用的 CET(控制流強制技術)兼容性有關(參考 https://learn.microsoft.com/zh-cn/dotnet/core/compatibility/interop/9.0/cet-support),建議換用正常的官方系統鏡像。

適用版本:lip 當前版本(v0.41.x;win-x64/win-arm64 命名自 C# 版 v0.33 起即已使用)

在 Windows Server(如 2022 數據中心版)上 lip 安裝器報錯 lip Setup Wizard ended prematurely because of an error 或 lip 無法使用,怎麼辦?

Windows Server 本身是支持的。先確認下載的是 win-x64 版本(服務器不是 ARM 架構時不要下 win-arm64)。如果 msi 安裝器出錯,可以不用安裝器:下載 lip-<版本>-win-x64.zip,解壓出 lip.exe,並把其所在目錄加入 PATH 環境變量即可(msi 安裝器主要也是把 lip 放到 Program Files\lip 並把該目錄寫入 PATH)。當前 lip 是自包含發佈,不需要另外安裝 .NET 運行時;便攜版之後也可用 lip self-update 升級。

適用版本:lip 當前版本(v0.41.x,自包含發佈,無需 .NET)

用 lip 安裝某個包失敗(換版本號也不行、像是包沒上傳完,或依賴無法滿足),是什麼原因?

常見原因是本地 lip 版本太舊,讀不了新格式的包(新包使用 lip.toml,舊版 lip 只認 tooth.json)。先執行 lip self-update 把 lip 更新到最新版再安裝。如果是依賴確實無法滿足(作者未發佈滿足要求的依賴版本或寫錯版本號),當前 lip 沒有跳過依賴檢查的選項,只能安裝其他版本的包、用 lip setup 換匹配的遊戲/LeviLamina 版本,或等作者修正。

適用版本:lip 當前版本(v0.41.x;lip self-update 可用)

LeviLamina/BDS 是手動安裝(或 exe 安裝)的,之後用 lip 安裝 LegacyScriptEngine、LeviAntiCheat 等依賴 LeviLamina 的模組時提示缺少依賴、識別不到 LeviLamina,怎麼辦?lip 命令應該在哪裡執行?

lip 只認識它自己安裝並記錄在服務器文件夾 .lip/(狀態文件)裡的包,手動解壓的 BDS/LeviLamina 在 lip 看來不存在,所以要麼全部用 lip,要麼全部手動,不要混用。在沒有遊戲記錄的文件夾裡安裝模組,lip 會失敗並提示先用 lip setup。推薦做法:新建一個空文件夾,在該文件夾裡執行 lip install LeviLamina(或連同模組一起:lip install LeviLamina LegacyScriptEngine),裝好後再用 lip install <模组> 安裝其他模組,最後把舊服務器的 worlds/、server.properties、allowlist.json、permissions.json 和模組配置複製過去。lip 命令必須在服務器根目錄(工作區)裡執行,lip 用 MSI 安裝後已在 PATH 中,cd 到服務器目錄直接運行即可。若堅持全手動安裝,可參考各包倉庫裡的 lip.toml(舊包為 tooth.json),裡面寫明瞭依賴、下載地址和文件放置位置。

適用版本:lip v0.40+(當前 v0.41.1),LeviLamina 當前版本

在 BDS 控制台裡輸入 lip install ...(如更新 LeviLamina)提示 Unknown command / 無效,lip 命令應該在哪裡執行?LeviLamina 會自動更新嗎?

lip 是獨立的命令行程序,不是 BDS 控制台命令。要在系統終端(cmd/PowerShell)裡執行,並先切換到服務器根目錄(盘符: 然後 cd 路径;也可以在資源管理器打開服務器目錄,在地址欄輸入 cmd 回車)。只輸入 lip 不帶參數會打開 lip 的終端界面,可在裡面創建服務器、安裝模組、啟動服務器。LeviLamina 不會自動更新:更換 LeviLamina/遊戲版本用 lip setup --game <游戏版本> --loader levilamina@<版本>(或在界面的工作區頁面操作),更新其他模組用 lip update。面板服無法使用終端時只能手動替換文件或聯繫服務商。

適用版本:lip v0.40+(當前 v0.41.1)

用 lip install 升級 LeviLamina 或已裝的包時提示“已經安裝”或版本沒變,應該怎麼正確升級/安裝指定版本?

  1. lip install 只用於安裝尚未安裝的包;對已經安裝的包再 install 會被拒絕,並提示改用 lip update。
  2. 普通模組:lip update 更新全部,lip update <包> 更新指定包,lip update <包>@<版本> 換到指定版本(升降級都行)。
  3. LeviLamina 和 BDS 不能用 install/update 更換,要用 lip setup --game <游戏版本> --loader levilamina@<版本>,會保留世界和配置並把模組換成兼容版本;在全新文件夾安裝指定版本可用 lip install LeviLamina@<版本>。
  4. 所有 lip 命令都必須在服務器根目錄執行,不要在 Win+R 打開的默認目錄(如 C:\Windows\System32)裡運行。
  5. 如果 lip -v 顯示的版本很老,請到 https://github.com/LiteLDev/lip/releases 安裝最新版,之後可用 lip self-update 更新 lip 本身。

適用版本:lip 0.40 及以上

用 lip 安裝 LeviLamina/服務器時文件裝到了別的地方(如用戶目錄)或和其他文件混在一起,lip 把服務器裝在哪裡?怎麼指定安裝位置?

lip 把服務器和包安裝到執行命令時的當前工作目錄(這個目錄就是 lip 的“工作區”)。先新建一個空文件夾,用 cd <该文件夹路径> 進入(或在資源管理器地址欄輸入 cmd 打開命令行),再執行 lip install LeviLamina、lip setup ...、lip install <包> 等命令。之後對這個服務器的所有 lip 操作也都要在該文件夾裡執行。

面板服/雲服務器上沒有 lip、無法運行 lip,或聯網安裝失敗,怎麼安裝 LeviLamina 及其模組?

lip 是單個可執行文件,不需要安裝其他運行環境,可以直接把 lip 放到服務器上(任意目錄或 PATH 中)使用;Linux 版只有 x64,需要 glibc 2.27 以上(不支持 Alpine);Linux/macOS 上 lip 通過自動下載配置的 Wine 運行 Windows 版服務端,Wine 還需要系統有 GnuTLS(裝了 FreeType 時還需 Fontconfig),缺少時 lip 會給出名稱和安裝命令。

如果面板服完全不能運行 lip:在本地電腦上用 lip 裝好整個服務器(或某個模組),再把文件上傳到面板服;搬整個服務器時連同 .lip 文件夾一起上傳。也可以查看對應包的清單文件(新包為倉庫根目錄的 lip.toml,舊包為 tooth.json),裡面寫有各資源的下載鏈接(assets 的 urls)和放置路徑(place / placements),手動下載後按其中的路徑放置。

若只是 GitHub 連不上,可用 lip config set github_proxy <代理地址> 設置 GitHub 代理。

適用版本:lip 0.40 及以上

用 lip 安裝 GMLIB 報 404 / 下載不了,怎麼辦?

GMLIB 已更換倉庫,舊地址 github.com/GroupMountain/GMLIB 已不存在,應改用新倉庫:lip install github.com/GroupMountain/GMLIB-Release。GMLIB 的包聲明瞭對 LeviLamina 的依賴,lip 會選擇與當前已安裝 LeviLamina 兼容的版本;需要指定舊版本時可用 lip install github.com/GroupMountain/GMLIB-Release@<版本>。

lip 的 msi 安裝包和直接下載 lip 可執行文件(zip)有什麼區別?安裝後怎麼用?

功能上沒區別。msi 是規範安裝:會自動把 lip 加入 PATH 環境變量,安裝後可直接在命令行使用 lip,並可在“程序和功能”中卸載,適合不會改環境變量的用戶;zip 為便攜版,需自行解壓並放到 PATH 中的目錄。兩者都可以用 lip self-update 更新(msi 安裝的會通過 msiexec 靜默更新)。安裝後在服務器文件夾中輸入 lip 即可打開界面。

適用版本:lip 0.41.x(Windows)

GitHub 訪問不了,如何下載安裝 lip?

lip 的安裝包在 GitHub Releases:https://github.com/LiteLDev/lip/releases/latest(舊地址 futrime/lip 會自動跳轉)。Windows 下載 lip-<版本>-win-x64.msi(或 -win-arm64.msi,也有 .zip 便攜版),例如 https://github.com/LiteLDev/lip/releases/download/v0.41.1/lip-0.41.1-win-x64.msi;Linux/macOS 下載對應的 .tar.xz/.zip。

如果無法訪問 GitHub,可以通過第三方 GitHub 加速鏡像下載(在鏈接前加鏡像前綴,或把 github.com 換成鏡像域名)。安裝後可以執行 lip config set github_proxy <代理URI>,讓 lip 之後對 GitHub 的下載都走代理。

LeviLamina 更新支持新版遊戲後,用 lip 安裝 LL 本體和 BDS 正常,但安裝 LegacyScriptEngine 的 quickjs/nodejs/lua 等版本一再失敗,怎麼辦?

先執行 lip cache clean 清理 lip 緩存,再重新安裝,例如 lip install LegacyScriptEngine#lua。清理緩存不會丟失任何東西,lip 會重新下載需要的文件;清理時不要同時運行其他 lip 命令。如果仍然失敗,查看 .lip/logs/ 裡的失敗報告;提示遊戲或加載器版本不兼容時,說明該 LSE 版本還不支持當前 LeviLamina,需等 LSE 更新或用 lip setup 換到它支持的版本。

適用版本:lip 0.41.x

lip 的官方地址是什麼?github.com/lippkg/lip 還能用嗎?

lip 的倉庫現在是 https://github.com/LiteLDev/lip,文檔在 https://levimc.org/zh-Hant/lip/(英文 https://levimc.org/lip/)。舊的 github.com/lippkg/lip、github.com/futrime/lip 目前會被 GitHub 重定向到 LiteLDev/lip,舊文檔域名 lip.levimc.org 等也只是指向新文檔,請直接使用新地址。插件建議通過 lip 自行安裝。

winget 倉庫裡的 lipd 版本一直停在舊版本(如 0.33.1)沒有更新,是怎麼回事?

lipd 已經廢棄,不再單獨發佈,它的功能(後臺守護進程)已經內置在 lip 中,只需安裝/更新 lip 即可(守護進程由第一條 lip 命令自動啟動,可用 lip daemon status / lip daemon stop 查看和停止)。另外 winget 鏡像源只鏡像包清單信息,實際安裝包仍從 GitHub Release 下載。

適用版本:lip 0.34 及以後

不小心在 plugins(或 mods)目錄裡執行了 lip 安裝,結果下載了一大堆東西(甚至又下了一個服務端),該怎麼辦?

lip 把當前工作目錄當作工作區(服務器文件夾),所有 lip 命令都應在服務器根目錄執行,不要在 mods/plugins 等子目錄裡運行。在子目錄裡執行 lip install LeviLamina 之類的命令會在那裡另建一個服務器。處理方法:把在子目錄裡誤裝的內容(包括其中的 .lip 文件夾)刪除,或在該子目錄裡用 lip uninstall 卸載,然後回到服務器根目錄重新執行。

去哪裡下載舊版本的官方 BDS 服務端?官網只有最新版。

可以用 lip:在一個空文件夾裡運行 lip setup --game <版本> --no-loader(例如 --game 1.21.80,需要特定構建寫 1.21.80-patch.3)即可得到該版本的原版服務端;不加 --no-loader 則會同時裝上適配的 LeviLamina。lip 根據 https://levimc.org/api/v4/mc/versions/ 的構建列表從 minecraft.net 官方地址下載。也可以在 Minecraft Wiki 上搜索對應版本號找到官方直鏈。

在新建空目錄中用 lip 安裝 LeviLamina 26.60.x 和 LSE 0.23.x 後,啟動時提示資源包版本不兼容(BDS 版本與 LeviLamina 要求的 1.26.60 不一致),原因是什麼?該按什麼順序安裝?

原因是先安裝了 LSE,舊版 lip 的依賴解析只拉到了 BDS 組件並下載成了最新版 BDS,而不是 LeviLamina 要求的 1.26.60。正確做法是先搭好遊戲和加載器,再裝插件:

shell
lip install LeviLamina          # 安装最新 LeviLamina 及其支持的最新 BDS(等同一次 lip setup)
lip install LegacyScriptEngine  # 再安装 LSE(默认同时装 QuickJS 和 Lua 引擎)

或者顯式指定:lip setup --game 1.26.60 --loader levilamina 後再 lip install LegacyScriptEngine#lua 等。請先用 lip self-update 更新到最新 lip:新版 lip 在沒有遊戲的空工作區裡直接安裝 mod 會報錯並提示先執行 lip setup,不會再裝出錯誤版本的 BDS。LeviLamina 要求的 BDS 版本寫在其 lip.toml 的依賴 github.com/LiteLDev/bds 中(舊包為 tooth.json)。

適用版本:lip 0.41.x;LeviLamina 26.60.x;LegacyScriptEngine 0.23.x

如何用 lip 安裝 LSE 的 Lua / QuickJS 等引擎?執行安裝報錯怎麼辦?

現在各語言引擎是 LegacyScriptEngine 包的變體(variant),用 # 指定:

shell
lip install LegacyScriptEngine#lua
lip install LegacyScriptEngine#quickjs
# 另有 #nodejs、#python

不帶變體(lip install LegacyScriptEngine)會同時安裝 QuickJS 和 Lua 引擎。LegacyScriptEngine 是 github.com/LiteLDev/LegacyScriptEngine 的簡寫。安裝前工作區需要已有服務器和 LeviLamina(lip install LeviLamina 或 lip setup --game <版本>)。若報錯:先 lip self-update 更新到最新 lip,再執行 lip cache clean 清理緩存後重試,並閱讀 lip 輸出的 error/hint 及 .lip/logs/ 下的失敗報告。

適用版本:lip 0.41.x;LegacyScriptEngine 0.23.x

手動下載的 LeviLamina mod 啟動時報缺少依賴/加載失敗,以及在 BDS 1.21.70 等舊版本上如何安裝對應版本的 mod?

手動下載的文件可能不完整或缺依賴,建議使用 lip 安裝(會自動處理依賴)。要用舊版 BDS:在服務器文件夾裡先用 lip setup --game 1.21.70(會配上適配該版本的最新 LeviLamina)搭好遊戲與加載器,然後 lip install <包>,lip 會自動選擇能在當前工作區工作的最新版本。也可以到該 mod 的 GitHub Releases 查到適配該 BDS 版本的版本號,用 lip install <包地址>@<版本号> 精確指定(例如 lip install github.com/user/repo@1.2.0),可先加 --dry-run 查看會安裝什麼。該 mod 需有適配目標 BDS 版本的發佈。

適用版本:lip 0.41.x

按 LeviLamina/LSE 安裝文檔執行 lip install 命令時,帶 @version 的命令報錯,該怎麼寫?

文檔裡 <repo>@<version> 中的 version 只是佔位符,不能照抄。想裝最新版就把 @version 整個去掉,例如 lip install github.com/LiteLDev/LegacyScriptEngine(LiteLDev 的倉庫也可簡寫為 lip install LegacyScriptEngine);需要特定版本時寫具體版本號,例如 lip install github.com/LiteLDev/LegacyScriptEngine@0.23.1(對應倉庫的 v0.23.1 標籤)。有變體時 #变体 寫在 @ 之前,如 LegacyScriptEngine#lua@0.23.1。

注意:在當前 lip 中 lip install LeviLamina / lip install LeviLamina@<版本> 會按 lip setup 的方式一併裝好匹配的 BDS(需同意 EULA),已安裝的 LeviLamina 要換版本請用 lip setup。

用 lip install github.com/LiteLDev/LegacyScriptEngine@版本号 安裝時,會不會把 LSE 的四個語言引擎都裝上?版本號後需要帶 # 嗎?

不需要帶 #。直接 lip install github.com/LiteLDev/LegacyScriptEngine@版本号(不帶變體)只會安裝 QuickJS 和 Lua 兩個引擎。Node.js、Python 引擎需單獨安裝對應變體,變體寫在 @ 之前:lip install github.com/LiteLDev/LegacyScriptEngine#nodejs@版本号、lip install github.com/LiteLDev/LegacyScriptEngine#python@版本号(不寫 @版本号 則裝最新版)。

適用版本:LegacyScriptEngine 0.17.x 及以後

用 lip 安裝 LeviLamina 後沒有 LegacyScriptEngine,舊 JS/Lua 插件不能用,怎麼回事?

LeviLamina 是模塊化的,LSE 不隨 LL 自動安裝,需要單獨安裝:在服務端根目錄執行 lip install github.com/LiteLDev/LegacyScriptEngine(簡寫 lip install LegacyScriptEngine,不帶變體會裝 QuickJS 和 Lua 引擎;只要某一種可寫 #quickjs、#lua,Node.js/Python 用 #nodejs、#python)。

也可以從 https://github.com/LiteLDev/LegacyScriptEngine/releases 下載對應的 LegacyScriptEngine-server-<引擎>-windows-x64.zip 手動解壓到服務端(引擎位於 mods/legacy-script-engine-<引擎>/),但需自行處理 LegacyRemoteCall、LegacyMoney、iListenAttentively 等依賴(Node.js 引擎還需另裝 node 運行時 node-prebuilt.zip 與 7-zip-tooth),推薦用 lip。安裝後把腳本插件放進 plugins/ 並重啟服務器。

適用版本:LeviLamina 0.10 及以上

用 lip 下載/安裝 LSE 的 NodeJS 引擎失敗怎麼辦?

  1. 先把 lip 更新到最新:lip self-update。
  2. 清理緩存後重試:lip cache clean。
  3. GitHub 訪問慢或被牆時,設置 GitHub 代理:lip config set github_proxy <代理地址>;或在終端設置系統 HTTP 代理環境變量(如 PowerShell 中 $env:HTTPS_PROXY = "http://127.0.0.1:端口"),lip 會自動使用。
  4. 用當前包名重新安裝:lip install github.com/LiteLDev/LegacyScriptEngine#nodejs(可簡寫為 lip install LegacyScriptEngine#nodejs)。注意需先用 lip setup --game <版本> 裝好遊戲與 LeviLamina;若該包已被顯式安裝,lip install 會拒絕,應改用 lip update,或先 lip uninstall 再安裝。

失敗時可查看終端裡的 hint 以及 .lip/logs/ 下的失敗報告定位原因。

適用版本:lip 0.41.x 及以上

用 lip 安裝 BDS/LeviLamina 時會卡在需要同意 Minecraft 用戶協議(EULA)的步驟嗎?寫一鍵安裝腳本時有沒有跳過同意的參數?

會詢問。當前 lip 在安裝遊戲(BDS)時會列出 Minecraft EULA 和 Microsoft 隱私政策鏈接並要求輸入 yes 才繼續;在腳本等非交互終端中不加參數會直接失敗。寫腳本時加 --accept-eula 即可跳過詢問,例如:

shell
lip setup --game 1.21.0 --loader levilamina@1.0.0 --accept-eula

或 lip install LeviLamina github.com/user/repo --accept-eula(當 install 以 setup 方式執行時生效)。每次安裝遊戲都會重新詢問,同意結果不會被記錄。

適用版本:lip 0.41.x 及以上

用 lip 安裝 LeviLamina 後啟動 BDS 彈出缺少運行庫類錯誤(看起來像要裝 vcredist),但已經裝了 vcredist 仍然不行,怎麼辦?

這通常是 BDS 本體沒下載完整導致的。BDS 由 lip 包 github.com/LiteLDev/bds 的安裝鉤子調用 bdsdown 從官網下載,可以通過環境變量 BDSDOWN_MIRROR_URL 指定下載鏡像。在 PowerShell 中先設置鏡像再在空文件夾中重新安裝:

powershell
$env:BDSDOWN_MIRROR_URL="<镜像地址>"
lip setup --game <版本>

(或 lip install LeviLamina)。lip 會把當前終端的環境變量傳給安裝過程。有用戶用 https://mcdl.bibk.top 作為鏡像並下載成功。

用 lip 安裝 LeviLamina 或插件失敗,lip 應該在哪個目錄運行?安裝 LSE 需要逐個裝依賴嗎?

lip 以當前工作目錄作為工作區,必須在服務端根目錄(bedrock_server.exe 所在目錄)下運行,沒有指定其他目錄的選項;lip 本身可以放進 PATH。新建服務端時在空文件夾中執行 lip setup --game <版本>(或 lip install LeviLamina)。

安裝 LegacyScriptEngine 只需安裝本體(如 lip install LegacyScriptEngine#lua),其他依賴(如 LegacyRemoteCall)會自動解析安裝;但 lip install 不會安裝或更換遊戲與 LeviLamina,需先用 lip setup 裝好與 LSE 版本約束相符的 LeviLamina,否則命令會失敗並提示 lip setup。安裝 LeviLamina 時會自動運行 PeEditor 生成 bedrock_server_mod.exe。腳本中需要免交互時使用 --accept-eula(新版 lip 已無 -y 參數)。

適用版本:lip 0.41.x 及以上

用 lip 安裝 LeviLamina 時包名是什麼?去哪裡查 lip 包?

LeviLamina 的包名是 github.com/LiteLDev/LeviLamina,LiteLDev 組織下的倉庫可簡寫,如 lip install LeviLamina(等同完整寫法;新建服務端更推薦 lip setup --game <版本>,會自動選配合適的 LeviLamina)。lip 沒有中心化倉庫,包就是公開 git 倉庫的地址;想找 mod 可以運行 lip 打開交互界面的 Get mods 頁面,或在 levimc.org 上瀏覽。

適用版本:lip 0.41.x 及以上

用 lip 安裝/升級 LeviLamina 時中途中斷(目錄裡殘留 bdsdown.exe 等),或在已有舊服務端文件的目錄安裝後無法開服,應該怎麼正確安裝和升級?

新建服務端:在空文件夾中執行 lip setup --game <版本>(或 lip install LeviLamina),再用 lip install 裝需要的 mod,然後把舊服的 worlds/、server.properties、allowlist.json、permissions.json 以及各 mod 的配置複製過來。舊的 bedrock_server_mod.exe 無需保留,安裝 LeviLamina 時會重新生成。

升級:對已由 lip 管理的服務端,直接在該目錄執行 lip setup --game <新版本>,世界與上述配置文件會保留;與新版本不兼容的 mod 會被列為 left-out 並詢問是否卸載。

中斷:當前 lip 的安裝是原子操作,中途中斷後下一次 lip setup/install/update/uninstall/run 會自動撤銷或完成上次操作,無需手動刪除殘留文件(不要刪除 .lip/journal 和 .*.bak)。

開不了服時先看服務端輸出和 logs\latest.log(常見如端口被佔用、mod 加載失敗)。

適用版本:lip 0.41.x;LeviLamina 26.x

用 lip 安裝完 LeviLamina 後,用哪個文件啟動服務器?

帶 LeviLamina 的服務器要運行 bedrock_server_mod.exe(安裝時由 PeEditor 從 bedrock_server.exe 生成),不要運行原版 bedrock_server.exe。新版 lip 也可以直接在服務器目錄執行 lip run(或在 lip 界面的服務器頁面點擊啟動),有加載器時它運行的就是 bedrock_server_mod.exe。

用 lip 安裝插件時沒有下載過程直接顯示完成,但 mods(舊版為 plugins)目錄裡卻沒有對應插件(例如 GMLIB),並提示缺少依賴,怎麼辦?

lip 有下載緩存,所以可能不下載直接完成;並且 lip 在工作區的 .lip/state.json 裡記錄已安裝的包,若之前手動刪除過已安裝包的文件,lip 仍認為它已安裝,不會對同一版本重新安裝,就會出現文件缺失。解決:先 lip uninstall <你显式安装的包> 再 lip install <该包> 重新安裝(依賴會自動一併卸載/安裝)。注意 lip uninstall 只接受顯式安裝的包,像 GMLIB 這類作為依賴被裝上的包不能直接卸載,要卸載依賴它的那個模組。如懷疑緩存損壞可執行 lip cache clean 清空緩存(Windows 下緩存位於 %LOCALAPPDATA%\lip\Cache)。不要手動刪除 lip 安裝的文件,卸載請用 lip uninstall。

適用版本:lip 0.41.x

能否用 lip 單獨更新 BDS 本體?

可以。BDS 在 lip 中是包 github.com/LiteLDev/bds(即工作區的“遊戲”)。在服務器目錄執行 lip setup --game <版本>(例如 lip setup --game 1.26.60)即可換到指定 BDS 版本,lip 會同時選擇適配該版本的最新 LeviLamina(也可用 --loader levilamina@<版本> 指定,或 --no-loader 只裝原版),並把其他模組換成能配合的版本;世界、server.properties、allowlist.json、permissions.json 會保留。可加 -n(--dry-run)先預覽會發生的變化。注意 lip install/lip update 不能直接更新 BDS,會提示改用 lip setup。

適用版本:lip 0.41.x

能用 lip 把 LeviLamina 更新到開發分支的最新 commit 嗎?

不能得到未發佈的開發構建。lip 安裝/切換 LeviLamina(加載器)通過 lip setup --loader levilamina@<已发布版本>(或 lip install 不帶 ref/帶版本號時作為加載器安裝);雖然 lip install 支持 @branch:<名>/@rev:<commit> 引用,但 LeviLamina 的 lip.toml 資源地址指向 GitHub Release 的發佈包,分支上取到的仍是已發佈版本的構建。想用最新提交的構建,只能從 LeviLamina 倉庫的 GitHub Actions(build 工作流)下載產物手動替換。注意 LeviLamina 默認分支現為 main(已無 develop 分支)。

適用版本:LeviLamina 26.x;lip 0.41.x

運行 lip 提示版本太老(顯示 0.31 之類),但明明已經裝了新版,怎麼回事?

新舊兩個 lip 同時存在,PATH 環境變量仍先指向舊 lip 的目錄。用 lip --version(或 lip -v)確認當前實際運行的版本,在 PowerShell 中可用 Get-Command lip、cmd 中可用 where lip 查看實際路徑;刪除舊版或把 PATH 改為新 lip 的安裝路徑(修改後需重新打開終端)。之後可用 lip self-update 更新 lip 本身。

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

把服務端直接裝在磁盤根目錄(如 F:\)時 lip 安裝出錯,怎麼辦?

不要把盤符根目錄直接作為服務端目錄(工作區)。請新建一個子文件夾(如 F:\server)作為工作區,再在其中用 lip setup / lip install 安裝。

適用版本:舊版 lip(當前版本未確認)。未能從源碼或文檔中直接證實,僅供參考。

用 lip 下載/安裝包時下載被中斷,提示被 360 安全衛士攔截,怎麼辦?

這是殺毒軟件(360)攔截了 lip 的下載或文件寫入。右鍵托盤中的 360 圖標退出,或將 lip / 服務端目錄加入信任白名單後,重新執行一遍安裝命令即可。

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