跳到主要内容

安装插件

环境要求

项目要求
JavaJava 21 或更高版本
Minecraft建议 1.20.1 或更高版本
服务端核心Paper、Purpur、Folia 或其他 Paper 分支
权限插件推荐 LuckPerms
注意

如果你的插件不支持 Folia 或某些服务端核心,请在这里明确写出,避免用户在不兼容环境中安装。

安装步骤

  1. 停止服务器。
  2. 下载插件文件,例如 YourPlugin-1.0.0.jar
  3. 将文件放入服务器的 plugins 文件夹。
  4. 启动服务器。
  5. 检查控制台是否出现插件启用日志。
  6. 打开 plugins/YourPlugin/config.yml 修改配置。
  7. 执行重载命令。
服务器控制台
yourplugin reload

验证安装

进入服务器后执行:

/yourplugin help

如果能看到帮助菜单,说明插件已经正常加载。

常见问题

控制台提示 Java 版本过低

请安装 Java 21 或更高版本,并确认启动脚本使用的是正确 Java 路径。

插件没有生成配置文件

检查服务器是否成功启动、插件文件是否完整,以及控制台是否有报错。