如何在 Minecraft 中安装 Fabric 模组

Fabric 是一款轻量级的模组加载器，它允许你在不修改原生 Minecraft 游戏文件的情况下，同时运行模组。本指南将指导你安装 Fabric、设置模组文件夹以及添加模组，使其自动加载。

前置条件

开始前：

• 已安装并至少启动过 Minecraft Java 版
• 已安装 Java 17 或更高版本（建议使用 Java 21，以支持当前版本的 Minecraft）
• 互联网连接
• 已下载 Fabric 模组（以 JAR 文件形式）

通过在终端中运行 java -version 命令来检查你的 Java 版本。

第一步：安装 Fabric Loader

请按照 Fabric Loader 安装指南 的步骤操作：

1. 从 fabricmc.net 下载官方 Fabric 安装程序
2. 运行安装程序并选择你的 Minecraft 版本
3. 在启动器中选择新的 Fabric 配置文件
4. 启动一次，以便创建模组文件夹

完成此步骤后，你将拥有一个可用的 Fabric 安装以及一个准备好用于添加模组的模组文件夹。

第二步：获取 Fabric API

大多数 Fabric 模组都依赖于 Fabric API，这是一个共享库。下载它：

1. 访问 fabricmc.net/use/api
2. 找到与你的 Minecraft 版本匹配的版本
3. 下载 JAR 文件
4. 将其移动到你的模组文件夹

第三步：下载并添加模组

1. 下载模组 JAR 文件

   在像 Modrinth 或 CurseForge 这样的网站上寻找模组。下载与你的 Minecraft 版本相符的 JAR 文件.

2. 移动到模组文件夹

   将每个 JAR 文件拖入你的 mods 文件夹。不要解压它们，它们保持 JAR 文件格式.

3. 发射 Fabric

   打开 Minecraft，选择 Fabric 档案，然后点击“开始游戏”.

4. 验证模组已加载

   在主菜单中，转到“模组”选项。你应该能看到你的模组列表。如果某个模组没有出现，请检查它的版本是否与你的 Minecraft 版本相符.

启动后，您文件夹中的所有模组将自动加载。

整理您的模组文件夹

保持模组文件夹的整洁：

.minecraft/mods/
├── fabric-api-X.X.X.jar
├── mod-name-1.jar
├── mod-name-2.jar
├── mod-name-3.jar
└── (all mods here)

通过删除其 JAR 文件来删除模组。无需任何配置，只需重新启动即可。

处理模组冲突

某些模组之间可能存在冲突。冲突的迹象：

• 加载特定模组时启动时崩溃
• 游戏异常冻结或卡顿
• 模组的功能无法正常工作

要找到罪魁祸首：

1. 移除所有模组，只保留一个
2. 重新启动以确认其单独工作
3. 每次添加一个模组
4. 当发生崩溃时，您就找到了冲突

查看模组的文档——作者通常会列出已知的冲突。

版本匹配说明

这是最常见的失败点：

如果 Minecraft 是 1.21 但模组仅支持 1.20.1，则它将无法加载。始终检查模组的下载页面以获取支持的版本。

常见问题和解决方案

• ✓模组未出现在模组列表中：请仔细检查它是否位于正确的模组文件夹（路径见上）以及你是否启动了 Fabric 配置文件，而不是原版配置文件。
• ✓崩溃时出现“找不到类”：Fabric API 缺失或版本错误。请下载适用于您的 Minecraft 版本的正确 API。
• ✓日志中出现版本错误：您的 Minecraft、Fabric、API 或模组目标版本不一致。所有版本必须完全匹配。
• ✓模组加载但使用时崩溃：可能与其他模组冲突。禁用其他模组并单独测试.
• ✓性能非常慢：您的硬件可能无法支持过多的模组。请尝试禁用最耗资源的模组。

添加 Terminus

Terminus 是一款与其它模组一同运行的 Fabric 模组。要安装它：

1. 按照上述所有步骤设置 Fabric 和 Fabric API
2. 从您的账户仪表盘下载 Terminus
3. 将 Terminus JAR 文件放入您的模组文件夹中
4. 启动 Fabric

Terminus 就像任何其他 Fabric 模组一样加载。您可以在游戏内的模组菜单中配置它。

常见问题解答