插件未加载

检查 /plugins——插件会以绿色（已加载）或红色（报错）列出。如果某个插件完全没有出现在列表中，说明服务器从未读取到它。

排查顺序

1. 文件放在正确的文件夹里。 .jar 要放在 plugins 中，而不是子文件夹里，也不是 mods 里。
2. 核心支持插件。 Fabric 和 Forge 完全没有插件——核心与版本。在原版核心上根本不存在 plugins 文件夹。
3. 版本。 该插件是为另一个游戏版本构建的——兼容性。
4. 前置依赖。 Vault、ProtocolLib、PlaceholderAPI——缺少它们时插件会静默加载失败：日志中会显示 Unknown dependency——缺少前置。
5. 配置错误。 YAML 格式损坏——插件会在启动时自行禁用——插件配置。
6. 文件损坏。 下载中断会生成 Invalid plugin.yml——排查方法。

查看日志

启动的最初几秒就包含确切原因。搜索插件名称以及 Could not load、Unknown dependency、Error occurred while enabling 这些关键词——日志。

插件已加载但不工作

那就是另一回事了：检查权限（lp verbose on）、配置以及所需的前置是否齐全——LuckPerms、权限不生效。

通过目录安装

面板的目录会在安装前检查兼容性并自动安装前置——如何安装。手动安装则意味着所有检查都要您自己完成。