Minecraft Mod Compatibility Checker Will These Mods Work Together?
Paste your mod list, jar names or a whole mods-folder listing and check it against Forge, NeoForge, Fabric and Quilt, from 1.20.1 to 26.2. It finds loader and version mismatches, missing dependencies (with one-click add), renderer and shader conflicts and client-only mods on servers, then gives you the right Java version (17, 21 or 25) and how much RAM to allocate.
Checking mod compatibility...
Paste a mod list or select known mods, then click Check Compatibility to find conflicts, dependencies, RAM needs, and performance risk.
Crash Log Analyzer — Find the Mod That Won't Load
Works with any mod, even ones not in our list. Paste a crash report or logs/latest.log from Fabric, Quilt, NeoForge or Forge and get the missing, wrong-version, duplicate and conflicting mods in plain English. Nothing is stored.
Reading log…
How the Minecraft Mod Compatibility Checker Works
Paste your mod list — names, comma-separated lists, jar filenames, a whole dir or ls listing of your mods folder, or Modrinth and CurseForge links — or tick the known mod chips. The checker matches each mod against a curated dataset and flags anything that would stop your game launching: a mod built for a different loader or Minecraft version, a missing required library, two mods fighting over the same job, or a client-only mod on a dedicated server.
It also estimates RAM use, FPS cost and server TPS risk from your mods, shaders, resource pack and player count, and tells you how much memory to allocate. Missing dependencies come with an Add & re-check button. Mods it doesn't know are listed separately with a one-click Modrinth search, and jars ending in .disabled are skipped just like your launcher skips them.
It covers Minecraft 1.20.1 through 1.21.11 and the new year-numbered 26.1 and 26.2 releases. For 1.21.8 and newer, it checks loaders, dependencies, conflicts, Java and RAM, but it can't confirm that each mod has a build for that exact version yet, so the results tell you which ones to check. It also understands Quilt running Fabric mods, NeoForge 1.20.1 loading Forge mods, and Sinytra Connector loading Fabric mods on Forge or NeoForge.
Fabric vs Forge vs NeoForge: Equivalent Mods
The most common cause of a crash is mixing loader ecosystems. Use the matching mod for your loader:
| Job | Fabric / Quilt | Forge / NeoForge |
|---|---|---|
| Rendering performance | Sodium | Embeddium (1.20.1) · Sodium (NeoForge 1.21+) |
| Shaders | Iris | Oculus (1.20.1) · Iris (NeoForge 1.21+) |
| Recipe viewer | REI, EMI or JEI | JEI, EMI or REI |
| Memory reduction | FerriteCore, ModernFix | FerriteCore, ModernFix |
| Core library | Fabric API (QFAPI on Quilt) | Built into the loader — Forgified Fabric API only with Sinytra Connector |
| Accessory slots API | Trinkets | Curios API |
| Mods list screen | Mod Menu | Built into the loader |
Which Java Version Does Minecraft Need?
Using the wrong Java version is a classic "game crashed with exit code 1" cause, especially on servers. Mojang switched to year-based version numbers in 2026, and 26.1 was the first release to need Java 25. Pick a Minecraft version above and the checker sets the matching Java version for you.
| Minecraft version | Java needed |
|---|---|
| 1.16.5 and older | Java 8 |
| 1.17.x | Java 16 |
| 1.18 – 1.20.4 | Java 17 |
| 1.20.5 – 1.21.11 | Java 21 |
| 26.1, 26.2 and newer | Java 25 |
How to Copy Your Minecraft Mod List
You don't need to type mod names. Open your mods folder and paste the file list straight into the checker. Version numbers and loader tags in jar names are stripped automatically.
| Where | Mods folder | Copy the list |
|---|---|---|
| Windows (vanilla launcher) | %appdata%\.minecraft\mods | Type cmd in the folder's address bar, then run dir /b *.jar | clip |
| macOS | ~/Library/Application Support/minecraft/mods | In Terminal: ls *.jar | pbcopy |
| Linux | ~/.minecraft/mods | ls ~/.minecraft/mods and copy the output |
| CurseForge, Prism, Modrinth App | Instance → Open folder → mods | Same commands, run inside that instance's mods folder |
| Dedicated server | mods/ next to the server jar | ls mods over SSH, or copy the file list from your host's panel |
Common Modded Minecraft Crash Messages and What They Mean
Find the first error line in logs/latest.log or the crash report, then match it here.
| Message contains | Usual cause | Fix |
|---|---|---|
| Missing or unsupported mandatory dependencies / requires any version of fabric-api | A required library isn't installed, or it's the wrong version | Install the named library for your loader and version. The checker's Add & re-check button does this for known mods |
| class file version 65.0 … only recognizes up to 61.0 | The mod or loader needs Java 21 but the game is running on Java 17 | Switch the launcher or server to Java 21. Class version 69.0 means Java 25, which 26.x needs |
| Incompatible mods found / Mod resolution failed | A mod built for a different Minecraft version or loader | Download the build that matches your exact version and loader |
| Found duplicate mods / Duplicate mod IDs | Two versions of the same mod, often one bundled inside another jar | Delete the older jar. Create, for example, already bundles Flywheel |
| Mixin apply failed / Mixin transformation failed | Two mods patching the same code, or a mod for the wrong version | Remove recently added mods one at a time. Renderer stacks like OptiFine + Sodium are the usual suspects |
| Attempted to load class … for invalid dist DEDICATED_SERVER | A client-only mod (minimap, shaders, Sodium) in a server's mods folder | Remove client-only mods from the server and keep them on clients only |
| Exit code 1 with no clear error | Wrong Java version, too little RAM, or a crash before logging starts | Check the Java version first, then RAM, then remove mods in halves to isolate the cause |
How Much RAM to Allocate to Modded Minecraft
Typical starting points — the checker refines this from your actual mods, shaders and player count.
| Modpack size | Typical allocation |
|---|---|
| Vanilla + a few optimisation mods | 3–4 GB |
| Light pack (up to ~50 mods) | 4–6 GB |
| Medium pack (~50–150 mods) | 6–8 GB |
| Large kitchen-sink pack (150+ mods) | 8–10 GB |
| Add shaders or high-res textures | +1–2 GB |
Minecraft Mod Compatibility FAQ
Is there a website that checks a modpack for incompatible mods?
Yes — this checker. Paste your mod list or mods folder to check loaders, versions, dependencies and known conflicts, or paste a crash report or latest.log into the Crash Log Analyzer to find the exact mod that stops the game loading. The log analyzer works for any mod, not just the ones in our list.
How do I find which mod is crashing Minecraft?
Open the newest file in .minecraft/crash-reports, or logs/latest.log, and paste it into the Crash Log Analyzer. Fabric, Quilt, NeoForge and Forge name missing or wrong-version mods, duplicate jars, mixin failures and Java mismatches, and the analyzer lists each one with a fix. If no mod is named, remove half your mods, test, and repeat on the half with the problem.
How do I know if Minecraft mods will work together?
Check that every mod has a build for your exact Minecraft version and loader, that its required libraries are installed, and that no two mods replace the same system — for example two renderers or two shader loaders. Paste your list into this checker to catch all three at once, then test in a fresh world.
Can Fabric mods run on Forge?
Not directly. Fabric and Forge are separate loaders, so you need the Forge or NeoForge version of each mod. Sinytra Connector, together with Forgified Fabric API, can load many Fabric mods on Forge 1.20.1 and NeoForge 1.21.1, but mods that patch deep Fabric internals can still fail. Add Connector to your list and the checker treats Fabric-only mods as a medium risk instead of a hard error.
Can Quilt run Fabric mods?
Mostly, yes. Quilt Loader is designed to run the large majority of Fabric mods, so the checker groups Fabric-only mods on Quilt into one low-risk note rather than an error. Use Quilted Fabric API (QFAPI) in place of Fabric API. A few mods that rely on Fabric internals can still fail.
Can NeoForge use Forge mods?
On Minecraft 1.20.1, NeoForge still loads most Forge mods because the two had only just split. From 1.20.2 onward they are separate ecosystems, and you need a NeoForge build of each mod.
Which Java version do I need for Minecraft 1.21?
Minecraft 1.20.5 through 1.21.11, including all 1.21 versions, need Java 21. Versions 1.18 to 1.20.4 use Java 17. The checker sets the Java version automatically when you pick a Minecraft version.
Which Java version does Minecraft 26.1 need?
Minecraft 26.1, released in March 2026, and every later year-numbered version such as 26.2 need Java 25. A server still on Java 21 won't start 26.1, so update the Java runtime before you update the server jar.
What does class file version 65.0 mean in Minecraft?
It means something was compiled for a newer Java than the one running the game. Class file version 61 is Java 17, 65 is Java 21 and 69 is Java 25. If the error says a mod needs 65.0 but your runtime only recognizes up to 61.0, switch the launcher or server to Java 21.
Do I need to install Flywheel for the Create mod?
No. Since Create 0.5.1, Flywheel is bundled inside the Create jar, so you don't add it separately. Installing a second, mismatched Flywheel can actually cause a version error.
Should I use Sodium, Embeddium or OptiFine?
On Fabric or Quilt use Sodium, with Iris for shaders. On Forge 1.20.1 use Embeddium with Oculus. On NeoForge 1.21, Sodium and Iris now have native builds. OptiFine conflicts with all of these, so don't mix them.
Can I use JEI and EMI together?
Yes. EMI loads JEI plugins and hides JEI's own panel, so mods that only ship JEI integration still show their recipes in EMI. Pairing JEI with REI, or REI with EMI, gives you two full recipe viewers, and the checker flags that.
Do I still need Indium with Sodium?
Only on Minecraft 1.20.x with Sodium 0.5. Sodium 0.6 and newer, used on 1.21, has the Fabric Rendering API built in, and Indium doesn't work with it, so remove Indium on 1.21 packs.
Can I put client-only mods on a Minecraft server?
No. Mods such as Sodium, Iris, Entity Culling and shader or HUD mods only run on the client. On a dedicated server they usually crash with an "invalid dist DEDICATED_SERVER" error. Choose Dedicated Server as the environment and the checker lists every client-only mod to remove.
How do I fix a missing dependency in modded Minecraft?
Read the crash screen or log for the missing mod's name, then download the version of that library made for your Minecraft version and loader. Common ones are Fabric API, Architectury API, Cloth Config, Balm, Moonlight Lib and GeckoLib. In this checker, click Add & re-check next to the missing dependency to confirm the list is complete.
How much RAM should I allocate to modded Minecraft?
Most packs run well with 6–8 GB; large kitchen-sink packs may want 8–10 GB. Allocating far more than the pack needs can cause longer garbage-collection pauses, so use the recommendation in your results rather than the maximum.
Related Minecraft Calculators
Minecraft Server RAM Calculator
Server memory and JVM flags by players and mods
Minecraft Farm Rates Calculator
Items per hour from mob and crop farms
Minecraft Ticks Calculator
Convert ticks, seconds and redstone delays
Minecraft XP Level Calculator
XP needed between any two levels
Minecraft Beacon Calculator
Blocks needed for each beacon tier