跳到主要内容

插件安装教程

插件的结构

LeviLamina 的插件是以文件夹的格式存在的。通常插件文件夹中包含以下内容:

插件文件夹
├─manifest.json // 插件元数据文件,该文件必须存在并格式正确才能被 LeviLamina 识别
├─(插件配置文件和数据库)... // 插件生成的配置文件和数据库等,大多数插件的配置文件名叫config.json,并以一个文件夹或一个 .db 或 .json 后缀文件作为数据库
├─(插件代码或二进制文件)... // 插件源代码,通常是 .js、.lua、.dll 后缀的文件。不要删除,修改或重命名文件,否则可能导致插件无法运行!

通常情况下,你不需要手动修改 manifest.json 这个文件,因为插件作者会将它事先配置好。如果有特殊插件需要手动配置这个文件,该插件文档应该会给出相应教程。

使用 Lip 安装插件

如果你还没有安装 Lip,可以参考 上一章的教程

要使用 Lip 安装插件,你必须确保该插件支持通过 Lip 安装 。如果插件文档没有写明任何使用 Lip 安装的方法或命令,你就不应该使用 Lip 安装该插件。

通常情况下,一个 Lip 插件的安装命令会像这样:

lip install <一个URL>

通过命令安装插件

在服务端根目录(包含 bedrock_server_mod.exe 的文件夹)打开 powershell,执行插件使用说明给出的 Lip 安装命令,

通过 LipUI 安装插件

TODO

随后插件将在服务器下次启动时被加载。要想让正在运行的服务器加载该插件,你必须重启服务器

手动安装插件

原生(native)插件

解压并整理插件文件夹,确保其结构符合上文结出的插件结构。有时插件压缩包解压后里面会套一层文件夹,这点要格外留意。

将插件文件夹放入服务器的 plugins 文件夹,它将在服务器下次启动时被加载。要想让正在运行的服务器加载该插件,你必须重启服务器

LSE 插件

要安装 LSE 插件,你的服务器必须安装了 Legacy Script Engine 作为前置。

quick-js、lua、python 单文件

指只有一个 .js/.lua/.py 代码文件的插件。

首先将插件文件放入 plugins 文件夹,然后启动或重启一次服务器。 此时服务器将警告 WARN [legacy-script-engine-quickjs] Legacy plugins have been migrated, please restart the server to load them!此时插件并未被加载,你需要再次重启服务器 ,之后插件就能加载了。

nodejs、python 多文件

指 .llplugin 后缀名或解压后为一个文件夹的 LSE 插件。

如果插件为文件夹,那么检查该文件夹结构。如果其中包含 manifest.json,直接将其放入 plugins 文件夹即可。随后它将在服务器下次启动时被加载。要想让正在运行的服务器加载该插件,你必须重启服务器

如果该插件为文件夹但不包含 manifest.json,你需要将其放入 plugins 文件夹后,按上文 quickjs、lua、python 单文件的操作方法进行操作。

如果该插件为 .llplugin 后缀名的单个文件,你需要将其后缀名改成 .zip 并解压,之后按照上面两种方法进行操作。