📖 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.
• 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.
└── 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).
└── 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.
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!
📋 Shader Pack Compatibility (reference)
| Shader Pack | Status | Notes |
|---|---|---|
| Complementary Shaders | ✅ Fully supported | Recommended |
| BSL Shaders | ✅ Fully supported | Works great |
| SEUS Renewed | ✅ Supported | Some features disabled |
| Chocapic13 | ✅ Supported | Performance friendly |
| Sildur's Vibrant | ✅ Supported | Works out of the box |
| Nostalgia Shaders | ⚠️ Partial | Some effects missing |
| Continuum | ❌ Unsupported | Requires 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