HMCL-dev · Glavo · Nov 4, 2025 · Nov 4, 2025 · Nov 5, 2025 · Nov 5, 2025
diff --git a/Gemfile b/Gemfile
@@ -17,6 +17,7 @@ group :jekyll_plugins do
   gem "jekyll-feed", "0.17.0"
   gem "jekyll-include-cache", "0.2.1"
   gem "jekyll-redirect-from", "0.16.0"
+  gem "jekyll-polyglot", "1.11.0"
 end
 
 # Windows and JRuby does not include zoneinfo files, so bundle the tzinfo-data gem

diff --git a/_config.yml b/_config.yml
@@ -67,6 +67,7 @@ plugins:
   - jekyll-feed
   - jekyll-include-cache
   - jekyll-redirect-from
+  - jekyll-polyglot
 # minimal-mistakes (mimic GitHub Pages with --safe)
 whitelist:
   - jekyll-paginate
@@ -137,13 +138,19 @@ defaults:
 #   # minimal-mistakes
 #   enable_coderay: false 
 
+# polyglot
+languages: ["und", "en", "zh"]
+default_lang: "und"
+exclude_from_localization:
+  - assets
+parallel_localization: false
+
 # Theme Settings
 theme: minimal-mistakes-jekyll
 minimal_mistakes_skin: default # "air", "aqua", "contrast", "dark", "dirt", "neon", "mint", "plum", "sunrise"
 minimal_mistakes_skin_dark: dark
 
 # Site Settings
-locale: zh
 # rtl:
 title: HMCL 文档
 # title_separator: -

diff --git a/_data/en/navigation.yml b/_data/en/navigation.yml
@@ -0,0 +1,53 @@
+main:
+  - title: FAQ
+    url: /faq.html
+
+docs:
+  - title: Question Collection
+    children:
+      - title: Common Questions
+        url: /faq.html
+      - title: Launcher Usage
+        url: /launcher/
+      - title: Modpack Help
+        url: /modpack/
+      - title: Multiplayer Help
+        url: /multiplayer/
+  - title: User Help
+    children:
+      - title: Version Isolation
+        url: /launcher/isolation.html
+        description: This article can help you better separate maps, mods, and other content between versions.
+      - title: Set Offline Skin
+        url: /launcher/offline-skin.html
+        description: This article will tell you how to set your own offline skin.
+      - title: HMCL Auto Installation Guide
+        url: /launcher/auto-installing.html
+        description: This article will tell you how to use HMCL to install Forge, Fabric, Fabric API, LiteLoader, Optifine, and mods.
+      - title: Install Shaders
+        url: /launcher/shader.html
+        description: This article will tell you how to install shaders.
+      - title: Settings Details
+        url: /launcher/set-item-details.html
+        description: This article explains each setting item of HMCL in detail.
+  - title: Developer Help
+    children:
+      - title: Create HMCL Format Datapack
+        url: /launcher/datapack.html
+        description: This article will tell you how to create datapacks that HMCL can recognize.
+      - title: Create Modpack
+        url: /modpack/serverpack.html
+        description: This article will tell you how to create a modpack.
+      - title: Add Default authlib-injector Authentication Server
+        url: /launcher/authlib-injector.html
+        description: This article will tell you how to set the default authentication server.
+  - title: Others
+    children:
+      - title: Contribute to HMCL
+        url: /contribution.html
+      - title: HMCL GitHub Repository
+        url: https://github.com/HMCL-dev/HMCL
+      - title: HMCL Docs GitHub Repository
+        url: https://github.com/HMCL-dev/HMCL-docs
+      - title: HMCL Official Website
+        url: https://hmcl.huangyuhui.net
diff --git a/_data/zh/navigation.yml b/_data/zh/navigation.yml
@@ -0,0 +1,53 @@
+main:
+  - title: 常见问题
+    url: /faq.html
+
+docs:
+  - title: 问题集合
+    children:
+      - title: 常见问题
+        url: /faq.html
+      - title: 启动器使用相关
+        url: /launcher/
+      - title: 整合包帮助
+        url: /modpack/
+      - title: 多人联机帮助
+        url: /multiplayer/
+  - title: 使用者帮助
+    children:
+      - title: 版本隔离
+        url: /launcher/isolation.html
+        description: 本文可以帮助你更好的分离版本间的地图、模组等内容。
+      - title: 设置离线皮肤
+        url: /launcher/offline-skin.html
+        description: 本文将告诉你如何设置一个属于自己的离线皮肤。
+      - title: HMCL 的自动安装使用教程
+        url: /launcher/auto-installing.html
+        description: 本文将告诉你如何用 HMCL 安装 Forge、Fabric、Fabric API、LiteLoader、Optifine 以及 模组 等。
+      - title: 安装光影
+        url: /launcher/shader.html
+        description: 本文将告诉你如何安装光影。
+      - title: 设置项详解
+        url: /launcher/set-item-details.html
+        description: 这篇文章针对 HMCL 的各个设置项进行了详细的解释。
+  - title: 开发者帮助
+    children:
+      - title: 制作 HMCL 格式的数据包
+        url: /launcher/datapack.html
+        description: 本文将告诉你如何制作 HMCL 能够识别的数据包（Datapacks）。
+      - title: 制作整合包
+        url: /modpack/serverpack.html
+        description: 本文将告诉你如何制作整合包。
+      - title: 添加默认 authlib-injector 验证服务器
+        url: /launcher/authlib-injector.html
+        description: 本文将告诉你如何设置默认的验证服务器。
+  - title: 其他
+    children:
+      - title: 为 HMCL 做出贡献
+        url: /contribution.html
+      - title: HMCL GitHub 地址
+        url: https://github.com/HMCL-dev/HMCL
+      - title: HMCL 帮助文档 GitHub 地址
+        url: https://github.com/HMCL-dev/HMCL-docs
+      - title: HMCL 官网
+        url: https://hmcl.huangyuhui.net
diff --git a/_docs/crash-support-group.md b/_docs/crash-support-group.md
@@ -29,8 +29,8 @@ author: zkitefly
 [~/assets/groups/button-1]: /assets/img/docs/groups/button-1.png "导出游戏崩溃日志"
 [~/assets/groups/button-2]: /assets/img/docs/groups/button-2.png "日志"
 <!--{% endcomment %}--{{'>'}}
