ForgeWorld Gaming
Build your server

Hosting guide

How to install plugins on a Paper server

Paper plugin not loading? Start with the first error in logs/latest.log, then check the download, folder, dependencies and versions. This free checklist also covers a clean install. Last checked: 2026-10-04.

Updated 4 October 2026

See available Minecraft plans

Read the startup error before changing anything

Use the log from the restart that failed, not an older session. Search for the plugin's name near startup and read the first error plus its surrounding lines. Record the Paper version, plugin release and Java runtime used to launch the server. Change one thing at a time so you can tell what fixed it.

  • UnknownDependencyException
    The named required plugin is missing. Check the author's dependency list and install the supported dependency release.
  • InvalidDescriptionException or invalid plugin.yml
    Check that this is a Paper-compatible plugin, not a Forge or Fabric mod. Download it again from the project's trusted source if the file is incomplete.
  • Ambiguous plugin name
    Two releases of the same plugin may be installed. Keep one supported release; move the other JAR out while the server is stopped.
  • UnsupportedClassVersionError
    A class was compiled for a newer Java runtime. Check which class the error names and the runtime actually launching the server; this is different from a missing dependency.
  • Unsupported API version
    Check the plugin's supported server versions. A declared api-version newer than the server prevents loading; editing the declaration does not make incompatible code compatible.
  • Plugin name never appears
    Check the active server's working directory and the JAR placement below.

The PaperMC installation reference explains the dependency, description and duplicate-name errors. For Java failures, use PaperMC troubleshooting and the requirements for your Paper version, plus the plugin author's requirements. Do not assume one Java version fits every server release.

Check the file and the right plugins folder

Put the trusted, Paper-compatible .jar directly in the server's plugins directory, not inside a plugin-named subfolder. If the download is a ZIP, extract the intended plugin JAR first. A file ending in .jar can still be the wrong download: Forge and Fabric mods do not become Paper plugins by moving them here.

server-directory/
  paper.jar
  plugins/
    YourPlugin.jar

This is an example layout, not a filename requirement. Check the directory used by the running server, especially when you keep more than one test or production copy. Download from the project's official page or a trusted listing linked by its author; avoid random JAR attachments.

PaperMC links Hangar and Modrinth as places to find plugins. Check the project's loader, supported versions and author before installing; a repository listing alone is not a compatibility guarantee.

Install or replace it with a clean restart

  1. Stop the server cleanly and wait until it has exited. Save a backup of your worlds, configuration and existing plugin files before changing the installation. See the backup checklist.
  2. Confirm the plugin release supports your server software and Minecraft version, and check its required dependencies.
  3. While the server remains stopped, put the JAR in the top-level plugins folder; avoid leaving duplicate releases there.
  4. Start the server and read the new startup log. Use a full restart rather than /reload; /paper reload is for Paper configuration, not plugin installation.
  5. Run plugins in the server console or /plugins in-game with the necessary access. Green indicates enabled; red indicates disabled or a loading failure. Then test the feature you installed.

Check PaperMC's command reference for the status display and reload guidance, and its update guide before a larger upgrade. Keep a known working backup rather than deleting plugin settings as a first troubleshooting step.

For updates to an existing plugin, Paper also documents a plugins/update folder: put replacement JARs there, leave the running plugin JARs untouched and restart to apply them. Back up first and stay present to check the result. This update mechanism is separate from putting a first install directly in plugins.

Still stuck? Share a small, useful diagnostic

Give the plugin author or support team the exact plugin release, Paper version, Java runtime and first relevant startup error with nearby lines. Review that excerpt before posting it: redact passwords, tokens, connection credentials and private addresses or player details. Never post a whole configuration archive or a secret-bearing log just to ask for help.

If the error names another plugin, check that project's requirements too. Test suspected conflicts on a backup or separate test copy, keeping dependencies together. The official troubleshooting guide explains how to narrow plugin conflicts. A new hosting plan will not fix an incompatible JAR.

Planning a Paper server?

Compare Paper, Vanilla, Spigot and Purpur or check FWG's current Minecraft hosting details. Before ordering, confirm your intended plugins and setup with support; do not assume every third-party plugin or upload method is supported.

