Minecraft
Mod 加载器图鉴

🟩它是什么

Fabric Loader 是加载器；Fabric API 是许多模组使用的一组公共 API。两者不是一回事，装了 Loader 不代表自动拥有 Fabric API。

• 常见用途：性能优化、界面增强、地图、信息显示与原版体验改良。
• 不少项目能较快支持新游戏版本，但每个模组仍要单独确认。
• 开发中常见 Mixin 等机制，可修改游戏行为或注入逻辑。

常见项目：Fabric API、Sodium、Lithium、Mod Menu（请按目标版本检查兼容性）。

Fabric 官网 ↗ · Modrinth 模组库 ↗

⚙️优点与注意点

• 优点：轻巧灵活，客户端增强和性能优化选择多。
• 注意：没有 Fabric 版的 Forge 模组不能直接复制 JAR 来运行。
• 依赖：部分模组需要 Fabric API 或其他库，按报错和项目页安装。
• 服务器：纯界面类模组往往只需客户端；改变游戏机制的模组通常需要服务端配合。

🟠它是什么

Forge 提供事件系统、注册机制和模组开发接口。它与 Fabric 的加载机制和 API 不同。

• 许多经典模组和整合包以特定 Forge 版本为目标。
• Forge 与 NeoForge 是不同平台，不能只凭名字假设互通。
• 新旧 Minecraft 版本的模组可用情况差别很大。

Forge 官方下载 ↗

📦优点与注意点

• 优点：历史积累深，部分版本有大量成熟内容和教程。
• 注意：大型模组之间可能有复杂依赖和兼容关系。
• 性能：加载器本身不能直接决定整合包快慢，模组组合与配置影响很大。
• 迁移：从 Forge 换到 Fabric 通常需要替换模组，而非只换启动配置。

🔴它是什么

NeoForge 不是一个可以与 Forge 随意互换的“新版名字”。它有自己的 API、版本支持和模组发行情况。

• 部分新版本大型内容模组会优先支持 NeoForge。
• 有的模组同时发布 Forge 与 NeoForge 版本，有的只支持其中一个。
• 下载时确认文件明确标注 NeoForge 和对应 Minecraft 版本。

NeoForge 官网 ↗

🧭与 Forge 怎么区分

不要只凭名称判断兼容性。若下载页分别提供 Forge 与 NeoForge 文件，应按实际安装的平台选择。

• 检查整合包说明要求哪一个加载器。
• 确认加载器版本、模组文件和游戏版本一致。
• 崩溃时检查是否缺依赖、加载器错误或版本不匹配。

🟣它是什么

Quilt 旨在提供开放、社区参与度高的模组平台。部分 Fabric 模组可能可以运行，但不能保证全部兼容。

• 检查 Quilt Loader、对应 API 和目标模组支持说明。
• 不要假设 Fabric API 的所有功能或版本组合都完全一致。
• 如果核心模组明确支持 Quilt，再按官方说明配置。

Quilt 官网 ↗

🔍选择前注意

• 查看模组是否发布 Quilt 版本或明确说明兼容。
• 兼容桥接工具可能有局限，不应当作通用方案。
• 出问题时先用最少模组启动，再逐个添加定位冲突。

📥安装前检查

• 游戏版本精确匹配，1.21.1 和 1.21.11 不要当作同一个版本。
• 安装正确加载器，确认启动器运行的是对应配置。
• 下载模组 JAR，而不是资源包、数据包或源码压缩包。
• 安装所有必需依赖，并确认依赖版本匹配。
• 核对 Java 运行环境要求，以游戏版本和启动器提示为准。
• 启动一次游戏后，把模组放入该实例的 mods 文件夹。

🧰启动崩溃时这样查

• 缺少依赖：按报错补装指定库。
• 加载器不符：换成当前平台的发行文件。
• 版本不兼容：核对游戏版本与模组页说明。
• 添加后崩溃：移出最近加入的模组，再逐个加回。
• 查日志：查看 logs/latest.log 或 crash-reports。

尽量使用项目官方页面或可信平台下载；警惕要求运行陌生 EXE、关闭安全软件或提供账户密码的安装器。