# Minecraft modpack crashing with exit code 1? Find the real error

> Markdown version of https://stella.sh/how/game-mods/minecraft-modpack-exit-code-1 for agents and LLMs.
> Exit code 1 only means Minecraft quit with an error. Find the real cause in the log (a missing or wrong mod, Java, RAM) and fix it, or let Stella (stella.sh) do it.

Exit code 1 only says Minecraft stopped with an error; the reason is in the pack's logs/latest.log or crash-reports folder. Usually it's a missing library mod such as Fabric API, a mod built for another Minecraft version, the wrong Java, or too little RAM. Read the last error, fix that one thing and launch again. Stella (stella.sh) reads the log and every mod's version, swaps the right files in and tests the pack before handing it back.

- Checked: 10 November 2026
- Stella does it on: Windows, Mac, Linux

## Stella doing it

Recorded 10 November 2026 on Linux (Omarchy) with Stella’s own models (GPT-6 Luna).
Result: Both causes found and fixed on the first try, with no follow-up: Stella added Fabric API 0.116.18 and swapped Lithium 0.11.4 (built for 1.20.1) for 0.15.4 for 1.21.1, keeping the old jar in a backup folder. Started afterwards with the pack's own start script, the server loaded 50 mods and reached “Done”. The pack is a small Fabric 1.21.1 server made for this run from real mods, with Fabric API left out and the wrong Lithium on purpose. Stella took 1 minute 52 seconds; the wait is sped up 10×.

Video (49 s): https://stella.sh/media/proofs/game-mods/minecraft-modpack-exit-code-1/proof.mp4

Transcript:

- 0:00 Stella on a Linux computer. The modpack server crashed earlier with exit code 1.
- 0:08 The prompt is sent, with the folder the server is in.
- 0:13 Stella replies that it's checking the server logs and mod files, and will keep the originals before changing anything.
- 0:14 Reading the log and each mod, downloading the right versions and test-starting a copy, sped up 10×.
- 0:28 Done: Fabric API was missing and Lithium was built for Minecraft 1.20.1. Both fixed, a test copy reached “Done”, and the old Lithium jar is in a backup folder.

What Stella does:

1. Reads `logs/latest.log` and the newest crash report, then opens each mod jar to see which Minecraft version and libraries it needs
2. Names the cause in plain words; in the recording, Fabric API was missing and Lithium was built for Minecraft 1.20.1 instead of 1.21.1
3. Downloads the matching versions from Modrinth and checks each file's SHA-512 against the one Modrinth lists
4. Moves the wrong jar into a dated `backups` folder instead of deleting it, and leaves the world and settings alone
5. Starts a copy of the server as a test and reads its log until it says Done, then removes the test copy

## The prompt to paste

```text
My modpack crashes on startup with exit code 1, can you find what's wrong and fix it? It's the server in Desktop/Fabric Friends SMP.
```

## Fix it yourself

1. **Open the pack's own folder.** In the CurseForge app, open My Modpacks, click the pack's ⋮ menu and choose Open Folder. For a server, it's the folder with start.bat or start.sh. Everything you need is in `logs` and `crash-reports` inside it.
2. **Read the last real error.** Open `logs/latest.log` (or the newest file in `crash-reports`) in Notepad or TextEdit and search for ERROR, “requires” or “Caused by”. Fabric spells it out (“Mod AppleSkin requires any version of fabric-api, which is missing!”); Forge buries it near the bottom of a long stack trace.
3. **Add or swap the mod it names.** Download the missing library (Fabric API, Architectury, Cloth Config…) or the right version of the named mod from CurseForge or Modrinth. Pick the file for your exact Minecraft version and loader, put it in `mods`, and move the old one out rather than deleting it.
4. **Check Java and memory.** Minecraft 1.20.5 and newer need Java 21; 1.18 to 1.20.4 need Java 17. In CurseForge, Settings, Minecraft, Java Settings sets memory for every pack, and a pack's Profile Options can override it. Most packs want 6 to 8 GB, never more than two-thirds of your RAM.
5. **Launch again, one change at a time.** Start the pack after each fix and read the new log; fixing one error often reveals the next. If a pack updated itself and broke, CurseForge's ⋮ menu can switch it back to the previous version.

## Where Stella stops

- The recording is a Fabric server on Linux, where the log named both problems. A CurseForge client on Windows works the same way in the files, but Stella hasn't been recorded doing it there, and it doesn't sign in to your Minecraft account or launch the game for you.
- Forge and NeoForge crashes (mixin conflicts, client-only mods on a server, out-of-memory) are harder to read, and may take a few rounds of launch, read, fix.
- Stella doesn't say how to start the server again unless you ask; it's the same start.bat or start.sh as before.
- If the crash is in your graphics driver (an `hs_err_pid` file, or exit code -1073741819), mods aren't the cause; update the driver first.

## Questions

**What does exit code 1 mean in Minecraft?**
Only that Java exited with an error. It's the same code for a missing mod, a wrong Java version or a bad setting, which is why the log matters more than the number.

**Will more RAM fix exit code 1?**
Only when the log says the game ran out of memory. Too much RAM can cause stutters of its own, so read the error before raising the slider.

**What about MCDoctor and other crash log readers?**
MCDoctor.ai reads a pasted log and explains it, with a few free analyses a month. That helps you understand the crash; you still download and swap the mods yourself. Stella does both on your computer, and it's free with the ChatGPT or Claude plan you already have.

**I'm starting from a plain game. Where do I begin?**
Install a loader first, then add mods made for the same Minecraft version. The guide to [install Fabric, Sodium and Iris](https://stella.sh/how/game-mods/install-sodium-iris-minecraft-1-21-fabric) walks through it, and Stella can do it in the same chat.

**Is Stella free for this?**
Yes. Free with the ChatGPT or Claude plan you already have. Sign in with your ChatGPT plan, or use your Claude plan through Claude Code, and this task costs nothing extra. New accounts also get a small free trial of Stella’s own models.

**Can I control what Stella changes on my computer?**
Yes. Stella works on Windows, Mac and Linux with your own files and shows each step in the chat, so you can watch it and stop it at any point. Tell it what it may not do, as the prompts on these pages do (“don't delete anything without asking”). In the Downloads recording it deleted nothing until it was told to go ahead. It also refuses commands that would wipe a whole disk, your home folder or system folders.

Sources: [Minecraft Wiki: Java Edition system requirements and Java versions](https://minecraft.wiki/w/Tutorial:Update_Java), [Fabric API on Modrinth](https://modrinth.com/mod/fabric-api), [MCDoctor.ai](https://mcdoctor.ai).

## Related problems

- [Install Sodium and Iris on Minecraft 1.21 (Fabric)](https://stella.sh/how/game-mods/install-sodium-iris-minecraft-1-21-fabric.md)
- [Organize a messy Downloads folder](https://stella.sh/how/pc-cleanup/organize-downloads-folder.md)
- [How to allocate more RAM to Minecraft and stop out of memory crashes](https://stella.sh/how/game-mods/allocate-more-ram-to-minecraft.md)
- [How to install Minecraft mods, and why yours don't show up](https://stella.sh/how/game-mods/install-minecraft-mods.md)
- [How to install a Minecraft resource pack that isn't showing up](https://stella.sh/how/game-mods/install-minecraft-resource-pack.md)
- [Minecraft shaders not showing up in the Shader Packs list](https://stella.sh/how/game-mods/install-minecraft-shaders.md)

Get Stella: https://stella.sh/download. Free with the ChatGPT or Claude plan you already have.
