mirror of
https://gitee.com/huanghongxun/HMCL-docs.git
synced 2026-09-15 08:31:11 +08:00
This commit is contained in:
@@ -0,0 +1,25 @@
|
||||
---
|
||||
title: "Authlib-Injector 服务器设置指南"
|
||||
permalink: /launcher/authlib-injector.html
|
||||
date: 2021-08-22 23:18:02 +0800
|
||||
categories: 启动器
|
||||
toc: true
|
||||
---
|
||||
|
||||
> 本文由 huanghongxun 编写。
|
||||
|
||||
## 背景
|
||||
使用 authlib-injector 认证的服主可以通过本教程提供的方法使 HMCL 默认在打开时弹窗要求创建对应认证服务器的账户。
|
||||
## 方法
|
||||
在 HMCL 启动器同级目录下创建 `authlib-injectors.json` 文件,此时文件夹目录结构如下图所示:
|
||||
|
||||

|
||||
|
||||
(注意,请确保打包后的整合包不包含 `hmcl.json` 文件,否则无法生效) `authlib-injectors.json` 文件的示例如下
|
||||
```
|
||||
{
|
||||
"urls": [
|
||||
"https://example.yggdrasil.yushi.moe/"
|
||||
]
|
||||
}
|
||||
```
|
||||
@@ -0,0 +1,70 @@
|
||||
---
|
||||
title: "自动安装与模组下载简介"
|
||||
permalink: /launcher/auto-installing.html
|
||||
date: 2021-10-09 23:18:02 +0800
|
||||
categories: 启动器
|
||||
toc: true
|
||||
---
|
||||
|
||||
> 本文由 asdqp233 编写。
|
||||
|
||||
## 安装Mod加载器
|
||||
|
||||
当你在安装新的游戏客户端时候,会看到其中有forge,liteloader,fabric这3个mod加载器可供选择。
|
||||
|
||||

|
||||
|
||||
当你使用1.14及以上的游戏版本时,推荐使用fabric,1.14以下的版本推荐使用forge。liteloader只适用1.12及以前的版本(目前已停更)。
|
||||
|
||||
**注意:*liteloader*和*forge*是兼容的(*Forge*较新版本和*LiteLoader*较老版本可能会出现不兼容),但*fabric*和*forge*不兼容!**
|
||||
|
||||
选择完合适的mod加载器之后就可以点击右下角的`安装`继续进行安装。
|
||||
|
||||
**注意:如果选择*fabric*,那么建议你同时选择*fabric api***
|
||||
|
||||
## 安装Mod
|
||||
|
||||
### 自动安装
|
||||
|
||||
#### Forge Mod
|
||||
|
||||
HMCL内置了Curseforge源和 Modrinth源的搜索和下载功能,目前已支持中文搜索(匹配结果不一定准确)。点开mod下载页面,最上方会显示当前mod需要的前置mod(如果有的话),以及mod支持的全部版本,请根据你当前安装的游戏版本选择恰当的版本。
|
||||
|
||||
**注意:请区分*Forge Mod* 和*Fabric Mod*,大部分mod在文件名中会注明,请不要选择错误,否则mod无法被正确加载。**
|
||||
|
||||

|
||||
|
||||
#### Fabric Mod
|
||||
|
||||
*Fabric Mod* 的安装和*Forge Mod*的安装类似,参照上文。
|
||||
|
||||
**注意:所有的*Fabric Mod*都需要*Fabric API*(前置mod)在安装Mod加载器时候如果没有选择,请先安装*Fabric API*(安装方法和普通mod安装方法相同),否则*Fabric Mod*无法被加载!**
|
||||
|
||||
#### LiteLoader Mod
|
||||
|
||||
*LiteLoader Mod*安装和*Forge Mod*的安装类似,参照上文。
|
||||
|
||||
**注意:LiteLoader 只能加载文件后缀为litemod的模组,Forge Mod修改后缀后LiteLoader无法检测。**
|
||||
|
||||
### 手动安装
|
||||
|
||||
一般的Mod文件后缀为`jar`或者`litemod`。
|
||||
|
||||
将这个jar文件复制到`\.minecraft\mods`文件夹中即可 (没有这个文件夹就自己新建一个)。如果开了版本隔离,那么文件夹是`\.minecraft\version\<客户端名称>/mods`。
|
||||
|
||||
或者在HMCL中`游戏管理页面—模组管理`页面点击添加模组或直接将文件拖入启动器窗口。
|
||||
|
||||

