运行服务器

本指南用 lip 搭建一个 LeviLamina 服务器，并用 lip run 运行它：在 Windows 上，以及在 Linux 和 macOS 上通过 Wine。除了 lip 本身，无需下载或安装任何东西：服务器需要的系统组件由 lip 自行安装。

设置服务器

为服务器（即工作区）新建一个空目录，并在其中运行 lip：

shell

mkdir my-server
cd my-server
lip setup --game 1.21.0
lip run

lip setup 选择工作区的服务器：

游戏：版本为 --game 的 Bedrock Dedicated Server github.com/LiteLDev/bds。
构建：--build windows（默认）为 Windows 版服务器，--build linux 为 Linux 版服务器（参见 Linux 版服务器）。
加载器：Windows 版服务器默认为 LeviLamina，用 --no-loader 则不带加载器。--loader levilamina@<version> 取该版本的 LeviLamina；不带版本时，lip 取支持该游戏版本的最新 LeviLamina。

lip setup --game 1.21.0 把游戏 1.21.0 和支持它的最新 LeviLamina，连同 LeviLamina 依赖的包，安装到工作区，并准备好 bedrock_server_mod.exe。lip run 随后在工作区中运行 bedrock_server_mod.exe。

你也可以让 LeviLamina 来选择游戏：lip install LeviLamina 会作为 lip setup 执行，取最新的 LeviLamina 及其支持的最新游戏版本；lip install LeviLamina@<version> 则取该版本的 LeviLamina：

shell

lip install LeviLamina

然后用 lip install 安装 mod。在还没有游戏的工作区中，安装 mod 会失败，并请你先运行 lip setup。

Minecraft EULA

在下载游戏之前，lip 会给出 Minecraft 最终用户许可协议和 Microsoft 隐私声明的链接，并询问你是否接受。输入 yes 继续；其他任何回答都会终止命令，不做任何改动。

lip 不会记住你的回答：每当设置安装或改变游戏时都会询问。在脚本、服务或容器中，lip 的标准输入或标准错误不是终端，lip 无法询问，除非你用 --accept-eula 表示接受，否则设置会失败：

shell

lip setup --game 1.21.0 --accept-eula

在交互界面中，当某次修改会设置游戏时，lip 会在对话框中询问。

改变游戏版本

lip install 和 lip update 从不改变游戏或加载器。当游戏有新版本，或某个 mod 需要另一个版本时，请再次运行 lip setup：

shell

lip setup --game 1.21.50

lip 会针对新的游戏和加载器重新解析工作区中的 mod：若某个 mod 的版本能与它们配合，则保持该版本，否则改变其版本。可以先加上 --dry-run 查看会有哪些变化。若某个 mod 没有能与新游戏配合的版本，lip 会列出这些 mod，并询问是否卸载它们；lip 无法询问时，命令会失败并指明这些 mod，你可以先用 lip uninstall 自行卸载它们，再运行 lip setup。用工作区已有的游戏和加载器运行 lip setup 不会改动它们，也不会询问 EULA。

不带加载器的 Windows 版服务器

如需运行不带 LeviLamina 的 Windows 版服务器，请不带加载器设置它：

shell

lip setup --game 1.21.0 --no-loader
lip run

此时 lip run 运行 bedrock_server.exe 而不是 bedrock_server_mod.exe，运行方式相同：在 Windows 上由 lip 运行，在 Linux 和 macOS 上通过 Wine 运行。需要 LeviLamina 的 mod 无法安装到这样的工作区中。

在 Windows 上

Windows 版服务器需要 Microsoft Visual C++ 可再发行组件包（x64）。若尚未安装，lip 会在 lip setup 设置 Windows 版服务器时，以及在运行钩子命令或 lip run 运行服务器之前，从 Microsoft 下载其安装程序并运行；Windows 会请你允许它以管理员身份进行更改。参见系统依赖。

