跳到正文
本頁目錄

lip 的使用與配置

配置

模組已被目錄收錄,之後修改了倉庫裡的包描述文件(tooth.json / lip.toml),為什麼目錄上的信息一直不更新?

目錄讀取的是每個版本標籤(v<版本>)處的包文件(lip.toml,沒有時才讀 tooth.json),列表中的名字、描述、標籤等取自最新版本的包文件,而不是默認分支上的最新文件。只改倉庫內容不發新標籤,目錄不會變。

正確做法:先改好 lip.toml(把 version 改高),再用新標籤(如 v0.2.0)發佈新版本;目錄每小時構建一次,新標籤會在下一次構建中出現。

詳情頁的 README 同樣取自該版本標籤處的倉庫文件(raw.githubusercontent.com/<作者>/<仓库>/v<版本>/README.md),只改默認分支上的 README 也不會更新;只有 Gallery(默認分支上的 docs/showcase/showcase.json)在下一次構建中直接生效。

適用版本:當前 LeviMC 模組目錄(levimc.org/mods)

發佈給 lip 的插件需要把編譯好的二進制提交到源碼倉庫或單獨開倉庫存放嗎?

不需要。在 lip.toml 中給變體條目加一個 type = "mcmod"(LeviLamina 模組 ZIP)或 type = "zip" 的資源,urls 指向 GitHub Release 的附件即可,例如 https://github.com/<you>/my-mod/releases/download/v{{version}}/my-mod-server-windows-x64.zip。

  • zip 資源需再用 place 指定把 ZIP 中哪些文件放到哪裡,例如 place = [{ src = "my-mod/", dest = "mods/my-mod/" }]。
  • mcmod 則要求 ZIP 根部有 manifest.json,整體放入 mods/<模组名>/。
  • LeviLamina、LSE 及 levilamina-mod-template 都用 zip + Release 附件的方式,模板的發佈工作流會自動構建並上傳 <仓库名>-server-windows-x64.zip 等 ZIP。

國內用戶訪問 GitHub 慢時,可用 lip config set github_proxy <URL> 設置 GitHub 代理,或使用 HTTPS_PROXY 等系統代理環境變量。

適用版本:lip 0.40 及以上(lip.toml)

新版 lip 的配置文件和緩存存放在哪裡?能放到當前目錄嗎?

lip 的用戶級配置和緩存放在各平臺的標準用戶目錄,不放在當前目錄:

  • 配置(config.toml):Windows %APPDATA%\lip,Linux/macOS $XDG_CONFIG_HOME/lip(默認 ~/.config/lip)
  • 緩存:Windows %LOCALAPPDATA%\lip\Cache,Linux/macOS $XDG_CACHE_HOME/lip(默認 ~/.cache/lip)
  • 數據(如 Wine):Windows %LOCALAPPDATA%\lip\Data,Linux/macOS 默認 ~/.local/share/lip
  • 狀態(界面的工作區列表):Windows %LOCALAPPDATA%\lip\State,Linux/macOS 默認 ~/.local/state/lip

每個服務器目錄(工作區)裡另有 .lip/ 目錄,存放 state.json、工作區配置 .lip/config.toml、日誌等。舊版的 liprc.json 會被自動轉換為 config.toml,tooth_lock.json 會被轉換為 .lip/state.json。如果下載的文件似乎損壞、同一個安裝一再失敗,可以執行 lip cache clean 清理緩存後重試,這不會丟失任何東西。

適用版本:lip 0.40 及以上(當前 0.41.1)

用 lip 安裝新的服務端(BDS)時無論輸入什麼版本號都報錯,怎麼解決?

多半是網絡/代理配置問題。用 lip config list 檢查 lip 的 GitHub 代理設置 github_proxy:代理不可用或不支持 git 倉庫時,用 lip config delete github_proxy 刪除(或 lip config set github_proxy "" 直連),或換一個可用的代理 lip config set github_proxy https://代理地址/。

