Minecraft Error Code 1, often shown as “Game ended with bad state: exit code 1” or simply “Exit Code: 1”, is one of the most common launch failures for Java Edition players. It usually means the game crashed during startup because something in the setup is broken, outdated, incompatible, or incorrectly configured.
TLDR: Minecraft Error Code 1 is usually caused by outdated Java, broken mods, incompatible Forge or Fabric versions, bad graphics drivers, corrupted launcher files, or incorrect JVM arguments. The fastest fix is to restart the computer, update the launcher and graphics drivers, remove mods temporarily, and make sure Java matches the Minecraft version. If the issue continues, the player should reset game settings, check the crash report, and reinstall Minecraft as a last resort.
What Minecraft Error Code 1 Means
Error Code 1 is a general crash code in Minecraft Java Edition. It does not point to one single cause. Instead, it tells the player that Minecraft failed to start or crashed shortly after opening. Because the message is broad, the solution usually requires checking several areas: Java, mods, launcher files, graphics drivers, settings, and system permissions.
This error often appears after installing mods, changing Minecraft versions, updating the launcher, switching Java versions, or changing graphics settings. It may also happen on a fresh installation if the computer has outdated drivers or missing dependencies.
Common Causes of Error Code 1
Before applying fixes, it helps to understand the most likely causes. Error Code 1 commonly appears because of:
- Outdated or incompatible Java for the selected Minecraft version.
- Broken, outdated, or conflicting mods, especially when using Forge, Fabric, or Quilt.
- Incorrect Minecraft version for a mod loader or mod pack.
- Corrupted launcher files or damaged game installation data.
- Old graphics drivers that cannot handle the game properly.
- Bad JVM arguments added manually in the launcher profile.
- Special characters in the Windows username or game path.
- Antivirus or firewall interference.
- Insufficient RAM allocation or too much RAM assigned incorrectly.
1. Restart the Computer and Launcher
The simplest fix should be tried first. The player should close Minecraft, exit the launcher completely, and restart the computer. This clears temporary processes, locked files, and background Java tasks that may prevent the game from launching.
After restarting, the player should open the Minecraft Launcher again and try launching the same profile. If the game opens normally, the issue may have been a temporary process conflict.
2. Update the Minecraft Launcher
An outdated launcher can cause compatibility problems, especially after Minecraft receives updates. The official Minecraft Launcher usually updates automatically, but it can sometimes get stuck or fail silently.
The player should open the launcher and allow it to update. If it does not update, reinstalling the launcher from the official Minecraft website can help. This does not normally delete worlds, but backing up the saves folder is always recommended before making major changes.
3. Check the Minecraft Version
Error Code 1 frequently happens when the selected game version does not match installed mods or loaders. For example, a mod made for Minecraft 1.20.1 may crash on 1.20.4. Forge and Fabric versions must also match the Minecraft version they are meant to run.
The player should open the launcher, go to Installations, select the affected profile, and confirm the chosen version. If mods are being used, every mod should support that exact version. If a mod pack is being used, the player should avoid changing the Minecraft version manually unless the mod pack instructions say so.
4. Remove Mods Temporarily
Mods are one of the biggest causes of Minecraft Error Code 1. A single outdated or incompatible mod can stop the entire game from launching. To test this, the player should temporarily remove all mods from the mods folder.
- Press Windows + R.
- Type %appdata%\.minecraft and press Enter.
- Open the mods folder.
- Move all mod files to a temporary folder on the desktop.
- Launch Minecraft using the same mod loader profile.
If Minecraft opens successfully, one or more mods are causing the crash. The player should add mods back one at a time or in small groups until the faulty mod is found. Any broken mod should be updated, replaced, or removed.
Image not found in postmeta5. Update Forge, Fabric, or Quilt
If the player uses a mod loader, the loader itself may be the problem. Forge, Fabric, and Quilt must match both the Minecraft version and the mods installed. A mismatched loader often causes instant crashes and Error Code 1.
The player should download the newest compatible loader version from the official source. It is also important to install required dependencies, such as Fabric API for many Fabric mods. Missing dependency mods can crash Minecraft before the main menu appears.
6. Install the Correct Java Version
Minecraft Java Edition depends on Java, although many modern launcher profiles include a bundled Java runtime. However, custom launchers, modded profiles, and older installations may use a manually installed Java version.
As a general rule:
- Minecraft 1.18 and newer usually require Java 17 or newer.
- Minecraft 1.17 typically uses Java 16.
- Minecraft 1.16.5 and older often use Java 8.
The player should check the Java executable path in the launcher profile. In the official launcher, this is found under Installations, then Edit, then More Options. If a custom Java path is set, clearing it may allow the launcher to use its bundled runtime instead.
7. Reset JVM Arguments
Incorrect JVM arguments are another common reason for Error Code 1. Players sometimes add custom memory settings or optimization flags, but a single invalid argument can break startup.
In the launcher, the player should open the affected installation, choose More Options, and look at the JVM Arguments field. If it has been heavily edited, it should be reset to the default values. A simple memory allocation such as -Xmx4G may work for many systems, but assigning too much RAM can also cause instability.
For most modded setups, 4 GB to 8 GB is reasonable, depending on the size of the mod pack and the computer’s total memory. A computer with 8 GB of total RAM should not allocate 8 GB to Minecraft, because the operating system also needs memory.
8. Update Graphics Drivers
Outdated or damaged graphics drivers can cause Minecraft to crash immediately. This is especially common after Windows updates or when switching between integrated and dedicated graphics.
The player should update drivers from the official website of the graphics card manufacturer, such as NVIDIA, AMD, or Intel. Using Device Manager may not always install the latest gaming driver, so the manufacturer’s driver tool is often more reliable.
After installing the driver, the system should be restarted before launching Minecraft again.
9. Check the Crash Report
Minecraft usually creates a crash report when Error Code 1 occurs. This report can reveal the real cause, such as a specific mod, missing dependency, Java error, or graphics issue.
The player can find crash reports in:
- Windows: %appdata%\.minecraft\crash-reports
- macOS: ~/Library/Application Support/minecraft/crash-reports
- Linux: ~/.minecraft/crash-reports
The newest file should be opened with a text editor. If the report mentions a mod name repeatedly, that mod is likely involved. If it mentions Java, OpenGL, or a graphics library, the problem may be related to Java or the graphics driver.
10. Rename the Minecraft Folder
If settings or launcher data are corrupted, creating a clean Minecraft folder can help. The player should close the launcher, open the Minecraft directory, and rename .minecraft to something like .minecraft backup. When the launcher opens again, it will create a fresh folder.
If the game launches after this, the old installation had corrupted files or settings. The player can then copy important folders such as saves, resourcepacks, and screenshots from the backup folder into the new one.
11. Remove Special Characters from the Path
Some Java applications have trouble with file paths that contain unusual symbols or non-English characters. If the Windows username includes special characters, Minecraft may crash with Error Code 1.
A practical workaround is to install Minecraft in a simple custom directory, such as C:\Minecraft. The player can create a new launcher installation and set the game directory to that folder. This avoids complicated file paths and may fix difficult launch failures.
12. Check Antivirus and Firewall Settings
Security software can sometimes block Java, the Minecraft Launcher, or mod loader files. If the crash began after an antivirus update, this should be considered.
The player should check the antivirus quarantine list and allow the Minecraft Launcher, Java, and Minecraft game folder if they were blocked. Security software should not be disabled permanently, but a temporary test can help confirm whether it is interfering.
13. Reinstall Minecraft
If all other fixes fail, a clean reinstall may be necessary. The player should first back up worlds from the saves folder. After that, Minecraft can be uninstalled, the remaining game folder can be renamed or removed, and the launcher can be installed again.
This step should be treated as a final option because it takes longer and may remove local settings. However, it is often effective when the installation has multiple damaged files or old mod loader remnants.
How to Prevent Error Code 1 in the Future
Preventing Error Code 1 is easier than fixing it repeatedly. The player should keep Minecraft, Java, graphics drivers, and mod loaders updated. Mods should be downloaded only from trusted sources and checked for version compatibility before installation.
It is also wise to change only one thing at a time. If the player installs ten mods at once and the game crashes, finding the cause becomes harder. Backing up the .minecraft folder before installing large mod packs can save time and protect worlds.
FAQ
What does Minecraft Error Code 1 mean?
It means Minecraft crashed during startup or shortly after launching. The code is general, so the cause may be Java, mods, drivers, launcher settings, or corrupted files.
Is Error Code 1 caused by mods?
It often is. Many cases are caused by outdated mods, missing dependencies, or mods made for a different Minecraft version.
Can updating Java fix Error Code 1?
Yes. If Minecraft is using the wrong Java version, updating or switching Java can fix the crash. Newer Minecraft versions usually need newer Java versions.
Why does Minecraft crash after installing Forge?
Forge may not match the Minecraft version, or one of the installed Forge mods may be incompatible. The player should verify the Forge version and test without mods.
Will reinstalling Minecraft delete worlds?
It can, if the player removes the entire .minecraft folder without backing it up. The saves folder should always be copied before reinstalling.
How much RAM should Minecraft use?
Vanilla Minecraft usually works with 2 GB to 4 GB. Modded Minecraft often needs 4 GB to 8 GB, but the player should not allocate all system RAM to the game.
What should be checked first?
The player should first restart the computer, update the launcher, remove mods temporarily, and check whether the selected Minecraft version matches the installed mod loader.
