lip setup

選擇工作區的遊戲和加載器。

概要

shell

lip setup --game <VERSION> [--build <BUILD>] [--loader <LOADER> | --no-loader] [options]

說明

lip setup 把工作區的服務器設為版本 <VERSION>、構建 <BUILD> 的 Bedrock Dedicated Server，帶加載器 <LOADER> 或不帶加載器，並保留工作區中能與之配合的其他包。請在新工作區中先運行它再安裝 mod；以後想換用另一個遊戲版本時，再次運行它即可。

遊戲與加載器

遊戲是 github.com/LiteLDev/bds（Bedrock Dedicated Server）的已安裝包。一個工作區至多有一個；沒有它的工作區沒有遊戲。
遊戲的構建為 windows 或 linux。windows 是 Windows 版服務器 github.com/LiteLDev/bds；linux 是 Linux 版服務器 github.com/LiteLDev/bds#linux。
加載器是 github.com/LiteLDev/LeviLamina 的已安裝包，或者沒有加載器。

lip setup 把兩者都顯式安裝，並固定其版本：遊戲來自 github.com/LiteLDev/bds@<VERSION> 或 github.com/LiteLDev/bds#linux@<VERSION>，加載器來自 github.com/LiteLDev/LeviLamina@<version>。此後 lip install 和 lip update 從不改變它們：如需改變遊戲或加載器，請再次運行 lip setup。lip uninstall 像卸載其他包一樣卸載它們。

若工作區已有你要求的遊戲和加載器，且版本相同，lip setup 不會改動它們。

加載器

不帶 --loader 和 --no-loader 時，構建 windows 的加載器為 LeviLamina，構建 linux 沒有加載器。LeviLamina 只加載到 Windows 版服務器中，因此 --build linux 與 --loader 一起使用會失敗。

--loader levilamina 取對 github.com/LiteLDev/bds 的依賴接受該遊戲版本的最新 LeviLamina 版本；若沒有任何 LeviLamina 版本支持該遊戲版本，lip setup 會在做任何改動之前失敗。--loader levilamina@<version> 恰好取該版本的 LeviLamina，它同樣必須支持該遊戲版本。

Minecraft EULA

在下載遊戲之前，lip 會給出 Minecraft 最終用戶許可協議和 Microsoft 隱私聲明的鏈接，並詢問你是否接受：輸入 yes 繼續。其他任何回答都會讓命令在做任何改動之前失敗。

lip 不會記住你的回答：每當 lip setup 安裝或改變遊戲時都會詢問，遊戲保持不變時則不詢問。帶 --accept-eula 時，lip 不詢問。當 lip 的標準輸入或標準錯誤不是終端時（例如在腳本中），不帶 --accept-eula 的 lip setup 會在做任何改動之前失敗。

改變裝有 mod 的工作區的遊戲

改變遊戲或加載器時，其他顯式安裝的包會針對新的遊戲和加載器重新解析。若某個包的版本能與它們配合，則保持該版本；否則其版本可能改變。工作區原有的遊戲和加載器會被卸載，不再被任何顯式安裝的包需要的依賴也會一併卸載。

若某個已安裝的 mod 沒有能與新的遊戲和加載器配合的版本，lip 會列出這些 mod，並詢問是否卸載它們；你不回答 yes 時，命令會在做任何改動之前失敗。當 lip 的標準輸入或標準錯誤不是終端時，lip setup 會直接失敗，並指明這些 mod：請先用 lip uninstall 卸載它們，再運行 lip setup。若其他包根本無法保留，命令會失敗。

lip 先詢問這些 mod，再詢問 EULA，時機在它決定好要做什麼之後、下載遊戲之前。

系統依賴

對構建 windows，lip setup 會安裝 Windows 版服務器需要而系統缺少的組件：Linux 和 macOS 上的 Wine，以及 Microsoft Visual C++ 可再發行組件包（參見系統依賴）。Linux 版服務器兩者都不需要。

選項

選項	說明
`--game <VERSION>`	遊戲版本，例如 `1.21.0`。必需。
`--build <BUILD>`	`windows`（默認）或 `linux`。
`--loader <LOADER>`	`levilamina`，即支持該遊戲的最新 LeviLamina；或 `levilamina@<version>`。構建 `windows` 的默認值。
`--no-loader`	不帶加載器設置遊戲。構建 `linux` 的默認值。不能與 `--loader` 同時使用。
`--accept-eula`	不經詢問，接受 Minecraft EULA 和 Microsoft 隱私聲明。
`-n, --dry-run`	僅模擬執行，不做實際更改。不詢問任何問題；說明將安裝、卸載或標記為顯式安裝哪些包，哪些 mod 會被排除，以及 lip 是否會請你接受 EULA。

示例

設置遊戲 1.21.0，並使用支持它的最新 LeviLamina：

shell

lip setup --game 1.21.0

設置指定版本的 LeviLamina，並在腳本中接受 EULA：

shell

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

設置不帶加載器的 Windows 版服務器：

shell

lip setup --game 1.21.0 --no-loader

設置 Linux 版服務器，它沒有加載器：

shell

lip setup --game 1.21.0 --build linux

查看換用另一個遊戲版本會對工作區的 mod 造成什麼影響：

shell

lip setup --game 1.21.50 --dry-run