Incompatibility Between Iris 1.8.8, Sodium 0.8.12-alpha and Sodium Options API on Minecraft 1.21.1

[pizzabonk32-lan]

Minecraft Version

1.21.1

Iris Version

1.8.8+mc1.21.1

Sodium Version

0.8.12-alpha.4+mc1.21.1

Operating System

Windows 11

What is your GPU?

NVIDIA QUADRO P5000

Java Version

Java 11

Reproduction Steps

Install Minecraft 1.21.1 with Fabric Loader.
Install Iris 1.8.8+mc1.21.1.
Install Sodium 0.8.12-alpha.4+mc1.21.1.
Install Sodium Options API 1.0.10 without installing Reese's Sodium Options.
Launch the game.
The game fails to start and Fabric reports dependency conflicts involving Iris, Sodium, and Sodium Options API.

Crash Report file and latest.log

Additional context

Issue Description

Minecraft fails to start due to dependency conflicts involving Iris, Sodium, and Sodium Options API.

The Fabric loader reports that:

Iris 1.8.8 requires a Sodium version from the 0.6.x branch.
The installed version is Sodium 0.8.12-alpha.4.
Sodium Options API 1.0.10 requires Reese's Sodium Options, which is not installed.
Additional dependency issues may exist but cannot be automatically determined while these conflicts remain unresolved.
Error Summary
Iris Dependency Conflict

Required:

Sodium 0.6.x

Installed:

Sodium 0.8.12-alpha.4

Result:

Iris cannot load because the installed Sodium version does not satisfy its dependency requirements.
Missing Dependency

Mod:

Sodium Options API 1.0.10

Required:

Reese's Sodium Options

Installed:

Not present

Result:

Sodium Options API cannot initialize due to a missing required dependency.
Expected Behavior

Minecraft should launch successfully with Iris and Sodium installed.

Actual Behavior

Minecraft fails to launch and Fabric reports incompatible mod dependencies.

Additional Notes

This appears to be caused by mixing mods that target different Sodium versions. It is unclear whether Iris 1.8.8 is intended to support Sodium 0.8.x or if a newer Iris version is required for compatibility.

[Mengmiya1027]

Iris 1.8.8 does not support Sodium 0.8.x. Please downgrade to Sodium 0.6.x.
It is worth mentioning that I have seen someone say that there seems to be a new build adapted for 1.21.1 Fabric with Sodium 0.8.x on GitHub Actions. However, the adaptation is still in progress, so please wait.

Also, in my opinion, before opening a new issue, please make sure there are no similar issues in the existing issue list. #3114
Duplicate issues will add unnecessary pressure to the development team.
Furthermore, this should not be considered a crash-related error. Fabric reporting a compatibility error to you simply means that the current Iris version is not compatible with Sodium 0.8.x. Please patiently wait for the development team to adapt.