Mod 管理

MC Launcher Alpha 内置了强大的 Mod 管理功能，接入 CurseForge 和 Modrinth 两大 Mod 仓库，支持搜索、下载、启用/禁用、配置编辑和更新检测等一站式操作。本章将详细介绍 Mod 管理的各个方面。

搜索与下载

MC Launcher Alpha 支持从 CurseForge 和 Modrinth 双源搜索和下载 Mod，覆盖绝大多数主流 Mod。

搜索步骤

1. 进入 下载 页面
2. 在搜索框中输入 Mod 名称或关键词
3. 可以通过分类标签筛选（如「工具」、「优化」、「装饰」、「冒险」等）
4. 也可以按热度、下载量、更新时间等排序
5. 找到目标 Mod 后，点击进入详情页

下载步骤

1. 在 Mod 详情页中，确认 Mod 支持的游戏版本和 ModLoader 类型
2. 点击 「下载」 按钮
3. 选择要安装到的目标实例（如果存在多个实例）
4. 等待下载完成

提示

下载进度可以在右下角的全局下载弹窗中实时查看，支持暂停和取消操作。

本地 Mod 管理

进入 实例详情 页面，可以查看和管理该实例中已安装的所有 Mod。

管理功能

操作	说明	详细描述
启用 / 禁用	切换 Mod 的加载状态	点击 Mod 旁的开关即可切换，无需删除文件。禁用的 Mod 不会被游戏加载，但文件仍保留在 mods/ 目录中（文件名会被添加 .disabled 后缀）
配置编辑	编辑 Mod 的配置文件	支持 .toml 和 .json 格式的配置文件。点击「编辑」按钮打开内置编辑器，修改后保存即可生效
删除	从实例中移除 Mod	点击「删除」按钮会将 Mod 文件从 mods/ 目录中永久移除。删除前会弹出确认对话框
更新检测	检查 Mod 是否有新版本	基于 Modrinth 的 SHA1 哈希值比对，自动检测已安装 Mod 是否有可用更新。有更新时会显示更新提示

ModLoader 支持

MC Launcher Alpha 支持以下 ModLoader，不同 ModLoader 对应不同的 Mod 生态：

ModLoader	Mod 生态	仓库来源	说明
Fabric	Fabric 专属 Mod	CurseForge / Modrinth	轻量级，Mod 数量多，加载速度快
Forge	Forge 专属 Mod	CurseForge / Modrinth	老牌生态，大型 Mod 丰富
NeoForge	NeoForge 专属 Mod	CurseForge / Modrinth	新版本生态，兼容 Forge Mod
Quilt	Quilt / Fabric Mod	Modrinth	兼容大部分 Fabric Mod

注意

• 下载 Mod 前，请确认 Mod 支持的游戏版本和 ModLoader 与你的实例配置一致。
• 不同 ModLoader 的 Mod 不能混用。例如，Fabric Mod 不能在 Forge 环境中加载。
• 部分大型 Mod 可能有前置依赖（前置 Mod），请确保所有依赖都已安装。

常见问题

Mod 安装后不生效？

请按以下步骤排查：

1. 确认 ModLoader 已正确安装 -- 进入版本页面，检查目标版本是否已安装对应的 ModLoader
2. 确认版本兼容性 -- 检查 Mod 支持的游戏版本是否与你安装的版本一致
3. 确认 ModLoader 类型匹配 -- Fabric Mod 只能在 Fabric 环境中加载，Forge Mod 只能在 Forge 环境中加载
4. 检查 Mod 是否被禁用 -- 在实例详情中确认 Mod 的启用开关处于开启状态
5. 检查前置依赖 -- 部分 Mod 需要安装前置 Mod 才能正常工作，请查看 Mod 的描述页面

Mod 下载失败？

可能的原因和解决方案：

原因	解决方案
网络连接异常	检查网络连接，或尝试切换下载源
下载源不可用	进入「设置」切换到其他下载源
磁盘空间不足	清理磁盘空间后重试
目标实例不存在	确认目标实例未被删除

如何查看 Mod 的详细信息和更新日志？

在「下载」页面点击 Mod 名称进入详情页，可以查看 Mod 的描述、截图、支持版本、更新日志和依赖关系等完整信息。

Mod 配置文件在哪里？

Mod 配置文件通常位于实例目录下的 config/ 文件夹中。你也可以通过 MC Launcher Alpha 的内置配置编辑器直接编辑，无需手动查找文件。