安裝依賴

lip 提供了靈活的依賴安裝方式。

基礎安裝

按路徑安裝包：

lip install <PACKAGES>

示例：

lip install github.com/user/repo

這會把該包的最新版本及其聲明的依賴安裝到工作區，並記錄到鎖文件中，但不會修改 manifest.json。

指定版本

可通過 @ 語法安裝某個確切版本：

lip install github.com/user/repo@1.0.0

如需選擇變體，請在路徑後追加 #<variant>，例如 github.com/user/repo#lua@1.0.0。

安裝分支、標籤或提交

如需試用尚未發佈的改動，可安裝分支的頭、任意標籤或某個提交：

lip install github.com/LiteLDev/LeviLamina@branch:main
lip install github.com/user/repo@tag:nightly
lip install github.com/user/repo@rev:0123456789abcdef0123456789abcdef01234567

鎖會記錄該提交，因此在 lip update 之前工作區始終保持該提交；lip update 會跟隨分支到新的頭。參見 git 引用。

從本地文件安裝

可直接從本地 .mcmod 或 .zip 文件安裝，使用相對於當前目錄的路徑或絕對路徑：

lip install ./path/to/package.mcmod
lip install C:\Downloads\package.zip

這對發佈前測試包很有用。本地目錄不能安裝；請先把它打包為 .mcmod 文件（根目錄含 manifest.json 的 ZIP 歸檔）。

從遠程 URL 安裝

也可以直接從 HTTPS URL 安裝 ZIP 歸檔：

lip install https://example.com/package.mcmod

僅限服務端工作區

lip 管理服務端工作區：mod 安裝到 mods/<name>/（參見環境）。客戶端工作區由 LeviLauncher 等啟動器管理，它們讀取同樣的包。

在服務端工作區中，plugins 是指向 mods 的鏈接（Windows 上為目錄聯接，其他平臺為符號鏈接），因此仍在 plugins/ 中查找的軟件可以繼續工作，plugins/ 下的路徑與 mods/ 下對應的路徑是同一個文件。在 lip install、lip uninstall 或 lip update 改動任何包之前，lip 會這樣準備：

mods 不存在時創建它；plugins 不存在時創建該鏈接。
plugins 是普通目錄時（之前搭建的工作區），lip 把其中的內容移入 mods，再把 plugins 換成鏈接。若某個條目同時存在於 plugins 和 mods 中，lip 會在移動任何內容之前停止；請先合併兩者，再重新運行命令。
plugins 是指向其他位置的鏈接時，lip 停止，不做任何改動。

使用 --dry-run 時，lip 只輸出它將要執行的操作。

命令參數

-n, --dry-run：僅模擬安裝，不做實際更改，可用於預覽結果。
--no-dependencies：僅安裝指定包，忽略其依賴，也不卸載其他包。這可能導致工作區損壞。
--ignore-scripts：不執行任何包腳本，包括安裝過程中被移除或替換的包的卸載腳本。
--rid <RID>：設置工作區的 .NET RID，例如 win-x64。