Migration Guides

The API has grown additively since 0.1. To upgrade, update the API and runtime JARs together, and rebuild your plugin against the matching dev.zernyth:api version.

To 0.8

Player views are stricter. After a new session with the same UUID, old views are invalid, and reads can throw IllegalStateException. Store the UUID and resolve a new Player. Java signatures did not change. Stricter configuration limits can reject oversized data that was accepted before.

To 0.7

TypedCommand, Component and EventView were added. CommandDefinition keeps working. For code that was ported from other platforms, PlayerAdapter in dev.zernyth.api.compat covers common player operations.

To 0.5

plugin.yml gained imports, exports and libraries, and lists may use block style. Remove any bundled copy of the Zernyth API from your JAR.

From Java versions below 25

Java 25 is required. Set your toolchain and release to 25. See Java 25 Setup.