安装指南

PLand 有两种安装方式，请根据你的情况选择：

方式	适合人群	难度	说明
Lip 一键安装	绝大多数服主（推荐）	⭐	自动下载并处理全部依赖，一条命令搞定
手动安装	熟悉插件结构的进阶用户	⭐⭐⭐	手动下载并放置插件与前置组件

无头版本

从 v0.23.0 开始，PLand 提供了无头版本，无头版本不包含任何图形依赖，可以在 windows server no gui 等环境下运行。

版本变体	文件名	说明
headless	PLand-windows-x64-headless.zip	无头版本，适用于无图形环境、无显示器等环境下使用
devtool	PLand-windows-x64-devtool.zip	包含图形管线依赖，需要完整 GUI 环境和可用的监视器(显示器)

如果您主要在服务器上运行(通过远程连接、VNC、RDP 等方式)，或家用服务器(显示器经常关闭、断开)，建议使用无头版本。

默认安装的是 devtool 版本，如果需要无头版本，请在下载(安装)时选择 headless 版本。

使用 Lip 安装（推荐）

使用前请确保已经安装了 Lip。

安装最新版本

lip install github.com/IceBlcokMC/PLand

安装指定版本

lip install github.com/IceBlcokMC/PLand@v1.0.0

安装无头版本

lip install github.com/IceBlcokMC/PLand#headless # 最新的无头版本

lip install github.com/IceBlcokMC/PLand#headless@1.0.0 # 并指定版本

更新 PLand

lip install --upgrade github.com/IceBlcokMC/PLand

安装完成后：

1. 在 plugins 文件夹中可以看到 PLand 的安装文件
2. 双击 bedrock_server_mod.exe 启动服务器
3. 在服务器日志中看到 PLand 的启动日志 即安装成功

Lip 会自动处理 PLand 的依赖（LeviLamina、iListenAttentively 等），无需手动下载。

手动安装

手动安装需要你先自行装好 PLand 的全部前置组件，且版本必须与 PLand 兼容。

前置组件

前置组件	项目地址	依赖等级	备注
LeviLamina	GitHub	必须	Mod 框架
iListenAttentively	v0.23.x 以后的版本 -> Github v0.23.x 以前的版本 -> GitHub	必须	事件库
LegacyMoney	GitHub	可选	economy.kit 为 LegacyMoney 时需要
DebugShape	Github	可选	features.draw.backend == DebugShape 时需要

版本兼容性

在下载前置组件时，请确保版本与 PLand 兼容。
如果你不确定，强烈建议改用 Lip 安装，由 Lip 自动处理依赖。

安装步骤

1. 前往 Minebbs 或 Github Release 下载 PLand 的最新版本

2. 解压下载的 PLand-windows-x64.zip

3. 将解压后的 PLand 文件夹移动到 plugins 文件夹下

4. 双击 bedrock_server_mod.exe 启动服务器

5. 在服务器日志中看到 PLand 的启动日志 即安装成功

启动日志

出现以下日志说明 PLand 已成功加载：

22:03:02.933 INFO [PLand]   _____   _                        _
22:03:02.933 INFO [PLand]  |  __ \ | |                      | |
22:03:02.933 INFO [PLand]  | |__) || |      __ _  _ __    __| |
22:03:02.933 INFO [PLand]  |  ___/ | |     / _` || '_ \  / _` |
22:03:02.933 INFO [PLand]  | |     | |____| (_| || | | || (_| |
22:03:02.933 INFO [PLand]  |_|     |______|\__,_||_| |_| \__,_|
22:03:02.933 INFO [PLand]
22:03:02.933 INFO [PLand] Loading...
22:03:02.933 INFO [PLand] Build Time: 2024-09-22 22:43:13
22:03:02.964 INFO [PLand] 已加载 1 位操作员
22:03:02.964 INFO [PLand] 已加载 1 块领地数据
22:03:02.964 INFO [PLand] 初始化领地缓存系统完成
22:03:02.964 INFO [LeviLamina] PLand 已加载

常见安装问题

Q：安装后没有看到 PLand 的启动日志？

• 检查 plugins 文件夹下是否有 PLand 文件夹
• 检查是否已安装全部必须的前置组件（LeviLamina、iListenAttentively）
• 查看服务器完整日志，确认是否存在加载失败/崩溃的具体报错

Q：日志提示缺少某个 DLL / 依赖？

PLand 依赖的前置组件版本不匹配，请升级或降级对应前置组件到与 PLand 兼容的版本。 如果不确定版本，建议用 Lip 安装让工具自动处理。

Q：我想从旧版本升级到新版本？

lip install --upgrade github.com/IceBlcokMC/PLand

升级前请务必备份数据

将 plugins/PLand 下的 config 和 data 文件夹复制一份保存，以防升级出现问题。

Q：更多问题？

请查看 FAQ 或加入 QQ 群 反馈。