diff --git a/Multiplayer/Help/HMCL联机(.md).zip b/Multiplayer/Help/HMCL联机(.md).zip deleted file mode 100644 index 95c6f18..0000000 Binary files a/Multiplayer/Help/HMCL联机(.md).zip and /dev/null differ diff --git a/Multiplayer/Help/OWNERS b/Multiplayer/Help/OWNERS deleted file mode 100644 index f18ff13..0000000 --- a/Multiplayer/Help/OWNERS +++ /dev/null @@ -1 +0,0 @@ -wifi-left \ No newline at end of file diff --git a/Multiplayer/OWNERS b/Multiplayer/OWNERS deleted file mode 100644 index f18ff13..0000000 --- a/Multiplayer/OWNERS +++ /dev/null @@ -1 +0,0 @@ -wifi-left \ No newline at end of file diff --git a/README.md b/README.md index b88fc17..55477cb 100644 --- a/README.md +++ b/README.md @@ -12,45 +12,29 @@ Hello Minecraft! Launcher 帮助文档仓库 ## 贡献 本仓库组织方式为一篇文章放在一个目录中。如果你要提交 PR,请不要将 md 文件直接放在根目录下。 -每篇文章的文件夹结构如下: +每篇文章结构如下: ``` -文件夹
- *
.md - * img1.png - * img2.png - * ... - * OWNERS +
.md + +assets + * img + * docs + *
+ * img1.png + * img2.png + * ... ``` -其中,`
` 表示你的文章的英文名,请仅使用英文字母、数字、中划线、下划线字符,不要使用空格、中文字符。请确保 md 文件名和文件夹名一致。具体可以参考已有文章目录格式。 +其中,`
` 表示你的文章的英文名(尖括号表示占位符,请替换为文章名称,不要直接提交 '`
`'),请仅使用英文字母、数字、中划线、下划线字符,不要使用空格、中文字符。请确保 md 文件名和文件夹名一致。具体可以参考已有文章目录格式。 -每篇文章由 Markdown 编写的 `
.md` 文件及附带图片组成。此外你还需要在文章目录中添加 OWNERS 文件,以标记该文章由哪些人编写或编辑过。 +每篇文章由 Markdown 编写的 `
.md` 文件及附带图片组成。文章的图片请放置到 `/assets/img/docs/
` 目录中。 ### 添加新文章 -添加新文章时,请确保你的 PR 仅在根文件夹下创建一个全新的文章目录,并将内容按照上述格式要求存放。你也可以参考已经写好的文章格式。 +添加新文章时,请确保将内容按照上述格式要求存放。你也可以参考已经写好的文章格式。 切记不要在一个添加新文章的 PR 里修改其他文章的内容。 ### 修改已有文章 -修改已有文章时,请确保你的 PR 仅修改一个文章内容,并在该文章的 OWNERS 里署名。 - -### 文章分类 - -如果你要提交的文章可以被囊括为一个分类,我们推荐你对文章进行分类。 - -目录分类的格式为: -``` -文件夹 - * 文件夹 - * .md - * OWNERS - * 文件夹 - * .md - * OWNERS - * .md - * OWNERS -``` - -具体你可以参考 multiplayer 分类。 +修改已有文章时,请确保你的 PR 仅修改一个文章内容,并在该文章里署名。 diff --git a/assets/img/docs/authlib-injector/image.png b/assets/img/docs/authlib-injector/image.png new file mode 100644 index 0000000..654a69e Binary files /dev/null and b/assets/img/docs/authlib-injector/image.png differ diff --git a/mod/mod_install.png b/assets/img/docs/auto-installing/mod_install.png similarity index 100% rename from mod/mod_install.png rename to assets/img/docs/auto-installing/mod_install.png diff --git a/mod/mod_loader.png b/assets/img/docs/auto-installing/mod_loader.png similarity index 100% rename from mod/mod_loader.png rename to assets/img/docs/auto-installing/mod_loader.png diff --git a/Multiplayer/Help/In-game.png b/assets/img/docs/multiplayer/help/In-game.png similarity index 100% rename from Multiplayer/Help/In-game.png rename to assets/img/docs/multiplayer/help/In-game.png diff --git a/Multiplayer/Help/create-room.png b/assets/img/docs/multiplayer/help/create-room.png similarity index 100% rename from Multiplayer/Help/create-room.png rename to assets/img/docs/multiplayer/help/create-room.png diff --git a/Multiplayer/Help/img1.png b/assets/img/docs/multiplayer/help/img1.png similarity index 100% rename from Multiplayer/Help/img1.png rename to assets/img/docs/multiplayer/help/img1.png diff --git a/Multiplayer/Help/join.png b/assets/img/docs/multiplayer/help/join.png similarity index 100% rename from Multiplayer/Help/join.png rename to assets/img/docs/multiplayer/help/join.png diff --git a/Multiplayer/Help/mainpage.png b/assets/img/docs/multiplayer/help/mainpage.png similarity index 100% rename from Multiplayer/Help/mainpage.png rename to assets/img/docs/multiplayer/help/mainpage.png diff --git a/assets/img/docs/serverpack/1-1.png b/assets/img/docs/serverpack/1-1.png new file mode 100644 index 0000000..2ee5528 Binary files /dev/null and b/assets/img/docs/serverpack/1-1.png differ diff --git a/assets/img/docs/serverpack/1-2.png b/assets/img/docs/serverpack/1-2.png new file mode 100644 index 0000000..9ec7d5e Binary files /dev/null and b/assets/img/docs/serverpack/1-2.png differ diff --git a/assets/img/docs/serverpack/1-3.png b/assets/img/docs/serverpack/1-3.png new file mode 100644 index 0000000..eccbfe7 Binary files /dev/null and b/assets/img/docs/serverpack/1-3.png differ diff --git a/assets/img/docs/serverpack/1-4.png b/assets/img/docs/serverpack/1-4.png new file mode 100644 index 0000000..8df31c2 Binary files /dev/null and b/assets/img/docs/serverpack/1-4.png differ diff --git a/assets/img/docs/serverpack/1-6.png b/assets/img/docs/serverpack/1-6.png new file mode 100644 index 0000000..974794c Binary files /dev/null and b/assets/img/docs/serverpack/1-6.png differ diff --git a/assets/img/docs/serverpack/1.png b/assets/img/docs/serverpack/1.png new file mode 100644 index 0000000..abb13af Binary files /dev/null and b/assets/img/docs/serverpack/1.png differ diff --git a/authlib-injector.md b/authlib-injector.md new file mode 100644 index 0000000..ac73f50 --- /dev/null +++ b/authlib-injector.md @@ -0,0 +1,25 @@ +--- +title: "Authlib-Injector 服务器设置指南" +permalink: /help/launcher/authlib-injector.html +date: 2021-08-22 23:18:02 +0800 +categories: HMCL +toc: true +--- + +> 本文由 huanghongxun 编写。 + +## 背景 +使用 authlib-injector 认证的服主可以通过本教程提供的方法使 HMCL 默认在打开时弹窗要求创建对应认证服务器的账户。 +## 方法 +在 HMCL 启动器同级目录下创建 `authlib-injectors.json` 文件,此时文件夹目录结构如下图所示: + +![](/assets/img/docs/authlib-injector/image.png) + +(注意,请确保打包后的整合包不包含 `hmcl.json` 文件,否则无法生效) `authlib-injectors.json` 文件的示例如下 +``` +{ + "urls": [ + "https://example.yggdrasil.yushi.moe/" + ] +} +``` diff --git a/mod/mod.md b/auto-installing.md similarity index 70% rename from mod/mod.md rename to auto-installing.md index b91bda6..b631ada 100644 --- a/mod/mod.md +++ b/auto-installing.md @@ -1,10 +1,18 @@ -# MOD +--- +title: "自动安装与模组下载简介" +permalink: /help/launcher/auto-installing.html +date: 2021-10-09 23:18:02 +0800 +categories: HMCL +toc: true +--- + +> 本文由 asdqp233 编写。 ## 安装Mod加载器 当你在安装新的游戏客户端时候,会看到其中有forge,liteloader,fabric这3个mod加载器可供选择。 -![mod_loader](C:\Users\Administrator\Desktop\mod_loader.png) +![mod_loader](/assets/img/docs/auto-installing/mod_loader.png) 当你使用1.14及以上的游戏版本时,推荐使用fabric,1.14以下的版本推荐使用forge。liteloader只适用1.12及以前的版本(目前已停更)。 @@ -22,7 +30,7 @@ HMCL内置了Curseforge源和 Modrinth源的搜索和下载功能,目前已支 **注意:请区分*Forge Mod* 和*Fabric Mod*,大部分mod在文件名中会注明,请不要选择错误,否则mod无法被正确加载。** -![mod_install](C:\Users\Administrator\Desktop\mod_install.png) +![mod_install](/assets/img/docs/auto-installing/mod_install.png) ### Fabric Mod @@ -40,10 +48,10 @@ HMCL内置了Curseforge源和 Modrinth源的搜索和下载功能,目前已支 造成游戏报错的原因有很多,比如mod之间不兼容,fabric api的版本过高,缺少前置mod等等。 -Ⅰ.新版本的HMCL拥有错误分析功能,可以根据HMCL的提示来排查原因。 +1. 新版本的HMCL拥有错误分析功能,可以根据HMCL的提示来排查原因。 -Ⅱ.也可以使用二分法来解决——每次加入/删除一半的mod,挨个排除,直到找到导致游戏报错的mod为止。 +2. 也可以使用二分法来解决——每次加入/删除一半的mod,挨个排除,直到找到导致游戏报错的mod为止。 -Ⅲ.如果你的能力很优秀,也可以直接查看游戏日志来找出问题的原因。 +3. 如果你的能力很优秀,也可以直接查看游戏日志来找出问题的原因。 -Ⅳ.如果无法理解日志内容,那么请将/.minecraft/crash-reports和/.minecraft/log文件夹打包发给其他人寻求帮助。 +4. 如果无法理解日志内容,那么请将/.minecraft/crash-reports和/.minecraft/log文件夹打包发给其他人寻求帮助。 diff --git a/datapack.md b/datapack.md new file mode 100644 index 0000000..6313177 --- /dev/null +++ b/datapack.md @@ -0,0 +1,58 @@ +--- +title: "数据包制作指南" +permalink: /help/launcher/datapack.html +date: 2021-08-22 23:18:02 +0800 +categories: HMCL +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 文件夹,不会解压(因为原版游戏支持读取压缩包)。 \ No newline at end of file diff --git a/mod/OWNERS b/mod/OWNERS deleted file mode 100644 index 52f50cf..0000000 --- a/mod/OWNERS +++ /dev/null @@ -1 +0,0 @@ -asdqp233 \ No newline at end of file diff --git a/Multiplayer/Help/multiplayer-help.md b/multiplayer-help.md similarity index 92% rename from Multiplayer/Help/multiplayer-help.md rename to multiplayer-help.md index f2a6269..e2c707d 100644 --- a/Multiplayer/Help/multiplayer-help.md +++ b/multiplayer-help.md @@ -1,4 +1,12 @@ -# HMCL 联机教程 v1.0 +--- +title: "多人联机教程" +permalink: /help/launcher/multiplayer/help.html +date: 2021-10-09 23:18:02 +0800 +categories: HMCL +toc: true +--- + +> 本文由 wifi-left 编写。 ## 注意 @@ -16,7 +24,7 @@ HMCL 联机模块使用了第三方软件 [Cato](https://noin.cn/71.html),所 左键此处,您将会打开联机页面。 -![多人联机界面](F:\Website-Wiki\pages\HMCL\img1.png) +![多人联机界面](/assets/img/docs/multiplayer/help/img1.png) @@ -66,13 +74,13 @@ HMCL 此时不会关闭界面。 设置好所有内容后,点击确认按钮后,将会出现对局域网开放成功的信息。(如下图红色边框内的信息) -![游戏地图创建局域网成功画面](F:\Website-Wiki\pages\HMCL\In-game.png) +![游戏地图创建局域网成功画面](/assets/img/docs/multiplayer/help/In-game.png) 此时,请回到 HMCL 多人联机界面。点击 `创建房间` ,您将看到您的局域网游戏已经被正确识别。 单击确认按钮,即可创建房间。 -![create-room](create-room.png) +![create-room](/assets/img/docs/multiplayer/help/create-room.png) 创建完毕后,点击 `复制邀请码` ,将邀请码复制到您的粘贴板内。 diff --git a/Multiplayer/multiplayer.md b/multiplayer.md similarity index 73% rename from Multiplayer/multiplayer.md rename to multiplayer.md index 0a6c1b9..643f4d5 100644 --- a/Multiplayer/multiplayer.md +++ b/multiplayer.md @@ -1,4 +1,12 @@ -# HMCL 联机帮助 +--- +title: "多人联机帮助" +permalink: /help/launcher/multiplayer/ +date: 2021-10-09 23:18:02 +0800 +categories: HMCL +toc: true +--- + +> 本文由 wifi-left 编写。 ## 注意 @@ -12,5 +20,5 @@ HMCL 联机模块使用了第三方软件 [Cato](https://noin.cn/71.html),所 ## 索引 -[HMCL 联机教程](./Help/Multi_Help.md) +[HMCL 联机教程](help.html) diff --git a/serverpack.md b/serverpack.md new file mode 100644 index 0000000..7484d5c --- /dev/null +++ b/serverpack.md @@ -0,0 +1,49 @@ +--- +title: "服务端自动更新整合包制作教程" +permalink: /help/launcher/serverpack.html +date: 2021-08-22 23:18:02 +0800 +categories: HMCL +toc: true +--- + +> 本文由 huanghongxun 编写。 + +HMCL 允许服务器管理员借助服务端自动更新整合包来实现自动分发整合包更新,这将大大方便有需要频繁更新游戏客户端 Mod、配置等信息的服务器管理员。 +HMCL 需要服务器管理员额外提供一个 HTTP 服务器(只需要能提供静态文件服务,比如 Apache 和 Nginx 皆可)来提供检查整合包更新并允许 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) + +运行启动器,并导入刚才导出的整合包,导入完成后,这个文件夹(这里叫“新整合包”)可以打包发给玩家。 + +## 第三步,部署整合包更新服务器 +你可以借助 Apache、Nginx 等支持静态文件的 HTTP 服务器软件提供文件。首先,决定好整合包下载链接前缀,比如我希望 HMCL 从远程服务器的 http://www.site.com/modpack 目录下存放整合包的更新信息,则在之前导出整合包的整合包下载前缀中填写 http://www.site.com/modpack。 + +![](/assets/img/docs/serverpack/1-4.png) + +上图为导出的服务器自动更新整合包压缩文件的内容,你需要将这个整合包解压到 http://www.site.com/modpack 下。也就是说,从 http://www.site.com/modpack/server-manifest.json 这个链接下载下来的文件必须和上图中整合包压缩文件中的 server-manifest.json 文件一致,并且,http://www.site.com/modpack/overrides 是一个文件夹,里面存放了整合包文件,比如: + +![](/assets/img/docs/serverpack/1-6.png) + +整合包压缩文件 test.zip/overrides/mods/Advancement_Book-1.12-1.0.3.jar 文件必须可以从 http://www.site.com/modpack/overrides/mods/Advancement_Book-1.12-1.0.3.jar 该目录下载下来,且文件内容一致。那么至此更新服务器就部署完成了。 + +## 第四步,更新整合包 + +如果你需要更新整合包,那么将新的整合包经过第一步导出新的整合包压缩文件,并解压到类似 http://www.site.com/modpack 文件夹下即可完成新整合包的部署。 \ No newline at end of file