Minecraft "Exit code: 1": what it means and how to fix it

Published By helps.wiki editorial team

"Exit code: 1" is a generic message from the Minecraft Launcher saying the Java process running the game ended abnormally. It names no cause. Read the crash report to find the real reason, then check Java, mods and graphics drivers, which are the most common culprits.

Applies to:Minecraft Java EditionMinecraft Launcher, vanilla and moddedWindowsGuides used for this article are Windows-focused
On this page

What it means

The Minecraft Launcher runs the game inside a Java process. When that process stops abnormally, the launcher shows the exit code, and 1 is simply the generic failure code. It is a catch-all, not a single documented error, so the number itself tells you nothing about why the game stopped.

The useful information is in the crash report or the Java (JVM) log. The steps below start with finding that, then move through the usual causes from the least to the most invasive fix. Neither Mojang nor the Minecraft Wiki documents "exit code 1" on its own, so the causes and fixes here come from general crash guidance and third-party guides. If your crash happens with Forge mods, see also Minecraft Forge "Game crashed, Exit code: 1".

Symptoms and causes

You are likely dealing with this problem if:

  • The launcher says the game crashed with "Exit code: 1" right at startup or shortly after.
  • No further explanation is shown in the launcher window.

The usual causes, most common first:

Wrong, outdated or corrupted Java
Often named as the primary cause. The Minecraft Wiki lists a wrong Java version as a startup crash cause: versions before 1.16 use Java 6 to 8, and 1.16 and later need Java 16, 17, 21 or 25.
Broken or mismatched mods
Mods that conflict with each other, are damaged, or were built for a different Minecraft version can crash the game on launch.
Outdated or faulty graphics drivers
An old or faulty GPU driver can make the game process exit during startup.
Special characters in the Windows user name
They can break the launcher's path to the game directory.
Corrupted game files
Damaged files in the game folder can stop the game from starting.
Less common causes
Running out of RAM (which the Wiki says almost always causes JVM crashes), antivirus or other security software interfering with the game, or failing hardware.

How to fix it

Work through these in order. They start with the quickest, safest checks and move to deeper repairs; stop as soon as the problem is gone.

1.Find the real cause in the crash report

Easy

The report usually names the failing mod, Java problem or driver, which saves guessing.

  1. Press WinR, type the path below and press Enter to open the game folder. On macOS it is ~/Library/Application Support/minecraft, on Linux ~/.minecraft.
    Text
    %appdata%\.minecraft\
  2. Open the crash-reports folder and open the newest file, named like crash-yyyy-mm-dd_hh.mm.ss-client.txt.
  3. If there is no crash-reports folder, look in the game folder for a file named like hs_err_pid#####.log. Its presence means the JVM itself crashed.
  4. Read the top of the file for the description and any mod or driver names mentioned, and use that to pick the fix below.

2.Update the launcher, game, Java and graphics drivers

Easy

Outdated components are a common cause, and updating rules them out quickly.

  1. Update the Minecraft Launcher and let it install the latest version of the game you are playing.
  2. Download graphics drivers from NVIDIA, AMD, or your laptop maker's support page, install them, and restart the computer.

3.Start the game without mods

Easy

If vanilla launches, a mod is the cause.

  1. Move all mods out of the mods folder (or use a profile with no mod loader) and start the game.
  2. If it runs, put the mods back one at a time, launching after each, until the crash returns.
  3. Check that each mod is built for your exact Minecraft version and remove or replace any that are not.

4.Reinstall Java

Moderate

A damaged or mismatched Java install is the most frequently cited cause.

  1. Uninstall the current Java from Settings > Apps > Installed apps if you installed one yourself.
  2. Install a current 64-bit Java that matches your Minecraft version (see the version ranges in the causes section) and restart the launcher.

5.Work around a bad launcher path

ModerateChanges settings

Helps when your Windows user name contains special characters that break the path to the game folder.

Before you start: Only change the end of the Target field and keep a note of the original text so you can restore it. This command form comes from a third-party guide, so if it does not work, undo it.

  1. Right-click the Minecraft Launcher shortcut and choose Properties.
  2. On the Shortcut tab, add this to the very end of the Target field after a space, then click OK.
    Text
    --workDir %ProgramData%\.minecraft

6.Reinstall the game files

AdvancedChanges settings

Clears corrupted game files when nothing else worked.

Before you start: Deleting the .minecraft folder removes your settings, mods and resource packs. Copy saves somewhere safe first.

  1. Copy the saves folder out of %appdata%\.minecraft to another location.
  2. Close the launcher and delete the .minecraft folder.
  3. Reinstall Minecraft, launch it once, then copy saves back into the new .minecraft folder.

Check that it worked

  • The game starts and reaches the main menu without the "Exit code: 1" message.
  • A world loads and you can play for several minutes without a crash.

If it still fails

  • Re-read the newest crash report or hs_err_pid log: the first lines usually point to a mod, Java or driver.
  • If the log mentions memory, close other programs and check that you are not allocating more RAM than the PC has free. Also look at antivirus software interfering with the game; if you briefly turn a third-party antivirus off to test, turn it back on right after.
  • If you use another launcher (Prism, MultiMC, CurseForge), the same code can have different causes, so check that launcher's own log.
  • Do not confuse this with other codes such as 1073740791 or -1, which have different causes.
  • If a different launcher error is shown instead, see Minecraft Launcher error 0x803F8001.

Sources

  1. How to Fix a Minecraft "Exit Code: 1" Error? 5 Solutions · Help Desk Geek
  2. Tutorial:Obtaining a crash report · Minecraft Wiki
  3. Crash · Minecraft Wiki

Browse