Compatibility

The overwhelming majority of mods are regular content mods that do not patch vanilla chunk rendering or access Embeddium internals directly. For the most part, these mods are expected to work out of the box,.

There are, however, some mods that require more invasive patches to accomplish their rendering. It is usually not trivial to support these mods from Embeddium's end as it would require custom logic to be added for each mod (which is not maintainable long-term). Often, the issue is relatively easy for the other mod to solve themselves, and I am happy to get in touch with these mod developers to help them fix these issues.

Fabric mods (Sinytra Connector)

You may experience some issues when using Fabric mods with Embeddium via Connector, and bug reports involving Fabric mods may be closed as "wontfix" if fixing them is impractical. However, we will support them on a "best effort" basis.

On 1.20.1, you may need to create a mod alias & dependency override for mods that depend on Sodium to work correctly with Embeddium installed - ask in Connector's support channels if you need help with this.

There is no benefit in using a mod alias on 1.21, as Embeddium no longer uses Sodium package names, which means Sodium integrations in Fabric mods won't work anyways.

Other known incompatibilities

• Better Chunk Loading - there are isolated reports of this mod causing chunks to randomly not load or stop rendering when Embeddium is present
• [1.16.5] CaveBiomeAPI - use SimpleCaveBiomes instead, it is a drop-in replacement, and implemented with far fewer hacks
• Chunk Animator - patches the vanilla renderer to achieve the effect; a dedicated version of the mod would need to be made for Embeddium.
• Rubidium addons - ensure you are using the latest version of any addons.
• [1.18.2/1.19.2] Effective - it relies on a mixin into vanilla chunk rendering to know when to display particles. Fixes have already been provided to the mod, but it has not received an update since October 2022.
• [1.20.1] Physics Mod - interacts with Sodium code directly, and therefore broke when Embeddium upgraded to Sodium 0.5.2.

Former incompatibilities

• [1.20.1] Valkyrien Skies versions before 2.3.0-beta5, as the mod depended on Sodium 0.4 for Sodium compatibility, and Embeddium is based off of Sodium 0.5
• [1.20.1] Snow Real Magic versions before 9.0.2, as the mod uses mixins into Sodium internals, which will break with updates.
• [1.20.1] Some Create blocks didn't render by default with Rubidium/Embeddium; updating to Create 0.5.1e or newer should resolve this. If you cannot update for some reason, use the workaround here at the cost of degraded performance.