Docs
Connector

Connector

⚠️

Connector is currently in beta state, and many mods may not work as expected, or might be broken completely. Please refer to our Mod Compatibility Thread and Issue Tracker for ongoing compatibility issues.
When reporting bugs, please make sure you are using the latest release of Connector and Forgified Fabric API, as well as Forge 47.1.3 on Minecraft 1.20.1

📖 About

Sinytra Connector is a translation/compatibility layer that allows running Fabric mods on MinecraftForge. Its goal is to bring the two platforms closer together, saving developers time and effort maintaining their mods for multiple platforms at once, as well as allowing players to play all their favourite mods in one modpack.

📦 Installation

Do not download the original Fabric API, as it’s substitued by the Forgified Fabric API.

Connector’s installation procedure follows the standard steps used for installing Minecraft mods. It runs on the MinecraftForge mod loader and depends only on the Forgified Fabric API. If you’re not familiar with this process, we’ve listed the exact steps below:

  1. Install Minecraft Forge. For Minecraft 1.20.1, we recommend using version 47.1.3.
  2. Download the Forgified Fabric API. It is meant to be a direct replacement for the Fabric API and is not compatible with it. We’ll try our best to avoid loading the Fabric API if it’s installed automatically (e.g. by your modpack manager), but if you have the option to avoid installing it, please do so.
  3. Install Connector. Get the latest release from one of our official distribution channels and drop the jar in your mods folder.

🎉 With all the steps completed, you’re good to go! With all dependencies installed, grab your favourite Fabric mods and just drop them in the mods folder like you would with any Forge mods. Connector will handle loading them for you with no additional steps required.

🔍 Help and Support

If you’re having trouble running a mod on Connector, join our community on Discord, ask us on GitHub Discussions or open an issue on our bug tracker.

Here’s a few tips to follow when reporting issues:

  1. Make sure you are using latest available version. Look for existing issues that might’ve already been answered / fixed. Think about whether the issue is caused by Connector itself and not another mod you’ve installed. To test this, try reproducing the same issue on Fabric.

  2. Navigate to the issues tab and open a new issue. Select one of the available templates depending on the topic. Fill in the required fields. In order to increase our chances of identifying and reproducing the issue, please make sure to include as many details as possible.

  3. Once you’re done describing the problem, submit the issue. We’ll get to you as soon as we can. Please note that providing as many details as possible is crucial to help us find and resolve the issue faster, while also getting you a fixed version ASAP.

Please note that providing as many details as possible is crucial to help us find and resolve the issue faster, while also getting you a fixed version ASAP.