[!WARNING]
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
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.
📘 The official documentation is available at sinytra.org.
We have an official Discord community for Connector. By joining, you can:
To install Connector and its dependencies, follow the same installation steps as you would for any other mods:
47.1.3
.If you're having trouble running a mod on Connector, join our community on Discord, ask us on GitHub Discussions or open an issue in this repository.
Here's a few tips to follow when reporting issues:
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.
Sinytra Connector is, and will always remain, licensed under the MIT License. All files in this repository should be treated as such unless otherwise explicitly stated.
Before you decide to make major changes, you might want to discuss them with us beforehand, so that you're not wasting your time. To submit your changes to the project, you can contribute via Pull-Request.
Here's a few tips to help get your PR approved:
If you're a mod developer and you'd like to run Connector in your dev environment, it is possible in just a few steps.
intermediary
mappings at runtime.repositories {
maven {
name = "Sinytra"
url = "https://maven.su5ed.dev/releases"
}
}
dependencies {
// Add Connector to the launch classpath
minecraftLibrary fg.deobf("org.sinytra:Connector:<version>")
// Add FFAPI dependency (if required)
runtimeOnly fg.deobf("org.sinytra.fabric-api:fabric-api:<version>")
// Install desired Fabric mods
implementation "some.fabric:mod:<version>"
}
// Attach clean minecraft artifact path to runs, necessary for Connector to work
afterEvaluate {
def cleanArtifactJar = Objects.requireNonNull(net.minecraftforge.gradle.common.util.MavenArtifactDownloader.generate(project, "net.minecraft:joined:${project.MCP_VERSION}:srg", true), "Cannot find clean minecraft artifact")
minecraft.runs.configureEach {
property("connector.clean.path", cleanArtifactJar)
}
}
All information regarding Connector's configuration options can be found here.