Minecraft 服务器上的插件；它运行授权系统、经济、保护、市场、事件、索赔、反作弊和许多特殊系统。如果未安装其中一个插件，服务器的很大一部分可能无法工作。

插件错误通常发生在控制台或 日志/latest.log 出现在文件中。最常见的错误； 无法加载插件, 不支持的 API 版本, 未知的依赖关系, 无效的plugin.yml 和 Java 版本不兼容。

1. 在哪里可以看到插件错误？

如果插件未加载，首先要查看的是服务器控制台和latest.log 文件。

tail -n 200 logs/latest.log

对于实时跟踪：

tail -f logs/latest.log

按插件名称搜索：

grep -i "pluginadi" logs/latest.log

2. 不支持的API版本错误

此错误表明该插件支持的 Minecraft API 版本与服务器版本不兼容。

Unsupported API version 1.20

例如，该插件可能是为 1.20 准备的，但您的服务器可能正在运行 1.16.5。在这种情况下，插件可能无法加载或无法正常工作。

解决方案：

• 检查插件支持的 Minecraft 版本。
• 下载与您的服务器版本兼容的插件版本。
• 不要指望新插件可以在非常旧的服务器上运行。
• 如有必要，请从插件的旧版本存档中找到合适的版本。

3.未知的依赖错误

有些插件不能单独工作。它要求首先安装另一个插件。这称为依赖性。

Unknown dependency Vault
Could not load plugin because dependency LuckPerms was not found

例如，经济插件经常 避难所 想要。授权或市场插件可能还需要其他库插件。

解决方案：

• 阅读插件页面上的要求。
• 下载缺少的依赖插件。
• 确保依赖插件也与您的服务器版本兼容。
• 完全重新启动服务器。

4.plugin.yml无效错误

插件 jar 文件内 插件.yml 如果文件损坏、丢失或不正确，则无法安装插件。

Invalid plugin.yml
Plugin does not contain a plugin.yml

这通常发生在以下情况：

• 下载了错误的文件。
• 源代码 zip 已放置在插件文件夹中，而不是插件。
• Jar 文件已损坏。
• 该插件被开发者错误地打包。

作为解决方案，该插件是正确的。 .jar 应下载该文件。从GitHub下载的source-code.zip不应直接放入plugins文件夹中。

5. Java版本不兼容

Minecraft 版本和插件需要特定的 Java 版本。如果使用错误的 Java 版本，插件或服务器可能根本无法打开。

java -version

常见错误：

UnsupportedClassVersionError

此错误表明该插件是使用较新的 Java 编译的，但服务器上使用的是较旧的 Java。

一般逻辑：

• 较旧的 Minecraft 版本通常需要较旧的 Java。
• 较新的 Minecraft 版本需要较新的 Java。
• 应检查插件描述中的 Java 要求。
• 必须验证托管面板中所选的 Java 版本。

6. 插件文件是否位于正确的文件夹中？

Bukkit、Spigot 和 Paper 服务器上的插件文件 插件 被扔进文件夹。

ls plugins/

插件文件应该是这样的：

plugins/PluginAdi.jar

留在 zip、rar、源代码或文件夹中的插件通常不起作用。

7. 插件冲突

执行相同工作的两个插件可能会相互冲突。例如，两个不同的聊天插件、两个不同的经济插件或两个不同的索赔系统可能会尝试管理相同的事件。

冲突症状：

• 该插件已安装，但其命令不起作用。
• 一个插件会压倒另一个插件的设置。
• 控制台发生事件冲突或异常。
• 玩家即使有权限也不能使用命令。
• 重新启动后服务器的行为有所不同。

为了找到解决方案，可以通过将插件一一禁用来进行测试。然而，在实时服务器上执行此操作之前，应先进行备份，并且应优先考虑玩家时间较短的情况。

8. 配置错误可能导致插件无法打开

如果配置文件中存在 YAML 错误，某些插件将无法打开。空格缩进在 YAML 文件中尤其重要。

常见错误：

• 使用制表符
• 冒号后面不要留空格
• 编写需要引号的文本而不使用引号
• 由于土耳其字符或特殊符号导致文件损坏
• 保存丢失的配置文件

如果配置文件不正确，可以临时重命名插件文件夹，以备份插件文件夹并重新创建配置。

常见错误

• 安装与服务器版本不兼容的插件
• 不安装缺少的依赖插件
• 将 GitHub 源 zip 文件误认为是插件
• 不检查Java版本
• 尝试使用 /reload 安装插件
• 在 YAML 配置文件中使用选项卡

常见问题解答

插件在plugins文件夹下但是不起作用，为什么？
可能是版本不兼容、缺少依赖项、Java 不兼容或配置错误。应检查latest.log 文件。

UnsupportedClassVersionError 是什么意思？
该插件刚刚用 Java 编译。服务器上使用的 Java 版本已过时。

使用 /reload 安全吗？
很多插件不推荐使用它。完全重新启动对于插件安装、删除和主要配置更改来说更安全。

安全和操作建议

• 从可靠来源下载插件。
• 在将插件添加到实时服务器之前，请先在测试服务器上尝试一下。
• 在每次插件更新之前备份插件文件夹。
• 通过删除不必要的插件来减少攻击面。
• 定期检查插件日志。

本文是专门为PvPServer准备的。