跳转到内容

特征文件

用解压缩软件打开插件的 jar 文件就可以看到 plugin.yml

用文本编辑器可以打开它:

其实只有 namemain 是必填的,其他可写可不写。

比如一个插件有提供命令,但它不在 plugin.yml 中写 commands 也是很常见的。

下面是常见的一些键值:

插件的名字,也是会在插件列表 (/pl) 和日志中输出的信息中显示的插件名。

插件版本,显示在 /version 插件名 中。

插件主类,加载插件时运行的类的名称,类似正常程序中的 main 函数,服主不用管。

简短描述插件的作用,会在 /pl 命令中鼠标悬浮在插件名称上时显示。

插件作者,显示在 /version 插件名 中。

贡献者,指非作者但为插件贡献了代码的人。

插件相关的网站,显示在 /version 插件名 中。

插件编译时使用的 API 版本,影响着 BukkitAPI 对插件提供的兼容性。

这告诉服务器何时加载插件。它可以是 STARTUPPOSTWORLD 。如果未指定,将默认为 POSTWORLD

在服务器日志中显示的前缀,有别于插件名称。

插件的依赖库表,不过这并不是前置插件的意思,而是插件开发时用到的依赖。

插件权限相关。

默认权限。

插件提供的命令。

依赖关系

硬依赖,必须安装。

软依赖,即不必须装的依赖。

在此列表中的插件加载前加载本插件。

告诉服务器本插件会提供哪些库或功能。

当此项为 true 时,Folia 端才会尝试加载此插件。

如果插件的 plugin.yml 里没有此项,你可以试着手动添加。

folia-supported: true