How to Install Plugins on a Minecraft Server (Paper, Spigot, Purpur)
How to install Minecraft plugins on a Paper, Spigot or Purpur server: safe downloads, versions and dependencies, the plugins folder, updates and errors.

Contents
- Plugins vs mods
- Check your server software and version
- Where to download plugins safely
- Match the version and check dependencies
- Installing a plugin step by step
- Check that the plugin is running
- Configuring a plugin
- Updating plugins
- Removing a plugin
- Popular plugins to start with
- Common errors
- Too many plugins and performance
- A Minecraft server at Nodesty
Once you know how to install Minecraft plugins, a plain survival world turns into a server with ranks, homes, protected areas and an economy. The installation itself is short: you download a .jar file, put it in the server's plugins folder and restart. Most problems come from what happens around it: the wrong server software, a plugin built for another Minecraft version or a missing dependency.
This guide covers the difference between plugins and mods, checking your server software and version, safe download sources, installing, configuring, updating and removing plugins, a short list of plugins to start with and the most common errors. If you haven't set up a server yet, start with our How to make a Minecraft server guide.
Plugins vs mods
The two words are often mixed up, but they are different systems:
| Plugins | Mods | |
|---|---|---|
| Server software | Paper, Spigot, Purpur | Forge, NeoForge, Fabric |
| Installed | Only on the server, in the plugins folder | On the server and usually on every client |
| Players need | A normal, unmodified Minecraft client | The same mods or modpack |
| Typical use | Ranks, economy, protection, admin tools | New blocks, items, mobs and dimensions |
Plugins change how the server behaves without changing the game files, which is why anyone with a normal client can join. The vanilla server from Mojang doesn't load plugins, and neither do Forge and Fabric servers. If you want to play a modpack, follow our Minecraft modpack server guide instead.
Check your server software and version
Before you download anything, find out what your server runs. Type this in the server console (in game, add a slash: /version):
version
A plugin-capable server answers with the name of the software, such as Paper, Spigot or Purpur, and the Minecraft version. Note both. If the answer doesn't name one of them and there is no plugins folder in the server directory, the server can't load plugins.
- Paper runs plugins written for Bukkit, Spigot and Paper. It's the best choice for most servers.
- Purpur is built on Paper and runs the same plugins.
- Spigot runs Bukkit and Spigot plugins, but not plugins that need the Paper API.
To switch from vanilla, download the Paper jar for your Minecraft version from papermc.io, back up your world and use that jar instead of the old server jar.
Where to download plugins safely
A plugin is a program that runs with the same rights as your server: it can read your files, run console commands and give anyone OP. Download only from sources where the author publishes the plugin:
- Modrinth (modrinth.com/plugins): lets you filter by platform and Minecraft version.
- Hangar (hangar.papermc.io): the plugin repository of the PaperMC project.
- SpigotMC (spigotmc.org/resources): the oldest and largest catalog, including paid (premium) plugins.
- The project's own site or GitHub releases: LuckPerms, EssentialsX and Geyser, for example, publish builds on their own sites.
Stay away from leaked or "nulled" premium plugins. Free copies of paid plugins from leak sites, Discord servers or video descriptions are a common way to spread malware: the jar is repacked with a backdoor that gives a stranger OP, steals your files or uses your server for attacks. You also get no updates and no support. If a paid plugin is outside your budget, look for a free alternative on the platforms above.
On any platform, check the date of the last update, the number of downloads and the reviews before you install.
Match the version and check dependencies
On the plugin's download page, check three things:
- Minecraft version. Pick the file that lists your server's version. Plugins that only use the official API often keep working on newer versions, but plugins that hook into the server's internals need a build made for your exact version.
- Platform. Many projects offer separate files for Paper, Velocity, BungeeCord or even Fabric. On a Paper, Spigot or Purpur server, take the file marked Paper, Spigot or Bukkit. Proxy files belong on the proxy, which we cover in our Minecraft Velocity network guide.
- Dependencies. Some plugins only work when another plugin is installed. Common ones are Vault (a bridge between economy, permission and chat plugins), ProtocolLib (access to network packets) and PlaceholderAPI (placeholders such as a player's rank or balance in texts). Required dependencies must be in the
pluginsfolder too; optional ones only unlock extra features.
Installing a plugin step by step
A plugin is loaded only when the server starts, so every installation ends with a restart.
- Stop the server with
stopin the console. You can also upload a new plugin while the server is running and restart afterwards, but never overwrite the jar of a plugin that is currently loaded. - Upload the
.jarfile to thepluginsfolder. Use the file manager of your panel or an SFTP program such as FileZilla or WinSCP; our FTP vs SFTP guide shows how to connect. From a terminal,scpdoes the same (adjust the path to your server folder):scp ExamplePlugin-1.0.jar minecraft@203.0.113.10:~/server/plugins/ - Check the file. It must end in
.jarand sit directly inplugins, not in a subfolder. If the download is a.zip, extract it and upload the jar inside. - Start the server. On first start, most plugins create their own folder,
plugins/<PluginName>, with their configuration files.
Check that the plugin is running
List the plugins in the console (or with /plugins in game):
plugins
- Green means the plugin is enabled.
- Red means it was found but couldn't be enabled.
- If the plugin isn't in the list at all, the server couldn't load the file.
Recent Paper versions split the list into Paper plugins and Bukkit plugins; that's normal. version PluginName shows which version of a plugin is installed.
For red or missing plugins, the reason is in the console and in logs/latest.log. On Linux, you can search the log from the server folder:
grep -iE "error|exception|could not load" logs/latest.log
Read the first error that mentions the plugin; it usually names the cause in plain words.
Configuring a plugin
Settings live in plugins/<PluginName>/config.yml; larger plugins add more files next to it. These are YAML files, and YAML is strict about formatting:
settings:
teleport-delay: 3
join-message: '&eWelcome to the server!'
- Indent with spaces, never with tabs, and keep the indentation of the lines around your change.
- Put text that contains characters such as
&,:or#in quotes.
A broken file makes the plugin fail at startup or fall back to its defaults, so keep a copy before larger edits.
To apply changes, restart the server. Many plugins also have their own reload command, such as /essentials reload or /wg reload, which is fine for small changes. Don't use the general /reload command: it reloads every plugin while the server is running, which can cause memory leaks, duplicated tasks and broken data. Paper prints a warning and asks for confirmation for exactly this reason.
Updating plugins
- Read the plugin's changelog; it tells you whether the new version changes the configuration or needs a newer server.
- Stop the server.
- Back up the
pluginsfolder:tar -czf ~/plugins-backup-$(date +%F).tar.gz -C ~/server plugins - Delete the old jar and upload the new one. Leave the
plugins/<PluginName>folder as it is; your settings and data are in it. - Start the server and check
pluginsand the log.
Before you move the server to a new Minecraft version, check that every plugin you rely on already supports it, then update the server software first and the plugins right after. Backups kept away from the server are covered in our Server backups guide.
Removing a plugin
Stop the server and delete the plugin's jar from plugins. The plugin's folder stays behind with its settings and data; delete it only if you're sure you won't need them again. Before removing a library such as Vault or ProtocolLib, make sure no other plugin depends on it, or those plugins will stop loading at the next start.
Popular plugins to start with
| Plugin | What it does |
|---|---|
| EssentialsX | Basic commands such as /home, /spawn and /tpa, plus kits and warps |
| LuckPerms | Groups, ranks and permissions |
| Vault | Connects economy, permission and chat plugins; required by many plugins |
| WorldEdit | Edits large areas in game: copy, paste, fill and replace |
| WorldGuard | Protects regions such as spawn; requires WorldEdit |
| CoreProtect | Logs block changes and rolls back griefing |
| Geyser + Floodgate | Lets Bedrock players join a Java server; Floodgate removes the need for a Java account |
Vault doesn't provide an economy by itself; it needs an economy plugin such as EssentialsX. Setting up ranks is explained in our LuckPerms guide, and the built-in admin commands in our Minecraft server commands guide.
Common errors
- Wrong server software: A Forge or Fabric mod, or a Velocity or BungeeCord plugin, in the
pluginsfolder of a Paper server isn't loaded; the console reports that the jar doesn't contain aplugin.yml. - Version mismatch: The plugin was built for another Minecraft version. It stays red, or it loads and throws errors when players use it. Download the build for your version or look for an updated fork.
- Missing dependency: The log shows
UnknownDependencyExceptiontogether with the name of the missing plugin. Install it and restart. UnsupportedClassVersionError: The plugin was compiled for a newer Java version than the one your server runs on. Class file version 65 means Java 21 and 61 means Java 17. Install the Java version the plugin asks for, provided your Minecraft version supports it, and make sure the start script uses it.- Duplicated jars: Two versions of the same plugin in the folder, for example after an update. The console warns about an ambiguous plugin name, and you can't be sure which one loads. Delete the old file.
- Broken configuration: After an edit, the plugin fails with a YAML error that names the line. Fix the indentation or restore your copy.
Too many plugins and performance
Every plugin adds work to each server tick, and a single badly written one can slow down the whole server. Install only what you actually use, and avoid plugins that do the same job twice, such as two economy or two teleport plugins.
To find out which plugin costs the most, measure it. Paper has shipped with the spark profiler built in since version 1.21, where it replaced the older Timings system:
/spark profiler start
/spark profiler stop
Let the profiler run for a few minutes while the server is busy; after the stop command, spark prints a link to a report that shows how much tick time each plugin takes. On Spigot and on older Paper versions, use /timings on followed by /timings paste after a few minutes, or install spark as a plugin. The next steps are in our Minecraft server lag guide.
A Minecraft server at Nodesty
Nodesty Minecraft server hosting plans run in Frankfurt on an AMD Ryzen 9 9950X processor reaching 5.7 GHz, with NVMe storage and DDoS protection. You can start with Paper in minutes, upload your plugins to the plugins folder and manage the server with full admin access. Daily backups on game servers are free and kept for 7 days, so a plugin update that goes wrong doesn't cost you your world.
Minecraft is a trademark of Mojang AB. Nodesty is not affiliated with or endorsed by Mojang or Microsoft.
Frequently Asked Questions
Can I install plugins on a vanilla Minecraft server?
No. The official server file from Mojang does not load plugins. You need Bukkit-compatible server software such as Paper, Spigot or Purpur. Switching is simple, because you replace the server jar with the Paper jar for the same Minecraft version and keep your world. Back up the world folder before you switch.
Do players have to install anything to join a server with plugins?
No. Plugins run only on the server, so players join with a normal, unmodified Minecraft client of a supported version. This is the main difference from mods, which usually have to be installed on every player's computer as well.
Can I use plugins and mods on the same server?
Not directly. Plugins need Paper, Spigot or Purpur, while mods need Forge, NeoForge or Fabric, and the two systems do not load each other's files. Hybrid server software that tries to combine both exists, but it often causes compatibility problems, so we do not recommend it for a first server.
Why is my plugin red in the plugins list?
Red means the plugin was found but could not be enabled. The usual causes are a missing dependency such as Vault, a plugin build for a different Minecraft version or a Java version that is too old. Open logs/latest.log and read the first error that mentions the plugin name, as it normally states the reason.
Is it safe to use the reload command after adding a plugin?
No. The reload command unloads and reloads every plugin while the server keeps running, which many plugins are not built for. It can cause memory leaks, duplicated tasks and broken data, and Paper itself warns against it. Restart the server instead.
Will I lose my settings when I update a plugin?
No, as long as you only replace the jar file. Settings and data live in the plugin's own folder inside the plugins folder and stay there. Still back up the plugins folder before an update, because a new major version can change the format of its configuration or data.
About the author
Nodesty Team · Infrastructure & Support
The Nodesty team runs our servers, network and DDoS protection day to day and answers customer support requests around the clock. These guides come from that work.
Related articles

Minecraft server.properties Explained: The Key Settings
Minecraft server.properties explained: where the file is, how to edit it safely and what to set for gameplay, world, whitelist, network and performance.

LuckPerms Guide: Ranks and Permissions on a Minecraft Server
A LuckPerms guide for Paper servers: installation, groups and inheritance, prefixes, temporary ranks, promotion tracks, the web editor and storage options.

How to Connect a Domain to a Minecraft Server: A and SRV Records
Minecraft server domain setup: an A record for play.example.com, an SRV record for a custom port, Cloudflare DNS only, Bedrock ports and checks with dig.