How to update a Minecraft plugin to a newer version

Updated

First check for an update from the plugin's author. If there is none, AssetMC's free Version Converter changes the plugin's api-version and fixes renamed Spigot and Paper names inside the .jar, with no source code needed. Plugins that use NMS still need their author.

Steps

  1. Look for an official update

    Check the plugin's page for a newer release. An official update is always the safest fix.

  2. Open the Version Converter

    Drop the plugin's .jar into the converter.

  3. Pick the target version

    Choose the Minecraft version your server runs and convert.

  4. Test it

    Put the new .jar in plugins on a copy of your server and read the console for errors.

Tips

  • Keep the original .jar in case you need to go back.
  • Mods can be converted too: their version range, recipes, tags and loot tables.

Frequently asked questions

Why does my server say the plugin is incompatible?

Its api-version may not match the server, or it uses names that were renamed in newer versions, such as some potion, enchantment and attribute names.

Can every plugin be converted?

No. Plugins that use NMS (Minecraft's internal server code) change with each version and need an update from their author.