Documentation Menu

Installing plugins (Paper / Purpur)

Drop a .jar in /plugins, restart. That's it.

If you're on Paper or Purpur (or older Spigot), plugins are .jar files that live in the /plugins/ folder.

Installing one

  1. Get the plugin .jar from the developer's site or a hub like Modrinth, Hangar, or SpigotMC. Check the version — must match your Minecraft version.
  2. In the panel → Files → open /plugins/.
  3. Upload the .jar (drag-and-drop or Upload button).
  4. Restart the server (/stop in console, then Start button).
  5. Watch the console — successful plugins log [Plugin] Enabled.

Configuring

Most plugins create a folder under /plugins/<PluginName>/ on first run, with a config.yml you can edit:

  1. Stop the server.
  2. Open the config file in the file manager.
  3. Edit, save.
  4. Start.

Some plugins support /<plugin> reload in console for hot-reload — check the plugin's docs.

Updating

  1. Stop the server.
  2. Replace the old .jar with the new one (delete the old, upload new).
  3. Start.

Some plugins migrate their config automatically. Some require you to merge changes manually. Read the changelog.

Common useful plugins

  • EssentialsX — homes, warps, kits, chat formatting
  • LuckPerms — permissions
  • Vault — economy + permissions API for other plugins
  • WorldEdit — building tool
  • WorldGuard — region protection
  • CoreProtect — block/inventory rollback logs
  • DiscordSRV — Discord ↔ in-game chat bridge
  • dynmap / BlueMap — web map of your world

When a plugin breaks the server

Symptom: server crashes on startup with the plugin in /plugins/.

Fix:

  1. Stop the server.
  2. Remove (or rename to .jar.disabled) the offending plugin.
  3. Start.
  4. Check the plugin's docs for compatibility with your Minecraft + server type + other plugins.