☰

Paper API Mismatch

A plugin will not enable because it targets a different Paper/Bukkit API version than your server runs. The plugin needs updating to match your server, or vice versa.

What does this error mean?
Plugins declare an api-version they were built for. 'Unsupported API version' means the plugin was compiled against an API your server does not provide, commonly an old plugin on a new server or a plugin built for a newer API than you run. 
Unsupported API version
Most Common Causes
  • An outdated plugin not updated for your server version.
  • A plugin built for a newer Paper API than installed.
  • Running a server version older than the plugin supports.
  • A legacy plugin relying on removed API.
  • Mixing plugins meant for different server generations.
How To Diagnose
  1. Note the plugin name and the API version in the error.
  2. Check the plugin's listed supported versions.
  3. Compare against your actual server version.
  4. Look for an updated build of the plugin.
Recommended Fixes
  • Update the plugin
    Install a build that supports your server's API version.
  • Match the server version
    If the plugin is essential and newer, update the server to a supported version.
  • Replace legacy plugins
    Swap abandoned plugins for maintained alternatives.
  • Check compatibility first
    Confirm a plugin lists your version before installing it.
Analyze My Log
Frequently Asked Questions

A field in plugin.yml stating which server API generation the plugin was built against.

Sometimes it loads but may break, updating the plugin is the safe fix.

Run '/version' in the console, it reports the exact build.