|
||||
|
||||
## 安装Mod后游戏报错/无法启动
|
||||
|
||||
造成游戏报错的原因有很多,比如mod之间不兼容,fabric api的版本过高,缺少前置mod等等。
|
||||
|
||||
1. 新版本的HMCL拥有错误分析功能,可以根据HMCL的提示来排查原因。
|
||||
|
||||
2. 也可以使用二分法来解决——每次加入/删除一半的mod,挨个排除,直到找到导致游戏报错的mod为止。
|
||||
|
||||
3. 如果你的能力很优秀,也可以直接查看游戏日志来找出问题的原因。
|
||||
|
||||
4. 如果无法理解日志内容,那么请将/.minecraft/crash-reports和/.minecraft/log文件夹打包发给其他人寻求帮助。
|
||||
|
||||
@@ -0,0 +1,58 @@
|
||||
---
|
||||
title: "数据包制作指南"
|
||||
permalink: /launcher/datapack.html
|
||||
date: 2021-08-22 23:18:02 +0800
|
||||
categories: 启动器
|
||||
toc: true
|
||||
---
|
||||
|
||||
> 本文由 huanghongxun 编写。
|
||||
|
||||
本指南只介绍如何制作一个 HMCL 可导入的数据包压缩包。
|
||||
|
||||
## 建议
|
||||
始终建议你使用多数据包格式制作数据包压缩包,因为 HMCL 会删除重名的数据包,因此可以借此完成更新功能,只要直接导入新的多数据包格式的压缩包就可以完成更新你制作的数据包。
|
||||
|
||||
## 多数据包
|
||||
如果你的数据包被分离成多个部分供玩家选择是否启用,或者需要自带资源包,那么你需要制作多数据包格式的压缩包。
|
||||
|
||||
多数据包文件(只能是一个 `.zip` 文件)格式例子如下:
|
||||
```
|
||||
crafting++.zip
|
||||
\
|
||||
* datapacks
|
||||
|\
|
||||
| * block_sky_domain (一个合法的数据包)
|
||||
| * crafting_machine
|
||||
| * craftingpp
|
||||
| * tradepp
|
||||
| * utilitypp
|
||||
|
|
||||
* resources.zip (如果你的数据包需要附带材质)
|
||||
\
|
||||
* assets
|
||||
\
|
||||
* ...
|
||||
```
|
||||
|
||||
其中,`datapacks` 下的文件格式和 `.minecraft/saves/New World/datapacks` 的一样,因此可直接手动打包你本地的 `datapacks` 文件夹,
|
||||
就可以直接导入 HMCL 了。如果还需要资源文件,请在压缩包内附带上。
|
||||
|
||||
此外,`resources.zip` 文件的格式和 `.minecraft/saves/New World/resources.zip` 的格式一样,
|
||||
导入数据包时,启动器将会合并世界附带的默认资源包和你的数据包附带的资源包,如果有重复的文件,旧的文件将被覆盖。
|
||||
如果你的服务器使用了包含资源包的数据包,那么请在服务器上完成这个操作,接着玩家下载服务器资源包即可。
|
||||
|
||||
## 单数据包
|
||||
如果你的数据包不需要资源文件,那么你直接打包 `datapacks/<你的数据包名称>` 文件夹,即可直接导入 HMCL。
|
||||
|
||||
单数据包文件(只能是一个 `.zip` 文件)格式例子如下:
|
||||
```
|
||||
RealisticGlassPane.zip
|
||||
\
|
||||
* pack.mcmeta
|
||||
* data
|
||||
\
|
||||
* 一些文件
|
||||
```
|
||||
|
||||
HMCL 将会将你打包好的数据包压缩包直接复制到 datapacks 文件夹,不会解压(因为原版游戏支持读取压缩包)。
|
||||
@@ -0,0 +1,43 @@
|
||||
---
|
||||
title: "全局版本隔离"
|
||||
permalink: /launcher/isolation.html
|
||||
date: 2021-10-09 23:18:02 +0800
|
||||
categories: 启动器
|
||||
toc: true
|
||||
---
|
||||
> 本文由 LIPiston 编写。
|
||||
|
||||
这是一个游戏客户端很多不方便寻找的最佳解决方案<br/>
|
||||
**注意:改方法会改变默认的 minecraft 文件结构**
|
||||
|
||||
## 使用方式
|
||||
进入 hmcl 的`设置`
|
||||

