Fix Plugin and Mod Incompatibility Errors

Common Incompatibility Causes

• A plugin built for a different Minecraft version than the server is running
• A Paper/Bukkit/Spigot plugin installed on a Forge or Fabric server (or the reverse)
• A Fabric mod installed on a Forge server, or a Forge mod installed on Fabric
• Two plugins or mods that hook the same event or override the same block/item behavior
• A client-only mod uploaded to the server

Confirm the Server Software First

Plugins (Paper, Spigot, Bukkit, Folia) and mods (Forge, Fabric, NeoForge) are not interchangeable — installing one on the wrong platform will not load, or will crash the server on startup. Check the server’s software type before troubleshooting further. See Paper , Fabric or Forge if you are unsure which one you need.

Isolate the Conflicting Plugin or Mod

1. Open Console or Logs and read the first error, not the final shutdown line — it usually names the file that failed to load.
2. Confirm the plugin or mod page states support for the exact Minecraft version installed.
3. Remove the most recently added plugin or mod and restart to confirm whether it caused the failure.
4. Re-add content one item at a time so a future conflict is easy to identify.

Check Dependencies Before Reinstalling

Some plugins and mods require another library or API mod to be installed first. Review the project page for required dependencies and install them in the order listed. For the standard installation flow, see How to Install Plugins on a Paper Minecraft Server or How to Install a Modrinth Modpack .