[YM] 面纱虹膜灯光兼容 (VILC)

[YM] 面纱虹膜灯光兼容 (VILC)

Iris 支持的面纱光照与阴影 + 着色器包

装饰

Veil Iris Lights Compat

为 Iris 光影包提供客户端 Veil 光照渲染。

Veil Iris Lights Compat 展示图

Minecraft 1.21.1 | NeoForge 21.1.228+ | 仅客户端 | 当前版本:1.5.1

Veil Iris Lights Compat,简称为 VILC,可在启用 Iris 光影包时保持动态的 Veil 点光源和区域光可见。它在 Iris 完成关卡图像渲染后,于自己的光照通道中绘制 Veil 的光照数据。

VILC 不会在 Iris 内转换或运行其他 Veil 着色器效果。

VILC 不添加方块、物品、生物或玩法内容。它是一个渲染兼容模组,用于其他已经使用 Veil 的模组,包括 YesMenn! Colored Lights、Nox Lights 以及其他标准 Veil 光源。

功能

  • 为标准 Veil 点光源添加光影包感知渲染
  • 为标准 Veil 矩形区域光添加光影包感知渲染
  • 支持锥形和聚光灯式区域光
  • 当源模组更新变换时,支持移动和旋转的光源
  • 支持同一场景中多个不同颜色的光源
  • 从深度数据重建世界坐标和表面法线
  • 在受光表面添加漫反射、角度感知的光照响应
  • 支持可配置的体素遮蔽和方块阴影
  • 在明亮的彩色光照下保留可见的纹理细节
  • 使用实时外观控制来调节光影包光照
  • 当 Iris 存在但光影包被禁用时,提供基于深度的回退通道
  • 在窗口大小调整和全屏切换后恢复光照通道帧缓冲

动态光照支持

VILC 可与 Veil 的标准光照数据配合使用:

  • PointLightData
  • AreaLightData

对于兼容的模组,区域光还可以额外提供光束整形:

  • 光束角度
  • 光束大小
  • 边缘柔和度
  • 聚焦
  • 方向和旋转

这些控制对于舞台灯、探照灯、装饰性 RGB 聚光灯、现场演出布置、技术性建筑,以及其他需要光源表现得像真正的定向光束而非简单发光点的场景特别有用。

配置

从模组列表打开配置,或默认按 O 键打开。

配置存储在:

config/veil_iris_lights.json

质量预设

预设 点光源 区域光 表面法线 体素阴影
性能 24 8 快速 禁用
均衡 48 16 快速 启用
高 96 32 详细 启用

每个主要性能设置也可以手动调整:

  • 点光源预算从 1 到 96
  • 区域光预算从 1 到 96
  • 详细或快速表面法线
  • 体素阴影开关

外观控制实时更新:

  • 曝光
  • 颜色强度
  • 颜色饱和度
  • 中性提升
  • 亮度归一化限制

重置按钮会恢复外观控制,但不会清除自定义光照预算和质量选项。

调试

VILC 向 F3 和 BetterF3 添加有用的渲染信息:

  • 活动光照通道
  • 光影包通道或回退通道状态
  • 已上传的点光源数量
  • 已上传的区域光数量
  • 已配置的光照预算
  • 体素遮蔽状态
  • 当前渲染目标状态

这在检查光影包是否使用 VILC 通道、场景是否达到光照预算,或体素阴影当前是否激活时很有用。

需求

依赖 要求
Minecraft 1.21.1
NeoForge 21.1.228 或更新
Iris 1.8.14 beta 1 或更新
Veil 4.1.4 或更新
Sodium 0.8.12 beta 1 或更新

仅在客户端安装 VILC。专用服务器不需要它。

模组开发者支持

使用 Veil 标准 PointLightData 和 AreaLightData 的模组会被 VILC 的兼容光照通道自动识别。标准光照不要求直接依赖 VILC。

模组可以选择使用 VILC 的区域光形状支持,以实现逐光源的光束柔和度和聚焦控制。不使用此可选 API 的模组仍会以默认区域光行为渲染。

包含自身光源的方块可以通过以下标签选择退出自遮蔽:

#veil_iris_lights:non_occluding

客户端模组也可以直接注册非遮蔽方块:

VeilIrisLightOcclusion.registerNonOccluding(
    ResourceLocation.fromNamespaceAndPath("example", "light_block")
);

标准点光源和区域光 API 之外的自定义 Veil 光照渲染器类型可能需要单独集成。

兼容性说明

  • 光影包差异很大,因此不寻常的管线可能仍需要特定的兼容工作
  • VILC 是客户端的,不会改变服务器行为
  • 体素阴影使用以相机为中心的 64 x 64 x 64 方块网格
  • 复杂方块模型会被近似用于遮蔽
  • 树叶使用部分体素透射,而不是完整的纹理 Alpha 采样
  • 活动体素网格之外的遮蔽无法完美重建
  • 光照预算限制每帧处理多少可见的 Veil 光源
  • 第一人称手持物品光照可能因光影包和模型而异
  • 正常的非光影包 Veil 光照有意与光影包光照调节分开
  • 来自其他模组的视觉光束网格仍由那些模组控制

搭配良好

  • YesMenn! Colored Lights 用于可配置的 RGB 方块、面板、灯管、聚光灯、隐形聚光灯和光照工具
  • Nox Lights 以及其他使用标准 Veil 点光源或区域光的模组
  • BetterF3 用于扩展调试布局

近期亮点

  • 改进了彩色 Veil 点光源和区域光的光影包集成
  • 为兼容模组添加了专用的聚光灯式区域光行为
  • 添加了实时光影包光照外观调节
  • 改进了窗口大小调整和全屏切换后的帧缓冲恢复
  • 添加了 F3 和 BetterF3 渲染状态诊断
  • 为模组开发者添加了可选的非遮蔽光源支持

由 xcruell & YesMenn! 制作