在 Linux 和 macOS 上通过 Wine 运行

无论 lip 运行在什么系统上，它默认都安装平台 win-x64 的包（参见环境）。在 Linux 和 macOS 上，它通过 Wine 运行这些包的钩子命令和 Windows 版服务器，因此同一个 Windows 版服务器可以在那里运行。

安装与运行

命令与 Windows 上相同：

shell

mkdir my-server
cd my-server
lip setup --game 1.21.0
lip run

lip 第一次需要 Wine 时（即 lip setup 设置 Windows 版服务器时），会下载一个 Wine 构建，用写在 lip 中的 SHA-256 校验它，并解压到其数据目录（~/.local/share/lip，参见常见问题），由所有工作区共用。随后它向工作区的 Wine 前缀中安装一次 Microsoft Visual C++ 可再发行组件包。两者都不需要 root，也不需要你自己的 wine：lip 从不运行 PATH 中的 wine。参见系统依赖。

在 Windows 以外的系统上，当工作区的平台以 win 开头时，lip 通过它的 Wine 运行所有 Windows 程序：安装、更新或卸载包时的钩子命令（以 wine cmd /s /c <命令> 的形式），以及 lip run 运行的 Windows 版服务器（以 wine 加服务器文件的绝对路径的形式，即 bedrock_server_mod.exe，不带加载器时为 bedrock_server.exe）。Wine 把钩子命令中的每个 " 以 \" 的形式传给 cmd，而 cmd 不把它当作转义，因此含有 " 的钩子命令通过 Wine 运行时不会按原样运行；面向 Wine 的包应避免在钩子中使用 "。对 lip 而言，这样的工作区中的路径不区分大小写，与 Wine 运行的程序看到的一样：写入 Plugins/a.dll 的包会写入已有的 plugins/ 目录，而不是在其旁边新建目录。

Wine 前缀

lip 为 wine 设置两个环境变量，除非你自己设置了它们：

变量	默认值
`WINEPREFIX`	工作区中 `.lip/wine` 的绝对路径，在 `WINEPREFIX` 未设置或为空时使用。每个工作区都有自己的前缀，由 Wine 在该工作区中首次运行时创建，并随工作区一起移动。
`WINEDEBUG`	`-all`，在 `WINEDEBUG` 未设置时使用：不显示 Wine 的调试信息。如需查看，请自行设置，例如设为 `err+all`。

如需使用其他前缀，请为该工作区的每条 lip 命令设置 WINEPREFIX：

shell

export WINEPREFIX="$HOME/.wine-bds"
lip setup --game 1.21.0
lip run

macOS 与 arm64

Windows 版服务器是 x64 的 Windows 程序。lip 在它发布的每个系统上都用真实的 LeviLamina 服务器测试过，配置如下：

系统	由什么运行服务器
x64 上的 Windows	Windows。
arm64 上的 Windows	Windows，由它模拟 x64。
x64 上的 Linux	lip 的 Wine。
x64 上的 macOS	lip 的 Wine。
arm64 上的 macOS	同一个 x64 的 Wine，由 Rosetta 2 运行。

在 x64 的 Linux 上，lip 的 Wine 是 Kron4ek/Wine-Builds 的构建；在 macOS 上，是 Gcenx/macOS_Wine_builds 的构建。

在 Apple 芯片的 Mac 上，Wine 需要 Rosetta 2，而安装它需要管理员权限，因此 lip 不会安装它：缺少它时，lip 会失败并请你运行：

shell

softwareupdate --install-rosetta --agree-to-license

lip 不为 arm64 的 Linux 发布，因为试过的办法都无法在那里可靠地运行 LeviLamina 服务器：

Hangover 能运行原版 Bedrock Dedicated Server，但 LeviLamina 修改过的服务器一启动就失败。
由 box64 运行的 x64 Wine 会在 Windows 程序退出时将其杀死，退出码因此丢失。
由 FEX 运行的 x64 Wine 在六次尝试中有两次成功运行了 LeviLamina 服务器。有两次，安装 LeviLamina 时用来修改服务器的 PeEditor.exe 被杀死；另有两次，服务器启动成功，但在停止时失败。

