Screenshot 1 of 5. Wide landscape with custom purple blocks, terrain, trees and cyan sky in the Miasma shader.
What Miasma works with.
| Platform | Java Edition |
|---|---|
| Loaders | Iris, OptiFine |
| Minecraft versions | 1.8.9, 1.16.5, 1.17.1, 1.18.2, 1.19.4, 1.20.6, 1.21.11, 26.1.2, 26.2, 26.3 |
Miasma is a cel-shading shader pack for Minecraft Java that turns the world into a toxic, acidic planet, in the style of Borderlands. It runs on Iris and OptiFine and works on the client side only.
Shader loaders and versions
- Iris and OptiFine: Minecraft 1.8.9 to 26.3.
What Miasma changes
The pitch is atmosphere. The world is meant to feel uninhabitable but mesmerizing. The listing sums up the effect in short lines, and Modrinth tags the pack as atmosphere, cartoon, cursed, fantasy and shadows. It also links a Discord for discussion and bug reports.
- The world breathes poison.
- Light bends through venomous air.
- Soil hums with decay.
- Step carefully, the planet remembers.
It suits horror maps and content that wants a bold, artistic look. The trade-off is the same as the appeal. This is a strong visual identity, not a subtle enhancement.
Installing Miasma
- 1.Install Iris or OptiFine if you have not already. The shader install guide covers both.
- 2.Get the pack from Modrinth using the link on this page.
- 3.Put the .zip in the shaderpacks folder inside your .minecraft directory.
- 4.Launch, open Options, then Video Settings, then Shaders.
- 5.Choose Miasma.
Miasma trailer
Questions about Miasma.
4 questions
How do I install the Miasma shader?
Install Iris or OptiFine, get the pack from Modrinth, and place the .zip in the shaderpacks folder inside your .minecraft directory. Then open Options, Video Settings, Shaders, and choose Miasma. The pack needs no other dependency.
Does Miasma work with Iris and OptiFine?
Yes. Both loaders have builds for it, and neither build lists a required dependency. Iris and OptiFine are Java mods, so Miasma does not run on Bedrock. Pick whichever loader you already use for your shader setup.
Which Minecraft versions does Miasma support?
Miasma covers 1.8.9 to 26.3 on both Iris and OptiFine. The newest release, 1.0.2, arrived on 2026-08-23. Check that your loader supports your chosen game release before you select the pack.
Is Miasma a realistic shader?
No. It is a cel-shading pack inspired by Borderlands, and its tags are cartoon, cursed and fantasy. It turns the world into a poisonous planet, so expect a stylised, dramatic look. It is a client-side Java pack for Iris and OptiFine, aimed at players who want a stylised experience, horror maps or bold, artistic content.
