翻新文档 (#32)

2026-09-15 08:31:11 +08:00 · 2022-11-26 00:14:18 +08:00
parent 9d1d3368b8
commit caf4a87d26
15 changed files with 165 additions and 86 deletions
@@ -9,13 +9,19 @@ toc: true
 > 本文由 huanghongxun 编写。

 ## 背景
+
 使用 authlib-injector 认证的服主可以通过本教程提供的方法使 HMCL 默认在打开时弹窗要求创建对应认证服务器的账户。
+
 ## 方法
+
 在 HMCL 启动器同级目录下创建 `authlib-injectors.json` 文件，此时文件夹目录结构如下图所示：

 ![](/assets/img/docs/authlib-injector/image.png)

-（注意，请确保打包后的整合包不包含 `hmcl.json` 文件，否则无法生效） `authlib-injectors.json` 文件的示例如下
+（注意，请确保打包后的整合包不包含 `hmcl.json` 文件，否则无法生效。该文件默认为隐藏状态，需开启隐藏文件显示） 
+
+`authlib-injectors.json` 文件的示例如下
+
 ```
 {
    "urls": [
@@ -10,17 +10,33 @@ toc: true

 ## 安装 Mod 加载器

-当你在安装新的游戏客户端时候, 会看到其中有 Forge, LiteLoader, Fabric, Quilt 这 4 个 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 及以前的版本 (目前已停更) 。
+当你使用 1.14 及以上的游戏版本时, 推荐使用 *Fabric*

-**注意: *LiteLoader* 和 *Forge* 是兼容的 ( *Forge* 较新版本和 *LiteLoader* 较老版本可能不兼容) , 但 *Fabric* 和 *Forge* 不兼容!**
+1.14 以下的版本推荐使用 *Forge* 
+
+*LiteLoader* 只适用于 1.12.2 及以前的版本 (目前已停更)
+
+**注意: 

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

-**注意: 如果选择 *Fabric* , 那么建议同时选择 *Fabric API***
+**注意: **
+
+***LiteLoader* 和 *Forge* 是兼容的 ( *Forge* 较新版本和 *LiteLoader* 较老版本可能不兼容)**
+
+***Fabric* 和 *Forge* 不兼容!****
+
+**如果选择 *Fabric* , 那么建议同时选择 *Fabric API***
+
+**如果选择 *Quilt* ，那么建议同时选择 *QSL/QFAPI***

 ## 安装 Mod

@@ -28,33 +44,47 @@ toc: true

 #### Forge Mod

-HMCL 内置了 CurseForge 和 Modrinth 下载源的搜索和下载功能, 目前已支持中文搜索 (匹配结果不一定准确) 。点开 Mod 下载页面, 最上方会显示当前 Mod 需要的前置 Mod (如果有) , 以及 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
+#### Fabric Mod / Quilt Mod 

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

-**注意: 几乎所有的 *Fabric Mod* 都需要 *Fabric API* 。在安装 Mod 加载器时候如果没有选择, 请先安装 *Fabric API* (安装方法和普通 Mod 安装方法相同) , 否则 *Fabric 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* 的安装类似, 参照上文。
+*LiteLoader Mod* 安装和 *Forge Mod* 的安装类似, [参照上文](#forge-mod)。

-**注意: LiteLoader 只能加载文件后缀为 litemod 的模组, Forge Mod 修改后缀后 LiteLoader 无法检测。**
+**注意: LiteLoader 只能加载文件后缀为 litemod 的模组, *Forge Mod*、*Fabric Mod* 和 *Quilt Mod*等修改后缀的方法 LiteLoader 是无法检测。**
+
+#### Optifine
+
+[详情请查阅此](/launcher/optifine.html)

 ### 手动安装

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

-将这个 jar 文件复制到 `\.minecraft\Mods` 文件夹中即可 (没有这个文件夹就自己新建一个) 。如果开启了版本隔离, 那么文件夹是`\.minecraft\version\<版本名称>\Mods`。
+将这个 jar 文件复制到 `\.minecraft\Mods` 文件夹中即可 (没有这个文件夹就自己新建一个) 。
+
+若开启了版本隔离, 那么文件夹是`\.minecraft\version\<版本名称>\Mods`。

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

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

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

@@ -66,5 +96,4 @@ HMCL 内置了 CurseForge 和 Modrinth 下载源的搜索和下载功能, 目前

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

-4. 如果无法理解日志内容, 那么请将 `\.minecraft\crash-reports` 和 `\.minecraft\logs` 文件夹打包发给其他人寻求帮助。
-
+4. 如果无法理解日志内容, 那么请将 `\.minecraft\crash-reports` 和 `\.minecraft\logs` 文件夹打包发给其他人寻求帮助。
@@ -11,9 +11,11 @@ toc: true
 本指南只介绍如何制作一个 HMCL 可导入的数据包压缩包。

 ## 建议
+
 始终建议你使用多数据包格式制作数据包压缩包，因为 HMCL 会删除重名的数据包，因此可以借此完成更新功能，只要直接导入新的多数据包格式的压缩包就可以完成更新你制作的数据包。

 ## 多数据包
+
 如果你的数据包被分离成多个部分供玩家选择是否启用，或者需要自带资源包，那么你需要制作多数据包格式的压缩包。

 多数据包文件（只能是一个 `.zip` 文件）格式例子如下：
@@ -12,10 +12,10 @@ toc: true

 ## 使用方式
 进入 hmcl 的`设置`
-![](assets\img\docs\Global-version-isolation\img.png)
+![](\assets\img\docs\Global-version-isolation\img.png)
 在全局设置中找到 `版本隔离`
 改为 `各版本独立`
-![](assets\img\docs\Global-version-isolation\img1.png)
+![](\assets\img\docs\Global-version-isolation\img1.png)
 这时候 minecraft 的文件结构就会有所改变
 ```
 .minecraft
@@ -37,7 +37,7 @@ toc: true

 ## 往后的使用
 在做完版本隔离的设置后，hmcl 的快速打开各个游戏文件夹的功能就会显得十分重要。
-![](assets/img/docs/Global-version-isolation/img2.png)
+![](/assets/img/docs/Global-version-isolation/img2.png)

 善用该功能也可为你的磁盘剩下不少的空间

@@ -13,11 +13,11 @@ toc: true

 当你在安装新的游戏客户端时候，会看到有个 `OptiFine` 的选项。

-![OptiFine_Install](assets/img/docs/install_optifine/optifine_install.png)
+![OptiFine_Install](/assets/img/docs/install_optifine/optifine_install.png)

 点开之后会看到有 3 个复选框，一般而言，`正式版` 会比 `测试版` 更加稳定。选择安装 `正式版` ，如果没有 `正式版` 那么再考虑 `测试版` 。

-![OptiFine_Selection](assets/img/docs/install_optifine/select_optifine.png)
+![OptiFine_Selection](/assets/img/docs/install_optifine/select_optifine.png)

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

@@ -25,7 +25,7 @@ toc: true

 在对应的游戏版本管理页面，点击 `自动安装` ，你会看到有个 `OptiFine` 的选项。

-![OptiFine_AutoInstaller](assets/img/docs/install_optifine/install_auto-16338577874692.png)
+![OptiFine_AutoInstaller](/assets/img/docs/install_optifine/install_auto-16338577874692.png)

 点开之后选择合适的版本然后等待安装完成即可。
 目前，如果要在  `Fabric` 使用 `OptiFine` ，需要通过 **方式四** 安装。
@@ -36,7 +36,7 @@ toc: true

 双击打开或者使用 `java -jar 文件名` 的方式打开，然后你就会看到这个界面。

-![Path_Selection](assets/img/docs/install_optifine/change_path.png)
+![Path_Selection](/assets/img/docs/install_optifine/change_path.png)

 选择自己游戏的 `.minecraft 目录`（默认安装到 `\AppData\Roaming\.minecraft` 目录下），然后点击 `Install` 按钮，之后你在 HMCL 的版本列表中就可以找到含有 OptiFine 名字的客户端，启动即可。

@@ -60,6 +60,6 @@ toc: true

 如果你不知道版本隔离是啥，也不会创建文件夹，那么请打开游戏，依次点击 `设置—视频设置—光影—光影包文件夹` ，在里面放入光影包，然后点击你要加载的光影，最后点击 `完成` 即可

-![Shader_Settings](assets/img/docs/install_optifine/shaders_setting.png)
+![Shader_Settings](/assets/img/docs/install_optifine/shaders_setting.png)

 **注意：光影对于电脑配置的要求比较高，如果开了光影之后出现游戏画面很卡的情况，请升级电脑配置、使用低配置光影或者关闭光影。**
@@ -68,26 +68,4 @@ toc: true

 ![](/assets/img/docs/offline-skin/img4_2.png)

-![](/assets/img/docs/offline-skin/img4_3.png)
-
-## 以下内容为测试
-
-<div class="note">
-  <h5>提示™帮助你更好的使用 Jekyll</h5>
-  <p>这里有各种小技巧让你成为 Jekyll 大神</p>
-</div>
-
-<div class="note info">
-  <h5>说明包含一些有用的信息</h5>
-  <p>这里提供一些帮助你理解 Jekyll 的内容</p>
-</div>
-
-<div class="note warning">
-  <h5>警告帮助你不出错</h5>
-  <p>如果不想出错，请注意这类消息</p>
-</div>
-
-<div class="note unreleased">
-  <h5>尚未发布的功能</h5>
-  <p>这部分内容针对 Jekyll 尚未发布的版本</p>
-</div>
+![](/assets/img/docs/offline-skin/img4_3.png)