🚀 Lumina Shader Lite v1.2.8-rc.2 — 兼容性与阴影稳定性

此候选版本重点扩展了 Minecraft 兼容性，强化了阴影渲染，并防止复杂视觉效果中的数学错误。其结果是为即将到来的正式版打下更安全、更干净、更可靠的基础。✨

🌍 兼容性与稳定性

• 🧩 改进了 Minecraft 1.16.5 至 26.3 的版本相关条件。

• 🧱 修正了不同 Minecraft 版本中方块、炼药锅、植被和船只的标识符。

• 📐 改进了线条渲染兼容性。

• 🔍 强化了各向异性过滤的安全防护。

• 🌌 修复了某些末地效果中可能产生无效值的计算。

• 🌿 移除了生物群系过渡之间的干扰，提升了环境一致性。

🌑 五项阴影相关修复

阴影渲染获得了五项针对性的稳定性和准确性改进：

• ☁️ 统一了地形阴影、云阴影和体积光光线所使用的深度计算。

• 🌿 修复了太阳位于正上方时树叶阴影的偏移问题。

• 🌤️ 修正了阳光以倾斜角度照射时云阴影的投影问题。

• ✨ 防止了极低帧率下无效的光线计算。

• 🛡️ 防止了在无有效体积采样时的除零错误。

这些修正使阴影在全天更加一致，同时保护着色器免受罕见的数值错误影响。

🧪 更强的验证

• ✅ 添加了新的自动化回归测试。

• 🖥️ 在 GitHub Actions 中添加了着色器编译与链接检查。

• 📚 添加了专门的兼容性文档。

• 📦 准备并验证了 rc.1 和 rc.2 的分发 ZIP 包。

• 🔎 扩展了对版本相关及可选着色器路径的验证。

📊 最终验证结果

• 20 项自动化测试全部通过

• 5,628 种着色器编译与链接组合已验证

• 0 个编译错误

• 0 个链接错误

🚧 发布状态

Lumina Shader Lite v1.2.8-rc.2 现已准备就绪，可在 luminalitedev 分支上进行最终视觉测试。

此候选版本使 Lumina Lite 向完整支持 Minecraft 26.3 又迈进了一步，同时保持了其轻量级设计、广泛的版本兼容性以及注重性能的特性。🚀💙

🚀 Lumina Shader Lite v1.2.7 — 性能释放

Lumina Shader Lite 现在比以往更快、更简洁、更高效。 ⚡

这次以性能为重点的重大更新彻底重构了所有画质配置档，显著减少了不必要的 GPU 运算，并在保持 Lumina Lite 视觉风格的同时，改善了集成显卡和低端显卡的使用体验。

内部测试显示，根据硬件、配置档和场景的不同，FPS 提升了 28–30%。📈

⚡ 巨大的性能提升

• 完全优化了所有七种性能配置档，从马铃薯到极致档。

• 降低了阴影、影像、SSAO、泛光、水面、云朵和实体阴影的消耗。

• 阻止了未使用的影像和后处理通道在较低配置档上运行。

• 在不需要时禁用了非活动的时序抗锯齿程序。

• 将每个活动图块的低细节泛光过滤采样数从 49 个减少到 25 个。

• 将低细节程序化水面法线的纹理读取次数从 四次减少到两次。

• 提升了低、极低和马铃薯配置档的着色器加载速度。

• 显著改善了集成显卡和低端 GPU 的性能。

🎚️ 完全重新平衡的配置档

每个配置档现在都遵循清晰一致的画质阶梯：

🥔 马铃薯 → 最大性能
⚡ 极低 → 轻量级视觉效果
🚀 低 → 最佳性能与画质平衡
🎮 中 → 改进的效果与细节
✨ 高 → 更高的阴影和视觉质量
💎 极高 → 高级效果
🌟 极致 → 最大视觉质量

“低”现在是默认配置档，在安装着色器后立即提供更流畅的性能、更低的 GPU 占用和更好的体验。

继承的“互补”配置档已被移除，使配置档选择器更简洁，并防止出现令人困惑或不正确的默认设置。

🌕 全新的可配置月晕

Minecraft 的夜空获得了一项美丽的新的大气细节：

