Skip to content

Commit 5a3d9aa

Browse files
committed
Update _docs
1 parent 2f80ef8 commit 5a3d9aa

14 files changed

Lines changed: 298 additions & 140 deletions

_changelog/dev_en.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,9 +1,9 @@
11
---
22
layout: changelog
3-
lang: en
4-
permalink: changelog/dev
53
channel: dev
64
title: Changelog for Beta Version
75
date: 2021-08-22 23:18:02 +0800
86
note: Changelogs are written in Chinese.
7+
lang: en
8+
permalink: changelog/dev
99
---

_changelog/dev_zh.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,8 @@
11
---
22
layout: changelog
3-
lang: zh
4-
permalink: changelog/dev
53
channel: dev
64
title: 开发版更新日志
75
date: 2021-08-22 23:18:02 +0800
6+
lang: zh
7+
permalink: changelog/dev
88
---

_changelog/stable_en.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,9 +1,9 @@
11
---
22
layout: changelog
3-
lang: en
4-
permalink: changelog/stable
53
channel: stable
64
title: Changelog for Stable Version
75
date: 2021-08-22 23:18:02 +0800
86
note: Changelogs are written in Chinese.
7+
lang: en
8+
permalink: changelog/stable
99
---

_changelog/stable_zh.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,8 @@
11
---
22
layout: changelog
3-
lang: zh
4-
permalink: changelog/stable
53
channel: stable
64
title: 稳定版更新日志
75
date: 2021-08-22 23:18:02 +0800
6+
lang: zh
7+
permalink: changelog/stable
88
---

_docs/404.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,5 +4,5 @@ layout: splash
44

55
<div class="notice--danger">
66
<h1 id="">404</h1>
7-
<p><strong>页面不存在</strong></p>
7+
<p><strong>Page not found.</strong></p>
88
</div>

_docs/contribution.md

