Mod Remapping API Mod FAQ
10 questions players actually ask, answered.
Do I need to install this mod separately or does it come with my compatibility layer?
Mod Remapping API is a dependency that compatibility layers like Fabricated Legacy Forge install automatically—you don't need to add it yourself. If you're using one of these tools, the mod is already present in your mods folder.
What's the difference between remapping and just loading a mod normally?
Remapping translates a non-Fabric mod's code to match your game's current mapping system at startup, so mods designed for other loaders can run on Fabric. Without remapping, these mods would crash because their code references outdated or incompatible names.
Can I use this to run old Forge mods on modern Fabric?
Mod Remapping API provides the foundation for this, but you need a compatibility layer like Fabricated Legacy Forge on top of it—the API alone doesn't bridge the loader gap. The compatibility layer uses the remapping hooks to make old mods work.
Why is my mod still crashing even though remapping is enabled?
Remapping handles code translation, but some mods have deeper incompatibilities (missing dependencies, incompatible APIs, or version mismatches) that remapping can't fix. Check the crash log for the actual error and verify the mod is compatible with your Fabric setup.
Does remapping slow down my game startup?
Remapping adds a small overhead during the launch process as it translates mod code, but it's typically negligible. If startup is very slow, the issue is usually mod count or conflicts, not the remapping itself.
Can I write my own remapping rules or hooks?
Yes—Mod Remapping API provides hooks that other tools and developers can use to extend the remapping process with custom logic. See the Extending Remapping with Custom Hooks guide for implementation details.
What happens if two mods need conflicting remappings?
Conflicts can cause crashes or unpredictable behavior; load order and mod compatibility matter. If you hit this, check if both mods are actually compatible with your Fabric version and consider removing one or finding an alternative.
Does this mod work with mods that already target Fabric?
Native Fabric mods don't need remapping and work fine alongside it—the API only processes non-Fabric mods. Having it installed won't break or slow down pure Fabric mods.
How do I know if a mod is being remapped or loaded normally?
Check your launcher's log during startup—remapped mods will show remapping activity in the debug output. You can also enable verbose logging in your Fabric configuration to see which mods are processed by the remapping system.
Can I disable remapping for specific mods?
Mod Remapping API doesn't have a built-in per-mod toggle, but you can remove mods from your mods folder or use your compatibility layer's settings if it offers selective remapping. For most setups, remapping is safe to leave on for all mods.