Step-by-step guide
How to install a plugin on a Minecraft server
Download the plugin's .jar file, drop it into your server's plugins folder, then restart the server. With a host that gives you file access, such as Apex or BisectHosting, upload the .jar through the file manager instead. Aternos only installs plugins from its own catalogue, so a .jar built by Minax will not go on it. Confirm it works by running its commands or checking the console for a startup line.
Installing a Minecraft plugin takes a few steps, and they are always the same. This guide covers local servers (PaperMC, Spigot, Bukkit), hosts that give you file access (Apex, BisectHosting, OMGServ), and what Aternos accepts or refuses.
- .jar plugins only: mods (Forge/Fabric) work differently
- Compatible with Paper, Spigot, Bukkit and their forks
- No command line required
- Local servers, or hosts that accept your own plugins
Step 1: Confirm your server supports plugins
Plugins only work on Bukkit-API servers: Paper, Spigot, Bukkit, Purpur, Folia. If you run vanilla, Forge or Fabric, you need mods (which go in /mods), not plugins.
Step 2: Download the .jar
Download directly from Minax (Download button on the plugin page) or from SpigotMC / Modrinth / GitHub. Check the announced Minecraft version, a 1.21 Paper plugin won't load on 1.8.
Step 3: Place the file
On a local server: drop the .jar into the plugins/ folder. Launch the server once if the folder does not exist yet.
With a host that gives you file access (Apex, BisectHosting, OMGServ and many others): use the panel file manager or an FTP client like FileZilla. The path is usually /plugins.
Aternos is different: it only installs plugins from its own catalogue and refuses the ones you upload yourself, so a plugin built by Minax will not go on it. For your own plugin, use your PC, a host that gives you file access, or exaroton, the paid service from the Aternos team, which accepts it.
Step 4: Restart
Avoid /reload for this: it often destabilizes plugins already running (orphaned tasks, memory leaks, inconsistent state). Stop the server completely, start it again, check the console for [MyPlugin] Enabled.
Troubleshooting
When loading fails, the console almost always tells you why:
- Could not load 'plugins/X.jar': wrong Minecraft / Java version
- UnsupportedClassVersionError: Java too old (Java 21 for 1.21, Java 25 for 26.x)
- Plugin already initialized: duplicate plugin name, remove one
- NoClassDefFoundError: missing dependency (Vault, PlaceholderAPI…)
Frequently asked questions
How many plugins can I run on a Minecraft server?
Technically hundreds. In practice, 20-50 well-chosen plugins run smoothly on Paper. Watch TPS via /tps.
How do I cleanly remove a plugin?
Stop the server, delete the .jar from plugins/, optionally delete plugins/MyPlugin/, then restart.
Can I install plugins on Aternos?
Only the ones from its own catalogue. Aternos refuses plugins you upload yourself, for security reasons, so a plugin built by Minax will not go on it. For your own plugin you need your PC, a host that gives you access to the server files, or exaroton, the paid service from the Aternos team, which accepts it.
My plugin needs Vault or PlaceholderAPI, where do I get them?
Both are free plugins on SpigotMC. Install them the same way before the plugin that depends on them.
Ready to build your Minecraft plugin?
Describe it in plain English, get a compiled .jar. No Java required. Your account is free. Credits paid once, no subscription: 50 credits for €17.99 VAT included.
Find a plugin