Installing Minecraft plugins: how it works on Paper
A plugin is a single .jar file that gives your server new commands and features: homes, protected areas, ranks, an economy. It is installed in a few minutes, and your friends don’t have to download anything for it.
First: is your server running Paper?
Plugins only run on Paper. Vanilla has no plugins, NeoForge takes mods instead of plugins (see NeoForge server). The dashboard shows which software your server runs. You can switch under Settings, but that deletes the world, so download it first.
Plugins for Bukkit and Spigot usually run on Paper too, Paper is built on top of them.
In four steps
-
Get the right release
Download the file for your Minecraft version from the plugin’s page. Good sources are Hangar (the directory run by the Paper team), Modrinth and SpigotMC. No re-uploads from random sites.
-
Upload to the plugins folder
Dashboard → Files → open the plugins folder → Upload. Upload the .jar file itself, not the zip it came in: the file browser can’t unpack archives. Up to 100 MB per file.
-
Restart
Press Restart. Paper loads plugins at startup. Better skip the
reloadcommand, many plugins don’t handle it well. -
Check
Type
pluginsin the console. Green means the plugin is running. Red means it failed at startup, and the reason is further up in the console.
Changing settings
On first start, almost every plugin creates its own folder under plugins, usually with a config.yml. Open it in the file browser’s editor, change it, save and restart.
In YAML files every space at the start of a line counts. Indent with spaces, never with tabs, or the plugin won’t load its settings and reports an error in the console.
With 2 GB, less is more
Every plugin needs memory and CPU time, some hardly any, some a lot. Permissions, homes, spawn protection, a chat plugin: a 2 GB server carries that well. Plugins that pre-compute the whole world or keep loading chunks can max it out on their own.
Keep an eye on memory and CPU in the dashboard after installing something new. If the curve climbs and stays up, the new plugin is usually why.
Updates and removal
- Plugins don’t update themselves. Upload the new .jar, delete the old one, restart. If two releases sit in the folder, Paper loads only one, and not necessarily the new one.
- Create a backup before a bigger update (Backups tab). There is one per server, delete the old one first.
- Removing: delete the .jar in the plugins folder, restart. The folder with its settings can stay or go.
- After switching Minecraft versions, many plugins no longer fit. Check first whether there is a release for the new version.
What is not allowed
Plugins from shady sources are a known way for malware to get onto Minecraft servers. We scan uploaded files for known malware and otherwise stay out of it. Cracked paid plugins are forbidden by § 9 of the terms, and so is anything that turns off account checks.
Questions
- Do my friends have to install the plugins too?
- No. Plugins only run on the server. Mods are different, everyone needs those themselves.
- Do plugins work on Vanilla or NeoForge?
- No, only on Paper. NeoForge takes mods.
- Why is my plugin red in the list?
- Usually it doesn’t match the Minecraft version, or it is missing another plugin it depends on. The console says what is missing at startup.
- How many plugins can the server handle?
- There is no fixed number. The limits are 2 GB of RAM and 5 GB of disk.
Build your server.
Pick Paper, upload plugins, restart. It costs nothing.
Start a server