Browse Source

翻新文档 (#32)

zkitefly-patch-1
zkitefly 2 years ago committed by GitHub
parent
commit
caf4a87d26
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
  1. 42
      _docs/about-questions.md
  2. 3
      _docs/contribution.md
  3. 8
      _launcher/authlib-injector.md
  4. 57
      _launcher/auto-installing.md
  5. 2
      _launcher/datapack.md
  6. 6
      _launcher/global-version-isolation.md
  7. 10
      _launcher/install_optifine.md
  8. 22
      _launcher/offline-skin.md
  9. 15
      _modpack/modpack-in-java.md
  10. 7
      _modpack/serverpack.md
  11. 10
      _modpack/serverpack2.md
  12. 13
      _multiplayer/multiplayer-feedback
  13. 13
      _multiplayer/multiplayer-help
  14. 13
      _multiplayer/multiplayer-token
  15. 8
      _multiplayer/multiplayer.md

42
_docs/about-questions.md

@ -18,48 +18,74 @@ toc: true
## 关于游戏的下载
__想必你注意到我了,记住上面讲的话__
首先 Minecraft 的下载有着 HMCL 十分的简单
首先打开你的 hmcl
![](assets/img/docs/about-questions/img.png)
找到 `下载`
点击 `游戏`
选择一个你喜欢的版本
__版本从上往下由高到低__
![](assets/img/docs/about-questions/img2.png)
然后点击 `安装` 即可
![](assets/img/docs/about-questions/img3.png)
## 关于游戏的游玩
__想必你注意到我了,记住上面讲的话__
等待游戏的下载过程中
或许可以了解一下游戏的游玩
简单的讲
就是用 `破坏``创造` 来进行游玩
详细请看 [wiki百科](https://minecraft.fandom.com/zh/wiki/%E6%95%99%E7%A8%8B/%E6%96%B0%E6%89%8B%E6%89%8B%E5%86%8C)
简单的讲,就是用 `破坏``创造` 来进行游玩
详细请看 [Minecraft Wiki](https://wiki.biligame.com/mc/%E6%95%99%E7%A8%8B/%E6%96%B0%E6%89%8B%E6%89%8B%E5%86%8C)
## 关于游戏的资源包
下载完了,也玩了会
总有人讲啥 “啥啥啥 `材质包` 很好看”
`材质包` 一般是单指修改了游戏材质的 `资源包` ,正式译名为 `纹理包`
`资源包` 可以做到很多的功能,甚至改变游戏的体验
大致示意图![](assets/img/docs/about-questions/img4.jpg)
资源包详细资料 [跳转](https://minecraft.fandom.com/zh/wiki/%E8%B5%84%E6%BA%90%E5%8C%85)
![大致示意图](assets/img/docs/about-questions/img4.jpg)
[资源包详细资料 ](https://wiki.biligame.com/mc/%E8%B5%84%E6%BA%90%E5%8C%85)
## 关于游戏的 Mods
mods 是基于 mod_loader 的一个从文件上更改游戏的内容的外置组件
你可以在这获得 __更多的游戏内容__、__更好的游戏体验__、__更好的游戏观感__ 等等
关于 Mods 的详细使用方法 [跳转](/launcher/auto-installing.html)
### 关于 Mods 的报错解决方法
在 [此文](/launcher/auto-installing.html) 末尾中的确讲到了一定的解决方法
但是我还是建议你看看更为详细的内容 [目前未写该教程,请等待]()
在 [此文](/launcher/auto-installing.html#%E5%AE%89%E8%A3%85-mod-%E5%90%8E%E6%B8%B8%E6%88%8F%E6%8A%A5%E9%94%99%E6%97%A0%E6%B3%95%E5%90%AF%E5%8A%A8) 末尾中的确讲到了一定的解决方法
但是还是建议看看更为详细的内容 [注:目前未写该教程,请等待]()
## 关于游戏的 Java 选择
这边你一般先使用默认的 Java
进阶一些的话,考虑 Java11+
进阶一些的话,考虑 Java17
选择其他方法:
> 先保证你有其他的Java
> 进入 设置-->全局游戏设置-->Java路径--->选择自定义并找到你需要的 jdk 的路径后确定
__如果出现任何的游戏崩溃问题请返回默认的 Java__

3
_docs/contribution.md

@ -8,5 +8,6 @@ toc: true
> 本文由 huanghongxun 编写。
如果你认为你有能力为 HMCL 添加高质量的帮助文档,或希望修改错误,你可以到 https://github.com/huanghongxun/HMCL-docs 仓库中发 Pull Request,或者提 Issue。
如果你认为你有能力为 HMCL 添加高质量的帮助文档,或希望修改错误,你可以到 [https://github.com/huanghongxun/HMCL-docs](https://github.com/huanghongxun/HMCL-docs) 仓库中发 Pull Request,或者提 Issue。
或者你可以进入我们的 [Discord](https://discord.gg/jVvC7HfM6U)、[开黑啦](https://kaihei.co/Kx7n3t)群以向 HMCL 反馈。

8
_launcher/authlib-injector.md

@ -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": [

57
_launcher/auto-installing.md

@ -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*
1.14 以下的版本推荐使用 *Forge*
*LiteLoader* 只适用于 1.12.2 及以前的版本 (目前已停更)
**注意: *LiteLoader**Forge* 是兼容的 ( *Forge* 较新版本和 *LiteLoader* 较老版本可能不兼容) , 但 *Fabric**Forge* 不兼容!**
**注意:
选择完合适的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* 和 *Quilt Mod* 的安装和 *Forge Mod* 的安装类似, [参照上文](#forge-mod)。
**注意:**
*Fabric Mod* 的安装和*Forge Mod*的安装类似, 参照上文。
- **几乎所有的 *Fabric Mod**Quilt Mod* 都需要 *Fabric API**QSL/QFAPI*。在安装 Mod 加载器时候如果没有选择, 请选择安装 *Fabric API**QSL/QFAPI* , 否则 *Fabric Mod**Quilt Mod* 则有可能无法被加载!**
**注意: 几乎所有的 *Fabric Mod* 都需要 *Fabric API* 。在安装 Mod 加载器时候如果没有选择, 请先安装 *Fabric API* (安装方法和普通 Mod 安装方法相同) , 否则 *Fabric 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 后游戏报错/无法启动
@ -67,4 +97,3 @@ HMCL 内置了 CurseForge 和 Modrinth 下载源的搜索和下载功能, 目前
3. 如果你的能力很优秀, 也可以直接查看游戏日志来找出问题的原因。
4. 如果无法理解日志内容, 那么请将 `\.minecraft\crash-reports``\.minecraft\logs` 文件夹打包发给其他人寻求帮助。

2
_launcher/datapack.md

@ -11,9 +11,11 @@ toc: true
本指南只介绍如何制作一个 HMCL 可导入的数据包压缩包。
## 建议
始终建议你使用多数据包格式制作数据包压缩包,因为 HMCL 会删除重名的数据包,因此可以借此完成更新功能,只要直接导入新的多数据包格式的压缩包就可以完成更新你制作的数据包。
## 多数据包
如果你的数据包被分离成多个部分供玩家选择是否启用,或者需要自带资源包,那么你需要制作多数据包格式的压缩包。
多数据包文件(只能是一个 `.zip` 文件)格式例子如下:

6
_launcher/global-version-isolation.md

@ -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)
善用该功能也可为你的磁盘剩下不少的空间

10
_launcher/install_optifine.md

@ -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)
**注意:光影对于电脑配置的要求比较高,如果开了光影之后出现游戏画面很卡的情况,请升级电脑配置、使用低配置光影或者关闭光影。**

22
_launcher/offline-skin.md

@ -69,25 +69,3 @@ 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>

15
_modpack/modpack-in-java.md

@ -5,7 +5,6 @@ date: 2021-10-09 23:18:02 +0800
categories: 整合包
toc: true
---
# 整合包自带 Java 教程
## 背景
@ -29,11 +28,11 @@ toc: true
首先我们假设整合包根文件夹是 `tutorial`(这个文件夹名字可以取别的),该文件夹内应该包含如下的文件:
![](assets/img/docs/modpack-in-java/2-1.png)
![](/assets/img/docs/modpack-in-java/2-1.png)
其中,`.minecraft` 是 Minecraft 文件夹,`jre-x64` 是你的 Java 运行时,我们分别来看看这两个文件夹的内容:
![](assets/img/docs/modpack-in-java/2-2.png)
![](/assets/img/docs/modpack-in-java/2-2.png)
上图是 `.minecraft` 文件夹的内容,里面包含着 `assets`、`libraries`、`versions` 等传统的文件夹。以及 `HMCL.jar`,这个文件是 HMCL 启动器的 `jar` 文件,可以在 https://hmcl.huangyuhui.net/download 里面下载 macOS 或者 Linux 版本(这两个版本的文件后缀名都是 `jar`,实际上是完全一样的东西,**也可以在 Windows 系统上双击运行**,没有平台限制)。
@ -41,7 +40,7 @@ toc: true
**注意:HMCL 本体文件 HMCL.jar 请务必保持该文件名,HMCL-3.2.117.jar 等带有版本号的文件名是不可以的**
![](assets/img/docs/modpack-in-java/2-3.png)
![](/assets/img/docs/modpack-in-java/2-3.png)
上图是 `jre-x64` 文件夹的内容,一看就是一个 JRE 的文件夹。
@ -49,21 +48,21 @@ toc: true
接下来我们创建一个快捷方式来使得 HMCL 通过 `jre-x64` 文件夹里的 Java 运行时启动,并使得 Minecraft 也通过该 Java 运行时启动。
![](assets/img/docs/modpack-in-java/2-4.png)
![](/assets/img/docs/modpack-in-java/2-4.png)
`tutorial` 文件夹内右击空白区域打开快捷菜单,创建快捷方式。
![](assets/img/docs/modpack-in-java/2-5.png)
![](/assets/img/docs/modpack-in-java/2-5.png)
在弹出的窗口中(如上图所示),在输入框内输入:`cmd /c start .\jre-x64\bin\javaw.exe -jar .\.minecraft\HMCL.jar`,其中 `jre-x64``.minecraft\HMCL.jar` 根据实际情况修改,`jre-x64` 是你的 Java 运行时的路径,`.minecraft\HMCL.jar` 是 HMCL 本体文件。
![](assets/img/docs/modpack-in-java/2-6.png)
![](/assets/img/docs/modpack-in-java/2-6.png)
接着给快捷方式取个名字就好了(如上图所示,`开始游戏` 是我取的名字)。
生成好快捷方式后我们还要编辑一下属性,右键 `开始游戏` 这个新创建的快捷方式(如果你取了别的名字请选中那个文件编辑其属性),在弹出的快捷菜单中选择属性,会打开快捷方式的属性窗口如下图所示:
![](assets/img/docs/modpack-in-java/2-7.png)
![](/assets/img/docs/modpack-in-java/2-7.png)
将起始位置内的文字删除干净,留空即可。保存退出该窗口。

7
_modpack/serverpack.md

@ -12,21 +12,22 @@ HMCL 允许服务器管理员借助服务端自动更新整合包来实现自动
HMCL 需要服务器管理员额外提供一个 HTTP 服务器(只需要能提供静态文件服务,比如 Apache 和 Nginx 皆可)来提供检查整合包更新并允许 HMCL 下载更新文件。
## 第一步:导出整合包
在 HMCL 中右键做好的客户端版本,选择导出整合包:
在 HMCL 中右键做好的客户端版本,选择`导出整合包`
![](/assets/img/docs/serverpack/1.png)
选择导出为服务器自动更新整合包:
选择导出为`服务器自动更新整合包`
![](/assets/img/docs/serverpack/1-1.png)
填写整合包信息,整合包下载链接前缀如何填写请看下文,你也可以先填别的(必须是个链接,比如 http://www.baidu.com),该项在整合包导出后可以修改
填写整合包信息,整合包下载链接前缀如何填写请看下文
![](/assets/img/docs/serverpack/1-2.png)
选择需要包含在整合包内的文件后将产生整合包压缩文件
## 第二步:导入整合包
接着创建一个全新的空文件夹,将启动器复制进去
![](/assets/img/docs/serverpack/1-3.png)

10
_modpack/serverpack2.md

@ -5,15 +5,13 @@ date: 2021-08-22 23:18:02 +0800
categories: 整合包
toc: true
---
# **使用HMCL启动器配置服务器客户端自动更新**
## 备注
- **文章原作者:[hy黑影](https://www.mcbbs.net/home.php?mod=space&uid=3051111)**
- **转载:Zkitfly**
- **部分内容进行了稍作打磨**
- **本教程转载至https://www.mcbbs.net/thread-1103864-1-1.html?action=printable**
- **标题: [综合]使用HMCL配置服务器客户端自动更新——再也不用担心玩家不会更新客户端了**
> 文章原作者:[hy黑影](https://www.mcbbs.net/home.php?mod=space&uid=3051111)
> 转载:Zkitfly
> 部分内容进行了稍作打磨
> 本教程转载至[https://www.mcbbs.net/thread-1103864-1-1.html?action=printable](https://www.mcbbs.net/thread-1103864-1-1.html?action=printable)
## **前言**

13
_multiplayer/multiplayer-feedback

@ -0,0 +1,13 @@
---
title: "目前 HMCL 多人联机正处于维护状态。"
permalink: /multiplayer/feedback.html
date: 2022-11-20 09:02:00 +0800
categories: 多人联机
toc: true
---
> 本文由 zkitefly 编写。
## 注意
目前 HMCL 多人联机正处于维护状态。[详情](https://hmcl.huangyuhui.net/api/redirect/multiplayer-migrate)

13
_multiplayer/multiplayer-help

@ -0,0 +1,13 @@
---
title: "目前 HMCL 多人联机正处于维护状态。"
permalink: /multiplayer/help.html
date: 2022-11-20 09:02:00 +0800
categories: 多人联机
toc: true
---
> 本文由 zkitefly 编写。
## 注意
目前 HMCL 多人联机正处于维护状态。[详情](https://hmcl.huangyuhui.net/api/redirect/multiplayer-migrate)

13
_multiplayer/multiplayer-token

@ -0,0 +1,13 @@
---
title: "目前 HMCL 多人联机正处于维护状态。"
permalink: /multiplayer/token.html
date: 2022-11-20 09:02:00 +0800
categories: 多人联机
toc: true
---
> 本文由 zkitefly 编写。
## 注意
目前 HMCL 多人联机正处于维护状态。[详情](https://hmcl.huangyuhui.net/api/redirect/multiplayer-migrate)

8
_multiplayer/multiplayer.md

@ -1,13 +1,13 @@
---
title: "多人联机帮助"
title: "目前 HMCL 多人联机正处于维护状态。"
permalink: /multiplayer/
date: 2021-11-11 19:33:00 +0800
date: 2022-11-20 09:02:00 +0800
categories: 多人联机
toc: true
---
> 本文由 bwtx1981 编写。
> 本文由 zkitfly 编写。
## 注意
目前 HMCL 多人联机正处于维护状态。请参阅: [**BakaXL / PCL2 / HMCL 对联机功能下一步发展的联合公告**](https://www.bilibili.com/read/cv19553778) 以获得详细信息。
目前 HMCL 多人联机正处于维护状态。[详情](https://hmcl.huangyuhui.net/api/redirect/multiplayer-migrate)

Loading…
Cancel
Save