HMCL-docs/_launcher/auto-installing.md

---
title:  "自动安装与模组下载简介"
permalink: /launcher/auto-installing.html
date:   2021-10-09 23:18:02 +0800
categories: 启动器
toc: true
---

![Hits](https://hits.seeyoufarm.com/api/count/incr/badge.svg?url=https%3A%2F%2Fdocs.hmcl.net%2Flauncher%2Fauto-installing.html&count_bg=%233E4245&title_bg=%233E4245&icon=&icon_color=%23E7E7E7&title=%F0%9F%91%80&edge_flat=false)

> 本文由 asdqp233 编写。

## 安装 Mod 加载器

当你在安装新的游戏客户端时候, 会看到其中有

`Forge, LiteLoader, Fabric, Quilt`这 4 个 Mod 加载器可供选择。

以及 `Fabric API, QSL/QFAPI` 这两个随 Fabric 与 Quilt 的 API（实际是模组）可供选择。

![AutoInstaller_ModLoader](/assets/img/docs/auto-installing/AutoInstaller_ModLoader.png)

当你使用 1.14 及以上的游戏版本时, 推荐使用 *Fabric*

1.14 以下的版本推荐使用 *Forge* 

*LiteLoader* 只适用于 1.12.2 及以前的版本 (目前已停更)

**注意: 

选择完合适的Mod加载器之后就可以点击右下角的`安装`继续进行安装。

**注意: **

***LiteLoader* 和 *Forge* 是兼容的 ( *Forge* 较新版本和 *LiteLoader* 较老版本可能不兼容)**

***Fabric* 和 *Forge* 不兼容!****

**如果选择 *Fabric* , 那么建议同时选择 *Fabric API***

**如果选择 *Quilt* ，那么建议同时选择 *QSL/QFAPI***

## 安装 Mod

### 自动安装

#### Forge Mod

HMCL 内置了 CurseForge 和 Modrinth 下载源的搜索和下载功能, 目前已支持中文搜索 (匹配结果不一定准确) 。

点开 Mod 下载页面, 最上方会显示当前 Mod 需要的前置 Mod (如果有) , 以及 Mod 支持的全部版本, 请根据你当前安装的游戏版本选择恰当的版本。

**注意: 请区分 *Forge Mod* 和 *Fabric Mod* , 大部分 Mod 在文件名中会注明, 请不要选择错误, 否则 Mod 将无法被正确加载。**

**建议点击上方的蓝色的 模组详情链接 查看模组的信息，这有可能会提示你些什么注意事项**

![AddingModAutomatically](/assets/img/docs/auto-installing/AutoInstaller_ModAutoAdding.png)

#### Fabric Mod / Quilt Mod 

*Fabric Mod* 和 *Quilt Mod* 的安装和 *Forge Mod* 的安装类似, [参照上文](#forge-mod)。

**注意：**

- **几乎所有的 *Fabric Mod* 或 *Quilt Mod* 都需要 *Fabric API* 或 *QSL/QFAPI*。在安装 Mod 加载器时候如果没有选择, 请选择安装 *Fabric API* 或 *QSL/QFAPI* , 否则 *Fabric Mod* 或 *Quilt Mod* 则有可能无法被加载!**

- ***Fabric* 对应 *Fabric API* ，*Quilt Mod* 对应 *QSL/QFAPI* ，请不要搞错。**

#### LiteLoader Mod

*LiteLoader Mod* 安装和 *Forge Mod* 的安装类似, [参照上文](#forge-mod)。

**注意: LiteLoader 只能加载文件后缀为 litemod 的模组, *Forge Mod*、*Fabric Mod* 和 *Quilt Mod*等修改后缀的方法 LiteLoader 是无法检测。**

#### OptiFine

[详情请查阅此](/launcher/shader.html)

### 手动安装

一般的 Mod 文件后缀为 `jar` 或者 `litemod` 。

将这个 jar 文件复制到 `\.minecraft\Mods` 文件夹中即可 (没有这个文件夹就自己新建一个) 。

若开启了版本隔离, 那么文件夹是`\.minecraft\version\<版本名称>\Mods`。

或者在 HMCL 的 `游戏管理页面—模组管理` 页面点击添加模组或直接将文件拖入启动器窗口。

![AddingModManually](/assets/img/docs/auto-installing/AutoInstaller_ModManualAdding.png)

## 安装 Mod 后游戏报错/无法启动

造成游戏报错的原因有很多, 比如 Mod 之间不兼容, Fabric API 的版本过高, 缺少前置 Mod 等等。

1. 新版本的 HMCL 拥有错误分析功能, 可以根据HMCL的提示来排查原因。

2. 也可以使用二分法来解决——每次加入 / 删除一半的 Mod , 挨个排除, 直到找到导致游戏报错的 Mod 为止。

3. 如果你的能力很优秀, 也可以直接查看游戏日志来找出问题的原因。

4. 如果无法理解日志内容, 那么请将 `\.minecraft\crash-reports` 和 `\.minecraft\logs` 文件夹打包发给其他人寻求帮助。