Minecraft mods crashing or won't load: how to find the cause
Updated 17 November 2026
The three usual causes
1. Wrong Minecraft version
Mods are built for specific versions. A mod for 1.20.1 won't load on 1.21.1. Every mod file has its version in its name or on its download page.
2. Wrong mod loader
Fabric, Quilt, Forge and NeoForge mods aren't interchangeable. A Fabric mod in a Forge pack won't load (Quilt can run most Fabric mods). Download the version for the loader you use.
3. A missing mod
Many mods need a "library" mod to work, such as Fabric API, Architectury, Cloth Config or GeckoLib. If it isn't in your mods folder, the game stops and says so.
Fix it, step by step
- Read the error. Fabric says "Incompatible mods found!" and lists what's missing. Forge and NeoForge list "Missing or unsupported mandatory dependencies". These lines name the exact mod.
- Check every mod is for your version and loader. Re-download any that aren't from Modrinth or CurseForge, picking your exact version and loader.
- Add missing library mods. Download the ones the error names, for the same version and loader.
- Remove doubles. Two copies of the same mod (often an old and a new version) stop the game loading. Keep the newest.
- Still crashing in game? Open the newest file in the
crash-reportsfolder. Look for a "Suspected Mods" line, or mod names near the top of the error.
mods folder itself. Any inside a subfolder are ignored, and zip files of resource packs belong in resourcepacks, not mods.Where to find things
| What | Where |
|---|---|
| Mods folder | .minecraft › mods (on Windows, Win + R, type %appdata%\.minecraft). In CurseForge, Modrinth or Prism: your instance folder › mods. |
| Crash reports | .minecraft › crash-reports |
| Log when the game stops before the menu | .minecraft › logs › latest.log |
Questions
Can I use Fabric and Forge mods together?
Not normally. Pick one loader. A tool called Sinytra Connector can run some Fabric mods on Forge or NeoForge, but it doesn't work for everything.
Is there a quick way to check a whole mods folder?
Yes. The free FixMyMods checker reads every mod's info file, works out your version and loader, and lists the mods that won't load and why.
Do mods work on Bedrock Edition?
No. These mods are for Java Edition on PC and Mac. Bedrock uses add-ons, which work differently.