Minecraft mods crashing or won't load: how to find the cause

Updated 17 November 2026

Quick answerAlmost every "mods won't load" problem is one of three things: a mod made for a different Minecraft version, a mod for a different mod loader (Fabric vs Forge vs NeoForge), or a missing mod it needs (like Fabric API). Fix those and most packs start.

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

  1. 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.
  2. 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.
  3. Add missing library mods. Download the ones the error names, for the same version and loader.
  4. Remove doubles. Two copies of the same mod (often an old and a new version) stop the game loading. Keep the newest.
  5. Still crashing in game? Open the newest file in the crash-reports folder. Look for a "Suspected Mods" line, or mod names near the top of the error.
Mods only load from the mods folder itself. Any inside a subfolder are ignored, and zip files of resource packs belong in resourcepacks, not mods.

Where to find things

WhatWhere
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.

More guides

The Sims 4Sims 4 mods not working after an update: how to fix themWhy patches break mods, how to switch mods back on, and how to find the broken ones fast.GTA VGTA V mods not working after an update: how to fix them"Unknown game version", Script Hook V, the mods folder and Enhanced vs Legacy explained.GTA 6GTA 6 mods: what to expectConsole vs PC, when mods could arrive, Rockstar's mod rules and the scams to avoid.