How to Convert a Forge Server to Fabric (or Vice Versa)

Understanding the Forge vs Fabric Split

Forge and Fabric are the two dominant modding platforms for Minecraft, and they are fundamentally incompatible. Forge mods cannot run on Fabric, and Fabric mods cannot run on Forge, they use entirely different APIs, event systems, and mod loading architectures. When you convert forge to fabric Minecraft (or the reverse), you are not just swapping a loader; you are replacing your entire mod stack with equivalent mods built for the target platform.

This guide covers both directions: Forge to Fabric and Fabric to Forge. The process is similar either way, but the ecosystem differences matter. Fabric is lighter, loads faster, and has become the primary home for performance and utility mods. Forge has a larger library of content mods (dimensions, magic systems, tech mods) and a longer track record. Your choice depends on which mods you need.

Can You Keep Your World?

Yes, with caveats. The vanilla world data (terrain, structures, player inventories, ender chests) is stored in a standard format that both Forge and Fabric read identically. Your builds, caves, and generated structures will survive the conversion perfectly.

What will not survive are blocks, items, and entities added by mods on your old platform. If you had Tinker's Construct tools in your inventory (Forge), those items will vanish on a Fabric server because Fabric has no idea what they are. Modded blocks placed in the world will either turn into air or become "unknown block" placeholders, depending on the Minecraft version.

The rule of thumb: your vanilla world converts cleanly; modded content does not.

Step-by-Step: Forge to Fabric Conversion

Step 1: Inventory Your Mods

List every Forge mod you currently run and find the Fabric equivalent:

ls mods/ | sort

For each mod, check if a Fabric version exists. Many popular mods are available on both platforms:

• JEI (Forge) → REI or EMI (Fabric)
• JourneyMap → available on both
• Waystones → available on both
• Create → available on both (since 0.5.1)
• Optifine (Forge) → Sodium + Iris + Lithium (Fabric, and better performance)

Mods without a Fabric port are the blockers. If your server depends on a Forge-exclusive mod with no alternative, you may need to stay on Forge or accept the loss of that mod's content.

Step 2: Back Up Everything

This is critical when you convert forge to fabric Minecraft, you cannot undo modded block removal once the world loads on the new platform:

tar -czf ~/forge-server-backup-$(date +%Y%m%d).tar.gz /opt/minecraft

Keep this backup permanently. See our backup guide for best practices.

Step 3: Install the Fabric Server

Download the Fabric installer from fabricmc.net:

# Download and run the Fabric server installer
curl -OJ https://meta.fabricmc.net/v2/versions/loader/1.21.4/0.16.14/1.0.3/server/jar
mv fabric-server-mc.1.21.4-loader.0.16.14-launcher.1.0.3.jar server.jar

Create a fresh directory for the Fabric server, do not install Fabric on top of your Forge server:

mkdir /opt/minecraft-fabric
cp server.jar /opt/minecraft-fabric/
cd /opt/minecraft-fabric
java -Xms4G -Xmx4G -jar server.jar --nogui

Accept the EULA, then stop the server. Install Fabric API (required by almost all Fabric mods) into the mods/ folder.

Step 4: Copy Your World

Copy the world folder from the Forge server to the Fabric server:

cp -r /opt/minecraft-forge/world /opt/minecraft-fabric/world

If your Forge server used Bukkit-style dimension splitting (SpongeForge, Mohist, etc.), you may need to restructure. Standard Forge uses the vanilla folder structure with DIM-1 and DIM1 inside the world folder, which Fabric expects as well.

Step 5: Install Fabric Mods

Place your Fabric mod jars in the mods/ folder. Essential Fabric mods for server performance:

• Lithium, general-purpose server optimization (the Fabric equivalent of Paper's patches)
• Starlight, lighting engine optimization (now integrated into Paper and Fabric)
• FerriteCore, reduces memory usage significantly
• Krypton, network stack optimization

Step 6: Handle Modded Content Loss

Start the server and check the logs carefully. You will see warnings about unknown block IDs and missing registries, these are the Forge mod blocks and items that Fabric cannot load. The server will load, but:

• Modded blocks in the world turn into air or placeholder blocks
• Modded items in inventories disappear
• Custom dimensions from Forge mods will not load

Warn your players in advance. If possible, have everyone store modded items in a vanilla chest and note what they had so you can compensate them with Fabric equivalents.

Sinytra Connector: Running Forge Mods on Fabric

Sinytra Connector is an experimental compatibility layer that allows some Forge mods to run on Fabric without modification. It reimplements parts of the Forge API on top of Fabric, similar to how Wine runs Windows programs on Linux.

To use it, install Sinytra Connector and Forgified Fabric API into your Fabric mods/ folder, then drop in your Forge mod jars alongside your Fabric mods. Compatibility is not guaranteed, complex mods that use deep Forge internals like mixins into Forge-specific code will not work. But simpler content mods often load successfully.

Check the Sinytra Connector compatibility list before relying on this for a production server. It is best treated as a bridge during migration rather than a permanent solution.

Step-by-Step: Fabric to Forge Conversion

The reverse process, converting Fabric to Forge, follows the same pattern:

1. Inventory your Fabric mods and find Forge equivalents
2. Back up the entire Fabric server
3. Download the Forge installer from files.minecraftforge.net and install it in a new directory
4. Copy your world folder to the new Forge server
5. Install Forge versions of your mods
6. Start the server and verify world integrity

The same content-loss caveats apply: Fabric-specific blocks and items will not survive the conversion to Forge.

NeoForge: The Third Option

Since late 2023, NeoForge has emerged as a fork of Forge with better mod compatibility and faster updates. If you are already planning to convert forge to fabric Minecraft, consider NeoForge as a middle ground, it runs most Forge mods with minimal changes and has a more modern codebase. Many mod authors now target NeoForge alongside or instead of legacy Forge.

Tips for a Smooth Migration

• Match Minecraft versions exactly, do not change both the mod loader and the game version at the same time
• Test on a copy first, spin up the new server with a copy of the world and verify everything before switching the production server
• Communicate with players, give at least a week's notice so players can prepare for modded content loss
• Keep the old backup forever, players may want to revisit their old builds on a local copy
• If you are coming from a modded server and want to go vanilla-like with plugins instead, consider migrating to Paper, it is much simpler since there is no mod content to worry about

Summary

Converting between Forge and Fabric preserves your vanilla world data but loses all modded blocks, items, and entities. The process involves setting up a fresh server with the target mod loader, copying your world, and installing equivalent mods. Sinytra Connector can bridge some Forge mods to Fabric temporarily. Always back up before converting, test on a copy, and communicate the change to your players well in advance. For more on server types and which one fits your needs, see our complete server types guide.

Want to just play? Join Astroworld MC, IP play.astroworldmc.com, Java + Bedrock.