DocumentationNextFix with AI after a failed test
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.
