Quick Fix
If you’re in a hurry, try these three things first:
Remove all mods
Update Java to the correct version
Restart the Minecraft Launcher
This fixes 80% of Exit Code 1 errors instantly. If it doesn’t, keep reading.
What Is Minecraft Exit Code 1?
You click Play on Minecraft. Instead of loading, the game closes. You see the words “Exit Code 1” and nothing else.
That’s frustrating — but don’t worry. It’s one of the most common Minecraft errors, and it’s very fixable.
Exit Code 1 means Minecraft crashed before it could fully start. Think of it like trying to open a door that’s blocked from the inside. The game tried to launch, hit a problem, and shut itself down. It can happen right at startup or just before the main menu loads.
The cause is almost always the same. And once you know what to look for, fixing it takes just a few minutes.
Why Does Minecraft Exit Code 1 Happen?
You click Play on Minecraft. Instead of loading, tFrom experience, 90% of Exit Code 1 errors come from either a wrong Java version or a broken/incompatible mod. Always check these two things first before trying anything advanced.
Here are all the possible causes:
Incompatible mods (most common). A mod built for Minecraft 1.19 will crash a 1.20 installation. Two mods can also conflict with each other. One bad mod is all it takes to bring the whole game down.
Wrong Java version. Minecraft runs on Java, and if your version is outdated or mismatched, the game won’t launch at all. Here are the version rules:
- Minecraft 1.17 and below → Java 8
- Minecraft 1.18 to 1.20 → Java 17
- Minecraft 1.21 and above → Java 21
Broken config files. Your game settings files can get corrupted after a bad update or a sudden crash. These broken files confuse Minecraft on startup.
Wrong Forge or Fabric version. These mod loaders must match your exact Minecraft version. A mismatch causes an instant crash with Exit Code 1.Outdated graphics drivers. Old GPU drivers can crash the game before it even opens — more often than most players realize.
How to Fix Minecraft Exit Code 1 (Step-by-Step)
Work through these steps in order. Don’t skip.
Step 1: Restart the Minecraft Launcher
Close the Minecraft Launcher completely — don’t just minimize it. Wait 30 seconds, then open it again and hit Play.
Simple, but it works more often than you’d think. Sometimes the launcher hits a small glitch that a fresh restart clears.
Step 2: Update Java (Most Important Fix)
Go to Adoptium.net and download the correct Java version for your Minecraft:
- Minecraft 1.17 and below → Java 8
- Minecraft 1.18 to 1.20 → Java 17
- Minecraft 1.21 and above → Java 21
After installing, open the Minecraft Launcher, go to your installation settings, and make sure it’s pointing to the new Java version. This single fix solves Exit Code 1 for the majority of players.
Step 3: Remove or Update Your Mods
Open your .minecraft/mods folder and move every mod into a backup folder on your desktop. Launch Minecraft with no mods at all.
Did it work? If yes, one of your mods was the problem. Now add them back one at a time, launching after each one. When it crashes again, you’ve found the culprit. Delete it or check CurseForge for an updated version that matches your Minecraft version.
Step 4: Delete the Config Folder
Inside your .minecraft folder, find the folder named config and delete it. Don’t worry — Minecraft automatically creates a fresh one when you launch. This fixes a lot of hidden errors that are hard to spot any other way.
Step 5: Update Your Graphics Drivers
- NVIDIA users: open GeForce Experience and check for updates
- AMD users: open AMD Adrenalin Software and do the same
Install any available updates, restart your PC, then try launching Minecraft again.
Step 6: Reinstall the Minecraft Launcher (Last Resort)
If nothing else has worked, the launcher itself may be corrupted. Uninstall it, download the latest version from pojav-launcher.org install it fresh, and log back in. Create a new installation and test it without any mods first.
Fix Exit Code 1 in Specific Cases
No mods installed
If you have zero mods and still get Exit Code 1, focus entirely on Java and the launcher. Update Java to the correct version for your Minecraft release. If that doesn’t work, go straight to Step 6 and reinstall the launcher.
Forge 1.20.1
This is almost always a version mismatch. Make sure you have the Forge version for exactly 1.20.1 — not 1.20, not 1.20.4. Go to the official Forge website, download the right build, and reinstall. Then verify that every mod in your folder is labeled 1.20.1 on its download page.
Fabric
Check that Fabric API is present in your mods folder — most Fabric mods require it. Also make sure your Fabric Loader is up to date. Download the latest from fabricmc.net and reinstall it.
CurseForge
Open the CurseForge app and check whether your modpack has an update available. If the crash started after a recent update, go into profile settings and roll back to the previous version. Also check your RAM allocation — heavy modpacks need at least 4GB assigned.
Old versions (1.12.2 and below)
You need Java 8 specifically. Newer versions of Java are not compatible with old Minecraft versions. Install Java 8 from Adoptium.net and set it as the runtime for that installation.
Minecraft Realms
Realms Exit Code 1 is usually a version mismatch. Your game version must match the version the Realm is running on. Check with the Realm owner and switch to their version. Also make sure your internet connection is stable before launching.
Pro Tips to Prevent Exit Code 1
Always check that new mods match your exact Minecraft version before installing
Never mix Fabric mods with a Forge setup
Keep Java updated whenever you update Minecraft
Add mods one at a time and test after each one
Back up your mods folder before making any big changes
Frequently Asked Questions
Exit Code 1 looks scary, but it isn’t. In most cases it’s either a simple mod conflict or a quick Java fix — both of which take under five minutes to resolve.
Start from Step 1 and work your way down. Don’t skip steps. Most players fix this error before they ever reach Step 4.
Follow the steps, stay patient, and you’ll be back in your world very soon.