• 在月球周围添加了柔和的程序化光晕。

• 强度完全可配置。

• 自动对雨天、云层和月相做出反应。

• 自然地出现在符合条件的天空和水面影像中。

• 不使用额外的纹理或昂贵的体积效果。

• 禁用时，其代码将从编译中完全排除。

结果是一个更具电影感和沉浸感的夜空，同时不牺牲 Lumina Lite 的轻量级设计。🌌

🌊 水面与视觉修复

• 修复了影响马铃薯、极低和低配置档的水面编译错误。

• 提高了低细节程序化水面的稳定性。

• 为 labPBR 资源包添加了更安全的自定义法线贴图重建。

• 稳定了 PBR 和 POM 位移计算。

• 改善了极端视角下的 GGX 影像。

• 保护了云影计算免受无效角度的影响。

• 添加了更安全的各向异性过滤回退方案。

• 修复了地平线附近像素化彩虹的数学不稳定性。

🧹 更简洁的界面

• 移除了过时的高级色彩追踪控制。

• 移除了不可用的世界空间影像选项。

• 消除了继承的和孤立的设置屏幕。

• 简化了优化菜单。

• 改善了配置档一致性和默认值处理。

🧪 更强的自动验证

Lumina Shader Lite 现在会自动验证：

• 性能配置档顺序和安全保护。

• 菜单、选项、屏幕和滑块。

• 轻量级着色器程序路径。

• 元数据和版本一致性。

• 着色器包含文件和条件块。

• 发布 ZIP 完整性和源代码对等性。

• 无效、重复、隐藏或过时的控件。

这些检查有助于防止配置错误和未来更新中的性能回归。🛡️

📈 最终成果

• 测试中 FPS 提升高达 28–30%。

• 较低配置档的着色器加载速度更快。

• 高消耗场景下的 GPU 占用更低。

• 集成显卡上的性能更好。

• 画质提升过程更加一致。

🌌 卢米娜光影精简版 v1.2.6

本次维护更新提升了卢米娜光影精简版在复杂渲染条件下的稳定性，同时保持其轻量级设计与独特视觉风格。✨

🛠️ 已修复 — 渲染稳定性

• 🛡️ 通过安全舍弃近乎完全透明的片段，避免附魔盔甲及玩家周围出现黑色矩形。
• 🌤️ 当阴影颜色长度为零时，防止自然光束与冰晶光束中产生无效的 NaN 值。
• ☁️ 当太阳与水平世界轴对齐时，稳定云层阴影投射效果。
• ❄️ 防止雪地、树叶及IPBR材质上因除零错误导致生物群系色调移除失效。
• 💧 防止高水波设置引发法线贴图计算异常。
• 🌫️ 防止体素烟雾光束在空体积采样中因除零错误而崩溃。

🎨 已优化 — 兼容性与界面

• 👻 在舍弃完全透明片段的同时，保留刻意设计为半透明的模组实体。
• 🎛️ 从精简版界面及配置文件中移除不可用的高级色彩追踪控制选项。

✅ 验证机制

• 🔍 版本校验现要求元数据严格匹配，并拒绝含有错误预发布后缀的版本。
• 🤖 新增自动着色器验证机制，覆盖开发推送、main 分支及拉取请求。
• 📦 已验证着色器包含项、预处理器代码块、默认配置文件、元数据，以及ZIP包与源码的一致性。
• 🧹 确认最终ZIP包共含397个文件，且不含任何冗余的macOS元数据。

💙 感谢您使用卢米娜光影精简版！ 尽享更洁净、更安全、更稳定的视觉体验。

🌌 卢米娜光影 Lite v1.2.5

本次更新在保持卢米娜光影 Lite 轻量级设计与性能优先理念的同时，优化了天空效果、自发光照明、视觉自定义选项及稳定性。✨

✨ 新增功能

🌠 银河亮度

• 在环境与天空设置中新增银河亮度选项。
• 可选等级：关闭、25%、50%、75%、100%、125% 和 150%。
• 默认值为100%，以保留原始视觉效果。
• 选择关闭将从天空与反射着色器中完全移除银河相关计算，带来小幅性能提升。