|
||||
在全局设置中找到 `版本隔离`
|
||||
改为 `各版本独立`
|
||||

|
||||
这时候 minecraft 的文件结构就会有所改变
|
||||
```
|
||||
.minecraft
|
||||
|*asstes
|
||||
|*libraries
|
||||
|*versions
|
||||
\1.16.5-optifine
|
||||
|1.16.5-optifine.jar
|
||||
|*saves
|
||||
|*resourcepacks
|
||||
|*logs
|
||||
|*mods
|
||||
|*config
|
||||
......
|
||||
```
|
||||
并非在 .minecraft 文件夹中存储一切的 mod 和 资源包**而是各版本的资源互相独立**
|
||||
|
||||
这样你就可以在一个目录下,安装多个客户端
|
||||
|
||||
## 往后的使用
|
||||
在做完版本隔离的设置后,hmcl 的快速打开各个游戏文件夹的功能就会显得十分重要。
|
||||

|
||||
|
||||
善用该功能也可为你的磁盘剩下不少的空间
|
||||
|
||||
@@ -0,0 +1,65 @@
|
||||
---
|
||||
title: "光影和Optifine"
|
||||
permalink: /launcher/optifine.html
|
||||
date: 2021-10-09 23:18:02 +0800
|
||||
categories: 启动器
|
||||
toc: true
|
||||
---
|
||||
# 光影和Optifine
|
||||
|
||||
## 安装Optifine
|
||||
|
||||
### 方式一:全新安装
|
||||
|
||||
当你在安装新的游戏客户端时候,会看到有个`Optifine`的选项。
|
||||
|
||||

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

|
||||
|
||||
选择完合适的版本之后就可以点击右下角的`安装`继续进行安装。
|
||||
|
||||
### 方式二:修改/升级已安装版本
|
||||
|
||||
在对应的游戏版本管理页面,点击`自动安装`,你会看到有个`Optifine`的选项。
|
||||
|
||||

