必须安装Fabric Loader和Fabric API——缺一不可，否则模组报错不启动；Loader是运行基础，API是通用接口层，二者版本须严格匹配MC版本（如1.20.1）和Java 17/20。
要在《我的世界》中用 Fabric 正常加载模组，必须先装好 Fabric Loader 和 Fabric API——缺一不可，否则模组会直接报错不启动。
Fabric 前置环境安装
这一步决定后续所有模组能否被识别。Fabric Loader 是运行基础，Fabric API 是绝大多数模组依赖的通用接口层，二者版本必须严格匹配 Minecraft 游戏版本（例如 1.20.1）和 Java 版本（Fabric 要求 Java 17 或 Java 20）。
第一步：访问 https://fabricmc.net/use/ → 点击「Download the installer」→ 下载对应 Minecraft 版本的 fabric-installer-*.jar 文件。
第二步：双击运行该 .jar 文件 → 选择「Install client」→ 在下拉菜单中选准你的目标游戏版本（如 1.20.1）→ 点击「OK」完成 Fabric Loader 安装。
第三步：打开 Minecraft 启动器 → 选择刚生成的「Fabric 1.20.1」（或对应版本）配置 → 首次启动并进入主菜单后退出。这一步强制生成 【.minecraft/runtime】和【.minecraft/mods】文件夹结构】，否则后续放模组会无效。
第四步：访问 https://modrinth.com/mod/fabric-api/versions → 找到与你 Minecraft 版本完全一致的 Fabric API 版本（如 mc1.20.1-0.91.3）→ 下载 .jar 文件 → 将其拖入 【.minecraft/mods 文件夹】（不要解压，不要放错目录）。
手动安装 Fabric 模组
模组文件本身是 .jar 格式，必须放在正确路径下，且不能与 Fabric 环境版本冲突。常见错误是把 1.21 的模组丢进 1.20.1 的 mods 文件夹，结果游戏启动卡在加载界面。
方法一：直投 mods 文件夹
① 按下 Win + R → 输入 %appdata%\.minecraft → 回车打开.minecraft根目录。
② 进入 mods 文件夹 → 将已下载的 Fabric 模组 .jar 文件（如 sodium-0.4.10-mc1.20.1.jar）直接拖入，不重命名、不解压、不建子文件夹。
③ 启动器中选择带「Fabric」字样的版本 → 启动游戏 → 主菜单右上角出现「Mods」按钮即表示加载成功。
方法二：通过 Modrinth CLI 自动注入（适合批量管理）
安装 modrinth-cli 工具后，在终端执行：
modrinth install sodium lithium --mc 1.20.1
命令会自动校验版本、下载依赖、放入 mods 文件夹并提示完成。
注意：若模组页面标注「Requires Fabric API」，而你没装 Fabric API，游戏会闪退且日志里报 NoClassDefFoundError，此时必须补上 Fabric API。
网易版与夸克版用户特别操作
网易版和夸克版 Minecraft 不支持 Fabric 加载器，它们使用封闭组件系统，无法运行任何 Fabric 或 Forge 模组。强行将 .jar 文件放入其 mods 文件夹完全无效，游戏启动时不会扫描、也不会报错提示。
如果你正在用网易启动器或夸克启动器，【请立刻停止尝试 Fabric 模组安装】，转而查找该平台「组件中心」里是否提供同功能的审核组件（如 JEI 功能可能有“物品查看器”替代组件）。
夸克版 1.24.15.145251 等新版本仍沿用自有组件框架，未开放 Fabric 接口。官方未发布任何兼容 Fabric 的适配补丁。