Lines changed: 3 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -1,9 +1,4 @@
11
---
2-
title: 为 HMCL 帮助文档出一份力
3-
date: 2021-10-09 23:18:02 +0800
4-
author: huanghongxun
5-
---
6-
7-
如果你认为你有能力为 HMCL 添加高质量的帮助文档,或希望修改错误,你可以到 [https://github.com/HMCL-dev/HMCL-docs](https://github.com/HMCL-dev/HMCL-docs) 仓库中发 Pull Request,或者提 Issue。
8-
9-
或者你可以进入我们的 [Discord](https://discord.gg/jVvC7HfM6U)[HMCL 用户群](/groups.html) 群以向 HMCL 反馈。
2+
layout: select_language
3+
permalink: contribution
4+
---

_docs/contribution_en.md

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,11 @@
1+
---
2+
title: Contribute to HMCL Help Documentation
3+
date: 2021-10-09 23:18:02 +0800
4+
author: huanghongxun
5+
lang: en
6+
permalink: contribution
7+
---
8+
9+
If you believe you can add high-quality help documentation for HMCL, or wish to correct errors, you can submit a Pull Request or open an Issue in the [https://github.com/HMCL-dev/HMCL-docs](https://github.com/HMCL-dev/HMCL-docs) repository.
10+
11+
Alternatively, you can join our [Discord](https://discord.gg/jVvC7HfM6U) or [HMCL User Group](/groups.html) to provide feedback to HMCL.

_docs/contribution_zh.md

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,11 @@
1+
---
2+
title: 为 HMCL 帮助文档出一份力
3+
date: 2021-10-09 23:18:02 +0800
4+
author: huanghongxun
5+
lang: zh
6+
permalink: contribution
7+
---
8+
9+
如果你认为你有能力为 HMCL 添加高质量的帮助文档,或希望修改错误,你可以到 [https://github.com/HMCL-dev/HMCL-docs](https://github.com/HMCL-dev/HMCL-docs) 仓库中发 Pull Request,或者提 Issue。
10+
11+
或者你可以进入我们的 [Discord](https://discord.gg/jVvC7HfM6U)[HMCL 用户群](/groups.html) 群以向 HMCL 反馈。

_docs/faq.md

Lines changed: 3 additions & 107 deletions
Original file line numberDiff line numberDiff line change
@@ -1,108 +1,4 @@
11
---
2-
title: 各大问题集合
3-
date: 2025-09-19 13:40:00 +0800
4-
author: LIPiston
5-
contributors:
6-
- Mine-diamond
7-
---
8-
9-
> 这是一个提供给新手或小白的阅读文档,旨在用最简单的方式帮你快速上手 HMCL 启动器和 Minecraft 游戏。如需深入了解某个主题,可点击文中提供的链接查看详细文档。
10-
11-
### 如何登录账户
12-
13-
你需要使用微软账户购买游戏才能游玩 Minecraft,或者使用离线账户/外置账户。
14-
15-
你可以在 [Minecraft 官网](https://www.minecraft.net/store/minecraft-java-bedrock-edition-pc?tabs=%7B%22details%22%3A0%7D)[Xbox 商店](https://www.xbox.com/games/store/minecraft-java-bedrock-edition-for-pc/9nxp44l49shj) 购买游戏。
16-
17-
完成购买后,在 HMCL 主界面左上角,点击「账户」,然后点击左侧的「微软账户」登录你的账户,或者点击「离线登录」创建一个离线账户。
18-
19-
### 如何下载游戏
20-
21-
使用 HMCL 下载 Minecraft 非常简单,只需几步即可完成。
22-
23-
如果你尚未安装任何实例(即未安装过任何游戏版本),可以直接点击 **「开始游戏」**。HMCL 会自动安装最新正式版 Minecraft 并启动游戏。
24-
25-
若想下载更多实例(首次下载也可以按此方式操作),请按以下步骤进行:
26-
27-
在主界面找到并点击左侧的「下载」按钮。
28-
29-
![](/assets/img/docs/about-questions/img.png)
30-
31-
在下载页面,点击左侧顶部的「游戏」选项卡。这里会列出所有可用的游戏版本(**版本号从上到下/由新到旧排序**),选择一个你喜欢的版本。我们通常推荐最新的正式版。
32-
33-
![](/assets/img/docs/about-questions/img2.png)
34-
35-
点击右下角的「安装」按钮,HMCL 就会自动为你完成下载和安装。
36-
37-
![](/assets/img/docs/about-questions/img3.png)
38-
39-
现在回到主界面,点击右下角的 **「启动游戏」** 按钮,开始你的创造吧!
40-
41-
![](/assets/img/docs/about-questions/img4.png)
42-
43-
### 游戏玩法是什么
44-
45-
在等待游戏下载时,不妨先了解一下它的核心玩法。
46-
47-
作为一款沙盒游戏,简单的说,核心玩法就是 **「破坏」****「创造」** 。你可以自由地探索世界、收集资源、建造家园、挑战怪物……
48-
49-
对于新手而言,下面这些官方中文 Wiki 链接是你的最佳起点:
50-
- **新手入门必读**[Minecraft Wiki 新手手册](https://zh.minecraft.wiki/w/%E6%95%99%E7%A8%8B/%E6%96%B0%E6%89%8B%E6%89%8B%E5%86%8C)
51-
- **生存第一天指南**[教程:第一天怎么过](https://zh.minecraft.wiki/w/Tutorial:%E7%AC%AC%E4%B8%80%E5%A4%A9)
52-
53-
### 什么是资源包
54-
55-
你可能听到有其他玩家讨论好看的「材质包」。
56-
57-
「材质包」一般是单指修改了游戏纹理的「资源包」,也是 Minecraft 1.5 及之前版本使用的称呼。
58-
59-
「材质」及「材质包」是以前的误译,目前的正式译名为「纹理」和「纹理包」。如果你看到有人讨论材质包,那么一般都是指纹理包。
60-
61-
「资源包」是指可以修改游戏中的多种资源,如**纹理(贴图)、模型、音乐、音效、语言文件**等的文件,能够极大地改变游戏的外观和感觉。而一个好的资源包能极大地提升你的游戏视听体验。
62-
63-
![大致示意图](/assets/img/docs/about-questions/img5.jpg)
64-
65-
- **如何使用资源包?** 查看 [加载资源包教程](https://zh.minecraft.wiki/w/Tutorial:%E5%8A%A0%E8%BD%BD%E8%B5%84%E6%BA%90%E5%8C%85)
66-
- **想制作自己的资源包?** 深入了解 [资源包详细资料](https://zh.minecraft.wiki/w/%E8%B5%84%E6%BA%90%E5%8C%85)
67-
68-
你可以在下列网站获取资源包:
69-
- [CurseForge](https://www.curseforge.com/minecraft/texture-packs)
70-
- [Modrinth](https://modrinth.com/resourcepacks)
71-
72-
### 什么是模组 (Mod)
73-
74-
你可能听说过我的世界拥有丰富的模组(Mod)资源。模组是一类能改变或增加游戏内容的强大工具,它允许你新增方块、生物、物品与机制等内容。通过安装模组,你可以获得更丰富的内容、更顺手的玩法体验和更出色的视听表现。
75-
76-
你可以在下列网站获取模组信息,并在 HMCL 内下载和安装:
77-
- [MC 百科](https://www.mcmod.cn/)
78-
- [CurseForge](https://www.curseforge.com/minecraft/search?class=mc-mods)
79-
- [Modrinth](https://modrinth.com/mods)
80-
81-
HMCL 自动安装与使用模组教程: [跳转](/launcher/auto-installing.html)
82-
83-
#### 安装模组后游戏报错怎么办
84-
85-
安装模组后游戏无法启动或崩溃是常见的情况,通常是模组冲突或缺少前置模组导致的。别担心,大部分问题都能轻松解决。
86-
87-
在 HMCL《自动安装与模组下载简介》的末尾讲到了常用的解决方法: [跳转](/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)
88-
89-
或者前往模组包报错排查手册中查看: [跳转](/modpack/error-handbook.html)
90-
91-
如果无法解决错误,尝试 [寻求帮助](help.html)
92-
93-
### 如何选择游戏的 Java 版本
94-
95-
HMCL 会自动管理 Java,并针对不同版本的游戏自动选择合适的 Java 版本。若在启动游戏时未检测到合适的 Java,HMCL 也会提示下载 Java(点击“下载”即可完成安装)。对于新手玩家,使用默认设置即可。
96-
97-
如果你确实需要手动安装并指定 Java 版本:
98-
99-
**安装 Java:**
100-
1. 进入 **设置 -> Java 管理**,此处会展示 HMCL 安装的或系统中已安装的 Java。
101-
2. 如果需要下载 Java,点击「下载 Java」,选择所需的版本,然后点击「确定」。
102-
3. 如果你安装了 Java 但是没有被 HMCL 识别,选择「添加 Java」,找到你需要的 Java 安装路径下的 `java.exe` 文件(仅 Windows)或 `java` 文件(仅 Linux/macOS),然后点击确定。
103-
104-
**选择 Java:**
105-
- 如果希望所有实例都使用同一 Java 版本,进入「设置 -> 全局游戏设置」,选择要使用的 Java。该 Java 将用于所有使用全局游戏设置的实例(一般不推荐)。
106-
- 如果仅需为某个实例指定 Java 版本,进入该实例的「实例管理界面 -> 游戏设置」(勾选“启用实例特定游戏设置”),然后选择要使用的 Java。该 Java 仅用于该实例的启动。
107-
108-
> **重要提示**:如果你在更换 Java 后遇到任何游戏崩溃或无法启动的问题,**请立即切换回 HMCL 默认的 Java 版本**
2+
layout: select_language
3+
permalink: faq
4+
---

_docs/faq_en.md

Lines changed: 110 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,110 @@
1+
---
2+
title: FAQ
3+
date: 2025-09-19 13:40:00 +0800
4+
author: LIPiston
5+
contributors:
6+
- Mine-diamond
7+
lang: en
8+
permalink: faq
9+
---
10+
11+
> This is a guide for beginners, aiming to help you quickly get started with the HMCL launcher and Minecraft in the simplest way. For more in-depth information on any topic, you can click the links provided in the text to view detailed documentation.
12+
13+
### How to log in to your account
14+
15+
You need to purchase the game with a Microsoft account to play Minecraft, or use an offline/external account.
16+
17+
You can buy the game on the [official Minecraft website](https://www.minecraft.net/store/minecraft-java-bedrock-edition-pc?tabs=%7B%22details%22%3A0%7D) or the [Xbox Store](https://www.xbox.com/games/store/minecraft-java-bedrock-edition-for-pc/9nxp44l49shj).
18+
19+
After purchasing, on the main HMCL interface, click "Account" in the top left, then click "Microsoft Account" on the left to log in, or click "Offline Login" to create an offline account.
20+
21+
### How to download the game
22+
23+
Using HMCL to download Minecraft is very simple and can be done in just a few steps.
24+
25+
If you haven't installed any instances (i.e., haven't installed any game versions), you can directly click **"Start Game"**. HMCL will automatically install the latest official version of Minecraft and launch the game.
26+
27+
If you want to download more instances (you can also follow these steps for the first download), please do the following:
28+
29+
Find and click the "Download" button on the left side of the main interface.
30+
31+
![](/assets/img/docs/about-questions/img.png)
32+
33+
On the download page, click the "Game" tab at the top left. Here you will see all available game versions (**versions are listed from newest to oldest**). Choose a version you like. We usually recommend the latest official version.
34+
35+
![](/assets/img/docs/about-questions/img2.png)
36+
37+
Click the "Install" button at the bottom right, and HMCL will automatically download and install it for you.
38+
39+
![](/assets/img/docs/about-questions/img3.png)
40+
41+
Now return to the main interface and click the **"Start Game"** button at the bottom right to begin your adventure!
42+
43+
![](/assets/img/docs/about-questions/img4.png)
44+
45+
### What is the gameplay
46+
47+
While waiting for the game to download, you can learn about its core gameplay.
48+
49+
As a sandbox game, simply put, the core gameplay is **"destroy"** and **"create"**. You can freely explore the world, collect resources, build homes, challenge monsters...
50+
51+
For beginners, the following official Chinese Wiki links are your best starting point:
52+
- **Must-read for beginners**: [Minecraft Wiki Beginner's Guide](https://zh.minecraft.wiki/w/%E6%95%99%E7%A8%8B/%E6%96%B0%E6%89%8B%E6%89%8B%E5%86%8C)
53+
- **Survival First Day Guide**: [Tutorial: How to Survive the First Day](https://zh.minecraft.wiki/w/Tutorial:%E7%AC%AC%E4%B8%80%E5%A4%A9)
54+
55+
### What is a Resource Pack
56+
57+
You may have heard other players talk about beautiful "texture packs".
58+
59+
A "texture pack" generally refers to a resource pack that modifies the game's textures, and was the term used for Minecraft versions 1.5 and earlier.
60+
61+
"Texture" and "texture pack" were mistranslations in the past; the official terms are now "texture" and "texture pack". If you see someone discussing texture packs, they are usually referring to texture packs.
62+
63+
A "resource pack" is a file that can modify various game resources, such as **textures (images), models, music, sound effects, language files**, etc., greatly changing the look and feel of the game. A good resource pack can greatly enhance your gaming audio-visual experience.
64+
65+
![General illustration](/assets/img/docs/about-questions/img5.jpg)
66+
67+
- **How to use resource packs?** See [Resource Pack Loading Tutorial](https://zh.minecraft.wiki/w/Tutorial:%E5%8A%A0%E8%BD%BD%E8%B5%84%E6%BA%90%E5%8C%85).
68+
- **Want to make your own resource pack?** Learn more at [Resource Pack Details](https://zh.minecraft.wiki/w/%E8%B5%84%E6%BA%90%E5%8C%85).
69+
70+
You can get resource packs from the following websites:
71+
- [CurseForge](https://www.curseforge.com/minecraft/texture-packs)
72+
- [Modrinth](https://modrinth.com/resourcepacks)
73+
74+
### What is a Mod
75+
76+
You may have heard that Minecraft has a wealth of mod resources. Mods are powerful tools that can change or add game content, allowing you to add new blocks, mobs, items, and mechanics. By installing mods, you can enjoy richer content, smoother gameplay, and better audio-visual effects.
77+
78+
You can get mod information from the following websites and download and install them in HMCL:
79+
- [MCBBS](https://www.mcmod.cn/)
80+
- [CurseForge](https://www.curseforge.com/minecraft/search?class=mc-mods)
81+
- [Modrinth](https://modrinth.com/mods)
82+
83+
HMCL automatic mod installation and usage tutorial: [Jump](/launcher/auto-installing.html)
84+
85+
#### What to do if the game reports an error after installing mods
86+
87+
It is common for the game to fail to start or crash after installing mods, usually due to mod conflicts or missing dependencies. Don't worry, most problems can be easily solved.
88+
89+
Common solutions are mentioned at the end of HMCL's "Automatic Installation and Mod Download Introduction": [Jump](/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)
90+
91+
Or check the modpack error troubleshooting manual: [Jump](/modpack/error-handbook.html)
92+
93+
If you can't solve the error, try [seeking help](help.html)
94+
95+
### How to Choose the Java Version for the Game
96+
97+
HMCL will automatically manage Java and select the appropriate Java version for different game versions. If a suitable Java is not detected when starting the game, HMCL will prompt you to download Java (just click "Download" to complete the installation). For new players, the default settings are sufficient.
98+
99+
If you do need to manually install and specify a Java version:
100+
101+
**Install Java:**
102+
1. Go to **Settings -> Java Management**, where you can see Java installed by HMCL or already installed on your system.
103+
2. If you need to download Java, click "Download Java", select the required version, and then click "OK".
104+
3. If you have installed Java but HMCL does not recognize it, select "Add Java", find the `java.exe` file in your Java installation path (Windows only) or the `java` file (Linux/macOS only), and then click OK.
105+
106+
**Select Java:**
107+
- If you want all instances to use the same Java version, go to "Settings -> Global Game Settings" and select the Java to use. This Java will be used for all instances using global game settings (generally not recommended).
108+
- If you only need to specify the Java version for a particular instance, go to that instance's "Instance Management -> Game Settings" (check "Enable instance-specific game settings"), and then select the Java to use. This Java will only be used for that instance.
109+
110+
> **Important Tip**: If you encounter any game crashes or startup issues after changing Java, **please immediately switch back to HMCL's default Java version**.

0 commit comments

Comments
 (0)