How do I install a plugin on my Minecraft server?
How to install a plugin on your Minecraft server with Paper, Purpur or Spigot: download it, upload it to the plugins folder and restart.
By Yvan Watchman Updated
You install a plugin by putting its .jar file in your server's plugins folder and restarting the server. This works on Paper, Purpur, Spigot and Bukkit. Plugins do not work on Vanilla, Fabric or Forge.
What you need
- A server running Paper, Purpur or Spigot. The console shows which one at the top during startup. To switch, see How do I change the version of my Minecraft server?
- A plugin made for your Minecraft version. You can find plugins on Hangar, Modrinth and SpigotMC.
Install a plugin
- Download the plugin. Mind the version: pick one that matches your Minecraft version.
- Log in to the game panel and open your server.
- Go to Files and open the
pluginsfolder. - Click Upload and choose the
.jarfile. Several plugins at once is easier with SFTP.
- Restart your server with Restart in the console.
Note
Do not use /reload to load plugins. It often causes errors; always restart the server.
Check
Type in the console:
plugins
It lists every loaded plugin. A green name means the plugin works; a red name means it did not load properly. Then look in the console for an error with the plugin's name.
Configure the plugin
After the first start, a plugin usually creates its own folder in plugins with a config.yml. You can open and edit it in Files. Restart your server afterwards.
Remove a plugin
Stop your server, delete the .jar file from plugins and start the server. You can also delete the plugin's settings folder if you no longer need it.
Related
Did this article help you?
Related articles
How do I install mods on my Minecraft server?
How to install mods on your Minecraft server: switch your server to Fabric in the client portal, add Fabric API and upload your mods.
How do I install a modpack on my Minecraft server?
How to put a modpack on your Minecraft server with the modpack installer in the game panel: CurseForge, Modrinth, Feed The Beast and more.
How do I change the version of my Minecraft server?
How to switch Minecraft version or server type through the Reinstall tab in the client portal. Your world and plugins stay in place.
Why can't I connect to my Minecraft server?
Cannot connect to your Minecraft server? Go through the most common causes: server off, wrong address, different version, whitelist or mods.