Iris Veil Compat
by leon-o
Iris Veil Compat lets Veil-rendered visuals, such as planes from the Aeronautics setup, display correctly while an Iris shaderpack is active.
What it does
When a shaderpack is enabled through Iris, visuals drawn by Veil normally skip the shaderpack pipeline and can look broken or disappear. This NeoForge mod intercepts Veil's shader compilation with mixins, keeps the processed shader source in a cache, and merges Veil shader logic into the shaderpack's gbuffer programs while the game runs. An Iris shader instance then takes the place of the original Veil shader, so the affected effects follow the pack's lighting and post-processing.
The cache is cleared whenever a shaderpack is switched or reloaded, so changing packs does not require a restart. The patching works on the parsed shader code rather than plain text, using the glsl-transformer library. The mod needs Iris Shaders and is built against Iris or newer and Veil 4.0.0 or newer. It is tested with Create: Aeronautics (Spring and Laser) and Sable. Only the client needs it, and the mod is open source under the GNU Lesser General Public License v3.0 only. Files target 1.21.1 for NeoForge, with 1.21.1+0.4.0-alpha as the latest file, published 2026-10-04.
Key features
Veil visuals inside shaderpacks
Veil shader output is merged into the active shaderpack's gbuffer programs so these visuals pass through its pipeline.
Runtime shader patching
Shader code is patched at render time with AST-level edits, so no changes to shaderpack files are needed.
Automatic cache invalidation
Cached shader source is discarded when a shaderpack is switched or reloaded, so changes take effect without a restart.
Replacement shader instance
An Iris shader instance stands in for the original Veil shader while the pack is active.
Aeronautics and Sable support
Testing covers Create: Aeronautics Spring and Laser parts and the Sable mod, the setups the author checked.
Compatibility
Latest build for each game version and loader.
Only full game releases are shown. This mod publishes no snapshot builds.
Requirements
Dependencies declared by the latest file for each loader.
Required 1
How it compares
Iris Extension is a Fabric and NeoForge client mod for 1.21.1 – 26.3, licensed under the Creative Commons Attribution Non Commercial Share Alike 4.0 license and not open source. Shaderpack_KaiGuan is a NeoForge shaderpack for 1.21.1 that needs a client, with the server optional, and is licensed as All rights reserved. Iris/Oculus & GeckoLib Compat is open source under the MIT License, client-side only, and covers 1.18.2 – 1.21 on Fabric, Forge and NeoForge, so it targets a different set of loaders and versions.
| Mod | Loaders | Game versions | Environment | Updated |
|---|---|---|---|---|
| Iris Veil Compat | NeoForge | 1.21.1 | Client-side only | 2026-10-04 |
| Iris Extension | Fabric and NeoForge | 1.21.1 – 26.3 | Client required, server optional | 2026-09-23 |
| Shaderpack_KaiGuan | NeoForge | 1.21.1 | Client required, server optional | 2026-08-20 |
| Iris/Oculus & GeckoLib Compat | Fabric, Forge and NeoForge | 1.18.2 – 1.21 | Client-side only | 2024-03-16 |
Questions
Does Iris Veil Compat need Iris Shaders?
Which Veil version does the mod work with?
Does the server need this mod?
More from leon-o
What the author says
The problem: when you enable a shaderpack via Iris, Veil-rendered visuals bypass the shaderpack's pipeline entirely, causing them to appear broken or missing. This mod automatically merges Veil shader code into the shaderpack's gbuffer programs at runtime, so Veil-based visuals (like Aeronautics planes) integrate…
Official listing
- Modrinth page
- modrinth.com/mod/iris-veil-compat
- Owner
- leon-o
- Published
- 2026-05-12
- Updated on Modrinth
- 2026-10-04
- Facts verified
- 2026-10-15