<center>
<a href="https://connector.sinytra.org">
<img alt="Connector Logo" height="165" src="https://raw.githubusercontent.com/Sinytra/.github/main/art/connector_banner.svg">
</a>
</center>
<center>
<a href="https://modrinth.com/mod/connector-extras">
<img height="42" src="https://cdn.modrinth.com/data/cached_images/5f202fa95a2bdd1d161c7a7378bfbea53467fe32.png" alt="ConnectorExtras">
</a>
</center>
<p></p>
<center>
<a href="https://discord.sinytra.org">
<img alt="discord-plural" height="56" src="https://raw.githubusercontent.com/intergrav/devins-badges/refs/heads/v3/assets/cozy/social/discord-plural_vector.svg">
</a>
<a href="https://bsky.app/profile/su5ed.dev">
<img height="56" src='https://cdn.modrinth.com/data/cached_images/4f9f69d8bda87db19795c17a3080d8fb4ac4aa9a.png' alt='Follow us on Bluesky' />
</a>
<a href="https://www.patreon.com/cw/Su5eD">
<img alt="patreon-plural" height="56" src="https://raw.githubusercontent.com/Sinytra/.github/refs/heads/main/badges/misc/patreon_cozy.svg">
</a>
</center>
<p></p>
## 📖 About
**Sinytra Connector** is a translation/compatibility layer that allows running [Fabric](https://fabricmc.net) mods
on [NeoForge](https://neoforged.net). 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.
Also check out [Forgified Fabric API](https://github.com/Sinytra/ForgifiedFabricAPI), a port of Fabric API to NeoForge.
To learn more about how Connector works, you can read our [Introductory blog post](https://github.com/Sinytra/Connector/discussions/11).
**For improved compatibility with third-party APIs and libraries (REI,EMI,TR Energy), we recommend installing [Connector Extras](https://modrinth.com/mod/connector-extras).**
## 📋 Usage Guide
To install Connector and its dependencies, follow the same installation steps as you would for any other mods:
1. If you haven't already, install NeoForge. We recommend using the latest stable version.
2. Download the latest release of Connector and its dependencies.
3. 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.
## 🔍 Get help
If you're having trouble running a mod on Connector, join our community on [Discord](https://discord.sinytra.org), ask us
on [GitHub Discussions](https://github.com/Sinytra/Connector/discussions) or open an issue in our repository.
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](https://github.com/Sinytra/Connector/issues) and open a [new issue](https://github.com/Sinytra/Connector/issues/new/choose). 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.
## ⚖️ License
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.
