Skip to content
Documentation

Runtime validation

Common plugin-load errors

What the typical messages mean.

  • “Could not load plugin”, “Invalid plugin.yml”: the descriptor is missing a required field or is not valid YAML.
  • “Main class … not found”: the main entry in the descriptor does not match the class in the .jar.
  • “Unknown dependency” or “Plugin … requires …”: the plugin needs another plugin (depend) that is not on the server. The test server only has what the project declares.
  • “UnsupportedClassVersionError”: the plugin was compiled for a newer Java than the server runs.
  • “NoClassDefFoundError”: a library is used at runtime but is not included or shaded into the .jar.
  • An exception with a stack trace in onEnable: a bug in the plugin’s startup code; the stack trace names the class and line.
NextFix with AI after a failed test