安裝服務器

LeviLamina 運行在 Windows 版基岩版專用服務器（BDS）中。你可以用 lip 直接在 Windows 上安裝，也可以在 Docker 容器中運行：Linux 容器（通過 Wine 運行 BDS）或 Windows 容器。

在 Windows 上通過 lip 安裝 Windows

前提條件

要安裝 LeviLamina，你需要以下 Windows 版本之一：

Windows 10
Windows 11
Windows Server 2019
Windows Server 2022
Windows Server 2025

要運行基岩版專用服務器（BDS），你需要安裝以下軟件：

Microsoft Visual C++ 可再發行程序包（x64）

安裝

安裝 lip。默認使用 npm 安裝，也可以使用 winget，或從 lip 的 releases 下載以 setup.exe 結尾的安裝包（參見 lip 安裝指南）：
Bash
```
npm install -g @levimc/lip
# 或
winget install levimc.lip
```
（可選）可以通過lip config set命令來設置GitHub鏡像，例如:
Bash
```
lip config set github_proxy https://mirror.ghproxy.com/
```
（可選）可以通過定義BDSDOWN_MIRROR_URL環境變量來自定義BDS下載鏡像站，例如: https://www.minecraft.net 。你也可以手動在Minecraft官網下載BDS，然後把壓縮文件丟到.cache/bdsdown目錄下，如果該目錄不存在請手動創建。該目錄基於您安裝BDS的路徑，例如C:\Users\YourName\BDS\.cache\bdsdown。
為你的 Minecraft 服務器創建一個目錄並切換到該目錄:
Bash
```
mkdir myserver
cd myserver
```
使用 lip 安裝 LeviLamina（已附帶基岩版專用服務器）:
Bash
```
# 安装最新版本
lip install github.com/LiteLDev/LeviLamina

# 安装指定版本 (把 x.y.z 替换成想要的版本)
lip install github.com/LiteLDev/LeviLamina@x.y.z
```
安裝過程中，PeEditor 會生成 bedrock_server_mod.exe（會加載 LeviLamina 的 bedrock_server.exe 副本），並把原來的可執行文件保留為 bedrock_server.exe.bak。
執行以下命令啟動服務器:
Bash
```
./bedrock_server_mod.exe
```

可在 releases 查看可用版本號。

升級

如果你想要升級LeviLamina，可以運行以下命令:

Bash

# 升级到最新版本
lip update github.com/LiteLDev/LeviLamina

# 升级到指定版本 (把 x.y.z 替换成想要的版本)
lip update github.com/LiteLDev/LeviLamina@x.y.z

Warning

為確保數據安全，跨Minecraft版本升級時，請勿在同一目錄內更新 LeviLamina。建議在獨立文件夾內安裝新版本，然後複製 worlds 目錄並按需更新配置。

通過 Docker 安裝

選擇容器類型。如果你的服務器在中國大陸，請使用第二條命令以更快地安裝。

Linux 容器通過 Wine 運行 BDS：

Bash

docker run -d -it -e EULA=TRUE -p 19132:19132/udp -p 19132:19132/tcp -v levilamina-server-data:/data ghcr.io/liteldev/levilamina-server:latest-wine

Bash

docker run -d -it -e EULA=TRUE -e GITHUB_MIRROR_URL=https://mirror.ghproxy.com/ -p 19132:19132/udp -p 19132:19132/tcp -v levilamina-server-data:/data ghcr.nju.edu.cn/liteldev/levilamina-server:latest-wine

Docker Compose：把 wine/compose.yaml 下載到一個空目錄並運行 docker compose up -d。

Windows 容器：

Bash

docker run -d -it -e EULA=TRUE -p 19132:19132/udp -p 19132:19132/tcp -v levilamina-server-data:C:\data ghcr.io/liteldev/levilamina-server:latest-windows

Bash

docker run -d -it -e EULA=TRUE -e GITHUB_MIRROR_URL=https://mirror.ghproxy.com/ -p 19132:19132/udp -p 19132:19132/tcp -v levilamina-server-data:C:\data ghcr.nju.edu.cn/liteldev/levilamina-server:latest-windows

Docker Compose：把 windows/compose.yaml 下載到一個空目錄並運行 docker compose up -d。

環境變量

EULA: 必須設置為TRUE以接受Minecraft最終用戶許可協議。
GITHUB_MIRROR_URL：可設置為GitHub鏡像URL（例如https://mirror.ghproxy.com/），以加速LeviLamina的安裝。當您處於防火牆後或在網絡較慢的地區時很有用。
PACKAGES：可設置為以空格分隔的包列表，用於首次運行時安裝。每個包必須符合 lip包名規範。支持本地和遠程的lip包。對於本地包，可能需要將包掛載到容器中。
VERSION(LATEST)：可設置為特定的LeviLamina版本，或設置為 LATEST以自動下載最新版本。
WINEDEBUG(-all) Linux：可設置以自定義Wine的調試輸出。欲瞭解更多信息，請參見Wine Debugging。僅在Wine鏡像中可用。
LANG：可設置容器中使用的語言環境。默認值為en_US.UTF-8。
LC_ALL：可設置容器中使用的語言環境。默認值為en_US.UTF-8。
TZ：可設置容器使用的時區。默認值為UTC。

搜尋模組

在添加模組之前，請先了解各種選項。最佳資源來源為 LeviMC 模組，當然你也可以在其他網站上找到更多資源。

安裝模組

大多數模組（尤其是 LeviMC 模組上列出的）都可在服務器目錄中運行提供的命令進行安裝。例如，要安裝 LeviAntiCheat:

Bash

lip install github.com/LiteLDev/LeviAntiCheat

在 Docker 容器中，請改為在 PACKAGES 環境變量中列出這些包。

如有需要，請遵循各個模組開發者提供的進一步說明。