Poradniki

Fix a Minecraft Plugin That Will Not Load

When /plugins shows a plugin in red, or the console says it could not be loaded, the plugin failed to start. The console tells you why.

Read the console

Open Console after a restart and look for lines with the plugin's name. The most common messages are below.

Common causes

  1. Unknown dependency or missing dependency: install the plugin it needs, often Vault, ProtocolLib or PlaceholderAPI.
  2. Unsupported API version: the plugin is made for a different Minecraft version. Get a build that matches your version on Software.
  3. Invalid plugin.yml: it is not a Paper plugin. It may be a Fabric or Forge mod, which needs a Kingdom world with a mod loader.
  4. Disabled after start: many plugins switch themselves off until you fill in their config, like a token or database. Edit it in Files under plugins/PluginName.

After fixing

Restart the world from the Overview. See also How to install plugins.

Plugins run on Village and Kingdom with Paper or Purpur. Compare plans on the plans page.