Forge mods not working after installation? You are not alone — most mod issues come down to a handful of common causes that are straightforward to fix. Whether your game crashes on launch, mods do not appear in the list, or you are staring at an error screen, this guide walks you through the most likely problems and how to resolve them step by step.
If you have not installed Forge yet or want to start over with a clean setup, follow our How to Install Forge Mods guide first. If you are unsure which mod loader you are using, our What Is Minecraft Forge explainer covers the basics.
Most Common Causes at a Glance
- Version mismatch — the mod, Forge, and Minecraft versions do not align
- Missing dependencies — a required library mod is not installed
- Mod conflicts — two mods are incompatible with each other
- Corrupt or incomplete download — the mod .jar file did not download fully
- Wrong mod loader — you placed a Fabric mod in a Forge setup
Fix 1: Version Mismatch (Minecraft, Forge, and Mod Versions)
Symptom: The game crashes during startup or shows errors about incompatible mod versions.
Three versions need to match:
- Minecraft version — the base game version (e.g., 1.20.1, 1.21)
- Forge version — the Forge build installed for that Minecraft version
- Mod version — each mod's download must target the same Minecraft version
How to fix:
- Open your Minecraft Launcher and check which Minecraft version your Forge profile targets
- Go to each mod's download page on CurseForge or Modrinth
- Verify that you downloaded the version that matches your Minecraft version exactly
- Re-download any mods that target a different version
Fix 2: Missing Dependencies
Symptom: The game crashes at startup with an error mentioning a specific mod ID or library that could not be found.
Common examples:
- Create requires Flywheel
- Many mods require Architectury API or Cloth Config
How to fix:
- Check the mod's page on CurseForge or Modrinth — required dependencies are listed in the sidebar
- Download each required library for the same Minecraft version
- Place the dependency .jar files in your
mods/folder - Relaunch the game
Fix 3: Mod Conflicts
Symptom: The game worked with fewer mods but started crashing after adding new ones.
How to fix using the binary search method:
- Remove half of your mods from the
mods/folder (move them to a temporary folder) - Launch Minecraft and check if the crash still occurs
- If the crash stops, the conflicting mod is in the group you removed. Add half back and test again
- Continue narrowing down until you identify the specific mod
Fix 4: How to Read a Forge Crash Log
Log file locations:
- Game log:
.minecraft/logs/latest.log - Crash reports:
.minecraft/crash-reports/
What to look for:
- Open the crash report in a text editor
- Search for "ERROR" or "FATAL"
- Look for a mod ID near the error
- Check for "Caused by:" lines — these describe the root cause
- Look for version numbers in the error
Fix 5: Reinstall Forge Cleanly
- Delete the Forge profile in your Minecraft Launcher
- Back up and remove the
mods/folder - Download a fresh Forge installer from files.minecraftforge.net
- Run the installer and select "Install Client"
- Launch once to generate a fresh
mods/folder - Add mods back one at a time, testing after each addition
When to Ask for Help
- Forge Discord server — official community for troubleshooting
- CurseForge mod pages — each mod has an "Issues" tab
- Reddit r/feedthebeast — the largest modded Minecraft community
When asking for help, include your crash log, Minecraft version, Forge version, and list of installed mods.
For similar troubleshooting with the Fabric loader, see our Fabric Mods Not Working guide.
Other Mod Loader Guides
Having trouble with a different mod loader? Check out these troubleshooting guides:
- Fabric Mods Not Working?
- NeoForge Mods Not Working?
- Quilt Mods Not Working?
- Forge vs Fabric — Which loader should you choose?
- NeoForge vs Forge — Understanding the fork
Frequently Asked Questions
Why do my mods disappear after updating Minecraft?
Mods do not disappear — they are still in the mods/ folder. However, if you update Minecraft, Forge and your mods may not support that version yet. Keep your Minecraft version, Forge version, and mods all aligned.
Can outdated mods crash my world?
An outdated mod can cause a crash, but it is unlikely to permanently corrupt your world. Always back up your worlds before adding or updating mods.
How do I check which Forge version I have installed?
Launch Minecraft with the Forge profile. The version number is displayed in the lower-left corner of the title screen.
I accidentally put a Fabric mod in my Forge setup. Can that cause a crash?
Yes. Fabric mods are built for a different loader. Remove any Fabric-only mods from your mods/ folder.
