Skip to content

模组加载器 ​

启动器在安装游戏时可一并选择模组加载器。本页列出各加载器的适用范围、可用版本、配套组件与已知限制,并汇总常见的兼容问题。

原版 ​

不加载模组,仅安装游戏本体。

  • 适用内容:原版游戏、资源包、数据包与存档
  • 可用版本:全部游戏版本
  • 配套组件:无
  • 已知限制:光影需另装 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 模组能否运行取决于其调用的接口

如何选择 ​

加载器面向模组可用版本
原版无全部版本
FabricFabric 模组主流版本
QuiltFabric、Quilt 模组少于 Fabric
Legacy Fabric旧版本 Fabric 模组1.8.9 及更早
ForgeForge 模组主流版本
NeoForgeNeoForge 模组1.20.1 起
OptiFine光影与画质仅部分版本有发行
CleanroomCleanroom 模组仅 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 与所选渲染器;无法启动时更换渲染器重试,具体现象见常见问题的「启动与运行」。

ZPCL Launcher 是 Zalith Launcher 2 的非官方修改版,遵循 GPLv3 开源协议