Minecraft Exit Code 1 — Java Virtual Machine Crash

What does Minecraft Exit Code 1 mean?

Java exit code 1 is the default non-zero exit code indicating an unhandled exception or fatal error. Unlike specific exit codes (like -1073740791 which points to an access violation), code 1 is a broad catch-all. The crash log in .minecraft/crash-reports is the most important diagnostic tool.

Reading the crash report

Crash reports are saved in .minecraft/crash-reports as dated .txt files. Open the latest one and look at the Description and Caused by lines near the top. These usually name the mod or Java class that failed, pointing directly to the cause.

Common causes

Incompatible mods (wrong Minecraft or Forge version), a mod conflicting with another, outdated GPU drivers failing OpenGL calls, corrupted .minecraft/assets files, or Java version mismatches are the most common Exit Code 1 causes.

How to fix step by step

1. 1Open .minecraft/crash-reports and read the latest crash log to identify the failing component.
2. 2If a mod is named in the crash, remove or update that mod.
3. 3Disable all mods and relaunch — if it works, add mods back one at a time to find the conflict.
4. 4Update your GPU drivers — OpenGL failures in drivers are a common Exit Code 1 cause.
5. 5Ensure you are using the correct Java version for your Minecraft version (Java 17 for 1.17+).
6. 6Use the Repair option in the Minecraft Launcher to restore corrupted game files.
7. 7Increase RAM allocation if the crash report mentions OutOfMemoryError.

How EXIT-CODE-1 differs from related codes

• Error OUT-OF-MEMORY: Minecraft's Java process ran out of allocated memory (heap space). The game crashed because it could not allocate more RAM. (user-side)
• Error IO-NETTY: Minecraft lost connection with an io.netty network exception — often timeout or forced disconnect. (server or client)