# How to install Minecraft mods, and why yours don't show up

> Markdown version of https://stella.sh/how/game-mods/install-minecraft-mods for agents and LLMs.
> Mods only load from the mods folder, built for your loader and game version, one copy each. Sort the jars by hand or let Stella (stella.sh) install the ones that work.

Minecraft only loads mods from the `mods` folder of the profile you launch, and only jars built for that profile's loader (Fabric or Forge) and exact game version. Put each mod in once, remove older copies, and add the library mods they need. Stella (stella.sh) reads every jar in your Downloads, installs the ones that match your Fabric version, moves out the duplicates and tells you which ones can't work and why.

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

## Stella doing it

Recorded 13 November 2026 on Linux (Omarchy) with Claude Code with Opus, on a Claude plan.
Result: Sorted in under a minute and a half. Checked afterwards against an answer key written before the run, by reading the mods folder: exactly one jar each of Fabric API, Swift Render (0.6.2 only), Lantern Lights, Cloth Config, Hearth Menu and AppleCore HUD; the Forge mod, the 1.20.1 mod and the resource pack kept out of it. Stella named both mods that won't work and why. File-level check only: the test computer had no Minecraft account and the game was never launched. The mods are fictitious stand-ins with real mod metadata inside, made for this run. The work is sped up 3×.

Video (45 s): https://stella.sh/media/proofs/game-mods/install-minecraft-mods/proof.mp4

Transcript:

- 0:00 Stella on a Linux computer. Downloads holds a mix of mod jars, a duplicate and a texture pack.
- 0:01 The prompt: install the mods that work with Fabric 1.21.4 and say which won't.
- 0:12 Stella replies that it will check each mod against Fabric 1.21.4 first.
- 0:19 Reading every jar and installing, sped up 3×.
- 0:31 Done: five mods and the texture pack installed, the old Swift Render moved aside, and the Forge and 1.20.1 mods explained.

What Stella does:

1. Opens each downloaded jar and reads its built-in description (`fabric.mod.json` or Forge's `mods.toml`) for the loader, Minecraft version and required mods
2. Installs the five that fit Fabric 1.21.4, one copy each: AppleCore HUD had been downloaded twice
3. Moves the old Swift Render 0.5.1 into a backup folder so it doesn't clash with the new 0.6.2, which would stop Fabric from starting
4. Spots that one zip is a texture pack, not a mod, and puts it with your resource packs
5. Leaves out the Forge-only mod and the one built for 1.20.1, says why for each, and reminds you to launch the Fabric profile

## The prompt to paste

```text
I downloaded a bunch of Minecraft mods into my Downloads for my Fabric 1.21.4 game but they don't show up. Install the ones that will work and tell me which ones won't.
```

## Install them yourself

1. **Know your loader and version.** Open the Minecraft Launcher, Installations, and look at the profile you play: it says something like `fabric-loader-1.21.4`. Every mod you add must say Fabric (or Quilt) and 1.21.4 on its download page. A Forge or NeoForge mod won't load on Fabric, and the reverse.
2. **Open the mods folder.** Windows: press Win+R and paste `%appdata%\.minecraft\mods`. Mac: in Finder, Go, Go to Folder, `~/Library/Application Support/minecraft/mods`. Linux: `~/.minecraft/mods`. Create the folder if it's missing. Launchers like Prism or CurseForge have their own mods folder per instance.
3. **Copy in one jar per mod.** Drag in the right jars from Downloads. Files named `something (1).jar` are second downloads; leave them out. If you're updating a mod, delete or move its old version out first: two copies stop Fabric with a “Duplicate mods found” error.
4. **Add what they depend on.** Most Fabric mods need Fabric API, and many need a library such as Cloth Config. The mod's page lists these under Dependencies. Download the versions for the same game version.
5. **Launch the right profile.** Pick the Fabric profile in the launcher, not the plain Latest release one, and press Play. If it stops with “Incompatible mods found”, the message names the mod and what it wanted; remove or replace that one and try again.

## Where Stella stops

- This was checked at file level only: no Minecraft account was used and the game wasn't launched, so a mod that is broken inside would only show when you play.
- Forge-only mods can't run on Fabric. Stella says so instead of forcing them in; you need a Fabric build or a Forge profile.
- Stella installs the files you downloaded. To fetch new mods, it uses Modrinth, CurseForge or the project's own site, never re-upload sites.
- Recorded on Linux, where the game folder is `~/.minecraft`. On Windows it's `%appdata%\.minecraft`, on a Mac `~/Library/Application Support/minecraft`; Stella finds it either way.
- Only file names and the mods' built-in descriptions go to the AI model you use in Stella.

## Questions

**Why don't my Minecraft mods show up?**
Usually they're still in Downloads, in the wrong profile's folder, or you launched the plain profile instead of Fabric or Forge. A jar for another loader or game version is also skipped or stops the game.

**What does “Duplicate mods found” mean?**
Two jars with the same mod inside are in the mods folder, often an old and a new version or a `(1)` second download. Keep one.

**Can I use Forge mods with Fabric?**
No. They're built for different loaders. Look for a Fabric version of the mod, or make a separate Forge profile for it.

**Do I need Sodium and Iris too?**
Only for better performance and shaders. See [Sodium and Iris on 1.21](https://stella.sh/how/game-mods/install-sodium-iris-minecraft-1-21-fabric), and if the game crashes at start, [exit code 1](https://stella.sh/how/game-mods/minecraft-modpack-exit-code-1).

**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: [Fabric documentation: Installing mods](https://docs.fabricmc.net/players/installing-mods), [Minecraft Wiki: .minecraft folder](https://minecraft.wiki/w/.minecraft).

## 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)
- [Minecraft modpack crashing with exit code 1? Find the real error](https://stella.sh/how/game-mods/minecraft-modpack-exit-code-1.md)
- [Minecraft shaders not showing up in the Shader Packs list](https://stella.sh/how/game-mods/install-minecraft-shaders.md)
- [How to install a Minecraft resource pack that isn't showing up](https://stella.sh/how/game-mods/install-minecraft-resource-pack.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)
- [Install a downloaded Minecraft map so it shows up in Singleplayer](https://stella.sh/how/game-mods/install-minecraft-map.md)

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