lip 的版本列表來自 https://levimc.org/api/v4/mc/versions/,服務端本體從 www.minecraft.net 下載,這兩處也需能訪問。建服命令為 lip setup --game <版本>(如 1.26.60)。失敗時可查看 .lip/logs/ 下的失敗報告定位原因。

適用版本:lip 0.38+(C# 重寫後,配置鍵為 github_proxy;已在 0.41.1 核對)

給 lip 配置了 GitHub 鏡像/代理後報錯,地址寫成了 https:/xxx,問題在哪?

URL 協議頭寫錯了,少了一個斜槓,應為 https://xxx/ 這種完整的 URL 前綴。當前版本的 lip 用 github_proxy 配置項設置 GitHub 代理,改正方法:

shell
lip config set github_proxy https://xxx/

也可以直接編輯 %APPDATA%\lip\config.toml 中的 github_proxy,或在 lip 界面的「設置」頁面填寫 GitHub 代理。設為空字符串(lip config set github_proxy "")表示直連 GitHub,lip config delete github_proxy 恢復為未配置。

適用版本:lip 0.40 及以上(config.toml / github_proxy);舊版 lip 對應 liprc.json 中的鏡像配置

lip 安裝包時下載超時(多次重試、換電腦都不行),怎麼辦?lip 如何指定安裝到哪個文件夾?

GitHub 慢或被屏蔽時,設置 GitHub 代理:lip config set github_proxy <代理地址>(0.41.1 之後的 lip 會把請求發往“該地址 + / + 完整的 GitHub 地址”,所以填服務本身的地址即可;0.41.1 及更早的 lip 只在地址後接 <所有者>/<仓库>/…,對 gh-proxy 這類服務,地址必須已經以 https://github.com/ 結尾),或在終端設置 HTTPS_PROXY 等環境變量使用普通網絡代理,然後重試。可用 curl "<代理地址>/https://github.com/LiteLDev/lip.git/info/refs?service=git-upload-pack" 測試代理是否返回 200。

lip 的工作區就是當前工作目錄,沒有指定其他目錄的選項:要裝到哪個文件夾,就先 cd 到那個目錄再執行 lip 命令。

適用版本:lip 0.40 及以上

lip 設置過 GitHub 代理等配置後,怎麼刪除(remove)該配置?

用 lip config delete <KEY> 刪除,使其回到默認值,例如 lip config delete github_proxy(不走代理,界面連不上 GitHub 時會重新詢問)。如果想明確“直接連接、不再詢問”,則設為空值:lip config set github_proxy ""(PowerShell 中寫 lip config set github_proxy --% "")。

適用版本:lip 0.40 及以上(“界面重新詢問”的區別自 0.41.0 界面起才有意義)

lip/啟動器通過 GitHub 鏡像克隆 LeviLamina 時失敗(如 fatal: unable to access 'https://github.bibk.top/LiteLDev/LeviLamina.git/': Recv failure: Connection was reset),如何更換 GitHub 鏡像(代理)?

舊的默認自建鏡像 github.bibk.top 受網絡干擾嚴重,可換用其他 GitHub 代理:

  1. 獨立版 lip:執行 lip config set github_proxy https://v4.gh-proxy.org/https://github.com/(gh-proxy 這類服務需要在地址後帶完整的 https://github.com/ 前綴)。可用 curl.exe -s -o NUL -w "%{http_code}" "<代理>/LiteLDev/LeviLamina.git/info/refs?service=git-upload-pack" 測試代理,返回 200 即可用;不想用代理時 lip config delete github_proxy。lip 的終端界面設置頁也可以設置並會先測試。
  2. LeviLauncher:在設置的「Package Management(包管理)」頁的 GitHub 代理一欄選擇預設或手動填寫(1.1.0 起默認已改為 https://gh-proxy.org/https://github.com,預設中還有 v4.gh-proxy.org、gh.bibk.top 等),改完不需要重裝啟動器。
  3. 也可以直接用普通代理:lip 會讀取 HTTPS_PROXY/HTTP_PROXY/ALL_PROXY 環境變量,沒有時使用系統代理。

另外 lip 通過 github_proxy 請求失敗時會回退為直連 GitHub。

適用版本:lip 0.40+(獨立版);LeviLauncher 1.1.0 及以上(內置包管理器)

lip 配置 GitHub 代理後下載 bedrock-runtime-data 報 HTTP 404(Failed to download from https://gh-proxy.com/LiteLDev/bedrock-runtime-data/releases/download/...),如何正確設置代理?

對你的 lip 來說代理地址寫錯了:gh-proxy 這類代理要求在其地址後接完整的 GitHub 地址(只寫 https://gh-proxy.com/ 或 https://gh-proxy.org/ 會得到 404)。0.41.1 及更早的 lip 會把 <所有者>/<仓库>/... 直接拼在 github_proxy 後面,所以應設置為(0.41.1 之後的 lip 會自己接上完整的 GitHub 地址,只填服務本身的地址即可,下面這種寫法也仍然可用):

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

設置前可用下面的命令測試,返回 200 說明可用:

shell
curl.exe -s -o NUL -w "%{http_code}" "https://v4.gh-proxy.org/https://github.com/LiteLDev/LeviLamina.git/info/refs?service=git-upload-pack"

適用版本:lip 0.40 及以上

mod 遷移到新的 GitHub 倉庫後,要被 lip/模組列表收錄需要改什麼?

包 ID 必須與倉庫路徑一致。現在的包使用 lip.toml,要把其中的 id 改為新倉庫路徑,例如倉庫為 https://github.com/user/repo 時寫 id = "github.com/user/repo";否則該提交不被視為包,lip 不會安裝(模組列表自然也無法正常安裝它;收錄方式見 levimc.org 的「用 lip 發佈你的模組」教程)。

舊格式 tooth.json 中對應的是 tooth 字段(可用 lip pkg migrate 遷移到 lip.toml,tooth 會變為 id)。改完後打新的版本標籤 v<版本> 發佈,且 version 要等於標籤版本。

適用版本:lip.toml 格式 4(當前);舊 tooth.json 包同理改 tooth 字段

發佈 LeviLamina mod 時,包文件中對 LeviLamina 的依賴版本能否鎖定為一個具體版本?模組圖標應寫在哪裡?

不建議鎖死單一版本:不帶運算符的完整版本(如 "26.60.8")只匹配該版本,LeviLamina 一發新版本你的 mod 就無法通過 lip/啟動器安裝到新版本上,只能手動放入。建議寫範圍,例如:

toml
[variants."".deps]
"github.com/LiteLDev/LeviLamina" = "26.60.*"

或 ">=26.60.0 <26.70.0" 之類(語法同 Semver for .NET 的 SemVersionRange,支持 ^、~、*、>=…<…、||)。

另外 id 要與實際倉庫地址一致;模組圖標寫在 [info] 下的 logo(必須以 https:// 開頭),例如 logo = "https://raw.githubusercontent.com/<owner>/<repo>/refs/heads/main/.../pack_icon.png"。舊 tooth.json 中對應的是 dependencies 和 info.avatar_url,遷移時 avatar_url 會變為 info.logo。

補充:客戶端條目(side = "client")依賴的也是不帶 #client 的 LeviLamina,官方模板寫作 ">26.60.6 <26.61.0"(因為 26.60.6 及以前的 tooth.json 版本默認變體是服務端構建)。

適用版本:lip.toml 格式 4(當前);LeviLauncher 1.1.0+ 內置包管理器;舊 tooth.json 包對應 dependencies/avatar_url

功能與版本

LeviLamina 的插件/模組去哪裡找、去哪裡發佈?(舊論壇、lippkg、bedrinth 都打不開了)

LiteLDev 論壇早已關閉,lippkg.com、bedrinth、pkg.levimc.org 也都已棄用。現在的插件/模組目錄是 LeviMC 模組:https://levimc.org/zh-Hant/mods/,每個模組頁面都給出安裝命令,可以用 lip(lip install github.com/<作者>/<仓库>,或在 lip 界面的「獲取模組」頁)安裝,客戶端模組也可在 LeviLauncher 裡瀏覽安裝。作者發佈模組只需在 GitHub 上用 lip.toml 發版本標籤,目錄會自動或經 PR 收錄;問題反饋請走各項目的 GitHub issue。

適用版本:當前所有版本(lip 0.40 及以上、LeviLauncher)

自己在 GitHub 發佈了 LeviLamina 模組,怎樣才能被 lip 的模組目錄(LeviMC 模組 / LeviLauncher)收錄?為什麼一直搜不到?

現在的目錄是 LeviMC 模組(https://levimc.org/zh-Hant/mods/),lip 的「獲取模組」頁和 LeviLauncher 都讀它,原來的 lipr / bedrinth 已被替代。它由 LiteLDev/liteldev.github.io 倉庫裡的 mods/repos.txt 倉庫列表構建:

  1. 自動發現:每兩小時有機器人用 GitHub 代碼搜索查找根目錄帶 lip.toml(或舊的 tooth.json)、且有 lip 能讀取的版本標籤的倉庫,然後發 PR 把它加入 repos.txt;維護者合併後,在下一次每小時構建中出現。fork 倉庫不會被發現。因為依賴 GitHub 代碼搜索(其配額也常被用盡而跳過某次運行),新倉庫在 GitHub 建好代碼索引之前可能搜不到,這時直接走第 2 步自己發 PR 最快。
  2. 想更快上架:自己發 PR 編輯 mods/repos.txt,加一行 <作者>/<仓库>。
  3. 收錄條件:版本標籤必須是 v 加完整語義化版本(如 v1.0.0,不能是 1.0.0 或 v1.0),且標籤處 lip.toml 的 version 與之一致;最新版本依賴 LeviLamina(直接或間接);把文件放到 mods/(或 plugins/ 等);倉庫不是 GitHub 模板,名字不以 -template、-example、-demo、-sample、-test 結尾。
  4. 自查:lip pkg view github.com/<作者>/<仓库> 應在 versions 中列出你的版本;也可在測試服務器上 lip install(加 --dry-run 可不改文件)。

不想被收錄:關閉機器人發的 PR(關閉後不會再提議)或刪除 repos.txt 中的那一行。另外,lip 本身不依賴目錄,沒被收錄的倉庫也能用 lip install github.com/<作者>/<仓库> 直接安裝。

適用版本:lip 0.40 及以上(發佈 lip.toml 包需 lip 0.41 的 lip pkg 命令);當前 LeviMC 模組目錄

一個倉庫裡放了多個 mod/插件,不想拆成多個倉庫,能發佈到 lip 嗎?發佈 lip 包必須發 GitHub Release 嗎?

lip 的包 ID 就是倉庫路徑(如 github.com/user/repo),一個倉庫對應一個包,但一個包可以有多個變體(variant),用來在同一倉庫裡放多個 mod:在 lip.toml 裡為每個 mod 寫一個 [[variants."<名字>"]] 條目(名字匹配 ^[a-z0-9_]+(/[a-z0-9_]+)?$),用戶用 lip install github.com/user/repo#<名字> 選擇安裝哪個(LSE 的 #lua、#nodejs 等引擎就是這樣做的)。注意同一倉庫的所有變體共用版本標籤。版本就是名為 v<SemVer> 的 git 標籤(如 v1.2.3),且該標籤處 lip.toml 的 version 必須一致;“發佈”本質上是推送這個標籤,GitHub Release 只是用來託管 assets 裡 urls 指向的 ZIP 文件。如果確實想讓各 mod 獨立版本,也可以為每個 mod 建一個只放 lip.toml 的倉庫,讓其 zip/mcmod 資源的 urls 指向大倉庫 Release 裡的文件。

適用版本:lip v0.40 及以上(lip.toml 格式 4);舊版 tooth.json 中以 label 區分變體

lipui(lip 的圖形界面)還能用嗎?不會用命令行有沒有圖形界面?想裝指定版本的 BDS 怎麼辦?

lipui 已歸檔,不再可用。它的功能已併入 lip 本身:在終端裡只輸入 lip(不帶參數)就會打開 lip 的界面,首頁會引導你創建服務器、安裝模組、啟動服務器,無需記命令。安裝指定版本的 BDS:界面中創建服務器時選擇版本,或用命令 lip setup --game <版本>(如 lip setup --game 1.21.0,默認帶適配的最新 LeviLamina,可用 --loader levilamina@<版本> 或 --no-loader 調整),也可以 lip install github.com/LiteLDev/bds@1.21.0 LeviLamina(遊戲 1.21.0 加適配它的最新 LeviLamina)。只需下載服務端文件時也可用 bdsdown(lip install github.com/LiteLDev/bdsdown)。

適用版本:lip v0.40 及以上(內置界面)

用 lip 安裝包必須寫版本號嗎?不寫能自動裝最新版嗎?

不需要寫。lip install github.com/user/repo 會安裝該倉庫最高的版本標籤(v<SemVer>);需要指定版本時寫 github.com/user/repo@1.0.0(對應標籤 v1.0.0),也可用 @branch:<名>、@tag:<名>、@rev:<完整提交>。LiteLDev 的倉庫可省略前綴,如 lip install LeviLamina。安裝不需要 -y 確認參數。用法見 https://levimc.org/zh-Hant/lip/。

適用版本:lip 0.26 之後至今(當前 v0.41.1)

lip 能否像 npm 一樣在當前目錄維護依賴清單,lip install 時自動寫入,從而通過分享清單實現“整合包”?

不能。lip install 只把包安裝進服務器文件夾並記錄在 .lip/state.json 中,從不寫入 lip.toml,lip 也沒有類似 package.json 的工作區清單。想一次安裝一組包(整合包),可以自己做一個包:在其 lip.toml 的 deps 裡寫上需要的所有包(類似 LegacyScriptEngine 默認變體依賴 quickjs 與 lua 兩個引擎變體的做法),發佈後別人 lip install <你的包> 即可一併裝好。發佈教程見 https://levimc.org/tutorials/develop/publish-a-package/。另外,lip 只管理服務端;lip.toml 的條目以 side = "server"/"client" 區分兩端,客戶端模組由 LeviLauncher 等啟動器讀取同樣的包來安裝。

適用版本:當前 lip(lip.toml 時代)

LeviLauncher 的 mod 下載和 lip 是什麼關係?Lamium 等外國作者的 mod 也是走 lip 嗎?

是的。LeviLauncher 內置了 lip 的包管理,下載/安裝/更新 LeviLamina 模組實際就是在用 lip,模組目錄來自 levimc.org 的 lip 模組索引;Lamium(github.com/amatouhake/Lamium)等模組同樣通過 lip 分發,而不是託管在 CurseForge。啟動器模組頁中“包管理模組”是由 lip 管理的模組,“普通模組”是 mods 目錄中不由 lip 管理的模組(如手動導入的)。

適用版本:LeviLauncher v1.1.0(當前版本)

lip 可以用來下載 BDS 嗎?

可以。lip 的遊戲包就是 github.com/LiteLDev/bds:lip install github.com/LiteLDev/bds@<version> 安裝不帶加載器的 Windows 版服務器,加 #linux 為 Linux 版;也可用 lip setup --game <version> --no-loader。若要帶 LeviLamina,直接 lip install LeviLamina 即可自動配好對應 BDS。如果只是需要下載 BDS 文件,也可以使用 bdsdown 工具(lip install github.com/LiteLDev/bdsdown)。

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

lip 安裝軟件包時執行的鉤子命令如果失敗,lip 會怎麼處理?

鉤子命令以非零退出碼退出會使整個操作(安裝/卸載)失敗,lip 會撤銷本次操作的文件改動,但不會撤銷鉤子命令自己做過的事,所以鉤子命令應能安全地重複執行。現在包描述文件為 lip.toml,鉤子寫在條目的 hooks 中(pre_install、post_install、pre_uninstall、post_uninstall)。每個條目只對應一個運行端和平臺,跨平臺時為每個平臺各寫一個條目和各自的命令;Windows 平臺的命令以 cmd /s /c 運行(在 Linux/macOS 上通過 Wine),其他平臺以 sh -c 運行。

適用版本:lip v0.40/v0.41(lip.toml);舊 tooth.json 的 scripts 會被轉換為 hooks

lip 能不能像 pacman 那樣只輸入包名(如 lip -S levilamina)就從模組列表搜索安裝?

命令行不能按包名搜索安裝。lip 包由來源(倉庫地址)唯一標識,如 github.com/LiteLDev/LegacyScriptEngine,沒有中央倉庫,第三方包必須寫完整倉庫路徑。例外:不含 / 的名字視為 github.com/LiteLDev/ 下的倉庫,所以 LiteLDev 官方包可以寫簡稱,如 lip install LeviLamina、lip install LeviOptimize。想按名字搜索,可在終端輸入 lip 打開界面,在“獲取模組”頁搜索 levimc.org 上收錄的模組,或在 https://levimc.org/mods/ 查找。

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

lip 能否像 npm -g 那樣把軟件包安裝到全局環境?

不能。lip 沒有全局安裝的概念,每個命令的工作區就是當前工作目錄(服務器文件夾),包都安裝到這個工作區中,也沒有指定其他工作區的選項,需要先 cd 到服務器目錄再執行命令。

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

用 lip 安裝 LeviLamina 後多出一個名為 loc 的包(levilamina-loc),這是什麼?需要手動安裝嗎?

這是 github.com/LiteLDev/levilamina-loc,LeviLamina 的語言包(Localization),內容會放到 mods/LeviLamina/lang/。它是 LeviLamina 聲明的依賴,安裝 LeviLamina 時 lip 會自動裝上,不需要手動處理。

適用版本:當前所有 LeviLamina 版本(服務端和客戶端)

新版 lip 還能安裝使用舊格式 tooth.json(format_version 1/2/3)的包嗎?包作者該怎麼處理?

能。當前 lip(v0.40.0 起的正式版,最新 v0.41.1;v0.37.0 及更早使用 tooth.json)的包描述文件已改為 lip.toml(format = 4),但仍會讀取 lip v0.x 時代的 tooth.json(format 1、2、3):format 1/2 先按 format 3 解讀,再在本地轉換成 lip.toml 的結構後安裝,與普通包無異;舊工作區的 tooth_lock.json、liprc.json 也會在首次使用時自動遷移為 .lip/state.json、config.toml。

包作者應在新版本中改用 lip.toml,可在倉庫根目錄執行 lip pkg migrate 把 tooth.json 轉換為 lip.toml(會刪除 tooth.json,需檢查警告後提交),再用 lip pkg view . 檢查。舊格式文檔不必再去翻舊 tag,lip 文檔的 lip.toml「Earlier formats」一節說明了 tooth.json 的讀取規則。

注意:新版 lip 沒有中心倉庫也沒有模塊代理(不再走 goproxy/lipr),直接從 git 倉庫獲取包;GitHub 慢時用 lip config set github_proxy <URL> 設置代理。

適用版本:lip 0.40.0 及以上(lip.toml 時代,當前最新 0.41.1)

用 lip 直接安裝 Glacie(多版本互通模組)後報錯/不工作,控制台顯示裝的版本與服務端不匹配,或指定版本安裝失敗,怎麼辦?

Glacie 的包清單沒有聲明對 LeviLamina/遊戲版本的依賴,所以 lip 不帶版本號安裝時會裝最新版,未必和你的服務端版本匹配。需要按服務端版本選對應的 Glacie 版本,安裝時指定版本號:lip install github.com/GlacieTeam/Glacie@<版本>,或到 GitHub Release 手動下載對應版本;版本對應關係請看 Glacie 的 README 和更新日誌,出問題時先看控制台輸出的實際版本號是否匹配。

如果 lip 讀不了新格式的包而安裝失敗,說明 lip 太舊,先用 lip self-update 或從 https://github.com/LiteLDev/lip/releases 更新 lip。

適用版本:lip 0.40 及以上;Glacie 3.x(tooth.json format_version 3,無 LeviLamina 依賴聲明)

用 lip 安裝插件/LeviLamina 後提示與當前 LeviLamina(或 BDS)版本不適配,是怎麼回事?

常見原因是安裝命令裡寫死了舊版本號(如插件說明中給出的 lip install <仓库>@x.y.z),裝上的是舊版本,與當前 LeviLamina 不匹配。把命令中的 @x.y.z 去掉,lip 會安裝能在當前工作區使用的最新正式版本。

遊戲(BDS)與 LeviLamina 的版本由 lip 統一選擇:lip install LeviLamina 會安裝最新的 LeviLamina 以及它支持的最新遊戲版本;lip install 不會替換已裝的遊戲/加載器,如果某個模組需要更新的 LeviLamina,命令會失敗並提示用 lip setup 先切換遊戲和加載器版本(例如 lip setup --game <version>),再安裝模組。開服後可用 version 命令確認 LeviLamina 版本。

舊版 lip 一鍵安裝拉取 LeviLamina 不支持的最新 BDS 的問題已不再出現。

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

lip 的源碼倉庫在哪?從 BDS 官網下載的最新 BDS 能直接配 LeviLamina 用嗎?

lip 倉庫地址為 https://github.com/LiteLDev/lip(舊地址 futrime/lip 會重定向過去)。官網下載的最新 BDS 往往比 LeviLamina 支持的版本新,不能直接用;應使用 LeviLamina 對應的 BDS 版本。推薦直接用 lip:lip install LeviLamina 會安裝最新 LeviLamina 及其支持的最新遊戲版本,或用 lip setup --game <版本> --loader levilamina 指定遊戲版本並自動選匹配的 LeviLamina。

想在舊版本 BDS(如 1.21.1)上部署 LeviLamina + LegacyScriptEngine,有沒有對應整合包?

沒有官方整合包,可用 lip(v0.41.0 及以上)按版本搭建。

遊戲和加載器:在空的服務器目錄中運行 lip setup --game 1.21.1(自動選適配該遊戲版本的最新 LeviLamina,也可用 --loader levilamina@<版本号> 指定),或 lip install github.com/LiteLDev/bds@1.21.1 LeviLamina。

LSE:從 LSE v0.10.0 起各引擎以變體形式發佈,可用 lip install github.com/LiteLDev/LegacyScriptEngine#lua@<版本号>(#<变体> 寫在 @ 之前)安裝與所用 LeviLamina 匹配的版本。

但 1.21.1 這一代(LeviLamina 0.13.x,對應 LSE 0.8.x)的 LSE 倉庫裡沒有 #lua 等變體,各引擎包託管在 gitea.litebds.com 上,目前無法通過 lip 安裝;這種情況只能從 LSE 的 GitHub Releases 下載對應版本的 legacy-script-engine-<引擎>-windows-x64.zip 手動安裝(LegacyMoney 等依賴也要自行裝匹配版本)。

適用版本:lip 0.41.0 及以上(lip setup 與裸名 LeviLamina 自 0.41.0 起才有);LSE 變體安裝僅適用於 LSE 0.10.0+。未能從源碼或文檔中直接證實,僅供參考。

發佈供 lip 安裝的包時,GitHub 版本標籤有什麼格式要求?標籤沒帶 v 導致裝不上、目錄搜不到怎麼辦?

lip 只把名字恰好為 v 加 SemVer 2.0.0 版本號的標籤當作版本,例如 v1.1.0-rc.1、v2.0.0;1.1.0-rc.1、2.0.0、v1.2、v01.2.3 等都會被忽略,lip 和 LeviMC 模組目錄、LeviLauncher 都會跳過。並且標籤處 lip.toml 的 version 必須與標籤一致(不帶 v,如 version = "2.0.0")。

修復方法:補發一個帶 v 的標籤/Release。lip 現在直接通過 git 協議查詢倉庫標籤,不經過 Go 模塊代理,也不緩存標籤列表,新標籤立刻生效,不需要再換 GOPROXY。

在 lip.toml 中可以用 {{version}} 引用版本號(例如在資源 URL 裡),{{id}} 引用包 ID。可用 lip pkg view github.com/<作者>/<仓库> 確認版本是否被識別。

適用版本:lip 0.40 及以上(lip.toml 格式 4);舊 tooth.json 包的標籤規則相同

lip 能安裝本地的包嗎?開發時能否不發佈就在本地測試自己的包?

可以。把根目錄帶 lip.toml 的 ZIP 文件或文件夾路徑交給 lip install 即可,例如 lip install ./my-mod.zip 或 lip install ../MyTool(也支持 https:// 上的 ZIP)。ZIP 只按內容識別,擴展名無所謂,舊的 .tth 改名做法已不需要;可用 lip pkg pack <目录> -o my-mod.zip 打包,用 lip pkg view . 檢查 lip.toml 能否被讀取。

另外也可以在推送標籤前用 lip install github.com/user/repo@branch:main 或 @rev:<40位提交> 測試。

建議儘量都用 lip 管理(包括 LeviLamina 本身),手動放進去的文件不在 lip 的狀態記錄中,lip 無法據此解析依賴關係。

適用版本:lip 0.40 及以上(lip pkg 系列命令需 lip 0.41+)

自己發佈 lip 包時,照抄 LeviLamina 的包文件卻無法安裝,常見原因是什麼?

  1. 版本 tag 必須嚴格是 v + 完整 SemVer,例如 v1.2.3;v1.2、1.2.3、v01.2.3 之類不算版本(不過可以用 lip install github.com/user/repo@tag:1.2.3 安裝任意 tag)。
  2. lip 讀取的是 tag 所指提交裡的 lip.toml(沒有時讀 tooth.json),修改包文件後要提交併打新 tag 推送,舊 tag 內容不會變。
  3. lip.toml 中的 id 必須等於倉庫路徑(如 github.com/user/repo),version 必須等於 tag 版本,且所請求的 variant 要有適配當前環境(平臺/side)的條目,否則該版本不會被當作候選。
  4. 倉庫必須是公開的。

可用 lip pkg view <仓库或 .> 檢查 lip 能否讀取。

適用版本:lip 0.40 及以上

lip 的舊文檔網站(lip.futrime.com、futrime.github.io/lip、lip.levimc.org 等)打不開了,現在去哪裡看 lip 文檔?

lip 文檔現在放在 LeviMC 官網:https://levimc.org/zh-Hant/lip/(英文 https://levimc.org/lip/,繁體 https://levimc.org/zh-Hant/lip/)。文檔源碼在 GitHub 倉庫 LiteLDev/liteldev.github.io 的 docs/lip/ 目錄。lip 倉庫本身已遷到 https://github.com/LiteLDev/lip。在終端裡可以用 lip --help(或 lip -h)查看幫助,lip <命令> --help 查看單個命令的幫助。

適用版本:lip 0.40 及以上

lip 的包索引網站(lippkg.com / bedrinth.com / pkg.levimc.org)打不開或證書過期,lip 是不是停了?還能用 lip 安裝包嗎?

lip 沒有停,只是包目錄網站多次換址:lippkg.com → bedrinth.com → pkg.levimc.org,這些舊地址都已棄用,不要再用。現在的目錄是 LeviMC 模組:https://levimc.org/zh-Hant/mods/(lip 界面裡的「獲取模組」頁和 LeviLauncher 顯示的也是這個目錄)。另外,目錄網站掛了並不影響 lip 安裝:lip 沒有中央倉庫,直接從包的 git 倉庫讀取版本,用 lip install github.com/<作者>/<仓库> 照樣能裝。

適用版本:lip 0.40 及以上

用 lip 配置好的服務端,用 Windows 自帶壓縮打包後 .lip 文件夾丟失,為什麼?

Windows 11 自帶的壓縮功能可能會跳過以 . 開頭的(隱藏)文件夾,導致 .lip 丟失。請改用 7-Zip 等第三方壓縮工具,打包/遷移服務器時務必連同 .lip 一起復制——.lip 記錄了已安裝的包、工作區設置等,在 Windows 上是隱藏目錄。壓縮行為取決於 Windows 版本。

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