Compatibility
Minecraft: Java Edition
Platforms
Supported environments
Details
Moonrise Compats
Moonrise Compats is a compatibility layer for Moonrise that provides targeted fixes/patches for mods that don’t work properly when Moonrise is installed.
Moonrise can replace/rewire large parts of vanilla internals for performance. While that’s great for optimization, it can break assumptions made by other mods - resulting in crashes, broken features, or subtle behavior issues. Moonrise Compats exists to bridge those gaps.
What does it do?
Depending on the patch and supported mods, Moonrise Compats may:
- Fix incompatibilities caused by mixins/overwrites and changed internals
- Add small “bridge” integrations where another mod expects vanilla behavior
- Patch specific edge-cases to let both mods coexist more reliably
- This mod does not replace Moonrise.
- It is intended to be installed together with Moonrise.
Why does this exist?
We rely on Moonrise for the performance improvements it brings.
Not every mod is built with Moonrise in mind, and compatibility is often highly mod-specific - so this project maintains the required patches in one place.
Versioning (Moonrise matching)
Moonrise Compats follows the same base version as Moonrise, plus an additional patch suffix.
Example:
Moonrise-NeoForge 0.1.0-beta.15+2eae1b1MoonriseCompats 0.1.0-beta.15+2eae1b1.1
The trailing suffix:
.1 ... .x
means Moonrise Compats patch revisions for that exact Moonrise build:
...+2eae1b1.1= first Compats patch for Moonrise build+2eae1b1...+2eae1b1.2= second patch, etc.
Compatibility & expectations
- Compatibility work is mod-dependent - a patch may exist for one mod but not another.
- This mod aims to be safe, but always test updates first, especially in large modpacks.
- In a modpack environment, keep Moonrise and Moonrise Compats base versions aligned.
Reporting issues
If something breaks, please include:
- Minecraft version
- Loader (NeoForge/Fabric/etc.)
- Exact versions of:
- Moonrise
- Moonrise Compats
- The mod(s) that conflict
latest.log(and crash report if present)- Minimal steps to reproduce



