☰

Arclight Plugin Load Error

On an Arclight hybrid server, a Bukkit plugin failed to load. Arclight bridges Forge/Fabric and Bukkit, and a plugin can fail when it expects behavior the hybrid implements differently.

What does this error mean?
Arclight runs Bukkit plugins on top of a modded server by reimplementing the Bukkit API. A plugin loader error means a plugin relied on something the hybrid does not provide identically, or there is a version mismatch between Arclight, mods, and the plugin. 
Plugin loader error (Arclight)
Most Common Causes
  • A plugin using API behavior Arclight implements differently.
  • An Arclight build mismatched to the mod loader/version.
  • A plugin requiring a feature the hybrid lacks.
  • Conflicts between a mod and the plugin.
  • An outdated plugin on a newer hybrid.
How To Diagnose
  1. Read the error for the plugin and what it needed.
  2. Confirm Arclight matches your loader and Minecraft version.
  3. Test the plugin on a pure Paper server to see if it is Arclight-specific.
  4. Check for mod/plugin overlap.
Recommended Fixes
  • Match the Arclight build
    Run the Arclight version made for your loader and Minecraft version.
  • Update the plugin
    Use a current plugin build, and verify it works under hybrids.
  • Replace the plugin
    If it is incompatible with the hybrid, find an alternative that works.
  • Reconsider the hybrid
    If many plugins fail, a pure Paper server may suit your plugin needs better.
Analyze My Log
Frequently Asked Questions

Hybrids reimplement the Bukkit API, subtle differences can break plugins that work on real Paper.

It targets specific Forge/Fabric and Minecraft versions, match the build to yours.

Only if you truly need mods and plugins together, expect more troubleshooting than a pure server.