自建服务器无法加载GravePlugin插件：主类找不到问题求助

核心排查与修复步骤： #

• 核对plugin.yml的主类配置
  这是最常见的触发原因：服务器通过plugin.yml里的main字段定位插件主类，必须填写全限定类名（包含完整包路径）。如果你的GravePlugin类在me.xxx.graves这类包下，main字段不能只写GravePlugin，必须写成me.xxx.graves.GravePlugin。
  示例正确配置：

  name: GravePlugin
  version: 1.0.0
  main: me.xxx.graves.GravePlugin
  api-version: 1.19
  

• 验证JAR包内的类文件结构
  解压你的graves.jar，确认GravePlugin.class文件存在，且所在路径和plugin.yml的main字段完全对应。比如main是me.xxx.graves.GravePlugin，JAR内必须存在me/xxx/graves/GravePlugin.class，不能把类文件直接放在JAR根目录（除非主类没有包）。

• 检查大小写一致性
  Java是大小写敏感语言，确保plugin.yml里的主类名和实际类文件名完全一致：比如不能把GravePlugin写成graveplugin，也不能出现Graveplugin这类大小写错误。

• 确认Java版本兼容性
  Paper 1.19.2要求使用Java 17运行，编译插件时必须用Java 17或兼容的字节码版本（不能用Java 8编译后放到Java 17的服务器上）。在IDE中检查项目的Java编译版本设置，确保和服务器版本匹配。

附报错信息： #

[23:24:37 ERROR]: Could not load 'plugins/graves.jar' in folder 'plugins'
org.bukkit.plugin.InvalidPluginException: Cannot find main class `GravePlugin'
    at org.bukkit.plugin.java.PluginClassLoader.<init>(PluginClassLoader.java:73) ~[paper-api-1.19.2-R0.1-SNAPSHOT.jar:?]
    at org.bukkit.plugin.java.JavaPluginLoader.loadPlugin(JavaPluginLoader.java:153) ~[paper-api-1.19.2-R0.1-SNAPSHOT.jar:?]
    at org.bukkit.plugin.SimplePluginManager.loadPlugin(SimplePluginManager.java:411) ~[paper-api-1.19.2-R0.1-SNAPSHOT.jar:?]
    at org.bukkit.plugin.SimplePluginManager.loadPlugins(SimplePluginManager.java:319) ~[paper-api-1.19.2-R0.1-SNAPSHOT.jar:?]
    at org.bukkit.craftbukkit.v1_19_R1.CraftServer.loadPlugins(CraftServer.java:423) ~[paper-1.19.2.jar:git-Paper-307]
    at net.minecraft.server.dedicated.DedicatedServer.initServer(DedicatedServer.java:278) ~[paper-1.19.2.jar:git-Paper-307]
    at net.minecraft.server.MinecraftServer.runServer(MinecraftServer.java:1100) ~[paper-1.19.2.jar:git-Paper-307]
    at net.minecraft.server.MinecraftServer.lambda$spin$0(MinecraftServer.java:305) ~[paper-1.19.2.jar:git-Paper-307]
    at java.lang.Thread.run(Thread.java:833) ~[?:?]
Caused by: java.lang.ClassNotFoundException: GravePlugin
    at org.bukkit.plugin.java.PluginClassLoader.loadClass0(PluginClassLoader.java:177) ~[paper-api-1.19.2-R0.1-SNAPSHOT.jar:?]
    at org.bukkit.plugin.java.PluginClassLoader.loadClass(PluginClassLoader.java:124) ~[paper-api-1.19.2-R0.1-SNAPSHOT.jar:?]
    at java.lang.ClassLoader.loadClass(ClassLoader.java:520) ~[?:?]
    at java.lang.Class.forName0(Native Method) ~[?:?]
    at java.lang.Class.forName(Class.java:467) ~[?:?]
    at org.bukkit.plugin.java.PluginClassLoader.<init>(PluginClassLoader.java:71) ~[paper-api-1.19.2-R0.1-SNAPSHOT.jar:?]
    ... 8 more

内容的提问来源于stack exchange，提问作者gyu29