Skip to main content
← All Guides
Troubleshooting · 7 min read

How to Fix Minecraft Exit Code 1

Fix Minecraft exit code 1 on launch. Covers Java path issues, missing libraries, Forge and Fabric errors, and launcher misconfigurations for Java Edition 1.21+.

How to Fix Minecraft Exit Code 1

The Error

Process exited with code 1
Error: Game crashed. Exit code: 1
An unexpected issue occurred and the game has crashed. Exit Code: 1

Exit code 1 means the Java process encountered a fatal error during startup or runtime and shut down. Unlike exit code -1 (which is typically an OS-level signal), exit code 1 is Java telling you something went wrong in the application layer. The details are always in the log file.

Quick Fix

Open your launcher, go to the profile settings, and make sure the Java executable path points to Java 21 for Minecraft 1.21+. If the field is empty or points to Java 8/17, correct it. Then try launching again.

Step-by-Step Diagnosis

  1. Read the log. Open .minecraft/logs/latest.log and scroll to the bottom. The last few lines before the process exits contain the actual error. Look for lines starting with Exception, Error, or FATAL.
  2. Check Java version. Open a terminal and run java -version. Minecraft 1.21+ requires Java 21. If you see Java 8 or 17, install Java 21 from Adoptium and update your launcher profile.
  3. Check for spaces in file paths. If your Minecraft or Java installation is in a folder with spaces in the name (like C:\Program Files), some launchers fail to quote paths correctly. Move Minecraft to a path without spaces, such as C:\Games\Minecraft.
  4. Verify mod loader version. If using Forge or Fabric, make sure the mod loader version matches your Minecraft version. Forge for 1.20.4 will not work with Minecraft 1.21. Download the correct installer from the official Forge or Fabric website.
  5. Delete .fabric or .forge folders. Corrupted mod loader caches cause exit code 1. Delete the .fabric folder inside .minecraft/ (for Fabric) or the libraries/net/minecraftforge/ folder (for Forge), then reinstall the mod loader.
  6. Repair game files. In the official launcher, go to Installations, select your profile, click the three dots, and choose "Repair". This re-downloads corrupted or missing game files.

Common Causes

  • Wrong Java version. The single most common cause. Each Minecraft version has a minimum Java requirement. Using Java 8 with Minecraft 1.21 causes an immediate exit code 1.
  • Missing native libraries. LWJGL native libraries for your operating system might be missing or corrupted. Reinstalling the game version fixes this.
  • Forge installer failure. If the Forge installer did not complete successfully, the libraries folder contains partial downloads. Run the installer again and watch for error messages.
  • Fabric Loader incompatibility. Fabric Loader updates frequently. Using an old Fabric Loader with a new Minecraft version produces exit code 1. Update Fabric Loader to the latest release.
  • JVM argument errors. Typos in custom JVM arguments (like -Xmx4 instead of -Xmx4G) cause Java to refuse to start. Remove all custom JVM arguments and try again.

Version-Specific Notes

Minecraft 1.21+ requires Java 21 as a hard minimum. The official launcher bundles Java 21, but third-party launchers (MultiMC, Prism, ATLauncher) require you to set the Java path manually. If you are using a third-party launcher, verify the Java path in its settings.

FAQ

How do I find the correct Java path?

On Windows, the default path is C:\Program Files\Eclipse Adoptium\jdk-21\bin\javaw.exe. On Linux, run which java or update-alternatives --list java. On macOS, run /usr/libexec/java_home -v 21.

Can exit code 1 happen during gameplay?

Yes, though it is less common. A mod throwing an unhandled exception during a tick can cause exit code 1 mid-game. The crash report in .minecraft/crash-reports/ will contain the stack trace.

I have the right Java version but still get exit code 1. What now?

Check for conflicting Java installations. Uninstall all Java versions except 21. Then set the path explicitly in your launcher. If the problem persists, try a different launcher to rule out launcher bugs.

Need a server that handles all this? Astroworld Hosting, NVMe SSDs, Pterodactyl panel, DDoS protection on every plan.

Related Tools & Resources

🔧

Minecraft Tools

Calculators, generators & server tools

🧱

Item Database

Browse all Minecraft items, stats & recipes

⚒️

Crafting Recipes

Visual crafting guides for every recipe