NEW 📢 Black Friday: our launch offer ends 30 Nov. Up to 70% off your first month on every game!See plans
Black FridayUp to 70% off your first month, ends 30 NovEnds in 9d 01h 40mBlack FridayUp to 70% off your first month, ends 30 NovEnds in 9d 01h 40mBlack FridayUp to 70% off your first month, ends 30 NovEnds in 9d 01h 40m

How to install plugins on Paper, Spigot and Purpur

MinecraftUpdated Oct 28, 20266 min read

Open the Modding tab, stay on Plugins, search for the plugin and click Install. The panel picks the newest build for your Minecraft version and puts it in the plugins folder. Then restart the server, because plugins are only read when it starts.

Plugins run on the server only, so your players join with the normal game and install nothing. They work on Paper, Purpur, Spigot and Folia, and on the hybrids Magma, Ketting and Mohist. A Fabric, Forge or NeoForge server needs mods instead: see How to install mods on Forge, Fabric and NeoForge.

Plugins have full access to your server. Install only plugins you trust, and take a backup first. See How to create, download and restore backups.

Install a plugin

  1. Open your server in the panel and click the Modding tab. Plugins opens on Browse.
  2. Type the plugin's name in Search plugins. The panel searches several catalogues at once. To search one, pick it under Source: Modrinth, CurseForge, Hangar or SpigotMC.
  3. Check the row. A plugin that cannot run on your server says Won’t run here and gives the reason under its name. Click the name to read the details first if you like.
  4. Click Install. The button says Installing… for a moment.
  5. If the plugin needs other plugins, a window titled Install and the plugin's name opens. It lists each one with required by and the plugin's name, and says the extra plugin is installed with it, because the plugin will not load without it. Click Install 2 files (the number counts every file).
  6. The panel says <name> is being installed. It will appear under Installed once the server has it.
  7. Restart the server. The panel does not restart it after an install. See How to start, stop, restart and force-stop your server.

You need permission to create files to install. Only Modrinth and CurseForge publish what a plugin needs, so for a plugin from Hangar or SpigotMC, read its page for anything it depends on and install that too.

Which build is installed

Install takes the newest stable build for your server's Minecraft version and its type, so you are not asked to choose. If the plugin has no build listed for your exact version, the panel takes the closest older one, which usually still works for plugins. If only a beta or development build fits, the message says so: No release of <name> supports this server yet, so the newest beta build, <version>, was chosen.

SpigotMC offers only its latest file. To pick another build from Modrinth, CurseForge or Hangar, install the plugin, then use Choose a version on its row: see How to update plugins and mods on your Minecraft server.

What each server type accepts:

  • Paper runs plugins made for Paper, Spigot or Bukkit.
  • Purpur runs those and plugins made for Purpur.
  • Spigot runs plugins made for Spigot or Bukkit. A plugin listed only for Paper says Won’t run here on Spigot.
  • Folia lets you install plugins listed for Folia, Paper, Spigot or Bukkit, but the panel describes Folia as a type on which most plugins do not work. Install only plugins whose page says they support Folia.

Check that it loaded

  1. After the restart, open the Console and watch the start. Lines about the plugin, and any errors that name it, appear there.
  2. When the server is online, type plugins in the Console and press Enter. It lists the plugins the server loaded.
  3. Open Modding, Plugins, Installed. The plugin is listed with its version.

If the plugin is missing or the Console shows an error with its name, it may be made for another Minecraft version or need another plugin. If the server stops, the Why your server stopped card on Overview names the cause. See How to see why your Minecraft server stopped and A Minecraft plugin needs another plugin that is not installed.

Change its settings

Most plugins write a folder with their settings the first time they start. Open the plugin's menu on the Installed list and choose Edit its settings. See How to edit plugin and mod settings on your Minecraft server.

Good to know

Already hosting it somewhere else? Move your server to us

OUR LATEST BLOGS