Minecraft error fixes
Paste your crash log or type the error. We match it to known causes and step-by-step fixes.
Error finder
Open logs/latest.log or the newest file in crash-reports, copy everything and paste it here. Nothing is uploaded; matching runs in your browser.
Exit codes
Minecraft "Exit Code 1" crash
How to find and fix the cause of Minecraft closing with exit code 1, usually a mod error, the wrong Java version or a mod built for another loader.
Minecraft "Exit Code -1" crash
What exit code -1 means in Minecraft and how to fix it, from mod crashes during loading to driver and memory settings.
Minecraft "Exit Code 255" crash
Fix exit code 255 in modded Minecraft. Common causes are mods that cannot load, an incompatible Java version and broken JVM arguments.
Loading and mods
Minecraft crashes on startup
A step-by-step method to find why modded Minecraft crashes while launching or loading, and how to fix it without guessing.
Incompatible mods and version mismatches
Fix "incompatible mod set" and version mismatch errors in Forge, NeoForge and Fabric by matching every mod to your Minecraft version and loader.
Missing mod dependencies
Fix crashes caused by missing libraries such as Fabric API, Citadel, Balm or Curios. Find which dependency is missing and install the right version.
Mod conflicts and mixin errors
Find and fix conflicts between two mods, including mixin injection failures and mods that cannot be installed together.
Common Forge and NeoForge errors
How to read Forge and NeoForge loading errors such as ModLoadingException and "Failed to create mod instance", and how to fix them.
Common Fabric and Quilt errors
How to read Fabric errors such as "incompatible mod set", mixin failures and entrypoint crashes, and how to fix them.
Java and memory
Java version errors in Minecraft
Fix UnsupportedClassVersionError and other crashes caused by running Minecraft or a mod loader on the wrong Java version.
Out of memory and RAM problems
Fix OutOfMemoryError, "Java heap space" and "Could not reserve enough space for object heap" by allocating the right amount of RAM.
Graphics and performance
Black screen when launching Minecraft
Fix a black or blank window when Minecraft starts, caused by drivers, OpenGL support, shaders or overlays.
Shader problems (Iris and OptiFine)
Fix shader packs that crash, show a black or white screen, or tank FPS with Iris or OptiFine.
Low FPS, lag and stutter in modded Minecraft
Practical fixes for low FPS, stutter and server lag in modded Minecraft, from settings to performance mods.