🌋 岩浆亮度

• 新增独立调节岩浆亮度的控制选项。
• 玩家现可单独调低或调高岩浆亮度，而不影响其他自发光材质。

🎨 视觉优化

• ☀️ 白天地平线与远距离大气雾效现采用更纯净、更自然的天蓝色调。
• 🌌 银河现能正确跟随夜空运动。
• 🔭 改进了银河程序化纹理的连续性，消除可见接缝。
• 🌧️ 在启用强降雨且更寒冷天气风格时，修正了中层天空在暴雨期间的色彩表现。
• 🌋 优化了岩浆自发光强度与泛光效果之间的平衡。

🛠️ 修复问题

• 防止大面积岩浆表面导致画面过曝，避免屏幕整体泛白。
• 在岩浆自发光进入泛光处理阶段前对其强度进行限制。
• 为泛光输入添加安全上限，以管控极端自发光光源。
• 修复了一个继承自旧版本的缺陷：此前错误地将地平线处的雨天颜色应用于中层天空区域。
• 无论是否启用 SPECIAL_BIOME_WEATHER，均应用雨天色彩校正。
• 移除了银河图像中的球面坐标接缝。
• 修正银河的天球朝向，使其能随夜空自然移动。

⚡ 性能优化

• 减少了银河所用程序化噪声计算的数量。
• 银河效果持续保持无需额外纹理、光线步进或高开销体积渲染效果的特性。
• 完全禁用银河后，其全部计算将从编译后的天空与反射着色器中彻底剔除。
• 默认的100%设置既保留了预期视觉效果，也契合卢米娜光影 Lite 专注性能的设计定位。

✅ 验证工作

• 验证了所有着色器引用与包含文件。
• 逐一测试了所有新选项所涉及的条件分支路径。
• 验证了设置菜单界面及所有可选参数值。
• 确认分发包完整性与源码一致性。
• 确认最终 ZIP 包共包含397 个文件。
• 确认未包含任何不必要的 macOS 元数据（包括 .DS_Store 文件）。

💙 感谢您使用卢米娜光影 Lite！尽享更明亮的天空、更出色的光照、更丰富的自定义选项以及流畅稳定的运行体验。

露米娜光影 Lite 版本 1.2.4 将经过验证的 RC4 视觉效果与发布候选周期内测试的内部修复及优化整合为一体。

新增特性：

• 宽幅对角线状银河系，搭配圆润的星云、温暖的银心、清凉的外围晕染以及扭曲的尘埃带。

已修复问题：

• 防止在零亮度色彩归一化过程中产生非数值（NaN）结果。
• 修正远景地平线（Distant Horizons）的时间性重投影，以减少细节层次（LOD）幽灵现象。
• 移除银河系中的方向性光痕，同时保留深邃的午夜苍穹与现有恒星。

性能优化：

• 在阴影采样过程中复用光照贴图幂次计算。
• 银河系渲染不依赖纹理采样、新资源或体素光线步进技术。

校验机制：

• 新增自动化元数据、头文件包含、预处理器指令、性能分析配置及 ZIP/源码一致性校验。

最终视觉发布候选版本。此版本直接更新了 RC4；未创建 RC5。

已修复：

• 移除了因将像素噪声投射至天空而残留的纤维状/帷幕状纹理。

已更改：

• 采用 Lumina 现有的平滑云层纹理，以呈现连贯的星系团块。
• 两层独立旋转的纹理共同构成宽广的辉光与不规则的尘埃带。
• 保留了对角弧线、清凉的外围薄雾、温暖的核心以及深邃的午夜色背景。

性能优化：

• 纹理采样次数由三次减少为两次。
• 未新增任何资源，亦未引入迭代噪声循环或体素光线步进算法。

视觉测试候选方案，用于替代过于暗淡的RC2银河系。

改动内容：

• 银河弧线更宽，整体可见度显著提升。
• 新增不规则发光云团与精细尺度结构。
• 银河核心呈现温暖、集中的视觉效果。
• 中心尘埃带经过扭曲处理，灵感源自真实拍摄的银河系影像。

性能设计：