|
||||
|
||||
点开之后选择合适的版本然后等待安装完成即可。
|
||||
目前,要在`Fabric`使用`Optifine`需要通过**方式四**安装。。
|
||||
|
||||
### 方式三:官网安装
|
||||
|
||||
在[Optifine官网](https://optifine.net/downloads)上下载合适版本的Optifine(下载完应为`OptiFine_<游戏版本>_<Optifine版本>.jar`)。
|
||||
|
||||
双击打开或者使用`java -jar 文件名` 的方式打开,然后你就会看到这个界面。
|
||||
|
||||

|
||||
|
||||
选择自己游戏的.minecraft目录(默认安装到`\AppData\Roaming\.minecraft`目录下),然后点击`Install`按钮,之后你在HMCL的版本列表中找到就含有Optifine名字的客户端启动即可。
|
||||
|
||||
如果提示未找到,请确认你是否已安装对应的版本的客户端,且**命名为对应版本号**的原本游戏客户端。
|
||||
|
||||
### 方式四:Optifine 与 Mod 加载器共存
|
||||
|
||||
从[Optifine官网](https://www.optifine.net/)上下载的jar文件本身也可作为Mod被加载,可以用 Java 运行下载的文件并导出 Mod 版本。Mod 安装具体方法见 [Mod安装教程](auto-installing.html)
|
||||
|
||||
注意:
|
||||
|
||||
1.Fabric和Optifine本身并不能共存,必须同时安装[Optifabric](https://www.curseforge.com/minecraft/mc-mods/optifabric)(一个Fabric Mod)。
|
||||
Optifabric 目前 1.17 仅支持`OptiFine HD U G9`、`Fabric` 最高支持的版本为`0.11.7` 。
|
||||
|
||||
2. Forge和Optifine会出现不兼容的情况,但大多数情况下,forge 和 optifine 是相互支持的(多半是后者修改后能兼容前者)。
|
||||
3. 若出现不兼容的情况,请使用[Optiforge](https://www.curseforge.com/minecraft/mc-mods/optiforge)(一个Forge Mod)解决。
|
||||
|
||||
## 安装光影包
|
||||
|
||||
一般光影是一个zip格式的文件,将光影文件放入`\.minecraft\shaders`文件夹中即可 (没有这个文件夹就自己新建一个)。如果开了版本隔离,那么文件夹是`\.minecraft\version\<客户端名称>/shaders`
|
||||
|
||||
如果你不知道版本隔离是啥,也不会创建文件夹,那么请打开游戏,依次点击`设置—视频设置—光影—光影包文件夹`,在里面放入光影包,然后点击你要加载的光影,最后点击`完成`即可
|
||||
|
||||

|
||||
|
||||
**注意:光影对于电脑配置的要求比较高,如果开了光影之后出现游戏画面很卡的情况,请升级电脑配置、使用低配置光影或者关闭光影。**
|
||||
@@ -0,0 +1,93 @@
|
||||
---
|
||||
title: "离线模式下更换皮肤"
|
||||
permalink: /launcher/offline-skin.html
|
||||
date: 2021-10-09 23:18:02 +0800
|
||||
categories: 启动器
|
||||
toc: true
|
||||
---
|
||||
|
||||
> 本文由 qiaoshouzi 主要编写 kitefly 修改
|
||||
|
||||
# 离线模式下更换皮肤
|
||||
**注意:**
|
||||
> 1. 本文档仅适用于**V3.4.205及以上版本**,不支持 **V3.3.188稳定版本**, 请在 启动器设置→启动器更新 或 设置→通用→启动器更新 中选择 **测试版** 并升级到**V3.4.205及以上版本** [HMCL下载页面](https://hmcl.huangyuhui.net/download/)
|
||||
> 2. 使用 默认、Steve、Alex、本地皮肤图片文件: 多人联机下其他玩家无法看到您的皮肤
|
||||
> 使用 LittleSkin、Blessing Skin 服务器: 多人联机下和您使用 **相同方式** 的玩家可以看到您的皮肤, 其他玩家不可以
|
||||
>
|
||||
> 3. 本文档在v3.4.208参考编写,有可能会的短时性的失效!
|
||||
|
||||
打开HMCL, 进入 **账号列表** , 点击下图离线账号的【上传皮肤】红框处:
|
||||
|
||||

|
||||
|
||||

|
||||
|
||||
> 默认: 使用默认随机的皮肤显示
|
||||
>
|
||||
> Steve: 使用Steve (史蒂夫) 皮肤显示
|
||||
>
|
||||
> Alex: 使用Alex (艾利克斯) 皮肤显示
|
||||
>
|
||||
> [本地皮肤图片文件](#本地皮肤图片文件)、[LittleSkin](#littleskin)、[Blessing Skin 服务器](#blessing-skin-服务器): 请见下文↓
|
||||
|
||||
## 本地皮肤图片文件
|
||||
|
||||
点击 **本地皮肤图片文件** , 设置 **皮肤/披风**皮肤图片 路径, 点击 **确认**, 即可
|
||||
|
||||

|
||||
|
||||
## LittleSkin
|
||||
|
||||
首先您需要一个LittleSkin的账号, [注册](https://mcskin.littleservice.cn/auth/register)并[登录](https://mcskin.littleservice.cn/auth/login)
|
||||
|
||||
然后前往 [角色管理](https://mcskin.littleservice.cn/user/player), 查看您的角色名, 如果没有, 请点击 **添加新角色** 进行添加
|
||||
|
||||
你可在 [我的衣柜](https://mcskin.littleservice.cn/user/closet) 修改此账户名的皮肤与披风
|
||||
|
||||

|
||||
|
||||
在HMCL中创建的离线账户的 账户名 **必须**和角色名相等, 如果不相等, 请 **重新在HMCL中创建离线账户**
|
||||
|
||||

|
||||
|
||||
确认相等后, 点击 **LittleSkin** 即可同步在LittleSkin上此账户名的皮肤
|
||||
|
||||

|
||||
|
||||
## Blessing Skin 服务器
|
||||
|
||||
**Blessing Skin 服务器, 进入 **角色管理** , 查看角色名 , 确认 **角色名** 和 **HMCL中创建的离线账号角色名** 相同, 如果不相等, **请重新在HMCL中创建离线账户**
|
||||
|
||||
你可在 我的衣柜 修改此账户名的皮肤与披风
|
||||
|
||||

|
||||
|
||||
进入 **配置生成**, 按下图找到 `CustomSkinLoader` 中的网址, 复制到HMCL中即可同步在Blessing Skin 服务器上此账户名的皮肤
|
||||
|
||||
> 注意: **V3.4.205**需把链接末尾的 / 去掉, 这个BUG已经在**V3.4.206**修复
|
||||
|
||||

|
||||
|
||||

|
||||
|
||||
## 以下内容为测试
|
||||
|
||||
<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>
|
||||
Reference in New Issue
Block a user