Stella
Game mods

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

The log already says what broke. Here's how to read it, and the fix.

Download StellaFree with the plan you already have.

A real run on 10 November 2026, on a Linux computer, using Stella’s own models (GPT-6 Luna). The waiting is sped up; it took 2 min 05 s in real time.

The short answer.

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.

Stella does this on Windows, Mac and Linux.

What happened.

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×.

Server log lines before and after. Before: Incompatible mods found, AppleSkin requires fabric-api which is missing, Lithium 0.11.4 requires Minecraft 1.20.1. After: Loading 50 mods, Starting minecraft server version 1.21.1, Done.
The crash before, and our own start of the fixed server after the run.

How Stella does it.

  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.

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.

Paste it into Stella and press Enter.

This is the exact prompt from the recording. If your files are somewhere else, say where.

Do 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 it 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 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.

Checked against these sources on 10 November 2026.

Stella