TRICK OR SAVE!Get 40% off your first payment with HALLOWEEN2026.See all our plans
Plugins & mods

A plugin will not load

Reviewed September 6, 2026 1 min read

When a plugin does not appear after a restart, the server almost always said why. The answer is in the startup log, in the seconds after the plugin's name.

What you're seeing

  • The plugin is red in the plugins list, or missing from it entirely.
  • Its configuration folder was never created.
  • Its commands return Unknown command.

What to do

  1. Find the plugin's name in the startup log

    Search the console output for it. Either it says it enabled, or there is an error next to it — and that error is the answer.

  2. Version mismatch

    Unsupported API version or a plain incompatibility message means the plugin was built for a different Minecraft version. Get the build that matches yours.

  3. Missing dependency

    The log names what it wanted in brackets. Install that first, then restart.

  4. Broken or partial file

    Invalid plugin.yml or a zip error means the jar is damaged, usually from an interrupted upload. Delete and re-upload it.

  5. Wrong server type

    If the console never mentions it at all, check you are not putting a plugin on a Forge server or a mod in plugins.

How to confirm it worked

plugins lists it in green and its commands respond.

Worth knowing

A plugin that loads but does nothing is a different problem: it loaded, so look at its configuration file and its permissions rather than at the startup log.

About this guide: An original guide from the EnduranceNodes team, written for the servers we host. If a step no longer matches what you see, tell us and we will update it.