ForgeWorld Gaming current order availability: Minecraft (Paper, Vanilla and Forge) Standard: 8–56 player slots at CA$9.89–CA$69.23/month; Terraria Standard: 4–24 player slots at CA$8.99–CA$16.99/month; Valheim Standard: 3–10 player slots at CA$11.99–CA$17.99/month; Garry’s Mod Standard: 8–56 player slots at CA$9.89–CA$69.23/month; Factorio Standard: 8–24 player slots at CA$9.99–CA$13.99/month; Palworld Standard: 4–8 player slots at CA$12.99–CA$16.99/month; Enshrouded Standard: 4–6 player slots at CA$11.99–CA$13.99/month; Satisfactory Standard: 4–6 player slots at CA$14.99–CA$18.99/month; Conan Exiles Standard: 8 player slots at CA$15.99/month; 7 Days to Die Standard: 4–8 player slots at CA$10.99–CA$15.99/month; Rust Standard: 50 player slots at CA$19.99/month; Project Zomboid Standard: 8 player slots at CA$13.99/month; ARK Standard: 10 player slots at CA$19.99/month. Other game orders and other sizes and qualities are temporarily paused. Hosted in Chicago, Illinois, United States. Prices are in Canadian dollars, with no setup fee and cancel any time. Your server is set up automatically after payment. Check the current Minecraft availability, Terraria availability, Valheim availability, Garry’s Mod availability, Factorio availability, Palworld availability, Enshrouded availability, Satisfactory availability, Conan Exiles availability, 7 Days to Die availability, Rust availability, Project Zomboid availability and ARK availability, or browse game availability before planning a purchase.

Common questions

How do I install a Paper plugin for the first time?

Use a trusted Paper-compatible JAR, check its required dependencies and supported versions, put the file directly in the active server plugins folder while stopped, then start the server and check its log and plugins list.

Why is my Paper plugin not loading?

Read the first startup error in logs/latest.log. Check the intended JAR, top-level plugins folder, required dependencies and supported server versions before making one change and restarting.

What does UnknownDependencyException mean?

The plugin needs another plugin that is missing. Check the named dependency against the requirements from its author and install the supported release.

Is UnsupportedClassVersionError a missing plugin dependency?

No. It indicates a class compiled for a newer Java runtime. Check the class named in the error and the Java runtime launching the server against Paper and plugin requirements.

Can I use reload to install a Paper plugin?

Use a full server restart. Paper warns that reload can cause plugin problems; paper reload changes Paper configuration rather than installing plugins.

Can a Forge or Fabric mod run as a Paper plugin?

No. Use a Paper-compatible plugin from a trusted source. Renaming or moving a Forge or Fabric mod into the plugins folder does not make it compatible.

How do I check whether the plugin is enabled?

After startup, use plugins in the console or /plugins in-game with the necessary access. Green indicates enabled; red means disabled or a loading failure. Read the log and test the intended feature.

Sources

Check current order availability. Minecraft (Paper, Vanilla and Forge) Standard: 8–56 player slots at CA$9.89–CA$69.23/month; Terraria Standard: 4–24 player slots at CA$8.99–CA$16.99/month; Valheim Standard: 3–10 player slots at CA$11.99–CA$17.99/month; Garry’s Mod Standard: 8–56 player slots at CA$9.89–CA$69.23/month; Factorio Standard: 8–24 player slots at CA$9.99–CA$13.99/month; Palworld Standard: 4–8 player slots at CA$12.99–CA$16.99/month; Enshrouded Standard: 4–6 player slots at CA$11.99–CA$13.99/month; Satisfactory Standard: 4–6 player slots at CA$14.99–CA$18.99/month; Conan Exiles Standard: 8 player slots at CA$15.99/month; 7 Days to Die Standard: 4–8 player slots at CA$10.99–CA$15.99/month; Rust Standard: 50 player slots at CA$19.99/month; Project Zomboid Standard: 8 player slots at CA$13.99/month; ARK Standard: 10 player slots at CA$19.99/month. Other game orders and other sizes and qualities are temporarily paused. Check game availability before ordering. After payment. Your server is set up automatically after payment. Prices are in Canadian dollars, there is no setup fee, and you can cancel any time.

See available Minecraft plans

Questions this guide did not answer? Email support@fwg.world for pre-sales help. No account or payment is required.