如何安装 Fabric 模组

分步说明

1. 1.选择 Minecraft 版本

   每个模组都是为某一个 Minecraft 版本（或一小段版本范围）构建的。先选定版本，再下载对应的模组。

2. 2.安装 Fabric Loader

   从 fabricmc.net 下载 Fabric 安装器，选择“客户端”，选好 Minecraft 版本并安装。它会在 Minecraft 启动器中添加一个“fabric-loader”配置。

3. 3.先运行一次该配置

   用 Fabric 配置启动游戏，然后关闭。这会在 .minecraft 中创建 mods/ 文件夹。

4. 4.添加 Fabric API 和模组

   下载同一 Minecraft 版本的 Fabric API，然后把它和模组 .jar 一起放进 .minecraft/mods/。不要解压。

5. 5.启动游戏并检查

   启动 Fabric 配置。如果某个模组缺少依赖或者版本不对，Fabric 会显示一个界面，写明是哪个模组以及它需要什么。

mods 文件夹在哪里

• Windows：%appdata%\.minecraft\mods（粘贴到“运行”对话框或资源管理器地址栏中）。
• macOS：~/Library/Application Support/minecraft/mods。
• Linux：~/.minecraft/mods。
• 其他启动器（Prism、MultiMC、Modrinth App、CurseForge 应用）每个实例都有单独的文件夹：使用它们的“打开 mods 文件夹”按钮。

在服务器上安装

多人游戏的话，服务器也需要 Fabric。获取相同 Minecraft 和加载器版本的 Fabric 服务端启动器（或用安装器的“服务端”模式），先启动一次，然后把 Fabric API 和模组放进服务器的 mods/ 文件夹并重启。

哪些模组装在哪里，取决于模组本身：

• 内容类模组（新方块、物品、生物）：装在服务器上，同时也装在每个玩家的客户端上。
• 仅客户端模组（HUD、小地图、光影、按键绑定）：只装在客户端上。有些装到专用服务器上会导致崩溃。
• 仅服务端模组（性能优化、管理工具、部分玩法规则）：只装在服务器上；如果模组说明允许，玩家用纯 Fabric 甚至原版就能加入。

常见问题

• “发现不兼容的模组”：某个模组是为其他 Minecraft 版本做的，或者需要更新的 Fabric Loader。Fabric 会写明是哪个模组：换成正确的版本即可。
• 需要 fabric-api：mods/ 中缺少 Fabric API，或者它的版本不对。
• 模组没有任何效果：你启动的是普通配置而不是 Fabric 配置，或者这个模组是 Forge 或 NeoForge 的。Fabric 不会加载 Forge 模组。
• 专用服务器崩溃并提到客户端类：服务器上装了一个仅客户端模组。

用 Codexe 制作的模组

在 Codexe 上制作的 Fabric 模组在标记为就绪之前会被编译，并且 .jar 必须包含有效的 fabric.mod.json。它基于 Fabric API 构建，所以要在旁边一起安装 Fabric API。编译通过只能证明模组能构建，不能证明它运行时不会崩溃，而且模组暂时还不能在 Codexe 测试服务器上试用：请在你自己的客户端中，用它所针对的版本进行测试。

常见问题