Ars Sky Shader Fix

Ars Sky Shader Fix

你是否曾经放下一个Ars Nouveau的天空方块，加载了你最喜爱的Iris光影，然后……盯着一个大黑方块？是的。这个小小的附属模组正是为了解决这个问题。

Ars Nouveau使用其自定义的小型着色器来绘制天空方块。当光影包运行时，Iris会礼貌地忽略自定义着色器，所以方块就会变成纯黑色。这个模组介入并改为通过光影包自身的天空来绘制方块——因此它能再次真正显示天空，光影效果也一并保留。

你将获得

当启用了受支持的光影包时，天空方块将成为一扇通往天空的窗口：

• 真实的天空颜色，直接取自你的光影包（并非伪装的近似值）。
• 云朵、太阳、月亮和星星透过开放面闪耀——它看起来真的像世界上的一个洞，并带有光影包自身的昼夜循环。
• 正确的深度——开放面能正确遮挡（无透视效果），且实心顶面保持可建造和可站立。
• 无阴影由天空方块本身投射。

没有光影包？没有任何变化——你会获得正常的原版效果。

工作原理

将配置设置为SHADER，模组会在运行时、内存中将天空注入你的光影包——它绝不会触碰你shaderpacks文件夹中的文件。它会自动检测光影包，并为该系列应用正确的补丁。无需向光影包中安装任何内容，也无需手动重新加载。

支持的光影包（已测试）

系列	测试版本	备注
Complementary Reimagined	r5.7.1, r5.8.1	完整天空（太阳/月亮/星星/云朵）。无论是否使用EuphoriaPatches均可工作。
Complementary Unbound	r5.7.1, r5.8.1	完整天空（太阳/月亮/星星/云朵）。无论是否使用EuphoriaPatches均可工作。
Photon	v1.3b	完整天空，包括体积云。
BSL	v10.1.3	完整天空。太阳/阳光部分基于屏幕空间（这是一个已记录的局限）。
SEUS Renewed	v1.0.1	天空渐变 + 太阳圆盘 + 云朵。月亮/星星在此光影包中基于原版纹理，无法显示在方块面上。
Sildur's Vibrant	v2.01 Extreme	完整天空（太阳/月亮/星星/云朵）。

许多其他以“常规”方式绘制天空的光影包，也恰好能在SHADER模式下开箱即用（天空 + 正确深度），即使没有专用补丁——Sunflawer就是其中一个例子。不妨试试你的光影包；如果天空和遮挡效果看起来正确，那就没问题了。

那些不兼容的光影包（例如SEUS PTGI和Kappa等路径追踪类，或以特殊方式构建天空的光影包）在SHADER模式下会显示以下两种迹象之一：

• 透视效果——开放面无法隐藏其后的物体，或
• 纯绿色方块——这个绿色是模组内部的天空标记，而该光影包不知道如何覆盖它。

如果你看到上述任何一种情况，该光影包需要专用补丁（或无法被支持）。支持是按系列划分的，因为每个光影包构建天空的方式不同——上表会随时间增长。

配置（renderMode）

• SHADER — 真正的效果，如上所述。运行时注入的光影包天空（太阳/月亮/星星/云朵）、正确深度、可建造的顶面、无阴影。如果你的光影包在列表中，请使用此模式。
• HYBRID — 并非真正的备用方案——请将其视为“大概看起来会是什么样”的预览，而非实际游玩的模式。它会为每个方块伪造窗口效果，并且代价极其高昂：即使在高性能GPU上，仅仅跑过一面天空方块墙，帧率就可能从封顶的60 FPS跌至个位数。这是一个概念验证，而非日常使用的选项。
• SKYBASIC — 由光影包自身的天空着色器绘制的实心方块：真实的天空颜色和太阳，能干净地隐藏其后的任何物体。便宜且稳定，但没有云朵。
• SOLID — 一个平坦的、天空色调的立方体。最便宜、始终有效、无花哨功能。

经验法则：受支持（或兼容）的光影包 → SHADER。在不支持的光影包上想要便宜且干净的效果 → SKYBASIC或SOLID。HYBRID仅用于展示完整窗口的效果——不要依赖它。

查找已放置的天空方块

由于开放面能完美融入天空，放置的天空方块几乎不可能被察觉。因此，顶面被赋予实色（默认是柔和的薰衣草色）——从上方看它就是一个正常方块。你可以重新着色或将其关闭：

• topMarker — true/false（默认true）。
• topColorR / topColorG / topColorB — 每个0–255。配置注释中有预设值（白色、品红、红色、青色、琥珀色等）。

前置要求

• Minecraft 1.21.1（NeoForge）
• Ars Nouveau
• Iris（这是关键——没有它则直接使用原版效果）

两件并非缺陷的事项（请勿报告🙏）

有些事情超出了模组能控制的范围，因此提前说明：

1. 放置在天穹方块上的方块可能会遮挡太阳/月亮。 如果光影包将太阳/月亮绘制为程序化天空元素，它们就能正常透显。如果它使用原版纹理的太阳/月亮（例如SEUS Renewed的月亮和星星），那是一个独立的物体，放置在顶部的方块确实会遮挡它——模组对此无能为力。上表已为每个光影包注明了这一点。

2. 浮空建筑会在地面上投射阴影。 如果你用天空方块建造一个浮空平台并在其上建造，上面的物体会正常向下投射阴影——就像任何浮空建筑一样。天空方块本身不投射阴影，但放置在它上面的真实方块会投射，而阴影就是这样运作的。模组这边无法解决。

其他一切？欢迎反馈——尽管报告缺陷吧。