How to install plugins on your Paper, Spigot, or Purpur Minecraft server

Plugins are how you extend a Paper, Spigot, or Purpur server with new commands, mini-games, world generation, anti-grief tools, economy systems, and almost anything else you can think of. The install process is the same across all three: drop a .jar into the plugins/ folder, restart the server, and configure it. This guide walks through the workflow on ServerPrism and points out the pitfalls that trip new server owners up.

Make sure your server can run plugins

Plugins only work on server software that implements the Bukkit API. That includes Paper, Spigot, Purpur, and Folia — but not vanilla Minecraft, Forge, NeoForge, or Fabric. Those mod-loader servers use mods (.jar files in mods/), which is a different system.

On ServerPrism, open your server's Startup tab in the dashboard and confirm the Server Jar line reads something like paper-X.X.jar, spigot-X.X.jar, or purpur-X.X.jar. If you see vanilla, forge, or fabric instead, plugins won't load — you'd need to reinstall as Paper first (Settings → Reinstall after switching the egg).

Also check that the plugin you want supports your exact Minecraft version. A plugin built for 1.20 will not always work on 1.21.

Find a plugin

These are the main places to look:

• Modrinth — clean UI, version filtering, the modern default.
• Hangar — the official PaperMC repository.
• SpigotMC — the largest catalog, but quality varies. Read the reviews.
• BukkitDev — older, but still hosts plugins not republished elsewhere.

On each site, filter by your Minecraft version and download the .jar (or .zip if it ships configs — extract first, you want the .jar).

Upload and load the plugin

1. Log in to your ServerPrism dashboard and open your server.
2. Click File Manager in the sidebar.
3. Open the plugins/ folder.
4. Drag the .jar into the folder, or click Upload.
5. Restart the server from the Console tab. Plugins are only discovered at startup.

You can install several plugins at once — just drop multiple .jar files in before the restart.

Verify it loaded

After the server boots, run /plugins in the in-game chat or the dashboard's Console tab. The plugin name should appear in green. If it's red, the plugin failed to load — open the latest log in logs/latest.log and look for the first ERROR line. It usually tells you whether you have the wrong version, a missing dependency, or an incompatible server type.

Configure it

Most plugins generate a config.yml inside plugins/<plugin-name>/ on first start. Edit it through the File Manager and restart the server for changes to take effect.

Some plugins support /reload <plugin-name> to apply changes without a full restart. Use it only when the plugin's own docs explicitly recommend it — reload is known to cause subtle bugs (broken event handlers, leaked tasks) on plugins that don't expect it.

Common issues

• Plugin doesn't show up in /plugins: server software isn't Bukkit-compatible (you have Forge/Fabric/vanilla), or the .jar is corrupt or incomplete — re-download it.
• UnsupportedClassVersionError in the console: the plugin was compiled for a newer Java version than your server is running. Check the plugin's required Java version and switch your server's Docker image in the Startup tab (java_17, java_21).
• NoClassDefFoundError: a dependency plugin is missing. Most plugins list their dependencies on their download page — install those too.
• Version mismatch warnings: a 1.20 plugin on 1.21 might "work" but break randomly. Use the version built for your Minecraft version.
• Server lags after install: some plugins are heavy. Disable them one at a time (move the .jar out of plugins/, restart) to find the culprit.

Popular plugins to start with

• LuckPerms — permissions and ranks, used by almost every server.
• EssentialsX — homes, warps, kits, economy basics. The classic toolbox.
• CoreProtect — block logging and rollback, lifesaver for griefing.
• WorldEdit + WorldGuard — region protection and bulk world editing.
• ViaVersion — lets players on older Minecraft clients join your newer server.

Next steps

Once you're comfortable installing plugins, set up a permissions system with LuckPerms, and get into the habit of backing up your plugins/ directory before adding anything new — a misconfigured plugin can wipe configs on shutdown. Backups are one click from the Backups tab in your dashboard.