Skip to content

Commit ceeaf71

Browse files
nevelerneveler
authored
支持多语言
1 parent faa6570 commit ceeaf71

16 files changed

+1260
-0
lines changed

‎src/collections/_launcher/authlib-injector.en.md‎

Lines changed: 31 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,31 @@
1+
---
2+
title: Authlib-Injector Server Setup Guide
3+
description: How to configure the launcher to display the login page upon first opening after manually archiving a modpack
4+
date: 2021-08-22 23:18:02 +0800
5+
author: huanghongxun
6+
note: The document is written in Simplified Chinese!
7+
hits: true
8+
toc: true
9+
---
10+
11+
## 背景
12+
13+
使用 authlib-injector 认证的服主可以通过本教程提供的方法使 HMCL 默认在打开时弹窗要求创建对应认证服务器的账户。
14+
15+
## 方法
16+
17+
在 HMCL 启动器同级目录下创建 `authlib-injectors.json` 文件，此时文件夹目录结构如下图所示：
18+
19+
![]({{ '/assets/img/docs/authlib-injector/image.png' | relative_url }})
20+
21+
（注意，请确保打包后的整合包不包含 `hmcl.json` 文件，否则无法生效。该文件默认为隐藏状态，需开启隐藏文件显示）
22+
23+
`authlib-injectors.json` 文件的示例如下
24+
25+
```json
26+
{
27+
"urls": [
28+
"https://example.yggdrasil.yushi.moe/"
29+
]
30+
}
31+
```

‎src/collections/_launcher/authlib-injector.zh-TW.md‎

Lines changed: 31 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,31 @@
1+
---
2+
title: Authlib-Injector 伺服器設定指南
3+
description: 手動打包模組包後，初次打開啟動器時直接彈出對應的帳戶登入頁
4+
date: 2021-08-22 23:18:02 +0800
5+
author: huanghongxun
6+
note: 本文件以簡體中文撰冩！
7+
hits: true
8+
toc: true
9+
---
10+
11+
## 背景
12+
13+
使用 authlib-injector 认证的服主可以通过本教程提供的方法使 HMCL 默认在打开时弹窗要求创建对应认证服务器的账户。
14+
15+
## 方法
16+
17+
在 HMCL 启动器同级目录下创建 `authlib-injectors.json` 文件，此时文件夹目录结构如下图所示：
18+
19+
![]({{ '/assets/img/docs/authlib-injector/image.png' | relative_url }})
20+
21+
（注意，请确保打包后的整合包不包含 `hmcl.json` 文件，否则无法生效。该文件默认为隐藏状态，需开启隐藏文件显示）
22+
23+
`authlib-injectors.json` 文件的示例如下
24+
25+
```json
26+
{
27+
"urls": [
28+
"https://example.yggdrasil.yushi.moe/"
29+
]
30+
}
31+
```

‎src/collections/_launcher/auto-installing.en.md‎

