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
- Open your server in the panel and click the Modding tab. Plugins opens on Browse.
- 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.
- 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.
- Click Install. The button says Installing… for a moment.
- If the plugin needs other plugins, a window titled Install and the plugin's name opens. It lists each one with
required byand the plugin's name, and says the extra pluginis installed with it, because the plugin will not load without it.Click Install 2 files (the number counts every file). - The panel says
<name> is being installed. It will appear under Installed once the server has it. - 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
- After the restart, open the Console and watch the start. Lines about the plugin, and any errors that name it, appear there.
- When the server is online, type
pluginsin the Console and press Enter. It lists the plugins the server loaded. - 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
- A plugin from another site, or one you bought, goes in by upload: How to upload your own plugins or mods to your Minecraft server.
- Update, switch off or remove a plugin: How to update plugins and mods on your Minecraft server and How to switch off or uninstall a plugin or mod on your Minecraft server.
- If Install is refused: A plugin or mod will not install on your Minecraft server.
- Guides for popular plugins: LuckPerms, EssentialsX, WorldEdit, WorldGuard, CoreProtect, Multiverse and ViaVersion.
- Plugins and lag: How to reduce lag on your Minecraft server.