lip 自己下载并放置服务器的文件，不借助任何 Windows 程序。

Linux 版服务器

构建 linux 设置 Minecraft 的 Linux 版服务器，而不是 Windows 版，即变体 github.com/LiteLDev/bds#linux。LeviLamina 只加载到 Windows 版服务器中，因此 Linux 版服务器没有加载器，需要 LeviLamina 的 mod 也无法与它一起安装：

shell

lip setup --game 1.21.0 --build linux
lip run

lip install github.com/LiteLDev/bds#linux 以最新的游戏版本做同样的事，lip install github.com/LiteLDev/bds#linux@<version> 则以该版本。

lip 放置 Linux 版服务器的文件，并自己把 bedrock_server 设为可执行，不借助钩子命令，因此没有任何程序通过 Wine 运行，lip 也不为它安装 Wine 或 Microsoft Visual C++ 可再发行组件包。一个工作区只有一个游戏，因此在装有 Windows 版服务器的工作区中设置 Linux 版服务器会替换前者，与任何游戏的改变一样。

在 x64 的 Linux 上，lip run 自己运行工作区根目录下的 bedrock_server；若环境变量 LD_LIBRARY_PATH 未设置或为空，则将其设为 .，使服务器能找到其旁边的库。在其他系统上，lip run 对 Linux 版服务器会失败。

早期 lip 以 --platform linux-x64 创建的工作区，若只装有服务器，则仍可使用：lip 把其中的服务器读作 github.com/LiteLDev/bds#linux（参见状态文件）。

服务器运行期间

控制台：服务器输出到你的终端，你输入的所有内容都会转交给它，因此你可以像平常一样输入服务器命令。
停止：按 Ctrl+C。lip 向服务器输入 stop，服务器随即保存世界并退出，lip 随后退出。再次按 Ctrl+C 不会强行中断服务器：lip 仍会等待它退出。若服务器卡住，请结束其进程。
退出码：lip run 以服务器的退出码退出（通过 Wine 运行时为 wine 的退出码）；在 Linux 或 macOS 上服务器被信号 n 结束时为 128 + n（例如 SIGKILL 为 137），因此在失败时重启服务器的脚本或服务管理器可以使用它。
重启：要让 lip 重启崩溃（以非零退出码退出）的服务器，请设置 lip config set restart on-failure --workspace。lip 会等待 5 秒后再次启动它，10 分钟内至多 5 次；你停止的服务器或以退出码 0 退出的服务器不会被重启。参见 lip run。
每个工作区一个服务器：工作区的服务器在运行时，再次在该工作区运行 lip run 会立即失败，无论服务器是由 lip run、交互界面还是守护进程启动的。
保持运行：lip run --managed 让 lip 的守护进程运行服务器，使它在你关闭终端后继续运行；再次运行 lip run --managed 即可连接到它，lip run --managed --detach 则启动它而不连接。交互界面也以这种方式运行服务器。参见托管服务器。
修改包：服务器运行期间，lip 不锁定工作区。你可以在另一个终端中对同一工作区运行 lip install、lip update、lip uninstall 或 lip setup；服务器下次启动时才会看到这些改动。若某个要替换或删除的文件因被运行中的服务器打开而无法替换或删除（在 Windows 上可能发生），该操作会失败并被撤销，工作区保持原样；请停止服务器后再运行该命令。交互界面更为严格：某个工作区的服务器运行期间，无论它是如何启动的，界面都不会在其中安装、更新、卸载或设置任何内容，游戏配置也只能查看。
被中断的操作：与任何操作一样，lip run 会先完成或撤销被中断的操作；若此时另一个 lip 命令正在修改该工作区，它会立即失败。