面向 Sulkan Vulkan 渲染引擎的 Complementary 风格光影包。 基于官方 base-shader.zip 模板二次调参，所有 UBO / 采样器绑定 / 编译期宏与 Sulkan 内部契约完全一致。 本仓库的所有修改与文档由 OpenAI Codex 在用户 PlaneYao 的指导下自动生成。
- 青橙互补调色（cyan-orange complementary grade）：阴影偏冷青，高光偏暖黄
- 正黄色的太阳与朝霞：太阳本身是黄色调（不是夕阳橙红），朝霞从地平线升起呈金黄光柱 + 玫红带
- 深色体积云：可见的厚实 cumulus 团块（深青底 + 暖黄冠 + 强银边），不会被亮天压成一层雾
- 旋转 PCF 软阴影：在官方 sulkan_pcfFiltered 上叠加 per-pixel 旋转 9-tap 采样，cascade texel 网格伪影被打散
| 组件 | 版本 |
|---|---|
| Minecraft | 26.2 |
| Loader | Fabric Loader 0.19.3（或更新的 0.19.x） |
| Fabric API | 0.155.2+26.2（或更新到 26.2） |
| Sulkan mod | 0.2.0-26.2（sulkan-0.2.0-26.2.jar，从 sulkan.org 下载） |
| Sodium | 0.9.1+mc26.2（sodium-neoforge-0.9.1+mc26.2.jar，Sulkan 依赖的 Vulkan 渲染器） |
| Java | Java 25（Java 21 无法启动） |
| 图形后端 | Vulkan（Sulkan 只支持 Vulkan；OpenGL 直接 hard-fail） |
| options.txt | preferredGraphicsBackend:vulkan |
测试环境：Windows 11 / AMD Radeon 780M（Vulkan 1.4.349 / 驱动 26.6.4）/ Fabric Loader 0.19.3。
- 装 Fabric Loader 0.19.3（MC 26.2）。
- 把下面三个 mod 丢进 mods/:
- fabric-api-0.155.2+26.2.jar
- sodium-neoforge-0.9.1+mc26.2.jar
- sulkan-0.2.0-26.2.jar
- 把 Complementary-Style-Pack_For_Sulkan_MC26.2.zip 丢进实例目录下的 shaders/ 文件夹。
- 编辑 config/sulkan-shaders.json，确保 enabled: true，并设：
json { enabled: true, selectedPackId: Complementary-Style-Pack_For_Sulkan_MC26.2.zip, shadowQualityPreset: high, aoQualityPreset: normal, waterQualityPreset: normal, cloudQualityPreset: normal, atmosphericQualityPreset: high, bloomEnabled: true, antiAliasingMode: fxaa }
预设档枚举：off / low / normal / high / ultra。 注意 cloudQualityPreset 在 Sulkan 默认是 off，必须显式给到至少 normal，否则体积云不会渲染。 atmosphericQualityPreset 也要给到 normal 以上，terrain_shadow.fsh 里的 applyTwilightSunlight 黄昏调光才会生效。
- 启动 MC，在 Video Settings → Shaders（Sulkan 自己的界面，不是 Iris 那个）里选 Complementary-Style-Pack_For_Sulkan_MC26.2。
- 客户端日志里看到 Sulkan Shaders bootstrap complete: enabled=true, selectedPack=Complementary-Style-Pack_For_Sulkan_MC26.2.zip, externalPacks=2 就是加载成功了。
shaders/ core/ ao.vsh, ao_apply.fsh XeGTAO 屏幕空间 AO shadow_depth.vsh/.fsh 太阳光阴影 caster entity_shadow_depth.vsh/.fsh 实体阴影 caster entity_shadow.vsh/.fsh 实体阴影 receiver terrain.vsh/.fsh 普通不透明地形 receiver terrain_shadow.vsh/.fsh 主光照地形 receiver water.vsh/.fsh 水面（带折射 + caustic） volumetric_clouds.vsh/.fsh 3D cumulus + wisps 体积云 ray-march volumetric_clouds_composite.fsh 云与天空合成 atmosphere_composite.fsh 天空 / 雾 / god rays bloom_prefilter.fsh bloom soft-threshold 抽取 bloom_downsample.fsh 1/2 downsample bloom_blur.fsh dual-Kawase blur bloom_composite.fsh bloom + exposure 合成 luminance_downsample.fsh log-luminance downsample exposure_adapt.fsh 自适应曝光 fxaa.fsh FXAA include/ chunksection.glsl held_light.glsl scene_tonemap.glsl ACES tonemap + Complementary display grade shadow_sampling.glsl PCF + 旋转 Poisson 盘 sulkan_terrain_core.glsl terrain_atlas_sampling.glsl wind.glsl pack.mcmeta
core/ 目录在 Sulkan 加载时会被重映射到 assets/sulkan/shaders/（参见 API 文档）。 文件名 / UBO 名 / 采样器绑定都从官方 base-shader.zip 原样保留，只对个别函数体做了 Complementary 风格的调参（详见 CHANGELOG.md）。
powershell Compress-Archive -Path .\shaders, .\pack.mcmeta -DestinationPath ..\Complementary-Style-Pack_For_Sulkan_MC26.2.zip -CompressionLevel Optimal
zip 根必须直接包含 shaders/ 和 pack.mcmeta，Sulkan scanner 会扫这两个。
- 阴影边缘仍有 cascade-texel 伪影：Sulkan 当前 3-cascade shadow map 是天花板，要彻底消掉得改 Sulkan mod 本身（VSM / ESM / 自定义 per-cascade bias profile）。包侧只对深度图做了 PCF 过滤，所以仍能看到网格边
- atmosphericQualityPreset 必须 ≥ normal：terrain_shadow.fsh 的 applyTwilightSunlight 黄昏/黎明色调才会激活
- 参数兜底：volumetric_clouds.fsh 里我加了一层防御 —— 如果 Sulkan 传过来的 Layer0Main / Layer1Main 是 0/异常值，会被替换成合理默认（coverage 0.55，altitude camY + 132）。这样即使运行时预设配错，云也至少能看见
源（GLSL shader）使用 MIT License —— 见 LICENSE。
本包基于 Sulkan 项目的 base-shader.zip 模板二次开发，模板本身也是 MIT 协议。 Sulkan mod jar 和官方 base-shader 模板不在本仓库内，请从 sulkan.org 自行下载。
- Sulkan 渲染引擎和 base-shader 模板 —— (c) 2026 Sulkan / MrAvatin，MIT
- Complementary Reimagined 光影（基岩版）—— 视觉参考来源（青橙互补调色）
- Bliss 光影（Java 版）—— 视觉参考来源（暖冷过渡调色）
- 整个调参工作由 OpenAI Codex 自动完成（用户 PlaneYao 指导）
A custom shader pack for the Sulkan Vulkan renderer, targeting Minecraft 26.2 + Fabric Loader 0.19.3. Built directly on top of the official base-shader template and tuned for the cyan-orange Complementary Reimagined aesthetic. All modifications and this documentation were generated with OpenAI Codex under the user direction.
Highlights: cyan-orange complementary grade, yellow-tinted dawn (朝霞) with a soft rosy horizon belt, visibly solid volumetric clouds with dark cyan undersides and warm-yellow crowns, and a per-pixel rotated PCF filter layered on top of the official sulkan_pcfFiltered to dissolve cascade-texel grid artefacts.