plurra plurra

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.

Start a server

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

  1. 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.

  2. 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.

  3. Restart

    Press Restart. Paper loads plugins at startup. Better skip the reload command, many plugins don’t handle it well.

  4. Check

    Type plugins in 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