概述

Sinytra Connector —— Forge 与 Fabric 模组共存。

Sinytra Connector 是一个基于 Forge/NeoForge 的模组，旨在作为一个转译/兼容层来让 Forge/NeoForge 能够运行 Fabric 的模组，从而拉近两个平台间的距离，节省模组开发者多平台维护的时间和精力，并让玩家可以在一个整合包中畅玩所有模组。

需要 Forgified Fabric API 来替代 Fabric API 的功能。

测试版注意事项：本模组目前处于测试阶段，很多模组可能无法完美运行，或是完全失效。

请参阅模组的 "Mod Compatibility Thread" 和 "Issue Tracker"，了解目前的兼容性问题。

反馈问题时，请确保自己安装的本模组和前置模组均为最新版。

无法支持的模组

主要是模组 Mixin 代码的问题，比如钠这种使用 Mixin 对原版代码进行大量侵入性修改的模组，就无法被本模组加载。

1. 模组的 Mixin 会跟 Forge 对原版代码的修改（Forge Patches）冲突，导致游戏无法启动（典型：Fabric API，不然 Forgified Fabric API 就不会存在了）。

2. 模组的 Mixin 会对原版方法进行覆写，可能会移除 Forge 安插在其中的修改或 API 实现，也可能会导致游戏无法正常进行/在某些情况下崩溃。

3. （beta.16 版本引入了 MixinTransmogrifier，解决了此问题）模组的 Mixin 依赖于 Fabric Mixin 的某些特点（Fabric Mixin 跟 Forge 内置的 SpongePowered Mixin 是不同的，前者由后者改进拓展而来），比如在接口（Interface）中使用 @Inject 注入、注入构造函数的位置不一定必须是末端，这些特点在 Forge 内置的 Mixin 中并不存在，一旦在 Forge 上运行，也会导致游戏崩溃。）

4. 模组的 Mixin 存在捕获方法内局部变量（LocalCapture）的行为，而 Forge Patches 可能会导致方法内的局部变量表发生变化，除非其捕获类型允许捕获失败时不中止游戏，否则将导致不兼容，无法加载。

5. 不兼容高清修复。

内容

如何使用

要安装 Sinytra Connector 及其前置模组，请按以下安装步骤进行安装：

1. 安装支持的最高版本的 Minecraft Forge / NeoForge（对于 MC 1.20.1：FFAPI 1.10.0 之前的版本，请使用 Forge 47.1.3 版本；FFAPI 1.10.0 及之后已经支持 47.2.6+ 的 Forge）；

2. 下载此模组的最新版本并放于 mods 文件夹中；

3. 下载并安装 Forgified Fabric API ，不要安装 Fabric API，尽管此模组会尽力避免其生效；

4. 将喜欢的 Fabric 模组放于 mods 文件夹中，就像安装 Forge 模组一样。

获取帮助

如果在使用此模组时遇到问题，请在 Mod Compatibility Thread 页面查看它是否将出现问题的模组列为不兼容。

如果没有列出，请在模组的 GitHub 仓库页面上提交新 Issue。

以下是反馈问题应遵循的一些提示：

1. 确保自己使用的本模组是最新版本。查找可能已经得到答复/修复的现有 Issues。

2. 考虑问题是否由本模组造成，而不是自己安装的其他模组。要测试这一点，请尝试在 Fabric 上重现相同的问题。

3. 到模组的 Issue 页面 并 提交一个新 Issue。根据问题选择一个可用模板，填写必填内容。为了提高作者理解和复现问题的概率，请确保包含尽可能多的信息。

4. 描述完成后提交问题，作者会尽快回复你。

请注意，提供尽可能多的细节对于帮助作者更快地发现和解决问题至关重要，同时还能让作者尽快为你提供修复版本，而在百科评论区提出的问题作者是看不到的。

其他帮助

• 模组配置文件相关；

• 对于模组开发人员；

• FAQ 常见问题解答。