Skip to content
Iris Shaders Mod · Technical Details & Installation
🌈 Iris Shaders Mod
Modern shader pack loader • compatible with OptiFine shaders • Fabric & NeoForge & Quilt • client-side only

📖 Mod Overview & Core Features

🖼️ Shader loader

  • Modern shader engine – loads and runs OptiFine-compatible shader packs.
  • Wide compatibility – supports almost all existing shader packs.
  • Performance focused – optimised for modern GPUs and render pipelines.
  • Real-time visual effects – shadows, reflections, god rays, and more.

📦 Shader pack support

  • Seamless integration – drop shader packs into the shaderpacks/ folder.
  • Live switching – change shaders without restarting MCPE.
  • Shader settings UI – in-game configuration for each shader pack.
  • Built-in shader list – browse and download packs from the community.

⚙️ Compatibility & optimisation

  • Works with Sodium – designed to be compatible with performance mods.
  • OptiFine shader support – runs existing OptiFine packs with high fidelity.
  • Lightweight – minimal overhead compared to other shader loaders.
  • Multi‑loader – Fabric, NeoForge, and Quilt support.

🌐 Community & support

  • Active Discord – get support and development updates.
  • Developer docs – comprehensive guide for building and contributing.
  • Website – downloads, screenshots, and shader pack database.
  • Open source – contributions welcome on GitHub.

🛠️ Technical Summary

🧠 Architecture & rendering

  • OpenGL 3.2+ core – uses modern GLSL shaders for advanced effects.
  • Shader pack parser – reads OptiFine format and converts to Iris pipeline.
  • Dynamic buffer management – efficient vertex and uniform buffer handling.
  • Multi‑pass rendering – supports deferred and forward shading passes.

📦 Loader & dependencies

  • Fabric – requires Fabric Loader and Fabric API (for events).
  • NeoForge – works with NeoForge; no extra dependencies.
  • Quilt – fully compatible with Quilt Loader.
  • No OptiFine required – Iris is a standalone shader loader.

⚙️ Core mechanics

  • Shader compilation – just‑in‑time compilation with error logging.
  • Uniform injection – passes MCPE data (time, light, view matrices) to shaders.
  • Shadow map rendering – supports shadow mapping for directional lights.
  • Post‑processing pipeline – bloom, depth of field, and colour grading.

🔧 Advanced features

  • Shader pack options – in‑GUI configuration for each pack.
  • Custom shader uniforms – expose pack‑specific settings.
  • Hot reload – reload shaders on the fly without restart.
  • Performance metrics – FPS and render time display.
/* Technical highlights */
• Iris uses a custom GLSL preprocessor to handle OptiFine compatibility.
• Shader packs are loaded from /shaderpacks/ as ZIP or folder.
• The render pipeline supports both forward and deferred rendering.
• Uniforms are synced with MCPE's rendering state each frame.
• Works with Sodium's rendering optimisations for best performance.

📥 Installation Guide

🧵 Fabric Installation

RECOMMENDED Best performance & mod compatibility

1. Install the Fabric Loader for your MCPE version.

2. Download Fabric API (optional but recommended).

3. Download Iris-[version]-fabric.jar.

4. Place JARs in .minecraft/mods/.

5. Launch using the Fabric profile.

Example mods folder:
└── mods/
    ├── fabric-api-0.92.0+1.20.1.jar
    └── Iris-1.7.0+1.20.1-fabric.jar

Note: Fabric API is optional but improves compatibility.

⚙️ NeoForge & Quilt

ALTERNATIVE For Forge‑ecosystem or Quilt users

NeoForge:

1. Install the recommended NeoForge version for your MCPE.

2. Download Iris-[version]-neoforge.jar.

3. Place JAR in mods/ folder.

Quilt:

1. Install Quilt Loader.

2. Use the Fabric version of Iris (Quilt is Fabric‑compatible).

Example NeoForge mods folder:
└── mods/
    └── Iris-1.7.0+1.20.1-neoforge.jar

⚠️ Important: Iris is client‑side only – not needed on servers.

📌 Universal steps & recommendations

  • Shader packs: Place shader ZIPs in ./shaderpacks/ folder (next to mods folder).
  • Performance: For best results, use with Sodium and Lithium.
  • Compatibility: Most OptiFine shader packs work; check the unsupported list.
  • Configuration: In‑game shader settings accessible via the Video Settings menu.
  • Support: Join the Iris Discord server for help and updates.
⚡ Quick shader pack setup:
1. Install Iris (any loader).
2. Download a shader pack (e.g., Complementary, BSL).
3. Place the ZIP file in /shaderpacks/.
4. Launch MCPE and go to Options → Video Settings → Shaders.
5. Select your shader pack and enjoy!
✅ Fabric: Fabric Loader + Iris-fabric ✅ NeoForge: NeoForge + Iris-neoforge ✅ Quilt: Quilt Loader + Iris-fabric (compatible) 🖥️ Client‑side only – no server install needed

📋 Shader Pack Compatibility (reference)

Shader PackStatusNotes
Complementary Shaders✅ Fully supportedRecommended
BSL Shaders✅ Fully supportedWorks great
SEUS Renewed✅ SupportedSome features disabled
Chocapic13✅ SupportedPerformance friendly
Sildur's Vibrant✅ SupportedWorks out of the box
Nostalgia Shaders⚠️ PartialSome effects missing
Continuum❌ UnsupportedRequires OptiFine

Check the Iris website for the full compatibility list and shader pack downloads.

Iris Shaders Mod · by coderbot & IMS · Fabric · NeoForge · Quilt · MCPE 1.16.5–1.21.x

🌈 Modern shader loader · OptiFine compatible · open source · active community