Install Sodium and Iris on Minecraft 1.21 (Fabric)
Fabric, Sodium, Iris and Mod Menu in matching versions, ready to play.
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 7 min 04 s in real time.
The short answer.
Install the Fabric loader for your exact 1.21 version, then put Sodium, Iris, Mod Menu and Fabric API (Mod Menu needs it) into your .minecraft/mods folder, every file built for that same version, and start the game from the Fabric profile. Most crashes come from one file built for a different version. Stella (stella.sh) can do the whole install on your computer: it picks versions that match, downloads them from Modrinth, checks each file and sets up a Fabric profile ready to play.
Stella does this on Windows, Mac and Linux.
What happened.
A launcher profile named “Fabric 1.21.1 - Sodium + Iris” (Fabric Loader 0.20.1), with sodium-fabric-0.8.13+mc1.21.1.jar, iris-fabric-1.8.14-beta.1+mc1.21.1.jar, modmenu-11.0.5.jar, fabric-api-0.116.18+1.21.1.jar and placeholder-api-2.4.2+1.21.jar (a Mod Menu dependency) in the mods folder, each checked against Modrinth’s SHA-512. The computer had no launcher or Java, so Stella installed the official Minecraft Launcher and Temurin Java 21 too.
Stella didn’t sign in or launch the game, because the test computer had no Minecraft account. The recording shows the chat; the work happened in the background.
How Stella does it.
- Looks for Minecraft, the launcher and Java; on a computer without them it installs the official Minecraft Launcher and Java 21 first
- Picks one game version (1.21.1 in the recording) that Sodium, Iris, Mod Menu and Fabric API all support
- Downloads the mods, plus the libraries they depend on, from Modrinth, and checks every file against Modrinth's published checksums
- Runs Fabric's official installer and creates a named profile, leaving your other profiles and worlds alone
- Stops before signing in: you open the launcher, sign in with your Microsoft account, pick the profile and press Play
The prompt.
Install Fabric for Minecraft 1.21.1 and add Sodium, Iris and Mod Menu so my game runs faster.
This is the exact prompt from the recording. If your files are somewhere else, say where.
Do it yourself.
Run 1.21 once without mods
Open the official Minecraft Launcher, pick the 1.21 release you want under Installations, and start a world once. This downloads the game files Fabric builds on. Close the game afterwards.
Install the Fabric loader
Download the installer from fabricmc.net/use/installer (an .exe on Windows, a .jar everywhere else). Choose Client, the same Minecraft version, the newest loader, and click Install. A new
fabric-loader-1.21.xprofile appears in the launcher.Download the four mods for that exact version
On Modrinth, open Sodium, Iris, Mod Menu and Fabric API. On each, filter by Fabric and your game version and download the .jar. Iris needs a matching Sodium release, so take the newest of both for the same version.
Put the files in your mods folder
Open the mods folder:
%appdata%\.minecraft\modson Windows (paste it into the Run box with Win+R),~/Library/Application Support/minecraft/modson Mac,~/.minecraft/modson Linux. Create the folder if it doesn't exist, then drop the four .jar files in. Remove older copies of the same mods.Launch the Fabric profile and check
Start the game from the Fabric profile. The title screen gains a Mods button (that's Mod Menu) listing Sodium and Iris, and Video Settings switches to Sodium's menu. If it crashes, open
logs/latest.logand look for a line naming a mod and the version it needs.Add a shader pack
Download a shader pack .zip (Complementary or BSL are common picks), then go to Options, Video Settings, Shader Packs, click Open Shader Pack Folder, drop the .zip in and select it. Don't unzip it. Lower the render distance if frames drop.
Where it stops.
- Java Edition only. Bedrock (the Microsoft Store and console version) uses add-ons, not Fabric mods.
- Stella only downloads from Modrinth, CurseForge and the projects' own sites. It won't fetch mods or cracked launchers from re-upload sites.
- It won't touch server anti-cheat or install mods a server bans. Check a server's rules before joining with mods.
- On Linux, Stella can't click inside the Minecraft Launcher. It installs Fabric with the official installer from the terminal instead, and you press Play yourself.
- It won't sign in to your Microsoft account for you. Signing in and pressing Play stay with you.
- Shaders cost real graphics power. On a weak or older laptop GPU, Stella can pick lighter settings, but it can't make shaders run smoothly on hardware that can't handle them.
Questions.
Do I need Fabric API for Sodium and Iris?
Sodium and Iris don't need it on their own, but Mod Menu does, and most other Fabric mods do too. Putting the matching Fabric API in your mods folder avoids a crash later.
Why does the game say “Iris requires Sodium” or crash at startup?
Your Iris and Sodium files don't match each other or your game version. Delete both, download the newest of each for exactly your Minecraft version, and launch again. logs/latest.log names the version it wanted.
Can I use OptiFine with Sodium and Iris?
No. OptiFine doesn't run on Fabric and conflicts with Sodium. Iris loads most OptiFine shader packs, so you usually don't need it.
Will mods get me banned?
Sodium, Iris and Mod Menu only change graphics and menus on your side, and they're allowed on most servers. Some servers ban client mods outright, so read their rules first.
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.