HMCL-docs/_launcher/auto-installing.md
zkitefly 8c8c308417
All checks were successful
continuous-integration/drone/push Build is passing
添加 hist 标签 (#46)
Co-authored-by: Yuhui Huang <i@huangyuhui.net>
2023-02-19 16:10:42 +08:00

101 lines
4.0 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

---
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/optifine.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` 文件夹打包发给其他人寻求帮助。