Iris Veil Compat

Iris Veil Compat

Iris Veil Compat

让使用 Veil 渲染引擎的模组（例如 Create: Aeronautics）在使用 Iris 光影包时也能正确渲染。

原理

Veil 是一款面向 Minecraft 模组的高级渲染 SDK，提供可供其他模组使用的光影基础设施。最知名的使用者是 Create: Aeronautics，它使用 Veil 渲染飞机机翼、玻璃面板、尾迹及其他视觉效果。

问题在于：通过 Iris 启用光影包后，Veil 渲染的画面会完全绕过光影包的渲染管线，导致这些画面显示异常或缺失。

本模组会在运行时自动将 Veil 光影代码合并到光影包的 gbuffer 程序中，让基于 Veil 的画面（例如 Aeronautics 飞机）与光影包无缝协作。

实现细节

本模组通过 mixin 拦截 Veil 的光影编译过程，捕获并缓存处理后的光影源码。渲染时，它会使用 AST 级补丁（由 glsl-transformer 提供支持）将 Veil 光影逻辑注入光影包的 gbuffer 顶点/片段程序，并创建一个 Iris ShaderInstance 来替换原始的 Veil 光影。

切换或重新加载光影包时，缓存会自动失效，无需重启。

兼容性

• Iris 1.8.1+（必需）
• Sodium
• Veil 4.0.0+
• 已使用 Create: Aeronautics（Spring、Laser）和 Sable 进行测试

致谢

本项目使用 glsl-transformer 操作光影 AST。