ForgedFabric API
Modding Minecraft has always been a tale of two ecosystems. On one side sits Fabric, beloved for its lightweight, fast-updating toolchain. On the other stands Forge, the long-standing giant with a massive library of content mods. For years, developers who wanted their work to run on both loaders had to maintain two separate codebases. The ForgedFabric API exists to shrink that gap, offering a partial reimplementation of the Fabric API on top of Forge so that porting and multiplatform development become far less painful.
What Is the ForgedFabric API?
At its core, the ForgedFabric API recreates a subset of the Fabric API's classes and hooks inside a Forge environment. The concept mirrors projects like QuiltMC's quilted-fabric-api, though the scope here is intentionally smaller and still growing. The goal is straightforward: let developers write or port code that expects Fabric-style entrypoints, events, and registries, then run it on Forge without rewriting everything from scratch.
It is important to set expectations. This is a utility built for mod developers. It adds no blocks, items, mobs, or gameplay content of its own. Installing it will not magically make a random Fabric mod spring to life on Forge, at least not yet. The project remains in its early stages, and the author implements features on an as-needed basis, driven by the mods currently in development.
Why Developers Use It
The primary audience is anyone maintaining mods across loaders or migrating an existing Fabric project to Forge. Common use cases include:
- Porting Fabric mods to Forge with minimal code changes
- Developing multiplatform mods that target both loaders from a shared codebase
- Reducing the maintenance burden of duplicating logic for each platform
- Experimenting with Fabric-style APIs in a Forge workspace
Real projects have already leaned on it, including BetterCombat, CombatRoll, and PowerScale. Development is sponsored by Adam, and the roadmap points toward eventually forking FabricMC's own Fabric implementation to chase fuller parity with the complete Fabric API.
Supported Minecraft Versions and Loaders
The ForgedFabric API targets the Forge loader, with builds tied to specific Minecraft releases as the upstream Fabric API evolves. Because it tracks Fabric's internal changes, version support moves in step with major Minecraft updates. Before you download ForgedFabric API, check the project's file listing to confirm which Minecraft version and Forge build your chosen release matches, since mismatched versions are the most common cause of crashes during testing.
If you would rather skip manual version hunting, the foxygame.net launcher bundles ForgedFabric API inside its curated add-on catalog, so you can add the right build to a compatible Forge profile with a single click instead of juggling jar files by hand.
How to Install
Manual Installation
Learning how to install the ForgedFabric API manually is quick. First, make sure you have a working Forge installation for your target Minecraft version. Next, obtain the correct ForgedFabric API jar that matches both your Minecraft version and Forge build. Place the jar into your mods folder alongside any mods that depend on it. Finally, launch the Forge profile and check the log to confirm the API loaded without errors.
Using a Launcher
Launchers that manage add-ons can simplify this process considerably. Instead of tracking down matching jars, you select the API from a catalog and let the launcher handle placement and updates. This is especially handy when you are testing multiple Minecraft versions in parallel and need the correct build for each profile.
Tips for Porting Mods
Start small. Port one feature at a time and test frequently, since only part of the Fabric API is currently implemented. Watch the console for missing class or method errors, which usually signal an unimplemented hook. If a dependency is not yet supported, consider contributing or waiting for an update, as the project grows based on real developer needs. Keeping an eye on the GitHub repository helps you track progress and upcoming parity work.
Final Thoughts
The ForgedFabric API for Minecraft is a practical bridge for developers who live between two modding worlds. It will not replace the full Fabric API overnight, and it is not meant for players hoping to force any Fabric mod onto Forge. But for mod authors porting projects or building multiplatform mods, it removes a meaningful amount of friction. As the project matures toward full parity, its value to the cross-loader community will only grow.