Lines changed: 99 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,99 @@
1+
---
2+
title: Automatic Installation and Mod Downloads
3+
description: Tutorials for installing Forge, LiteLoader, Fabric, and installing mods
4+
date: 2021-10-09 23:18:02 +0800
5+
author: asdqp233
6+
note: The document is written in Simplified Chinese!
7+
hits: true
8+
toc: true
9+
---
10+
11+
## 安装 Mod 加载器
12+
13+
当你在安装新的游戏客户端时候, 会看到其中有
14+
15+
`Forge, LiteLoader, Fabric, Quilt` 这 4 个 Mod 加载器可供选择。
16+
17+
以及 `Fabric API, QSL/QFAPI` 这两个随 Fabric 与 Quilt 的 API（实际是模组）可供选择。
18+
19+
![AutoInstaller_ModLoader]({{ '/assets/img/docs/auto-installing/AutoInstaller_ModLoader.png' | relative_url }})
20+
21+
当你使用 1.14 及以上的游戏版本时, 推荐使用 *Fabric*
22+
23+
1.14 以下的版本推荐使用 *Forge*
24+
25+
*LiteLoader* 只适用于 1.12.2 及以前的版本 (目前已停更)
26+
27+
**注意：**
28+
29+
选择完合适的Mod加载器之后就可以点击右下角的`安装`继续进行安装。
30+
31+
**注意：**
32+
33+
***LiteLoader* 和 *Forge* 是兼容的 (*Forge* 较新版本和 *LiteLoader* 较老版本可能不兼容)**
34+
35+
***Fabric* 和 *Forge* 不兼容!**
36+
37+
**如果选择 *Fabric* , 那么建议同时选择 *Fabric API***
38+
39+
**如果选择 *Quilt* ，那么建议同时选择 *QSL/QFAPI***
40+
41+
## 安装 Mod
42+
43+
### 自动安装
44+
45+
#### Forge Mod
46+
47+
HMCL 内置了 CurseForge 和 Modrinth 下载源的搜索和下载功能, 目前已支持中文搜索 (匹配结果不一定准确) 。
48+
49+
点开 Mod 下载页面, 最上方会显示当前 Mod 需要的前置 Mod (如果有) , 以及 Mod 支持的全部版本, 请根据你当前安装的游戏版本选择恰当的版本。
50+
51+
**注意: 请区分 *Forge Mod* 和 *Fabric Mod* , 大部分 Mod 在文件名中会注明, 请不要选择错误, 否则 Mod 将无法被正确加载。**
52+
53+
**建议点击上方的蓝色的 模组详情链接 查看模组的信息，这有可能会提示你些什么注意事项**
54+
55+
![AddingModAutomatically]({{ '/assets/img/docs/auto-installing/AutoInstaller_ModAutoAdding.png' | relative_url }})
56+
57+
#### Fabric Mod / Quilt Mod
58+
59+
*Fabric Mod* 和 *Quilt Mod* 的安装和 *Forge Mod* 的安装类似, [参照上文](#forge-mod)。
60+
61+
**注意：**
62+
63+
- **几乎所有的 *Fabric Mod* 或 *Quilt Mod* 都需要 *Fabric API* 或 *QSL/QFAPI*。在安装 Mod 加载器时候如果没有选择, 请选择安装 *Fabric API* 或 *QSL/QFAPI* , 否则 *Fabric Mod* 或 *Quilt Mod* 则有可能无法被加载!**
64+
65+
- ***Fabric* 对应 *Fabric API* ，*Quilt Mod* 对应 *QSL/QFAPI* ，请不要搞错。**
66+
67+
#### LiteLoader Mod
68+
69+
*LiteLoader Mod* 安装和 *Forge Mod* 的安装类似, [参照上文](#forge-mod)。
70+
71+
**注意: LiteLoader 只能加载文件后缀为 litemod 的模组, *Forge Mod*、*Fabric Mod* 和 *Quilt Mod*等修改后缀的方法 LiteLoader 是无法检测。**
72+
73+
#### OptiFine
74+
75+
[详情请查阅此]({{ '/launcher/shader.html' | relative_url }})
76+
77+
### 手动安装
78+
79+
一般的 Mod 文件后缀为 `jar` 或者 `litemod` 。
80+
81+
将这个 jar 文件复制到 `\.minecraft\Mods` 文件夹中即可 (没有这个文件夹就自己新建一个) 。
82+
83+
若开启了版本隔离, 那么文件夹是`\.minecraft\version\<版本名称>\Mods`。
84+
85+
或者在 HMCL 的 `游戏管理页面—模组管理` 页面点击添加模组或直接将文件拖入启动器窗口。
86+
87+
![AddingModManually]({{ '/assets/img/docs/auto-installing/AutoInstaller_ModManualAdding.png' | relative_url }})
88+
89+
## 安装 Mod 后游戏报错/无法启动
90+
91+
造成游戏报错的原因有很多, 比如 Mod 之间不兼容, Fabric API 的版本过高, 缺少前置 Mod 等等。
92+
93+
1. 新版本的 HMCL 拥有错误分析功能, 可以根据HMCL的提示来排查原因。
94+
95+
2. 也可以使用二分法来解决——每次加入 / 删除一半的 Mod , 挨个排除, 直到找到导致游戏报错的 Mod 为止。
96+
97+
3. 如果你的能力很优秀, 也可以直接查看游戏日志来找出问题的原因。
98+
99+
4. 如果无法理解日志内容, 那么请将 `\.minecraft\crash-reports` 和 `\.minecraft\logs` 文件夹打包发给其他人寻求帮助。

‎src/collections/_launcher/auto-installing.zh-TW.md‎

Lines changed: 99 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,99 @@
1+
---
2+
title: 自動安裝與模組下載
3+
description: 安裝 Forge、LiteLoader、Fabric 及安裝模組的教學
4+
date: 2021-10-09 23:18:02 +0800
5+
author: asdqp233
6+
note: 本文件以簡體中文撰冩！
7+
hits: true
8+
toc: true
9+
---
10+
11+
## 安装 Mod 加载器
12+
13+
当你在安装新的游戏客户端时候, 会看到其中有
14+
15+
`Forge, LiteLoader, Fabric, Quilt` 这 4 个 Mod 加载器可供选择。
16+
17+
以及 `Fabric API, QSL/QFAPI` 这两个随 Fabric 与 Quilt 的 API（实际是模组）可供选择。
18+
19+
![AutoInstaller_ModLoader]({{ '/assets/img/docs/auto-installing/AutoInstaller_ModLoader.png' | relative_url }})
20+
21+
当你使用 1.14 及以上的游戏版本时, 推荐使用 *Fabric*
22+
23+
1.14 以下的版本推荐使用 *Forge*
24+
25+
*LiteLoader* 只适用于 1.12.2 及以前的版本 (目前已停更)
26+
27+
**注意：**
28+
29+
选择完合适的Mod加载器之后就可以点击右下角的`安装`继续进行安装。
30+
31+
**注意：**
32+
33+
***LiteLoader* 和 *Forge* 是兼容的 (*Forge* 较新版本和 *LiteLoader* 较老版本可能不兼容)**
34+
35+
***Fabric* 和 *Forge* 不兼容!**
36+
37+
**如果选择 *Fabric* , 那么建议同时选择 *Fabric API***
38+
39+
**如果选择 *Quilt* ，那么建议同时选择 *QSL/QFAPI***
40+
41+
## 安装 Mod
42+
43+
### 自动安装
44+
45+
#### Forge Mod
46+
47+
HMCL 内置了 CurseForge 和 Modrinth 下载源的搜索和下载功能, 目前已支持中文搜索 (匹配结果不一定准确) 。
48+
49+
点开 Mod 下载页面, 最上方会显示当前 Mod 需要的前置 Mod (如果有) , 以及 Mod 支持的全部版本, 请根据你当前安装的游戏版本选择恰当的版本。
50+
51+
**注意: 请区分 *Forge Mod* 和 *Fabric Mod* , 大部分 Mod 在文件名中会注明, 请不要选择错误, 否则 Mod 将无法被正确加载。**
52+
53+
**建议点击上方的蓝色的 模组详情链接 查看模组的信息，这有可能会提示你些什么注意事项**
54+
55+
![AddingModAutomatically]({{ '/assets/img/docs/auto-installing/AutoInstaller_ModAutoAdding.png' | relative_url }})
56+
57+
#### Fabric Mod / Quilt Mod
58+
59+
*Fabric Mod* 和 *Quilt Mod* 的安装和 *Forge Mod* 的安装类似, [参照上文](#forge-mod)。
60+
61+
**注意：**
62+
63+
- **几乎所有的 *Fabric Mod* 或 *Quilt Mod* 都需要 *Fabric API* 或 *QSL/QFAPI*。在安装 Mod 加载器时候如果没有选择, 请选择安装 *Fabric API* 或 *QSL/QFAPI* , 否则 *Fabric Mod* 或 *Quilt Mod* 则有可能无法被加载!**
64+
65+
- ***Fabric* 对应 *Fabric API* ，*Quilt Mod* 对应 *QSL/QFAPI* ，请不要搞错。**
66+
67+
#### LiteLoader Mod
68+
69+
*LiteLoader Mod* 安装和 *Forge Mod* 的安装类似, [参照上文](#forge-mod)。
70+
71+
**注意: LiteLoader 只能加载文件后缀为 litemod 的模组, *Forge Mod*、*Fabric Mod* 和 *Quilt Mod*等修改后缀的方法 LiteLoader 是无法检测。**
72+
73+
#### OptiFine
74+
75+
[详情请查阅此]({{ '/launcher/shader.html' | relative_url }})
76+
77+
### 手动安装
78+
79+
一般的 Mod 文件后缀为 `jar` 或者 `litemod` 。
80+
81+
将这个 jar 文件复制到 `\.minecraft\Mods` 文件夹中即可 (没有这个文件夹就自己新建一个) 。
82+
83+
若开启了版本隔离, 那么文件夹是`\.minecraft\version\<版本名称>\Mods`。
84+
85+
或者在 HMCL 的 `游戏管理页面—模组管理` 页面点击添加模组或直接将文件拖入启动器窗口。
86+
87+
![AddingModManually]({{ '/assets/img/docs/auto-installing/AutoInstaller_ModManualAdding.png' | relative_url }})
88+
89+
## 安装 Mod 后游戏报错/无法启动
90+
91+
造成游戏报错的原因有很多, 比如 Mod 之间不兼容, Fabric API 的版本过高, 缺少前置 Mod 等等。
92+
93+
1. 新版本的 HMCL 拥有错误分析功能, 可以根据HMCL的提示来排查原因。
94+
95+
2. 也可以使用二分法来解决——每次加入 / 删除一半的 Mod , 挨个排除, 直到找到导致游戏报错的 Mod 为止。
96+
97+
3. 如果你的能力很优秀, 也可以直接查看游戏日志来找出问题的原因。
98+
99+
4. 如果无法理解日志内容, 那么请将 `\.minecraft\crash-reports` 和 `\.minecraft\logs` 文件夹打包发给其他人寻求帮助。

‎src/collections/_launcher/datapack.en.md‎

Lines changed: 60 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,60 @@
1+
---
2+
title: Datapack Creation Guide
3+
description: How to create datapacks that can be imported by HMCL
4+
date: 2021-08-22 23:18:02 +0800
5+
author: huanghongxun
6+
note: The document is written in Simplified Chinese!
7+
hits: true
8+
toc: true
9+
---
10+
11+
本指南只介绍如何制作一个 HMCL 可导入的数据包压缩包。
12+
13+
## 建议
14+
15+
始终建议你使用多数据包格式制作数据包压缩包，因为 HMCL 会删除重名的数据包，因此可以借此完成更新功能，只要直接导入新的多数据包格式的压缩包就可以完成更新你制作的数据包。
16+
17+
## 多数据包
18+
19+
如果你的数据包被分离成多个部分供玩家选择是否启用，或者需要自带资源包，那么你需要制作多数据包格式的压缩包。
20+
21+
多数据包文件（只能是一个 `.zip` 文件）格式例子如下：
22+
```
23+
crafting++.zip
24+
\
25+
* datapacks
26+
|\
27+
| * block_sky_domain (一个合法的数据包)
28+
| * crafting_machine
29+
| * craftingpp
30+
| * tradepp
31+
| * utilitypp
32+
|
33+
* resources.zip (如果你的数据包需要附带材质)
34+
\
35+
* assets
36+
\
37+
* ...
38+
```
39+
40+
其中，`datapacks` 下的文件格式和 `.minecraft/saves/New World/datapacks` 的一样，因此可直接手动打包你本地的 `datapacks` 文件夹，
41+
就可以直接导入 HMCL 了。如果还需要资源文件，请在压缩包内附带上。
42+
43+
此外，`resources.zip` 文件的格式和 `.minecraft/saves/New World/resources.zip` 的格式一样，
44+
导入数据包时，启动器将会合并世界附带的默认资源包和你的数据包附带的资源包，如果有重复的文件，旧的文件将被覆盖。
45+
如果你的服务器使用了包含资源包的数据包，那么请在服务器上完成这个操作，接着玩家下载服务器资源包即可。
46+
47+
## 单数据包
48+
如果你的数据包不需要资源文件，那么你直接打包 `datapacks/<你的数据包名称>` 文件夹，即可直接导入 HMCL。
49+
50+
单数据包文件（只能是一个 `.zip` 文件）格式例子如下：
51+
```
52+
RealisticGlassPane.zip
53+
\
54+
* pack.mcmeta
55+
* data
56+
\
57+
* 一些文件
58+
```
59+
60+
HMCL 将会将你打包好的数据包压缩包直接复制到 datapacks 文件夹，不会解压（因为原版游戏支持读取压缩包）。

‎src/collections/_launcher/datapack.zh-TW.md‎

Lines changed: 60 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,60 @@
1+
---
2+
title: 資料包製作指南
3+
description: 製作可以由 HMCL 匯入的資料包
4+
date: 2021-08-22 23:18:02 +0800
5+
author: huanghongxun
6+
note: 本文件以簡體中文撰冩！
7+
hits: true
8+
toc: true
9+
---
10+
11+
本指南只介绍如何制作一个 HMCL 可导入的数据包压缩包。
12+
13+
## 建议
14+
15+
始终建议你使用多数据包格式制作数据包压缩包，因为 HMCL 会删除重名的数据包，因此可以借此完成更新功能，只要直接导入新的多数据包格式的压缩包就可以完成更新你制作的数据包。
16+
17+
## 多数据包
18+
19+
如果你的数据包被分离成多个部分供玩家选择是否启用，或者需要自带资源包，那么你需要制作多数据包格式的压缩包。
20+
21+
多数据包文件（只能是一个 `.zip` 文件）格式例子如下：
22+
```
23+
crafting++.zip
24+
\
25+
* datapacks
26+
|\
27+
| * block_sky_domain (一个合法的数据包)
28+
| * crafting_machine
29+
| * craftingpp
30+
| * tradepp
31+
| * utilitypp
32+
|
33+
* resources.zip (如果你的数据包需要附带材质)
34+
\
35+
* assets
36+
\
37+
* ...
38+
```
39+
40+
其中，`datapacks` 下的文件格式和 `.minecraft/saves/New World/datapacks` 的一样，因此可直接手动打包你本地的 `datapacks` 文件夹，
41+
就可以直接导入 HMCL 了。如果还需要资源文件，请在压缩包内附带上。
42+
43+
此外，`resources.zip` 文件的格式和 `.minecraft/saves/New World/resources.zip` 的格式一样，
44+
导入数据包时，启动器将会合并世界附带的默认资源包和你的数据包附带的资源包，如果有重复的文件，旧的文件将被覆盖。
45+
如果你的服务器使用了包含资源包的数据包，那么请在服务器上完成这个操作，接着玩家下载服务器资源包即可。
46+
47+
## 单数据包
48+
如果你的数据包不需要资源文件，那么你直接打包 `datapacks/<你的数据包名称>` 文件夹，即可直接导入 HMCL。
49+
50+
单数据包文件（只能是一个 `.zip` 文件）格式例子如下：
51+
```
52+
RealisticGlassPane.zip
53+
\
54+
* pack.mcmeta
55+
* data
56+
\
57+
* 一些文件
58+
```
59+
60+
HMCL 将会将你打包好的数据包压缩包直接复制到 datapacks 文件夹，不会解压（因为原版游戏支持读取压缩包）。

0 commit comments

Comments
 (0)