☰

Plugin Placed in Mods Folder

A Bukkit/Paper plugin was dropped into a Forge/Fabric server's mods folder, and the loader rejected it. Plugins and mods are different things and live in different folders.

What does this error mean?
The mod loader expects mods, not plugins. Finding a plugin.yml inside a jar in the mods folder tells it the file is a Bukkit plugin, not a mod, so it flags an invalid mod file. Plugins belong in plugins/ on a Bukkit-based server, not in mods/. 
Invalid Mod File: plugin.yml found
Most Common Causes
  • A plugin jar placed in the mods folder of a modded server.
  • Confusing plugins with mods.
  • Trying to run plugins on pure Forge/Fabric (which has no plugins/ folder).
  • Mixing plugin and mod files in one folder.
  • Following a guide for the wrong server type.
How To Diagnose
  1. Confirm the jar contains a plugin.yml (it is a plugin).
  2. Check what server software you run (Forge/Fabric vs Paper).
  3. Note that pure modded servers have no plugins/ folder.
  4. Identify any other misplaced files.
Recommended Fixes
  • Remove the plugin from mods
    Take the plugin jar out of the mods folder, it cannot load there.
  • Use a hybrid server for both
    To run mods and plugins together, use a hybrid like Mohist/Arclight (with caveats).
  • Pick the right platform
    Use Paper for plugins, or Forge/Fabric for mods, based on what you need.
  • Separate file types
    Keep mods in mods/ and plugins in plugins/ (only on platforms that support both).
Analyze My Log
Frequently Asked Questions

Not directly. Pure Forge/Fabric loads mods only. Plugins need a Bukkit-based or hybrid server.

Plugins use the Bukkit API (server-side), mods use Forge/Fabric and can change the game on both sides.

Use a hybrid server (Mohist/Arclight), accepting that hybrids can be less stable.