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.

Share this tool

Version & Loader

Mod List

One mod per line, comma lists, jar filenames, a pasted dir / ls listing of your mods folder, or Modrinth/CurseForge links. Jars ending in .disabled are skipped.

Performance Inputs

Graphics Load

Preview

Selected known mods

plus pasted unknown or jar-name entries.

Static compatibility model

This checker flags known conflicts and common risks. Always verify unknown mods on the author's project page.

Quick Load:

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.

Where to find it: .minecraft/crash-reports or .minecraft/logs/latest.log. In CurseForge or Modrinth, right-click the profile › Open folder.

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:

JobFabric / QuiltForge / NeoForge
Rendering performanceSodiumEmbeddium (1.20.1) · Sodium (NeoForge 1.21+)
ShadersIrisOculus (1.20.1) · Iris (NeoForge 1.21+)
Recipe viewerREI, EMI or JEIJEI, EMI or REI
Memory reductionFerriteCore, ModernFixFerriteCore, ModernFix
Core libraryFabric API (QFAPI on Quilt)Built into the loader — Forgified Fabric API only with Sinytra Connector
Accessory slots APITrinketsCurios API
Mods list screenMod MenuBuilt 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 versionJava needed
1.16.5 and olderJava 8
1.17.xJava 16
1.18 – 1.20.4Java 17
1.20.5 – 1.21.11Java 21
26.1, 26.2 and newerJava 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.

WhereMods folderCopy the list
Windows (vanilla launcher)%appdata%\.minecraft\modsType cmd in the folder's address bar, then run dir /b *.jar | clip
macOS~/Library/Application Support/minecraft/modsIn Terminal: ls *.jar | pbcopy
Linux~/.minecraft/modsls ~/.minecraft/mods and copy the output
CurseForge, Prism, Modrinth AppInstance → Open folder → modsSame commands, run inside that instance's mods folder
Dedicated servermods/ next to the server jarls 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 containsUsual causeFix
Missing or unsupported mandatory dependencies / requires any version of fabric-apiA required library isn't installed, or it's the wrong versionInstall 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.0The mod or loader needs Java 21 but the game is running on Java 17Switch the launcher or server to Java 21. Class version 69.0 means Java 25, which 26.x needs
Incompatible mods found / Mod resolution failedA mod built for a different Minecraft version or loaderDownload the build that matches your exact version and loader
Found duplicate mods / Duplicate mod IDsTwo versions of the same mod, often one bundled inside another jarDelete the older jar. Create, for example, already bundles Flywheel
Mixin apply failed / Mixin transformation failedTwo mods patching the same code, or a mod for the wrong versionRemove recently added mods one at a time. Renderer stacks like OptiFine + Sodium are the usual suspects
Attempted to load class … for invalid dist DEDICATED_SERVERA client-only mod (minimap, shaders, Sodium) in a server's mods folderRemove client-only mods from the server and keep them on clients only
Exit code 1 with no clear errorWrong Java version, too little RAM, or a crash before logging startsCheck 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 sizeTypical allocation
Vanilla + a few optimisation mods3–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.