模组加载器
启动器在安装游戏时可一并选择模组加载器。本页列出各加载器的适用范围、可用版本、配套组件与已知限制,并汇总常见的兼容问题。
原版
不加载模组,仅安装游戏本体。
- 适用内容:原版游戏、资源包、数据包与存档
- 可用版本:全部游戏版本
- 配套组件:无
- 已知限制:光影需另装 Iris 或 OptiFine,不属于原版流程
Fabric
轻量加载器,性能类与光影类模组多在其上发布。
- 适用内容:Sodium、Iris、Lithium、Mod Menu
- 可用版本:1.14 及以后的主流正式版本,快照跟进较快
- 配套组件:Fabric API,放入
mods目录 - 已知限制:与 Forge、NeoForge 模组不通用;1.8.9 及更早版本改用 Legacy Fabric
Forge
早期出现的加载器,大型模组与整合包多以它为目标平台。
- 适用内容:Forge 模组、以其为目标平台的整合包
- 可用版本:主流正式版本均有发行,新版本发行晚于 Fabric
- 配套组件:模组自身的独立前置,如 GeckoLib
- 已知限制:与 Fabric 模组不通用;1.20.2 起与 NeoForge 分叉
NeoForge
由 Forge 分叉而来。1.20.1 的发行与 Forge 接口接近,此后差异逐步扩大。
- 适用内容:NeoForge 模组
- 可用版本:1.20.1 起,新版本跟进速度与 Fabric 接近
- 配套组件:同 Forge,前置按模组页标注安装
- 已知限制:与 Forge 模组不可混用;标注 Forge 的模组应改用 Forge
Quilt
Fabric 的分支,多数 Fabric 模组可在其上运行。
- 适用内容:标注兼容 Quilt 的模组
- 可用版本:覆盖版本少于 Fabric,旧版本以 Fabric 为主
- 配套组件:部分模组需 Quilt 标准库(QSL)
- 已知限制:少数 Fabric 模组不兼容;Forge 与 NeoForge 模组不可用
Legacy Fabric
面向旧版本游戏的分支。
- 适用内容:1.8.9 及更早版本上的 Fabric 模组
- 可用版本:仅旧版本,新版本使用 Fabric
- 配套组件:对应旧版本的 Fabric API
- 已知限制:模组、加载器、游戏版本三者须一致,任一不符则模组不加载
OptiFine
画质与光影组件,国内社区称「高清修复」,简称 OF。安装时与其他加载器同为可勾选项,不属于模组加载器。
- 适用内容:光影、画质选项、连接材质(CIT)
- 可用版本:仅部分游戏版本有对应发行,高版本发行很少
- 配套组件:Forge 环境使用对应 Forge 版;Fabric 环境需 OptiFabric 一类兼容层
- 已知限制:与 Sodium、Iris 功能重叠,同一实例不宜同时安装
每个发行版仅对应一个游戏版本,覆盖范围不完整。1.7.10 至 1.12.2 等旧版本的发行较全,高版本仅有少量发行,部分版本始终没有对应发行版。所选版本缺少发行版时,OptiFine 无法安装。
光影现已主要面向 Iris 发布,OptiFine 不再是主流方案。Iris 可加载多数为 OptiFine 编写的光影包,依赖 OptiFine 专有特性的光影除外。安装光影前应确认光影包标注的支持环境。
在 Fabric 上运行 OptiFine 依赖第三方兼容层,兼容性随版本变化。出现界面渲染异常或启动失败时,改用 Iris。
Cleanroom
由 1.12.2 的 Forge 分支而来的加载器,面向依赖其接口的 1.12.2 整合包。上游 2.8 已移除该支持,本修改版继续提供。
- 适用内容:以 Cleanroom 为目标的 1.12.2 模组与整合包
- 可用版本:仅 1.12.2
- 配套组件:模组放入
mods,前置按整合包说明安装 - 已知限制:其他版本不提供该选项;1.12.2 的 Forge 模组能否运行取决于其调用的接口
如何选择
| 加载器 | 面向模组 | 可用版本 |
|---|---|---|
| 原版 | 无 | 全部版本 |
| Fabric | Fabric 模组 | 主流版本 |
| Quilt | Fabric、Quilt 模组 | 少于 Fabric |
| Legacy Fabric | 旧版本 Fabric 模组 | 1.8.9 及更早 |
| Forge | Forge 模组 | 主流版本 |
| NeoForge | NeoForge 模组 | 1.20.1 起 |
| OptiFine | 光影与画质 | 仅部分版本有发行 |
| Cleanroom | Cleanroom 模组 | 仅 1.12.2 |
选择依据
以模组页标注的平台与游戏版本为准,不以社区教程或整合包名称为准。导入整合包时,加载器版本按整合包说明安装。
不可混用
Fabric 与 Forge、NeoForge 模组互不通用;NeoForge 与 Forge 自 1.20.2 起同样不可混用。同一实例只应保留一种加载器。
OptiFine 为可勾选项,不属于模组加载器。与 Sodium、Iris 同装会出现渲染异常,处理方式见「常见兼容问题」。
安装步骤与截图见帮助文档的「游戏与版本」与「模组与资源」专题,该栏目的专题尚在补充。
常见兼容问题
| 组合 | 表现 | 处理 |
|---|---|---|
| OptiFine 与 Sodium、Iris 同装 | 渲染异常,或启动失败 | 停用其中一类,光影改用 Iris |
| Forge 模组放入 Fabric 实例 | 加载器报错,或模组不生效 | 换用该模组的 Fabric 版本 |
| Fabric 模组放入 Forge 实例 | 模组不生效,部分模组导致启动失败 | 换用该模组的 Forge 或 NeoForge 版本 |
| 混装 NeoForge 与 Forge 模组 | 1.20.2 之后普遍无法加载 | 按模组标注的加载器分实例安装 |
| 整合包与加载器版本不符 | 缺少模组、依赖报错或启动失败 | 按整合包指定的版本重新安装 |
| 同一实例装入多个加载器 | 启动失败 | 每个实例仅安装一种加载器 |
| OptiFine 与优化模组同装 | 渲染异常、黑屏或崩溃 | 停用其中一类模组 |
上表按社区常见情况整理,未覆盖全部组合。
冲突排查
逐个移除近期安装的模组,直至异常消失;再逐个加回,确认冲突项。确认后仅保留一项。
查询模组的支持范围
模组能否在某个加载器上运行,以模组页的标注为准。
| 来源 | 可查内容 |
|---|---|
| MC 百科 | 模组页的「支持的 MC 版本」与「Mod 加载器」,以及中文说明与前置关系 |
| Modrinth | 版本列表,可按游戏版本与加载器筛选 |
| CurseForge | 文件页可按游戏版本与 Mod Loader 筛选 |
| 整合包 manifest | 指定的加载器与版本,导入后应与其一致 |
MC 百科的条目由社区维护,更新通常滞后于官方发布。加载器版本与前置信息以模组作者发布的页面为准。
注意事项
加载器与游戏版本
加载器版本需与游戏版本对应。安装时在「下载」版块选定游戏版本后勾选加载器,与游戏本体在同一步完成。所选版本没有对应加载器版本时,该加载器无法安装。
加载器版本的选择
同一游戏版本可能有多个加载器版本。整合包通常指定加载器版本,安装前按其说明选择;自行组装模组时,优先选择该加载器的最新稳定版本。
模组来源
Mod 默认从 Modrinth 获取。CurseForge 官方接口需要 x-api-key,未配置 Key 时使用镜像,可检索到的内容可能少于官方接口。
与渲染器的关系
Sodium、Iris 等要求桌面 OpenGL 3.3+ 的模组,启动器会进行兼容处理。能否运行取决于设备 GPU 与所选渲染器;无法启动时更换渲染器重试,具体现象见常见问题的「启动与运行」。
