Squall Shader Compatibility

双版本并行维护：本附属同时提供 Minecraft 1.20.1 的 Forge + Oculus 与 Fabric + Iris 两个版本，后续内容将同步更新。请按加载器下载对应文件。

Important — Minecraft 1.20.1 Fabric: Currently, loading the original Squall - Realistic Rain, Puddles & Thunder together with Iris causes the game to crash without this compatibility addon. You must also install the Fabric version of Squall Shader Compatibility to launch and enter the game with Squall + Iris. Keep the original Squall mod installed.

重要提示 — Minecraft 1.20.1 Fabric：目前，原模组 Squall - Realistic Rain, Puddles & Thunder 与 Iris 一起加载时，未安装兼容附属会导致游戏崩溃。必须额外安装本模组 Squall Shader Compatibility 的 Fabric 版本，才能在 Squall + Iris 环境下启动并进入游戏。原版 Squall 仍需保留。

This addon cannot run on its own. The required Squall mod must also be installed. Get Squall - Realistic Rain, Puddles & Thunder

Visual comparison / 效果对比

An independent, client-side compatibility addon for Squall on Minecraft 1.20.1 — Forge + Oculus / Fabric + Iris. Use Squall's rain, splashes, wet surfaces, window effects, haze, and weather sounds while playing with Oculus (Forge) or Iris (Fabric) shader packs.

Requires the original Squall mod. This addon does not include or replace Squall.

Features

• Restores Squall weather effects with Oculus or Iris shaders by rendering the weather pass after the shader pack's final composite.
• Keeps sky and cloud rendering under the shader pack's control.
• Improves rain droplets on glass blocks and panes, including viewing exterior droplets from inside a room and rain effects on horizontal glass.
• Fixes overlapping frost and filters hidden glass faces at adjoining blocks and window frames.
• Improves wet-surface rendering after nearby block changes and repairs framebuffer attachments after render-target changes.
• Adds nearby vanilla chest geometry to Squall's wet-surface reflections, including normal, trapped, ender, and double chests.
• Retains Squall's own controls for effect intensity and toggles.

Requirements and compatibility

• Minecraft: 1.20.1
• Forge build: Forge 47.x; Oculus for shader support.
• Fabric build: Fabric Loader 0.19.3 or newer (no upper bound), Fabric API, and the Fabric version of Squall; Iris for shader support.
• Required: Squall. The declared dependency range is 1.0.2 up to, but not including, 1.1.
• Forge shader test: Oculus 1.8.0 + Embeddium 0.3.31 + BSL v8.4.
• Fabric shader test: Iris 1.7.6 + Sodium 0.5.13 + Complementary Reimagined r5.9.3. Squall 1.0.2 and 1.0.4 passed both standard rendering and Iris shader tests with this addon installed.
• Installation side: Client only. Server installation is not required.

The declared Squall dependency range is 1.0.2 up to, but not including, 1.1. This is a loading range; future Squall updates may require a new addon release.

Installation

1. Install Minecraft 1.20.1 with Forge or Fabric and the matching original Squall mod.
2. For shader use, install Oculus on Forge or Iris on Fabric, together with their dependencies.
3. Place the matching Forge or Fabric addon JAR in your client mods folder. Fabric file: squall-shader-compat-fabric-1.20.1-1.0.0.jar. Install only the build matching your loader.
4. Remove older versions of this addon, keeping only one installed version.
5. Start the game and configure weather effects through Squall.

To uninstall, remove this addon's JAR. It does not edit the original Squall JAR, shader packs, or world saves.

Visual limitations

Weather effects are composited after the shader pack's final pass, so they are not relit by that pack. Fog, water, reflections, and temporal effects can look different across shader packs. Compatibility with every shader pack is not guaranteed.

Chest reflections are limited to nearby captured geometry. Custom chest renderers and high-resolution resource packs may have limitations. This addon does not add a first-person player reflection or replace shader-pack water reflections.

What's new in 1.0.0 — Forge and Fabric

The Forge series starts at 1.0.0 and supersedes the previous 1.0.20 release. The Fabric 1.0.0 port brings the same addon mechanisms to Fabric 1.20.1 with Iris support. Download the build for your loader.

• Flower glow: Added a check for genuinely light-emitting blocks so brightly colored flower petals are no longer mistaken for light sources. Torch glow is preserved.
• Slab drip alignment: Drips now originate from the actual bottom surfaces of upper and lower slabs, removing height offsets and gaps.
• Elevated fences: Drips originate at the lowest end of the fence post; stacked fences extend the source to the bottom of the stack, preventing floating drips on either side.

Credits and license

Original Squall by comedy01: https://github.com/comedy01/Squall

This is an independent community addon and is not an official Squall release. Licensed under MIT.

中文说明

Fabric 1.20.1 启动兼容性：目前原版 Squall 与 Iris 同时加载会导致游戏崩溃，必须额外安装本兼容附属的 Fabric 版本才能进入游戏。

这是适用于 Minecraft 1.20.1 — Forge + Oculus / Fabric + Iris 的 Squall 独立客户端光影兼容附属模组，必须同时安装原版 Squall。

Forge 使用 Oculus，Fabric 使用 Iris。启用光影后，可继续使用 Squall 的雨水、溅水、湿润表面、玻璃水珠、薄雾及天气音效，并修复部分玻璃结霜和表面渲染问题，支持附近原版箱子在湿润表面中的反射。天空和云层仍由光影包控制。

1.0.0 新增内容

Forge 版本以 1.0.0 作为新的起点；Fabric 1.0.0 移植保留同一套附属机制并支持 Iris。Fabric 需要 Loader ≥0.19.3、Fabric API 和 Fabric 版 Squall，没有设置 Loader 版本上限。

• 花朵发光：增加真实发光方块校验，避免把鲜艳花瓣误判成灯光，同时保留火把泛光。
• 半砖衔接：按上下半砖的实际底面生成水滴，消除高度偏差和间隙。
• 高处栅栏：水滴贴住立柱最底端生成，叠放时延伸至下端，避免两侧悬空滴落。

已测试 Squall 1.0.2 / 1.0.4；光影测试使用 Oculus 1.8.0、Embeddium 0.3.31 和 BSL v8.4。Fabric 另已测试 Squall 1.0.2 / 1.0.4，在安装本兼容附属后，分别通过普通渲染与 Iris 1.7.6 + Sodium 0.5.13 + Complementary Reimagined r5.9.3 测试。不同光影包的最终效果可能不同。

将本附属模组 JAR 放入客户端 mods 文件夹，保留原版 Squall，并移除旧版兼容补丁。无需安装到服务器，效果开关和强度仍在 Squall 中设置。