How to Install Minecraft Plugins on Paper and Purpur Servers

Paper / Purpur / Spigot

Before You Start

A Minecraft plugin is a server-side `.jar` file that runs on a plugin server such as Paper, Purpur, Spigot or Bukkit. Plugins can add commands, economy systems, moderation tools, scoreboards, gameplay rules, events and admin utilities without asking players to install a mod on their own computer.

Most plugin problems happen because the server type or Minecraft version does not match what the plugin expects. Check the plugin page first, keep a backup, and install one new plugin at a time when testing a production server.

Install Steps

1. Download the plugin .jar file. Use the project page or the direct download link for the plugin you want.
2. Stop the server. A clean stop avoids partial loading and broken plugin folders.
3. Upload the .jar into the /plugins folder. Do not place it in the world folder or the server root unless the plugin instructions say so.
4. Restart the server. A full restart is safer than a reload, especially for larger plugins.
5. Check the console for errors. Look for dependency warnings, unsupported version messages or startup failures.
6. Run /plugins in game or server console. Confirm the plugin appears and is enabled.
7. Configure config.yml if the plugin creates one. Stop the server before editing large config changes, then restart again.

Common Plugin Install Problems

• The plugin targets a different Minecraft version.
• The plugin needs dependencies such as Vault, PlaceholderAPI, ProtocolLib or another library.
• The server is Vanilla instead of Paper, Purpur, Spigot or Bukkit.
• The file was uploaded into the wrong folder.
• The server was reloaded instead of fully restarted.