Compatibility

The overwhelming majority of mods are regular content mods that do not patch vanilla chunk rendering or access Rubidium/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)

On 1.20.1+, a new mod has been developed called Sinytra Connector. This mod implements many necessary hooks & patches to Forge to allow it to load Fabric mods. Connector's reliability has improved significantly in recent times, but it is still not perfect, and it cannot completely hide the fact that Fabric & Forge are different mod platforms.

Embeddium's goal is to provide the most reliable and performant rendering experience possible on Forge, and so it makes necessary changes to improve support for Forge's rendering systems. For that reason, you will likely experience issues (even if very minor) when using Fabric mods with Embeddium via Connector, and this combination is not officially supported.

That being said, Lazurite has been created by the Connector developer to implement Fabric API support back into Embeddium, and with that installed I expect many Fabric mods will "just work", especially if they are not too invasive.

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.

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.