ACLClouds
ACLClouds

A Minecraft plugin is incompatible or prevents startup

Identify the Java version, the server API and the dependency that the failing plugin is missing.

A Paper or Spigot plugin is not automatically compatible with all versions of Minecraft. The logs often show the missing API, Java, or dependency.

Step-by-step procedure

  1. Spot the first ERROR

    Go back to the first error that mentions the plugin name, not just the last cascading exception.

  2. Check the server software

    A Bukkit plugin requires Paper, Purpur or Spigot; it does not load on Vanilla, Forge or Fabric.

  3. Compare the versions

    Check the Minecraft version, the required Java version and the plugin’s official page.

  4. Install the dependencies

    Add Vault, ProtocolLib or the required API only from their official source, then restart the server.