Troubleshooting
| Symptom | Likely cause and fix |
|---|---|
| The SDK artifact cannot be found | Build it first with :api:publishApiPublicationToSdkRepository. |
| Temurin cannot be found | Select the installed JDK, or pass -PzernythJavaVendor=any for a local check. |
UnsupportedClassVersionError | The runtime must be Java 25 or newer. |
ClassNotFoundException | Declare the local library or the import in plugin.yml. |
| Plugin rejected for duplicate API classes | Use compileOnly or provided, and do not shade the API. |
| Plugin rejected for its name | Use lowercase letters, digits and underscores. Names starting with endstone are reserved, as are minecraft and mojang. |
| Unsupported metadata key | Remove keys from plugin.yml that are not listed in Plugin Lifecycle. |
IllegalStateException from a game object | The call came from a worker thread, or the view is stale or belongs to a disabled plugin. |
TaskRejectedException | The runtime is at capacity or the plugin is disabling. Handle it explicitly. |
| No Java plugins load at all | Check ZERNYTH_JAVA_ENABLED, ZERNYTH_JVM_LIBRARY and ZERNYTH_JAVA_CLASSPATH, then restart the process. |
Still stuck? Ask in the community forum.