Sodium and Iris are Java performance and shader-related mods that need compatible loader and game builds.
Quick answer
For Java mods, match the game, loader, and mod versions. For Bedrock, check add-on support instead. Test changes in a copied world or profile.
What to do
Work through these checks in order. Stop if a menu, command, or world state differs from the conditions described.
- Confirm your Minecraft edition and release, then identify the world, device, or server involved.
- Check the exact versions and supported loader for both mods.
- Test them in a copied profile without other mods, then add a shader pack only after the game starts cleanly.
- Check the result in the game. If it differs, record the exact error or menu label and compare the official source for your version.
Edition and version differences
Java mod loaders and Bedrock add-ons are different systems. Check compatibility with the exact game build before installation.
If the result differs
Compare the current screen or error text with the conditions above. For Java mods, match the game, loader, and mod versions. For Bedrock, check add-on support instead. Test changes in a copied world or profile. Change one variable at a time so you can tell which step made a difference.
Official sources and version scope
Examples are based on the original BlockGuide research snapshot dated 2026-10-12. Check the current edition and release before changing a live world.