# Minecraft shaders not showing up in the Shader Packs list

> Markdown version of https://stella.sh/how/game-mods/install-minecraft-shaders for agents and LLMs.
> A shader pack only appears in Iris if its zip sits in the shaderpacks folder, not resourcepacks, with shaders/ at the top. Fix it by hand or let Stella (stella.sh) do it.

Shader packs go in `.minecraft/shaderpacks` as the zip you downloaded, not in `resourcepacks` and not unzipped one folder too deep. Iris lists a pack only when the `shaders` folder is at the top of the zip. In the game: Options, Video Settings, Shader Packs, Open Shader Pack Folder, drop the zip in, select it and Apply. Stella (stella.sh) finds where the pack ended up, moves it, and switches it on in Iris's settings file.

- 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: Fixed in about 75 seconds. Checked afterwards against an answer key written before the run: the pack in `shaderpacks` with `shaders/` at its top and all 7 shader files; Iris set to use it with shaders switched on and its other settings kept; mods and game options untouched; the stray copy gone from resource packs. File-level check only: no Minecraft account was used and the game was never launched, so the shader wasn't seen rendering. The Lumen pack is a stand-in made for this run. The work is sped up 2×.

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

Transcript:

- 0:00 Stella on a Linux computer with a Fabric 1.21.4 setup and Iris installed.
- 0:02 The prompt: the Lumen shader doesn't appear in Shader Packs; fix it and turn it on.
- 0:17 Stella replies that it's looking into why Iris doesn't list the pack.
- 0:23 Finding and moving the pack, sped up 2×.
- 0:32 Done: the zip was in resource packs; it's now in shaderpacks and switched on for the next launch.

What Stella does:

1. Looks for the Lumen pack and finds it in the resource packs folder, where Iris never looks
2. Checks the zip has the `shaders` folder at its top level, so it doesn't need re-packing
3. Moves it into `shaderpacks` and removes the stray copy from resource packs
4. Edits Iris's settings file to select Lumen and turn shaders on, leaving the other settings and your mods alone
5. Tells you to start the game with the Fabric profile, and that it hasn't launched the game to see it running

## The prompt to paste

```text
I put the Lumen shaders zip in Minecraft but it doesn't show up in the Shader Packs list. Iris is already installed. Can you fix it and turn the shader on?
```

## Fix it yourself

1. **Make sure Iris (or OptiFine) is running.** Shaders need a shader mod. In the game, Options, Video Settings should have a Shader Packs button. If it doesn't, you launched a profile without Iris: pick the Fabric profile, or [install Sodium and Iris](https://stella.sh/how/game-mods/install-sodium-iris-minecraft-1-21-fabric) first.
2. **Open the shaderpacks folder from the game.** Options, Video Settings, Shader Packs, Open Shader Pack Folder. This opens the right folder for the profile you're in, which matters with launchers that keep separate instances.
3. **Drop the zip in, unopened.** Move the shader .zip from Downloads (or from `resourcepacks`, if you put it there) into this folder. Don't unzip it. If you did unzip it, the folder you keep must contain a `shaders` folder directly inside it, not another folder first.
4. **Check what's inside an odd download.** Some sites wrap the real pack in a second zip or folder with a readme. Open it: if you see `shaders` at the top, that's the pack. If you see another folder or zip, that inner one is the pack to use.
5. **Select it and apply.** Back in Shader Packs, click the pack name, then Apply and Done. If it's still missing, press the refresh by closing and reopening the menu. Lower render distance or shader quality if frames drop.

## Where Stella stops

- Checked at file level only: no Minecraft account was used and the game wasn't launched, so we didn't see the shader render.
- Shaders need a capable graphics card. Stella can switch a pack on and choose lighter settings, but it can't make a weak laptop run one smoothly.
- Iris rewrites its settings file when the game closes, so quit Minecraft before asking Stella to change shader settings.
- Recorded on Linux (`~/.minecraft`). On Windows the folder is `%appdata%\.minecraft\shaderpacks`, on a Mac `~/Library/Application Support/minecraft/shaderpacks`.
- Only folder and file names and Iris's small settings file go to the AI model you use in Stella.

## Questions

**Why is my shader in the resource packs list instead?**
You put it in `resourcepacks`. Resource packs change textures; shader packs change lighting and need Iris or OptiFine. Move the zip to `shaderpacks`.

**Do I need to unzip shaders?**
No. Leave the zip as it is. Iris reads zips directly, as long as `shaders` is the first folder inside.

**Why is there no Shader Packs button?**
Iris isn't loaded: you launched the plain profile, or Iris doesn't match your game version. See [install Minecraft mods](https://stella.sh/how/game-mods/install-minecraft-mods) for how loaders and versions must match.

**What's the difference between shaders and resource packs?**
Resource packs swap textures and sounds and need no mods: see [install a resource pack](https://stella.sh/how/game-mods/install-minecraft-resource-pack). Shaders add lighting, shadows and water effects and need a shader mod.

**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: [Iris Shaders](https://irisshaders.dev/), [Iris on GitHub](https://github.com/IrisShaders/Iris).

## 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)
- [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 install Minecraft mods, and why yours don't show up](https://stella.sh/how/game-mods/install-minecraft-mods.md)
- [Minecraft modpack crashing with exit code 1? Find the real error](https://stella.sh/how/game-mods/minecraft-modpack-exit-code-1.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.