• 复用现有着色器噪声纹理。
• 仅需三次纹理采样。
• 不使用迭代式程序化噪声循环或体素光线步进算法。

请于晴朗天气的午夜进行测试，并对比地平线附近与天顶区域的可见度。

基于 RC1 的视觉测试候选版本。

新增内容：

• 在保留深邃午夜天空与当前星体的前提下，加入一条细腻自然倾斜的银河光带。
• 加入轻量级中央尘埃带及柔和的结构变化。
• 在支持高质量天空反射的场景中，同步呈现相同的细腻光带。

性能设计：

• 不增加额外纹理采样。
• 不使用循环或体积噪声。
• 仅依赖小型解析计算，并在降雨、白昼及视野受阻时自动淡出。

请于午夜时分，在开阔地形中，从地平线至天顶方向进行测试，并分别测试有雨与无雨环境下的效果。

在稳定版 v1.2.4 发布前用于游戏内测试的候选版本。

已修复：

• 防止亮度为零时进行颜色归一化运算产生非数值（NaN）结果。
• 修正了“遥远地平线”（Distant Horizons）的时间性重投影，以减少摄像机移动过程中细节层次（LOD）切换时产生的残影现象。

已优化：

• 在阴影采样过程中复用光照贴图幂次计算结果。

请重点测试黑暗场景、摄像机在“遥远地平线”细节层次（LOD）过渡区域附近的移动效果，以及各性能配置下的阴影表现。

更新日志

1.2.3 — 2026年7月13日

Lumina Shader Lite 1.2.3 是一次以修复缺陷为主的维护性版本，未引入任何有意的视觉改动或新功能。

已修复

• 修正了非正方形分辨率下的垂直图像锐化偏移问题。
• 在暗色色调映射中，将未定义的反向 smoothstep 调用替换为有效实现。
• 修正了“遥远地平线”（Distant Horizons）水体淡出效果，使其在不同显卡驱动下表现一致。
• 从保留的 composite2 着色器程序中移除了无效的 GLSL 代码。
• 将最终抖动噪声居中处理，避免产生微小的正向亮度偏差。
• 补全了缺失的默认配置文件映射，确保当前启用的默认配置能被正确识别。
• 从高画质配置文件中移除了错误标注的“默认”标签。

🌟 卢米娜着色器：精简版 — v1.2.2 更新日志

🌤️ 1. 云层阴影优化（社区反馈）

• 默认禁用：在全局配置文件（common.glsl）中注释掉了 #define CLOUD_SHADOWS 指令。

• 修复内容：解决了社区报告的一个问题（TikTok 创作者重点指出）：在轻量级着色器中，云层阴影显得过于生硬或块状。默认禁用该功能可省去庞大的太阳光计算流程，显著提升基础性能（可在设置菜单中完全开启或关闭）。

🌊 2. 高级水面重制（“黄油着色器”风格）

• 平滑风格化基底：彻底移除了像素化的原版 Minecraft 纹理网格（colorP.rgb），在 water.glsl 中替换为简洁、平整且现代的视觉效果（colorPM = vec3(0.35)）。

• 鲜活青绿色辉光：调整了生物群系专属系数（glColorM），赋予其惊艳的青绿/青蓝色调（vec3(0.85, 1.08, 1.32)），并将其自发光亮度增强至 0.55 * glColorM，营造出晶莹剔透、光芒四射的热带水域观感。

• 视差位移绕过（大幅提升帧率）：禁用了繁重的光线步进浮雕循环（#if 0），将每像素 8 次纹理采样降至零，确保集成显卡也能实现极速渲染。

• 流畅高光反射：统一将镜面反射的平滑度设为较高值 0.55（smoothnessG），使水面呈现出干净、电影级的太阳与月光倒影，而非噪点状像素化效果。

• 编译安全防护（恢复 30 FPS）：将高级法线贴图计算封装于安全条件块内（#if WATER_STYLE >= 2）。此举修复了低端设备配置下关键的着色器编译警告/缺陷，立即将丢失的最高达 30 帧每秒性能完全恢复。

• 统一不透明度：将水面 Alpha 透明度设为精细调校后的 0.52，以实现最佳水下可视性与干净的深度混合效果。

