如何安装Fabric模组

安装一个Fabric模组遵循一个简单的三步过程：确保你的Minecraft版本已安装Fabric Loader，将Fabric API添加到你的模组文件夹中，然后将模组JAR文件放在旁边。 大多数安装问题都源于版本不匹配，所以请验证每个组件都针对相同的Minecraft版本

先决条件

在安装模组之前：

• 您的 Minecraft 版本已安装 Fabric 载入器（请参阅如何安装 Fabric 载入器）
• 您至少已启动过 Fabric 配置文件，以便模组文件夹存在
• 模组 JAR 文件已下载

三步过程

1. 安装Fabric加载器

   请确保您已安装并启动了适用于您 Minecraft 版本的 Fabric 载入器。 如果尚未安装，请先按照Fabric 载入器安装指南进行操作.

2. 下载并添加Fabric API

   下载与您的 Minecraft 版本相对应的 Fabric API 的 JAR 文件。将其放置在您的 mods 文件夹中。大多数模组都依赖于此.

3. 添加模组 JAR 文件

   下载模组的 JAR 文件，并将其放置在与 Fabric API 相同的模组文件夹中。不要解压缩它，保持 JAR 格式即可.

使用 Fabric 配置文件启动 Minecraft，模组将在启动时自动加载。

模组文件夹

您的模组文件夹位于：

如果该文件夹不存在，请运行一次 Fabric 配置文件，它将为您自动创建。

Fabric API：您为什么需要它

大多数 Fabric 模组都依赖 Fabric API，这是一个为模组制作者提供常用工具的共享库。 优先安装它可以防止因缺少库而导致的崩溃。 即使某个特定模组声称不需要该 API，添加它也不会造成损害，并能避免意外情况。

模组未加载时该怎么办

• ✓模组未出现在模组列表中：JAR 文件在错误的文件夹中，或者你启动的是原版游戏而不是 Fabric。请确认路径和配置文件.
• ✓崩溃时出现“缺失类”错误：Fabric API 缺失或版本不正确。请为您的 Minecraft 版本下载正确的 API 版本。
• ✓日志中出现版本不匹配的错误：加载器、API 或模组目标 Minecraft 版本不同。这三个版本必须完全一致（例如，1.21，如果模组目标是 1.21，则不能是 1.21.1）。
• ✓模组加载但使用时崩溃：该模组可能与其他模组或设置冲突。尝试仅加载该模组以隔离问题。

版本匹配

这是最大的陷阱。每个模组都必须针对同一版本：

Minecraft version: 1.21
Fabric loader version: 1.21 ✓
Fabric API version: 1.21 ✓
Mod version: 1.21 ✓
All match → no crash

如果你的 Minecraft 是 1.21，但模组针对的是 1.20.1，它将无法加载。请在模组的下载页面上查看它支持的确切版本。

运行多个模组

一旦你有一个模组正常工作，添加更多就非常简单：

1. 下载每个模组的 JAR 文件
2. 将它们全部放入 mods 文件夹
3. 启动 Fabric
4. 所有模组一起加载（假设没有冲突）

某些模组之间存在冲突。如果在添加新模组后发生崩溃，请禁用它以确认是其原因，然后查看模组作者是否记录了冲突。

常见问题解答