-[~/assets/groups/button-1]: {% link /assets/img/docs/groups/button-1.png %} "导出游戏崩溃日志"
-[~/assets/groups/button-2]: {% link /assets/img/docs/groups/button-2.png %} "日志"
+[~/assets/groups/button-1]: /assets/img/docs/groups/button-1.png "导出游戏崩溃日志"
+[~/assets/groups/button-2]: /assets/img/docs/groups/button-2.png "日志"
 {% endcapture %}
 {{ notice | markdownify }}
 <p class="text-center">请等待 <span id="countdown">5</span> 秒，请认真阅读注意事项</p>
@@ -102,5 +102,5 @@ document.addEventListener("DOMContentLoaded", function () {
 <!--{% comment %}-->
 [~/assets/groups/crash]: /assets/img/docs/groups/crash.png
 <!--{% endcomment %}--{{'>'}}
-[~/assets/groups/crash]: {% link /assets/img/docs/groups/crash.png %}
+[~/assets/groups/crash]: /assets/img/docs/groups/crash.png
 <!---->
diff --git a/_downloads/java.md b/_downloads/java.md
@@ -1,23 +1,4 @@
 ---
-title: 下载 HMCL 和 Minecraft 依赖的 Java
-date: 2022-12-03 17:30:00 +0800
----
-
-正在前往 Java 下载页面，请点击下载，然后等待 Java 安装程序下载完成，最后启动安装程序，依照提示安装 Java。
-
-没有前往？[点击此处](https://www.java.com/zh-CN/download)
-
----
-
-You are going to the Java download page. Please click download after redirecting, then wait for the Java installer to finish downloading, finally open the installer and follow the prompts to install Java.
-
-No redirect? [Click here](https://www.java.com/download)
-
-
-<script>
-    /* 等待 5 秒. */
-    setTimeout(function() {
-        window.location.href = "https://www.java.com/download";
-    }, 5000);
-</script>
-
+layout: select_language
+permalink: downloads/java
+---
diff --git a/_downloads/java_en.md b/_downloads/java_en.md
@@ -0,0 +1,19 @@
+---
+title: Download HMCL and Minecraft Dependency Java
+date: 2022-12-03 17:30:00 +0800
+lang: en
+permalink: downloads/java
+---
+
+You are going to the Java download page. Please click download after redirecting, then wait for the Java installer to finish downloading, finally open the installer and follow the prompts to install Java.
+
+No redirect? [Click here](https://www.java.com/download)
+
+
+<script>
+    /* 等待 5 秒. */
-    /* 等待 5 秒. */
+    /* Wait 5 seconds. */
-    /* 等待 5 秒. */
+    /* Wait 5 seconds. */
+    setTimeout(function() {
+        window.location.href = "https://www.java.com/download";
+    }, 5000);
+</script>
+
diff --git a/_downloads/java_zh.md b/_downloads/java_zh.md
@@ -0,0 +1,18 @@
+---
+title: 下载 HMCL 和 Minecraft 依赖的 Java
+date: 2022-12-03 17:30:00 +0800
+lang: zh
+permalink: downloads/java
+---
+
+正在前往 Java 下载页面，请点击下载，然后等待 Java 安装程序下载完成，最后启动安装程序，依照提示安装 Java。
+
+没有前往？[点击此处](https://www.java.com/zh-CN/download)
+
+<script>
+    /* 等待 5 秒. */
+    setTimeout(function() {
+        window.location.href = "https://www.java.com/download";
+    }, 5000);
+</script>
+
diff --git a/_downloads/linux/arm32.md b/_downloads/linux/arm32.md
@@ -1,18 +1,4 @@
 ---
-title: 下载适用于 Linux ARM32 的 HMCL 和 Minecraft 依赖的 Java
-date: 2022-12-03 17:30:00 +0800
----
-
-点下面的链接以下载 Java ，然后使用软件包管理器或者手动解压安装。
-
-[链接](https://bell-sw.com/pages/downloads/?version=java-21&os=linux&package=jre-full&bitness=32&architecture=arm#:~:text=All%20versions)
-
-或者你也可以根据[教程](https://docs.bell-sw.com/liberica-jdk/latest/general/install-guide/#linux)来添加仓库到你的软件包管理器。
-
----
-
-Click one of the following links to download Java, and then use the package or extract it manually to install Java.
-
-[Link](https://bell-sw.com/pages/downloads/?version=java-21&os=linux&package=jre-full&bitness=32&architecture=arm#:~:text=All%20versions)
-
-Or you can add the repository to the package manager according to the [instruction](https://docs.bell-sw.com/liberica-jdk/latest/general/install-guide/#linux).
+layout: select_language
+permalink: downloads/linux/arm32
+---
diff --git a/_downloads/linux/arm32_en.md b/_downloads/linux/arm32_en.md
@@ -0,0 +1,12 @@
+---
+title: Download HMCL and Minecraft Dependency Java for Linux ARM32
+date: 2022-12-03 17:30:00 +0800
+lang: en
+permalink: downloads/linux/arm32
+---
+
+Click one of the following links to download Java, and then use the package or extract it manually to install Java.
+
+[Link](https://bell-sw.com/pages/downloads/?version=java-21&os=linux&package=jre-full&bitness=32&architecture=arm#:~:text=All%20versions)
+
+Or you can add the repository to the package manager according to the [instruction](https://docs.bell-sw.com/liberica-jdk/latest/general/install-guide/#linux).
diff --git a/_downloads/linux/arm32_zh.md b/_downloads/linux/arm32_zh.md
@@ -0,0 +1,12 @@
+---
+title: 下载适用于 Linux ARM32 的 HMCL 和 Minecraft 依赖的 Java
+date: 2022-12-03 17:30:00 +0800
+lang: zh
+permalink: downloads/linux/arm32
+---
+
+点下面的链接以下载 Java ，然后使用软件包管理器或者手动解压安装。
+
+[链接](https://bell-sw.com/pages/downloads/?version=java-21&os=linux&package=jre-full&bitness=32&architecture=arm#:~:text=All%20versions)
+
+或者你也可以根据[教程](https://docs.bell-sw.com/liberica-jdk/latest/general/install-guide/#linux)来添加仓库到你的软件包管理器。
diff --git a/_downloads/linux/arm64.md b/_downloads/linux/arm64.md
@@ -1,18 +1,4 @@
 ---
-title: 下载适用于 Linux ARM64 的 HMCL 和 Minecraft 依赖的 Java
-date: 2022-12-03 17:30:00 +0800
----
-
-点下面的链接以下载 Java ，然后使用软件包管理器或者手动解压安装。
-
-[链接](https://bell-sw.com/pages/downloads/?version=java-21&os=linux&package=jre-full&bitness=64&architecture=arm#:~:text=All%20versions)
-
-或者你也可以根据[教程](https://docs.bell-sw.com/liberica-jdk/latest/general/install-guide/#linux)来添加仓库到你的软件包管理器。
-
----
-
-Click one of the following links to download Java, and then use the package or extract it manually to install Java.
-
-[Link](https://bell-sw.com/pages/downloads/?version=java-21&os=linux&package=jre-full&bitness=64&architecture=arm#:~:text=All%20versions)
-
-Or you can add the repository to the package manager according to the [instruction](https://docs.bell-sw.com/liberica-jdk/latest/general/install-guide/#linux).
+layout: select_language
+permalink: downloads/linux/arm64
+---
diff --git a/_downloads/linux/arm64_en.md b/_downloads/linux/arm64_en.md
@@ -0,0 +1,12 @@
+---
+title: Download HMCL and Minecraft Dependency Java for Linux ARM64
+date: 2022-12-03 17:30:00 +0800
+lang: en
+permalink: downloads/linux/arm64
+---
+
+Click one of the following links to download Java, and then use the package or extract it manually to install Java.
+
+[Link](https://bell-sw.com/pages/downloads/?version=java-21&os=linux&package=jre-full&bitness=64&architecture=arm#:~:text=All%20versions)
+
+Or you can add the repository to the package manager according to the [instruction](https://docs.bell-sw.com/liberica-jdk/latest/general/install-guide/#linux).
diff --git a/_downloads/linux/arm64_zh.md b/_downloads/linux/arm64_zh.md
@@ -0,0 +1,12 @@
+---
+title: 下载适用于 Linux ARM64 的 HMCL 和 Minecraft 依赖的 Java
+date: 2022-12-03 17:30:00 +0800
+lang: zh
+permalink: downloads/linux/arm64
+---
+
+点下面的链接以下载 Java ，然后使用软件包管理器或者手动解压安装。
+
+[链接](https://bell-sw.com/pages/downloads/?version=java-21&os=linux&package=jre-full&bitness=64&architecture=arm#:~:text=All%20versions)
+
+或者你也可以根据[教程](https://docs.bell-sw.com/liberica-jdk/latest/general/install-guide/#linux)来添加仓库到你的软件包管理器。
diff --git a/_downloads/linux/loongarch64.md b/_downloads/linux/loongarch64.md
@@ -1,43 +1,6 @@
 ---
-title: 下载 HMCL 和 Minecraft 依赖的 Java
-date: 2023-09-05 14:00:00 +0800
+layout: select_language
+permalink: downloads/linux/loongarch64
 redirect_from:
   - /downloads/loongnix.html
----
-
-龙芯平台存在 “**新世界**” 和 “**旧世界**” 两个 ABI，不同 ABI 的 Java 暂时互不兼容。
-
-请在终端中输入 `uname -r` 命令查看 Linux 内核版本:
-
-- 如果你的内核版本为 5.10 或更高版本，请下载[新世界](#新世界) Java；
-- 如果你的内核版本为 4.19，请下载[旧世界](#旧世界) Java。
-
-## 新世界
-
-如果你正在使用新世界龙芯系统，请下载新世界 Java。
-
-直接下载 (需自行安装)：[loongson25.1.5-fx-jdk25_36-linux-loongarch64-glibc2.34.tar.gz](https://ftp.loongnix.cn/Java/openjdk25/loongson25.1.5-fx-jdk25_36-linux-loongarch64-glibc2.34.tar.gz)
-
-通过包管理器安装：
-
-- AOSC OS/Debian/Ubuntu: 
-
-  ```bash
-  sudo apt install default-jre
-  ```
-
-  注意：Deepin 软件源中的 Java 不包含 JIT 编译器，使用它启动游戏性能将极其糟糕。我们推荐 Deepin 用户直接下载 Java，而不是使用 APT 安装。
-
-- ArchLinux:
-
-  ```bash
-  sudo pacman -S jre-openjdk
-  ```
-
-## 旧世界
-
-如果你正在使用旧世界龙芯系统，请下载旧世界 Java：
-
-- `.tar.gz`: [loongson25.1.5-fx-jdk25_36-linux-loongarch64.tar.gz](https://ftp.loongnix.cn/Java/openjdk25/loongson25.1.5-fx-jdk25_36-linux-loongarch64.tar.gz)
-
-- `.deb`: [loongson25.1.5-fx-jdk25_36-linux-loongarch64.deb](https://ftp.loongnix.cn/Java/openjdk25/loongson25.1.5-fx-jdk25_36-linux-loongarch64.deb)
+---