🌌 3. 明艳高饱和度天空

• 全面重设 skyColors.glsl 中所有大气色彩配置，消除默认的褪色观感，呈现鲜明、高对比度的天空效果：

  • ☀️ 白昼：上层天空调整为浓郁靛蓝（vec3(0.68, 0.82, 1.15)），中层天空调整为明亮夏日青蓝（vec3(1.15, 1.3, 1.45)）。

  • 🌅 日落（黄金时刻）：地平线调整为恢弘琥珀金（vec3(1.70, 0.80, 0.30)），中层调整为炽烈橙色（vec3(2.1, 1.20, 0.80)），上层暮色则呈现优美的橙紫渐变（vec3(0.75, 0.40, 0.60)）。

  • 🌙 夜晚：夜空混合色设为深邃而富有美感的靛蓝-午夜蓝（vec3(0.03, 0.09, 0.24)）。

📦 4. 部署与构建清理

• 版本同步：正式将着色器版本号统一更新为 v1.2.2，涵盖项目元数据（pack.json）及本地化界面字符串（en_US.lang）。

• 整洁打包：生成最终部署归档包，并彻底清除所有临时开发者缓存与未优化资源残留。

🛠️ 性能与引擎（重大更新）

• 阴影：分辨率由 4096× 调整为 2048×（帧率大幅提升，画质影响极小）。

• 全新云层系统：中等画质下采用 2D 噪声引擎，移除了繁重的程序化 3D 计算。

• 优化 SSAO：减少环境光遮蔽采样数，提升密集生物群系中的画面流畅度。

• 阴影距离：中等画质下调整为 64 格，实现更佳平衡性。

• 光束效果：优化体积光渲染步进，加快渲染速度。

🎨 风格与用户界面

• 名称变更：原“Unbound”风格现正式更名为 “事件视界”。

• 简洁界面：移除 Discord / Patreon 按钮，呈现更专业的视觉风格。

• 团队管理： Benjiaa 正式担任 主开发者。

---

 

## Lumina Lite v1.1.1 — 稳定性与精度更新 ⚡

本次更新带来了关键的技术修复与性能调优，确保Lumina Lite在所有硬件上流畅无瑕地运行。

✨ 画质优化

• 阴影精度调优：优化阴影深度精度（0.3），修复“彼得潘效应”（阴影悬浮）问题，确保你在世界中移动时，阴影始终保持锐利与稳定。

• 末地维度光照修复：为末地实装径向光照。在这一昏暗维度中，方块与实体如今具备正确的纵深感与体积感。

🚀 性能提升与优化

• 神光效果优化：体素光照采样数调整为12次采样，在保留电影级视觉效果的同时，显著提升低端显卡的帧率表现。

• 内部清理：禁用彩色光照时，移除未使用的相关逻辑，降低GPU负载。

🛠️ 错误修复与兼容性改进

• 远距离地平线修复：移除水面高程偏移，避免使用Distant Horizons模组时出现Z冲突（画面闪烁）。

• 稳定性补丁：修复若干GLSL语法小问题，提升与新版Iris/Oculus的兼容性。

📝 CurseForge 更新日志（可直接复制粘贴）：

Lumina Lite v1.1.0 — 性能优化版

本版本专注于显著提升低端设备的帧率，并改善色彩准确性。

新增内容：

• 大幅帧率提升：优化了神光效果与3D云层，使其在较老显卡上运行更流畅。

• 专业级色彩校准：新增6500K色温白平衡，实现自然、真实的光照效果。

• 更锐利的画面表现：将曝光值调整为1.15，并优化时间性抗锯齿（TAA），呈现更清晰干净的画面。

• 完整支持 1.21.x 版本：已验证并适配最新版 Minecraft。

官方 Lumina 项目 — 由 Benja 制作。

🚀 初始发布（v1.0）

• 露米娜精简版正式发布：露米娜着色器的高度优化版本。

• 极致兼容性：专为低端PC、笔记本电脑及集成显卡设计。

• 原版+体验：保留方形云朵与清晰雾效，保障高帧率运行。

• 性能优化：降低阴影分辨率，优化光照计算，带来更流畅的游戏体验。