Replace two-level lists with bold section headers in changelog files

Agent-Logs-Url: https://github.com/HMCL-dev/HMCL-docs/sessions/85dd9646-e48a-449e-90ed-93535a3be5dd

Co-authored-by: Glavo <20694662+Glavo@users.noreply.github.com>

.github/workflows/pr-preview.yml

@@ -10,8 +10,9 @@ concurrency:
   group: pr-preview
   cancel-in-progress: false
 env:
-  GITHUB_PR_NUMBER: ${{ github.event_name == 'issue_comment' && github.event.issue.number || github.event.pull_request.number }}
   JEKYLL_ENV: production
+  ENABLE_WEBP_AUTO_CONVERSION: "true"
+  GITHUB_PR_NUMBER: ${{ github.event_name == 'issue_comment' && github.event.issue.number || github.event.pull_request.number }}
 jobs:
   cache-refresh:
     if: ${{ !github.event.repository.fork && github.event_name == 'schedule' && github.event.schedule == '0 0 */6 * *' }}

Gemfile

@@ -8,7 +8,7 @@ source "https://rubygems.org"
 # This will help ensure the proper Jekyll version is running.
 # Happy Jekylling!
 gem "jekyll", "4.4.1"
-gem "minimal-mistakes-jekyll", "4.27.3"
+gem "minimal-mistakes-jekyll", "4.28.0"
 
 group :jekyll_plugins do
   gem "jekyll-paginate", "1.1.0"
@@ -32,5 +32,4 @@ gem "wdm", "0.2.0", :platforms => [:windows]
 gem "http_parser.rb", "0.8.0", :platforms => [:jruby]
 
 # plugin dependencies
-gem "nokogiri", "1.18.10"
+gem "webp-ffi", "0.4.0" if ENV["ENABLE_WEBP_AUTO_CONVERSION"] == "true" || ENV["DRONE"] == "true"
-gem "addressable", "2.8.7"

_changelogs/dev/3.10/3.10.0.315.md

@@ -0,0 +1,22 @@
+---
+---
+
+[详细版本介绍 (Bilibili)](https://www.bilibili.com/opus/1149333068052430851)
+
+- GP-4932: 在主页右键点击账户按钮时弹出快速切换账户菜单 (by zimzaza4)
+- GP-5011: 在 `JFXCustomColorPickerDialog` 中使用 HEX 作为默认 Tab (by Glavo)
+- GP-5019: 使用子标题注解“提前预览 HMCL 版本”选项 (by neveler)
+- GP-5019: 使用子标题显示“重启后生效”提示 (by neveler)
+- GP-4927: 在 macOS 平台上导出启动脚本时支持导出 `.command` 文件 (by WhatDamon)
+- GP-4872: 添加快速进入世界功能 (by mineDiamond)
+- GP-5008: 优化反馈页面 (by Glavo)
+- GP-5035: 在所有平台上将 `:` 视为文件名中的非法字符 (by 辞庐)
+- GP-5016: 在刷新 `ModListPage` 时不滚动到顶部 (by OrzMiku)
+- GP-5032: 优化 `InputDialogPane` (by mineDiamond)
+- GP-4897: 导出整合包时隐藏系统资源文件 (by Calboot)
+
+错误修复:
+
+- GP-5018: 修复 `subtitle` 颜色丢失的问题 (by neveler)
+- GP-5020: 修复 `GameCrashWindow` 中 `feedbackTextFlow` 样式错误的问题 (by Glavo)
+- GP-5040: 修复陶瓦联机页面部分文本在深色模式下颜色异常的问题 (by Glavo)

_changelogs/dev/3.10/3.10.0.317.md

@@ -0,0 +1,47 @@
+---
+---
+
+[详细版本介绍 (Bilibili)](https://www.bilibili.com/opus/1154036684319358993)
+
+- GP-4289: 在添加游戏目录页面选择目录时自动填写名称 (by Dime，辞庐，Glavo)
+- GP-4794: 优化微软登录页面 (by 辞庐，3gf8jv4dv)
+- GP-4882: 取消 `FXUtils#onClicked` 的连点限制 (by 辞庐)
+- GP-5043: 修复导出整合包界面以及 NBT 文件查看界面样式 (by Calboot)
+- GP-5046: 禁用游戏日志窗口的平滑滚动效果 (by Glavo)
+- GP-5052: 优化列表的平滑滚动效果 (by Glavo)
+- GP-5054: 优化账户选择弹窗在列表为空时的表现 (by mineDiamond)
+- GP-5056: 优化列表性能 (by Glavo)
+- GP-5057: 更新“没有游戏实例”标签的颜色 (by Glavo)
+- GP-5060: 优化非主窗口中对话框的效果 (by 辞庐)
+- GP-5062: 更新 NBT 标签图标 (by mineDiamond)
+- GP-5076: 优化不透明度滑块显示效果 (by neveler)
+- GP-5077: 优化设置页面的内边距 (by neveler)
+- GP-5079: 为不同类型的对话框指定相应的默认标题 (by neveler)
+- GP-5082: 更新关于页面的版权年份至 2026 (by 辞庐)
+- GP-5086: 更新安装游戏时选择加载器版本后的返回动画方向 (by 辞庐)
+- GP-5087: 更新启动按钮分隔符颜色 (by neveler)
+- GP-5088: 切换实例菜单仅在菜单高度大于最大高度时显示垂直滚动条 (by neveler)
+- GP-5101: 在进度指示器中添加圆角 (by 辞庐)
+- GP-5102: 优化文本输入框右键菜单的样式 (by Glavo)
+- GP-5107: 优化 `OptionToggleButton` (by 辞庐)
+- GP-5108: 优化打包日志逻辑 (by 辞庐)
+- GP-5114: 优化部分页面显示效果 (by neveler)
+- GP-5119: 安装 Modrinth 整合包时下载图标 (by Glavo)
+- GP-5129: 优化校验输入框内容的方式 (by 辞庐)
+- GP-5131: 修复缓存目录设置进入时默认未勾选的问题 (by 辞庐)
+- 优化软件文案，修订翻译 (by 3gf8jv4dv)
+
+错误修复:
+
+- GP-5034: 修复下载光影时对话框的标题文字错误的问题 (by Wulian233)
+- GP-5064: 修复弹出菜单在 HiDPI 显示器上播放动画过程中内容 Y 轴方向缩放异常的问题 (by Glavo)
+- GP-5080: 修复外置登录对话框在部分情况下未正确验证用户名的问题 (by Glavo)
+- GP-5081: 修复无法读取部分模组信息的问题 (by Glavo)
+- GP-5091: 修复未正确处理部分特殊版本号的问题 (by mineDiamond)
+- GP-5110: 修复无法解析新版本 NeoForge 版本号的问题 (by 辞庐)
+- GP-5111: 修复复制游戏实例相关问题 (by 辞庐)
+- GP-5112: 修复添加实例目录页面有一个空 Tooltip 的问题 (by 辞庐)
+- GP-5117: 修复离线换肤对话框中提示栏和按钮重叠的问题 (by NoClassDefFoundError)
+- GP-5118: 修复部分平台弹出菜单无法通过点击侧边栏收起的问题 (by 辞庐)
+- GP-5125: 修复未正确归类 NeoForge alpha 版本的问题 (by 辞庐)
+- GP-5128: 修复使用 BMCLAPI 下载源时选择 `Liteloader` 版本时可能报错的问题 (by Wulian233)

_changelogs/dev/3.10/3.10.0.318.md

@@ -0,0 +1,37 @@
+---
+---
+
+[详细版本介绍 (Bilibili)](https://www.bilibili.com/opus/1156648660083146756)
+
+- GP-4823: 优化世界管理界面和世界信息界面 (by mineDiamond, 3gf8jv4dv)
+- GP-4832: 支持更新部分模组 (by ZZZank)
+- GP-4929: 将陶瓦联机更新至 0.4.1 (by Burning_TNT)
+- GP-5026: 限制访问 Modrinth/CurseForge 时的并发数 (by Burning_TNT)
+- GP-5133: 修复第三方构建下禁用账户刷新的 tooltip 展示不支持的超链接标签的问题 (by Wulian233, 3gf8jv4dv)
+- GP-5137: 允许重命名实例时使用原名 (by mineDiamond)
+- GP-5143, GP-5168: 优化对获取账号信息时发生 SSL 异常的处理 (by Xirren, 3gf8jv4dv)
+- GP-5146: 使用 kala-compress 读取模组元数据 (by Glavo)
+- GP-5150: 调整平滑滚动的截止速度 (by Glavo)
+- GP-5159: 更新“检查模组更新”按钮的文本 (by 3gf8jv4dv)
+- GP-5160: 优化下载页面中来自 Modrinth 的内容标签显示 (by ENC_Euphony)
+- GP-5174: 优化实例列表的性能 (by Glavo)
+- GP-5180: 在资源包下载页面中隐藏不必要的标签 (by Glavo)
+- GP-5182: 支持重置日志字体 (by 辞庐)
+- GP-5186: 优化弹出菜单的显示 (by 辞庐)
+- GP-5188: 仅在左键点击时触发 `JFXRippler` 的波纹 (by Glavo)
+
+错误修复:
+
+- GP-5124: 修复离线换肤界面部分字体下产生额外空行的问题 (by NoClassDefFoundError)
+- GP-5144: 修复 `FetchTask` 未捕获部分异常的问题 (by Glavo)
+- GP-5148, GP-5151: 修复无法安装文件名包含特殊字符的整合包的问题 (by Glavo)
+- GP-5153: 修复窗口重新获取焦点时 `JFXRadioButton` 显示阴影的问题 (by Glavo)
+- GP-5162: 修复数据包管理页面在加载大量数据包时卡顿的问题 (by mineDiamond)
+- GP-5178: 修复窗口重新获取焦点时 `JFXButton` 意外地显示阴影的问题 (by Glavo)
+- GP-5179: 修复窗口重新获取焦点时 `JFXCheckBox` 意外地显示阴影的问题 (by Glavo)
+- GP-5166: 修复未下载陶瓦联机时打开陶瓦联机页面抛出异常的问题 (by Glavo)
+- GP-5167: 修复游戏设置中 Java 路径过长时可能与 Java 版本号标签冲突的问题 (by ENC_Euphony)
+- GP-5170: 修复无法安装部分带有 NeoForge 的 Modrinth 整合包的问题 (by 3gf8jv4dv)
+- GP-5183: 修复重置字体后未遵循 `hmcl.font.override`/`HMCL_FONT` 设置的问题 (by 辞庐, Glavo)
+- GP-5184: 修复游戏安装页面中卡片未显示波纹的问题 (by 辞庐)
+- GP-5197: 修复使用默认窗口大小时进入高级版本设置会向下滚动一段距离的问题 (by 辞庐)

_changelogs/dev/3.10/3.10.0.319.md

@@ -0,0 +1,15 @@
+---
+---
+
+[详细版本介绍 (Bilibili)](https://www.bilibili.com/opus/1158117702119718933)
+
+- GP-5208: 惰性初始化 `JFXRippler` 属性 (by Glavo)
+- GP-5211: 优化下载页面图标缓存功能 (by Glavo)
+- GP-5221: 更新 `ToolbarListPageSkin` 以使用 `JFXListView` 展示节点 (by Glavo)
+- GP-5223: 重构 `JavaManagementPage` 以使用 `ListCell` 展示元素 (by Glavo)
+- GP-5224: 重构 `WorldListPage` 以使用 `ListCell` 展示元素 (by Glavo)
+
+错误修复:
+
+- GP-5203: 修复实例列表不显示实例名的问题 (by Xirren)
+- GP-5220: 修复 CurseForge 源无法搜索到内容的问题 (by Glavo)

_changelogs/dev/3.11/3.11.0.321.md

@@ -0,0 +1,29 @@
+---
+---
+
+[详细版本介绍 (Bilibili)](https://www.bilibili.com/opus/1160728024302223363)
+
+- GP-4792: 优化 Fabric API / Quilt API 安装提示 (by 辞庐, 3gf8jv4dv)
+- GP-5029: 优化检查模组更新功能 (by Burning_TNT)
+- GP-5090: 支持自动安装 Legacy Fabric (by 辞庐)
+- GP-5172: 支持通过拖动标题栏退出最大化 (by neveler)
+- GP-5196: 使用 Forge/Quilt 加载器时模组管理页面应当扫描子文件夹 (by Wulian233)
+- GP-5198: 将世界管理界面“生成启动脚本”按钮折叠到二级菜单 (by Glavo)
+- GP-5239: 下载页面图标尚未加载时应当将图像更新为空白 (by Glavo)
+- GP-5250: Modrinth 默认不获取更新日志 (by Calboot)
+- GP-5251: 修复自动安装界面卡片上按钮无法点击的问题 (by 神奇的赵二 (OrzMiku))
+- GP-5259: 提早非法路径检查 (by 辞庐)
+- GP-5269: 支持右键点击侧边栏弹出切换实例菜单 (by Glavo)
+- GP-5273: 优化游戏代理参数设置 (by Glavo)
+- GP-5274: 对 Java 26 默认启用压缩对象头 (by Glavo)
+- GP-5276: 重构 `SchematicsPage` 以使用 `ListCell` 展示元素 (by Glavo)
+
+错误修复:
+
+- GP-5195: 修复导出 Modrinth 整合包时勾选“包含启动器”选项时导出的整合包不是 ZIP 格式的问题 (by 辞庐)
+- GP-5243: 修复实例列表中包含名称超长的实例时出现水平滚动条的问题 (by OrzMiku)
+- GP-5257: 修复本地安装 Cleanroom 完成后会删除安装器的问题 (by 辞庐)
+- GP-5261: 修复下载页面选择游戏版本对话框包含 `_unobfuscated` 版本的问题 (by Glavo)
+- GP-5262: 修复使用 GIF 背景时调整背景不透明度导致启动器崩溃的问题 (by Glavo)
+- GP-5265: 修复未正确为游戏设置 `java.net.useSystemProxies` JVM 参数的问题 (by Xirren)
+- GP-5267: 修复部分场景中解压空 ZIP 文件失败的问题 (by Glavo)

_changelogs/dev/3.11/3.11.0.322.md

@@ -0,0 +1,23 @@
+---
+---
+
+[详细版本介绍 (Bilibili)](https://www.bilibili.com/opus/1162588466738888708)
+
+- GP-4733: 导出日志时允许重名文件 (by Glavo)
+- GP-5245: 修复主页公告阴影被裁切的问题 (by 辞庐)
+- GP-5270: 在陶瓦联机页面添加切换账号菜单 (by Glavo)
+- GP-5279: 更新下载页面条目样式 (by Glavo)
+- GP-5283, GP-5319: 优化深色模式支持 (by Glavo)
+- GP-5292: 更新文本输入框的右键菜单样式 (by 辞庐)
+- GP-5296: 扫描模组子目录时忽略 `.connector` 文件夹 (by 辞庐)
+- GP-5304: 取消游戏下载页面中高版本游戏对 Windows 7 的不兼容提示 (by 辞庐)
+
+错误修复:
+
+- GP-5284: 修复部分列表页面出现横向滚动条的问题 (by Glavo)
+- GP-5299: 修复添加认证服务器对话框非 CJK 语言下宽度异常的问题 (by 辞庐)
+- GP-5300: 修复下载页面模组简介只会显示一行的问题 (by 辞庐)
+- GP-5305: 修复返回页面时可能卡进空白页面的问题 (by 辞庐)
+- GP-5308: 修复 `JFXTabPane` 指示器偏移的问题 (by 辞庐)
+- GP-5310: 修复点击实例列表条目的中央区域无法触发涟漪效果的问题 (by 辞庐)
+- GP-5328: 修复弹出菜单在 RTL 布局下弹出位置错误的问题 (by 辞庐)

_changelogs/dev/3.11/3.11.0.323.md

@@ -0,0 +1,24 @@
+---
+---
+
+[详细版本介绍 (Bilibili)](https://www.bilibili.com/opus/1164826007218159625)
+
+- GP-5390: 将 TwelveMonkeys 更新至 3.13.0 (by Glavo)
+- GP-5391: 将 XZ for Java 更新至 1.11 (by Glavo)
+- GP-5392: 将 Gradle Shadow 插件更新至 9.3.1 (by Glavo)
+- GP-5385: 优化 `ComponentList` (by Glavo)
+- GP-4975: 调整渲染器名称 (by Chen Meng)
+- GP-5337: 使用 `LineSelectButton` 代替 `JFXComboBox` (by Glavo)
+- GP-5215: 优化世界管理与世界信息页面 (by mineDiamond, 3gf8jv4dv, Glavo)
+- GP-5272: 启动时检查 Jar 路径是否包含 `!` (by 辞庐)
+- GP-5317: 在 Linux 平台使用 dbus-send 检测深色模式设置 (by Glavo)
+- GP-5364: 在 NBT 查看器页面启用平滑滚动 (by Glavo)
+
+错误修复:
+
+- GP-5333: 修复启动服务端自动更新整合包时会下载并启用已禁用的模组的问题 (by Luo Chen)
+- GP-5374: 修复不透明度数值标签可能被折叠的问题 (by NoClassDefFoundError)
+- GP-5375: 修复部分列表点击后无法通过 esc 返回的问题 (by NoClassDefFoundError)
+- GP-5379: 修复版本设置页面滚动条总是显示的问题 (by Dime)
+- GP-5388: 修复导出的 PowerShell 脚本中路径可能无效的问题 (by Xirren)
+

_changelogs/dev/3.11/3.11.0.325.md

@@ -0,0 +1,34 @@
+---
+---
+
+[详细版本介绍 (Bilibili)](https://www.bilibili.com/opus/1167033744946626616)
+
+- GP-5395, GP-5408, GP-5416, GP-5446: 统一列表卡片样式 (by Glavo)
+- GP-5422: 优化日志窗口无日志行的背景色 (by 辞庐)
+- GP-5405: 统一加载指示器大小 (by 辞庐)
+- GP-5406: 统一实例管理页面子页面刷新时的样式 (by 辞庐)
+- GP-5426: 导出运行栈时附加 `-e` 和 `-l` 参数 (by 辞庐)
+- GP-5456: 优化工具栏按钮图标 (by Glavo)
+- GP-5465, GP-5474: 优化下载页面条目中标签的展示方式 (by Glavo)
+- GP-5481: 优化设置页面检查更新设置项的样式 (by Glavo)
+- GP-5467: 自动展开 NBT 查看器中部分子标签 (by Calboot)
+- GP-5417: 更新文言文 README (by GIGN)
+- 优化软件文案，修订翻译 (by 3gf8jv4dv)
+
+错误修复:
+
+- GP-5012: 修复 Modrinth 模组依赖已经被删除的条目时无法加载版本列表的问题 (by Burning_TNT)
+- GP-5432: 修复部分页面弹出菜单会被重复触发的问题 (by Glavo)
+- GP-5398: 修复文本输入框右键菜单中图标风格与其他图标不一致的问题 (by 辞庐)
+- GP-5411: 修复离线账户换肤对话框中对 Custom Skin API 地址的校验未生效的问题 (by 辞庐)
+- GP-5413: 修复 1.5.2 等版本 Legacy Fabric 无法安装的问题 (by 辞庐)
+- GP-5414: 修复 Legacy Fabric API 可以和 Forge 同时安装的问题 (by 辞庐)
+- GP-5423: 修复安装游戏时选择版本后返回已选择的版本会被清除的问题 (by 辞庐)
+- GP-5433: 修复部分环境中进入下载页面时启动器崩溃的问题 (by Glavo)
+- GP-5434: 修复日志级别选择按钮背景颜色溢出的问题 (by 辞庐)
+- GP-5442: 修复无法为 Minecraft 1.12.2 安装 Forge 和 Cleanroom 的问题 (by Glavo)
+- GP-5449: 修复 SVG 图标对齐错误的问题 (by Glavo)
+- GP-5461: 修复世界管理页面中快速启动按钮出现在不支持的版本的问题 (by mineDiamond)
+- GP-5477: 修复部分页面意外的显示滚动条的问题 (by Glavo)
+- GP-5479: 修复无法正确识别 Minecraft 2.0 实例版本号的问题 (by Glavo)
+- GP-5480: 修复无法归一化版本号 "1.16.2 Pre-release 1" 的问题 (by Glavo)

_changelogs/dev/3.11/3.11.0.326.md

@@ -0,0 +1,12 @@
+---
+---
+
+[详细版本介绍 (Bilibili)](https://www.bilibili.com/opus/1167774223102378020)
+
+- GP-5504: 更新陶瓦联机至 0.4.2 (by Glavo)
+- GP-5462: 未安装实例时点击主页“开始游戏”按钮不选择不支持当前平台的版本 (by 辞庐, Glavo)
+
+错误修复:
+
+- GP-5369: 修复在 ZIP 文件中遇到重名目录条目时读取失败的问题 (by NoClassDefFoundError)
+- GP-5507: 修复陶瓦联机页面“导出联机日志”按钮内边距异常的问题 (by Glavo)

_changelogs/dev/3.12/3.12.0.327.md

@@ -0,0 +1,17 @@
+---
+---
+
+[详细版本介绍 (Bilibili)](https://www.bilibili.com/opus/1169623275237539841)
+
+- GP-5330, GP-5531, GP-5538: 更新微软账户登录流程 (by 辞庐, Glavo)
+- GP-5368: 阻止在颜色选择器中输入非法颜色信息 (by Damon Lu)
+- GP-5527: 增加弹窗图标内容间距 (by 辞庐)
+- GP-5524: 将指向 MCEdit 的链接替换为 Minecraft Wiki 的教程页面 (by 3gf8jv4dv)
+- GP-5394: 使 Java 下载页面可以同时下载多个 Java (by NoClassDefFoundError)
+
+错误修复:
+
+- GP-5508: 修复部分请求头中 Accept-Language 字段包含 Java 版本的问题 (by Glavo)
+- GP-5520: 修复下载游戏版本列表点击左侧图标无法触发水波纹效果及光标没有变成手型的问题 (by 辞庐)
+- GP-5522: 修复安装卡片部分区域点击无法触发水波纹效果的问题 (by 辞庐)
+- GP-5543: Fix #5525: 修复 Task 进度异常的问题 (by Glavo)

_changelogs/dev/3.12/3.12.0.328.md

@@ -0,0 +1,28 @@
+---
+---
+
+[详细版本介绍 (Bilibili)](https://www.bilibili.com/opus/1171870118637994018)
+
+- GP-5242: 支持在实例列表搜索实例 (by 辞庐)
+- GP-5514: 为“渲染器”添加描述 (by Damon Lu)
+- GP-5521: 优化下载页面条目水波纹样式 (by 辞庐)
+- GP-5539: 解析 Yggdrasil 服务器地址时遵循服务器重定向 (by Glavo)
+- GP-5552: 支持新版本世界指定资源包位置 (by mineDiamond)
+- GP-5583: 支持在 FreeBSD x86-64、Linux Arm64、Linux RISC-V64 平台上启动 Minecraft 26.1-snapshot-8 或更高版本 (by Glavo)
+- GP-5585: 修复下载源失效时刷新版本列表不会回退到备用下载源的问题 (by Glavo)
+- GP-5586: 优化无法补全 JavaFX 时的报错信息 (by Glavo)
+- GP-5546, GP-5559, GP-5560, GP-5564, GP-5565, GP-5569, GP-5570, GP-5574: 优化部分控件样式 (by Glavo)
+
+错误修复:
+
+- GP-5430: 修复启动游戏补全文件时任务没有正确归类的问题 (by 辞庐)
+- GP-5532: 修复高分屏下新建账户 Tab 文字模糊的问题 (by 辞庐)
+- GP-5536: 修复更新整合包后模组加载器版本号不会及时更新的问题 (by 小宇)
+- GP-5549: 修复微软登录报错的超链接显示 (by Xirren)
+- GP-5550: 修复安装整合包时任务弹窗可能空白的问题 (by 辞庐)
+- GP-5556: 修复通过 CurseForge/Modrinth 安装整合包时可以返回到整合包类型选择页面的问题 (by 辞庐)
+- GP-5558: 修复光影下载搜索栏中错误地显示“支持中英文搜索”提示的问题 (by 辞庐)
+- GP-5575: 修复无法使用授权代码流登录微软账户的问题 (by 辞庐)
+- GP-5581: 修复日志窗口 Ctrl+C 复制日志时在主窗口显示提示的问题 (by 辞庐)
+- GP-5584: 修复打开登录微软对话框时加载指示器一闪而过的问题 (by 辞庐)
+- GP-5600: 修复部分对话框中取消按钮行为异常的问题 (by 辞庐)

_changelogs/dev/3.12/3.12.0.330.md

@@ -0,0 +1,25 @@
+---
+---
+
+[详细版本介绍 (Bilibili)](https://www.bilibili.com/opus/1175547967863521301)
+
+- GP-5030: 重新启用 MCIM 加速 (by Glavo)
+- GP-5359: 修复语言为文言时下载游戏的选择模组加载器页面的版本号未本地化的问题 (by Wulian233)
+- GP-5458, GP-5463: 下载界面简介不滚动 (by Calboot)
+- GP-5554: 向图标添加圆角 (by Dime)
+- GP-5603: 下载任务在重试前添加等待延迟 (by Glavo)
+- GP-5610: 优化设备代码流登录流程 (by Glavo)
+- GP-5622: 更新 Copyright 年份 (by 3gf8jv4dv)
+- GP-5624: 更新对 Linux LoongArch64 平台的支持 (by Glavo)
+- GP-5638: 切换实例隔离设置后自动刷新其他子页面 (by 辞庐)
+- GP-5652: 在世界管理页面中不展示 zip 格式的世界 (by Wulian233)
+- GP-5655: 添加对 1.21.11-rc3_unobfuscated 的支持 (by TNTyep520, Glavo)
+- GP-5623: 优化软件文案，修订翻译 (by 3gf8jv4dv)
+
+错误修复:
+
+- GP-5605: 修复选择角色弹窗未适配深色模式 (by 辞庐)
+- GP-5607: 修复账号列表复制按钮未正确应用样式的问题 (by 辞庐)
+- GP-5617: 修复 `JFXSpinner` 样式失效的问题 (by 辞庐)
+- GP-5613: 修复本地安装整合包时出现错误的问题 (by 辞庐)
+- GP-5633: 修复 `message.question` 未本地化的问题 (by 辞庐)

_changelogs/dev/3.12/3.12.0.331.md

@@ -0,0 +1,31 @@
+---
+---
+
+[详细版本介绍 (Bilibili)](https://www.bilibili.com/opus/1177774504686911489)
+
+- GP-5731: 将 Gradle 更新至 9.4.0 (by 辞庐)
+- GP-5717: 将 JetBrains Java Annotations 更新至 26.1.0 (by Glavo)
+- GP-5675: 支持解析 Minecraft 26.1-snapshot-6 新版本存档数据 (by mineDiamond)
+- GP-5690: 优化 `FileSelector` 按钮样式 (by 辞庐)
+- GP-5697: 将 BAT 脚本命令长度限制增加至 32767 (by 辞庐)
+- GP-5698: 优化安装实例时自动补全模组加载器名称 (by 辞庐)
+- GP-5707: 优化 `LineSelectButton` 弹出菜单配色 (by 辞庐)
+- GP-5716: 向滚动条添加圆角 (by Calboot)
+- GP-5739: 移除下载页面超链接多余 Tooltip (by 辞庐)
+- GP-5760: 优化 `JFXToggleButton` 配色 (by Glavo)
+- GP-5636: 支持使用键盘方向键调整 `LineSelectButton` 值 (by 辞庐)
+- GP-5759: 为主页启动按钮添加冷却时间 (by Glavo)
+- GP-5714: 更新阿拉伯语翻译 (by Hommam-Prom)
+- GP-5737: 更新运行路径中包含非法字符 `=` 时的提示 (by 辞庐)
+
+错误修复:
+
+- GP-5659: 修复导出游戏运行栈按钮对低版本 Java 未显示不兼容提示的问题 (by 辞庐)
+- GP-5662: 修复无法为使用 Java 11 启动的游戏导出游戏运行栈的问题 (by 辞庐)
+- GP-5669: 修复无法导入部分 Modrinth 整合包的问题 (by 辞庐)
+- GP-5691: 修复整合包安装界面文件名重复的提示显示不全的问题 (by 辞庐)
+- GP-5692: 修复整合包安装页面游戏实例名选项显示为文件名的问题 (by 辞庐)
+- GP-5693: 修复 `SpinnerPane` 会裁切元素的问题 (by 辞庐)
+- GP-5705: 修复取消模组更新检查时会弹窗操作失败的问题 (by 辞庐)
+- GP-5706: 修复 `LineComponent` 副标题样式未正确应用的问题 (by 辞庐)
+- GP-5710: 修复导出 Modrinth 整合包时不要求填写作者的问题 (by MovTery)

_changelogs/dev/3.12/3.12.0.332.md

@@ -0,0 +1,18 @@
+---
+---
+
+[详细版本介绍 (Bilibili)](https://www.bilibili.com/opus/1179999138825109529)
+
+- GP-5773: 更新模组数据 (by Glavo)
+- GP-4706: 添加"关闭启动时的更新弹窗"选项 (by An5w1r, Glavo)
+- GP-5620: 更新关于页面的许可证信息 (by 3gf8jv4dv)
+- GP-5769: 当背景自定义路径是文件夹时随机在文件夹中选取图片作为背景 (by 辞庐)
+- GP-5664: 优化删除垃圾桶图标 (by 辞庐)
+- GP-5663: 调整导出游戏运行栈加载指示器大小 (by 辞庐)
+
+错误修复:
+
+- GP-5728: 修复“从互联网下载整合包”选项对话框可能会意外被关闭的问题 (by Glavo)
+- GP-5765: 修复 `26.1-pre-1` 版本号无法归一化的问题 (by mineDiamond)
+- GP-5772: 修复显示器 125% 缩放时弹出菜单内容模糊的问题 (by 辞庐)
+- GP-5776: 修复颜色选择器中“自定义颜色”对话框初始值不会与当前颜色同步的问题 (by Damon Lu)

_changelogs/dev/3.13/3.13.0.333.md

@@ -0,0 +1,21 @@
+---
+---
+
+[详细版本介绍 (Bilibili)](https://www.bilibili.com/opus/1181885655980965928)
+
+- GP-5313: 支持从 CurseForge 下载光影 (by 辞庐)
+- GP-5631: 重启 HMCL 时继承所有 JVM 参数 (by 辞庐, Glavo)
+- GP-5787: 添加 Gitee Issue 模板配置 (by Zkitefly)
+- GP-5791: 支持愚人节模式 (by Glavo)
+- GP-5798: 使用 MCIM 作为回退下载源 (by Glavo)
+- GP-5800: 更新进度条样式 (by Glavo)
+- GP-5801: 更新 GitHub Actions (by Glavo)
+- GP-5803: 更新 `JFXSpinner` 默认样式 (by Glavo)
+- GP-5804: 优化 `JFXSpinner` 动画生成逻辑 (by Glavo)
+- GP-5805: 平滑进度条 (by Glavo)
+
+错误修复:
+
+- GP-4876: 修复 macOS 平台上空闲内存识别错误的问题 (by Damon Lu, Glavo)
+- GP-5782: 修复对高版本 Cleanroom 选择的 Java 版本错误的问题 (by 辞庐, Glavo)
+- GP-5810: 修复无法归一化 26.1 发布候选版本号的问题 (by mineDiamond)

_changelogs/dev/3.13/3.13.0.335.md

@@ -0,0 +1,22 @@
+---
+---
+
+[详细版本介绍 (Bilibili)](https://www.bilibili.com/opus/1183364580749869077)
+
+- GP-5660: 在游戏进程结束后禁用“结束游戏进程”与“导出游戏运行栈”按钮 (by 辞庐, Glavo)
+- GP-5667: 使用 HelloNBT 替代 OpenNBT (by Glavo)
+- GP-5694: 为游戏崩溃界面导出和启动器日志导出添加加载指示器 (by 辞庐, Glavo)
+- GP-5702: 优化 tag 展示逻辑 (by 辞庐)
+- GP-5786: 安装 CurseForge 整合包时下载图标 (by Calboot)
+- GP-5802, GP-5837: 当 CurseForge API Key 缺失时隐藏下载源切换选项 (by Glavo)
+- GP-5829: 更新内存状态栏 (by Glavo)
+- GP-5830: 禁止在颜色选择器中调整颜色透明度 (by neveler)
+- GP-5832, GP-5836: 为对话框添加圆角 (by neveler)
+- GP-5813: 将游戏设置中“不适用于当前系统的选项”提示移动到副标题 (by Damon Lu)
+- GP-5833: 优化对 26.1 正式版/预发布版/候选版的支持 (by Glavo)
+- GP-5841: 将 Java 下载页面默认 Java 版本更新至 Java 25 (by Glavo)
+- GP-5845: 更新文言文翻译 (by Glavo)
+
+错误修复:
+
+- GP-5839: 修复文本框导致 GPU 占用率异常高的问题 (by Glavo)

_changelogs/dev/3.13/3.13.0.336.md

@@ -0,0 +1,12 @@
+---
+---
+
+[详细版本介绍 (Bilibili)](https://www.bilibili.com/opus/1185155375901442055)
+
+- GP-5854: 将 twelvemonkeys 更新至 3.13.1 (by Glavo)
+- GP-5855: 将 HelloNBT 更新至 0.3.0 (by Glavo)
+- GP-5601: 下载页面折叠快照 Minecraft 版本 (by 辞庐, Glavo)
+- GP-5703: 更新更新渠道选择选项 (by 辞庐, 3gf8jv4dv, Glavo)
+- GP-5851: 优化读取 JAR/ZIP 文件时的性能 (by Glavo)
+- GP-5860: 更新种子地图、要塞地图、下届要塞地图和末地城地图链接以支持 26.1 (by neveler)
+- GP-5870: 优化 Minecraft 26.1 性能 (by Glavo, 3gf8jv4dv) ([BV1mPXSBEEBx](https://www.bilibili.com/video/BV1mPXSBEEBx))

_changelogs/dev/3.13/3.13.0.337.md

@@ -0,0 +1,21 @@
+---
+---
+
+[详细版本介绍 (Bilibili)](https://www.bilibili.com/opus/1188172826709852165)
+
+- GP-5882: 将 lwjgl-unsafe-agent 更新至 2.0 (by Glavo)
+- GP-5883: 将 XZ for Java 更新至 1.12 (by Glavo)
+- GP-5316: 更新 AMD 显卡信息数据 (by 辞庐, Glavo)
+- GP-5484: 支持加载 SVG 图片 (by Glavo)
+- GP-5518: 在 Wine 环境中启动时发出警告 (by Damon Lu)
+- GP-5738: 为在临时目录中启动 HMCL 时弹出的提示对话框添加 5 秒倒计时 (by 辞庐)
+- GP-5775: 为自定义颜色选择对话框添加确认和取消按钮 (by mineDiamond, Glavo)
+- GP-5781: 支持设置模组/整合包/光影/资源包/世界默认下载源 (by Calboot, Glavo, 3gf8jv4dv)
+- GP-5861: 优化“关于”页面组件间距 (by neveler)
+- GP-5892: 优化对 26w14a 愚人节版本的支持，更新模组下载页游戏版本列表至 26.1.1 (by Glavo)
+- 优化软件文案，修订翻译 (by 3gf8jv4dv, 辞庐, Xirren)
+
+错误修复:
+
+- GP-5301: 修复清理游戏资源/库操作在 JavaFX 线程运行的问题 (by 辞庐)
+- GP-5877: 修复对话框动画过程中内容模糊的问题 (by 辞庐)

_changelogs/dev/3.13/3.13.0.338.md

@@ -0,0 +1,26 @@
+---
+---
+
+[详细版本介绍 (Bilibili)](https://www.bilibili.com/opus/1188173041413128193)
+
+- GP-4716: 优化 Java 搜索 (by Glavo)
+- GP-5859: 优化 Java 下载 (by Glavo)
+- GP-5730: 支持通过版本 JSON 安装实例 (by 辞庐, Glavo)
+- GP-5917, GP-5905: 优化组合框样式 (by Wulian233, 辞庐, Glavo)
+- GP-5872: 优化下载页面依赖项展示 (by 辞庐)
+- GP-5923: 优化原理图管理和世界界面中部分输入框的校验方式 (by 辞庐)
+- GP-5924: 优化 Java 下载弹窗旋转指示器样式 (by 辞庐)
+- GP-5925: 优化添加认证服务器 HTTP 警告颜色 (by 辞庐)
+
+错误修复:
+
+- GP-5609: 修复阴影无法完整覆盖部分控件的问题 (by 辞庐)
+- GP-5688: 修复预览皮肤时 Alex 模型皮肤手臂后侧有一列侧面的异常像素的问题 (by 辞庐)
+- GP-5879: 修复安装模组时未检查是否已存在的问题 (by 辞庐)
+- GP-5888: 修复模组管理页面对于 1.20.1+NeoForge 实例会将部分 Forge 模组识别为 `MixinExtras` 的问题 (by Calboot)
+- GP-5899: 修复下载游戏内容时出现空游戏版本条目的问题 (by Calboot)
+- GP-5910: 修复无法为 Minecraft 26.1.1 从官方源安装 NeoForge 的问题 (by Glavo, Burning_TNT)
+- GP-5911: 修复多次打开微软登录弹窗后报错的问题 (by Glavo)
+- GP-5914: 修复深色模式下导入整合包界面箭头颜色错误的问题 (by Calboot)
+- GP-5915: 修复长按标题栏中部分按钮时可以拖动窗口的问题 (by 辞庐)
+- GP-5922: 修复安装整合包部分任务未正确归类的问题 (by 辞庐)

_changelogs/dev/3.13/3.13.0.339.md

@@ -0,0 +1,6 @@
+---
+---
+
+[详细版本介绍 (Bilibili)](https://www.bilibili.com/opus/1188905221714083844)
+
+- GP-5928: 支持在 FreeBSD x86-64、Linux Arm64、Linux LoongArch64 和 Linux RISC-V64 平台上启动 Minecraft 26.2-snapshot-1+ (by Glavo)

_changelogs/dev/3.13/3.13.0.340.md

@@ -0,0 +1,12 @@
+---
+---
+
+[详细版本介绍 (Bilibili)](https://www.bilibili.com/opus/1190023991956340740)
+
+- GP-5930: 增强对 Vulkan 的支持 (by Glavo, 3gf8jv4dv)
+- GP-5931: 支持将新格式快照版本号翻译为文言 (by Glavo)
+- GP-5934: 更新游戏内容下载页游戏版本列表至 26.1.2 (by Glavo)
+
+错误修复:
+
+- GP-5935: 修复日志窗口可能意外的显示横向滚动条的问题 (by Glavo)

_changelogs/dev/3.14/3.14.0.341.md

@@ -0,0 +1,14 @@
+---
+---
+
+[详细版本介绍 (Bilibili)](https://www.bilibili.com/opus/1192630259688669201)
+
+- GP-5940: 支持更多 Vulkan 渲染器 (by Glavo) [BV1Nhd5B9ENc](https://bilibili.com/video/BV1Nhd5B9ENc)
+- GP-5945: 增大自动安装界面加载器名称版本号间距 (by 辞庐)
+- GP-5949: 上传微软账户皮肤时校验大小 (by 辞庐)
+- GP-5944: 优化菜单分隔符颜色 (by 辞庐,Glavo)
+- GP-5946: 隐藏 CurseForge 源中游戏内容的不重要标签 (by 辞庐)
+
+错误修复:
+
+- GP-5943: 修复模组名字过长时下载页面布局异常的问题 (by 辞庐)

_changelogs/dev/3.6/3.6.11.265.md

@@ -9,10 +9,10 @@
 - GP-3490: 修复 OAuth 登录时轮询过于频繁的问题
 - GP-3464: 修复在更新日志界面无法拖动启动器窗口的问题
 - GP-3503: 使用 Zink 渲染器时禁用 DRI3
-- GC-`5fd52bb`: 皮肤缓存不再保存到 .minecraft 目录
+- GC-5fd52bb: 皮肤缓存不再保存到 .minecraft 目录
-- GC-`d5408c3`: 版本特定游戏设置从全局设置复制
+- GC-d5408c3: 版本特定游戏设置从全局设置复制
-- GC-`81b3911`: 修复按 ESC 键时文本框内的值没有保存的问题
+- GC-81b3911: 修复按 ESC 键时文本框内的值没有保存的问题
-- GC-`260f4b6`: 修复输入对话框中 ESC 键不起作用的问题
+- GC-260f4b6: 修复输入对话框中 ESC 键不起作用的问题
-- GC-`7d12ef6`: 修复内存滑块提示被设备内存进度条覆盖的问题
+- GC-7d12ef6: 修复内存滑块提示被设备内存进度条覆盖的问题
-- GC-`78e15d1`: 修复游戏设置中内存没有实时刷新的问题
+- GC-78e15d1: 修复游戏设置中内存没有实时刷新的问题
-- GC-`6f53da1`: 完善模组下载界面
+- GC-6f53da1: 完善模组下载界面

_changelogs/dev/3.6/3.6.11.266.md

@@ -10,6 +10,6 @@
 错误修复
 
 - GP-3252: 修复无法补全部分第三方 Minecraft 客户端游戏资源的问题
-- GC-`56d20a5`, GC-`397edae`: 修复 Linux 平台调整窗口大小的问题
+- GC-56d20a5, GC-397edae: 修复 Linux 平台调整窗口大小的问题
 - GP-3531: 修复在 FreeBSD x86-64 平台未正确替换 LWJGL 本地库的问题
 - GP-3541: 修复安装 MultiMC 整合包后没有设置图标的问题

_changelogs/dev/3.6/3.6.11.267.md

@@ -12,4 +12,4 @@
 - GP-3594: Java 下载对话框中切换包类型时不应重置版本字段
 - GP-3598: 修复使用自定义字体时未正确设置字重的问题
 - GP-3602: 修复使用系统 GLFW/OpenAL 时无法启动部分游戏版本的问题
-- GC-`ecafc9d`: 修复安装新游戏页面中组件框的高度问题
+- GC-ecafc9d: 修复安装新游戏页面中组件框的高度问题

_changelogs/dev/3.9/3.9.0.313.md

@@ -0,0 +1,30 @@
+---
+---
+
+详细版本介绍: [cv44304232](https://www.bilibili.com/opus/1148005940364050466)
+
+- GP-4992: 将 authlib-injector 更新至 1.2.7 (by Burning_TNT)
+- GP-4144: 添加输出游戏调试日志选项 (by 辞庐)
+- GP-4475: 添加资源包管理功能 (by 辞庐)
+- GP-4899, GP-4903, GP-4912, GP-4910, GP-4947, GP-4943, GP-4948, GP-4952, GP-4953: 优化深色模式支持 (by Glavo, Wulian233)
+- GP-4915: 在 HintPane 提示框中为图标和文本添加间距 (by neveler)
+- GP-4917: 适配 Minecraft 新版本号规则 (by Glavo)
+- GP-4911, GP-4963: 添加对 1.21.11_unobfuscated 及其预发布版的支持 (by mineDiamond)
+- GP-4854: 更新 `TableView` 的样式 (by Calboot)
+- GP-4951: 更新 `JFXComboBox` 下拉菜单滚动条的样式 (by Glavo)
+- GP-4964: 将 `TableView` 中的 `CheckBox` 替换为 JFXCheckBox (by Glavo)
+- GP-4581: 在日志中记录显示器信息 (by Glavo)
+- GP-4866: 在 `DownloadListPage` 中添加图标缓存 (by Glavo)
+- GP-4990: 支持下载 Java 25 (by OrzMiku)
+- GP-4916: 在陶瓦联机界面启动游戏时禁用离线皮肤功能 (by Glavo)
+- GP-4985: 在低于 JavaFX 23 的情况下隐藏主题模式跟随系统选项 (by Glavo)
+
+错误修复:
+
+- GP-4895: 修复模组更新列表界面按 esc 无法正确退出的问题 (by Calboot)
+- GP-4913: 修复 `ManagedProcess#getLines` 完成后不会解除锁定的问题 (by Glavo)
+- GP-4949: 修复从 BMCLAPI 下载部分旧文件时校验失败的问题 (by Glavo)
+- GP-4935: 修复本地安装新版本 Forge 时未移除版本号中 `forge-` 前缀的问题 (by 辞庐)
+- GP-4946: 修复模组管理页面中 OptiFine HD U G6 pre1 与 CurseForge 上的无关模组相关联的问题 (by Burning_TNT)
+- GP-4945: 修复无法识别部分 Forge/NeoForge 模组的问题 (by Burning_TNT)
+- GP-5002: 修复无法解析类似 "26.1 Snapshot 1" 的版本号的问题 (by Glavo)

_changelogs/stable/3.10/3.10.1.md

@@ -0,0 +1,90 @@
+---
+---
+
+[详细版本介绍 (Bilibili)](https://www.bilibili.com/opus/1158118032843735049)
+
+**启动器**
+
+- GP-4289: 在添加游戏目录页面选择目录时自动填写名称 (by Dime, 辞庐, Glavo)
+- GP-4882: 取消部分控件的连点限制 (by 辞庐)
+- GP-5024: 使用副标题显示重启生效提示 (by neveler)
+- GP-5032: 优化文本输入对话框体验 (by mineDiamond)
+- GP-5035: 在非 Windows 平台也将文件名中的 `:` 视为非法字符 (by 辞庐)
+- GP-5056: 优化列表滚动时的性能 (by Glavo)
+- GP-5060: 优化独立窗口中对话框的样式 (by 辞庐)
+- GP-5062: 更新 NBT 标签图标 (by mineDiamond)
+- GP-5077: 优化设置页面内边距 (by neveler)
+- GP-5082: 更新关于页面的版权年份至 2026 (by 辞庐)
+- GP-5087: 更新启动按钮分隔符颜色 (by neveler)
+- GP-5088: 首页切换实例菜单仅在菜单高度大于最大高度时显示垂直滚动条 (by neveler)
+- GP-5101: 在进度指示器中添加圆角 (by 辞庐)
+- GP-5107: 使切换按钮垂直居中对齐 (by 辞庐)
+- GP-5108: 优化打包日志逻辑 (by 辞庐)
+- GP-5114: 优化部分页面的布局效果 (by neveler)
+- GP-5129: 优化输入框校验逻辑 (by 辞庐, Glavo)
+- GP-5150: 调整平滑滚动的截止速度 (by Glavo)
+- GP-5143, GP-5168: 优化对获取账号信息时发生 SSL 异常的处理 (by Xirren, 3gf8jv4dv)
+- GP-5182: 支持重置日志字体 (by 辞庐)
+- GP-5188: 仅在左键点击时触发 `JFXRippler` 波纹 (by Glavo)
+**实例管理**
+
+- GP-5059: 调整实例管理页面“浏览”菜单中条目的顺序 (by 3gf8jv4dv)
+- GP-5137: 允许重命名实例时使用原名 (by mineDiamond)
+- GP-5174: 优化存在大量实例的情况下的实例列表性能 (by Glavo)
+**模组管理**
+
+- GP-4832: 支持更新选中的模组 (by ZZZank)
+- GP-5016: 刷新模组列表不滚动到顶部 (by OrzMiku)
+**世界管理**
+
+- GP-4823: 优化世界管理界面和世界信息界面 (by mineDiamond, 3gf8jv4dv)
+- GP-5162: 优化存在大量数据包的情况下数据包管理页面的性能 (by mineDiamond)
+- GP-5224: 优化存在大量世界的情况下世界管理页面的性能 (by Glavo)
+**整合包**
+
+- GP-4897: 导出整合包时隐藏系统资源文件 (by Calboot)
+- GP-5119: 安装 Modrinth 整合包时下载图标 (by Glavo)
+**账户**
+
+- GP-4794: 优化微软登录页面 (by 辞庐, 3gf8jv4dv)
+**下载**
+
+- GP-5026: 限制访问 CurseForge/Modrinth 时的并发数 (by Burning_TNT)
+- GP-5180: 在资源包下载页面中隐藏不必要的标签 (by Glavo)
+- GP-5160: 优化下载页面中来自 Modrinth 的内容标签显示 (by ENC_Euphony)
+- GP-5211: 优化下载页面图标缓存功能 (by Glavo)
+**联机**
+
+- GP-4929: 将陶瓦联机更新至 0.4.1 (by Burning_TNT)
+**本地化**
+
+- 优化软件文案，修订翻译 (by 3gf8jv4dv)
+**错误修复**
+
+- GP-5034: 修复下载光影时对话框的标题文字错误的问题 (by Wulian233)
+- GP-5043: 修复导出整合包有关以及 NBT 文件查看有关的界面样式及深色模式问题 (by Calboot)
+- GP-5064: 修复弹出菜单在 HiDPI 显示器上播放动画过程中内容 Y 轴方向缩放异常的问题 (by Glavo)
+- GP-5076: 优化不透明度滑块未垂直居中的问题 (by neveler)
+- GP-5080: 修复外置登录对话框在部分情况下未正确验证用户名的问题 (by Glavo)
+- GP-5081: 修复无法读取 `AppliedE` 模组信息的问题 (by Glavo)
+- GP-5086: 修复安装游戏时选择加载器版本后返回动画方向不正确的问题 (by 辞庐)
+- GP-5091: 修复部分版本无法正确归一化的问题 (by mineDiamond)
+- GP-5102: 修复文本输入框的上下文菜单未使用 MD3 色彩系统的问题 (by Glavo)
+- GP-5111: 修复复制游戏实例相关问题 (by 辞庐)
+- GP-5112: 修复添加实例目录页面有一个空 Tooltip 的问题 (by 辞庐)
+- GP-5117: 修复离线换肤对话框提示栏和按钮重叠的问题 (by NoClassDefFoundError)
+- GP-5118: 修复部分平台弹出菜单无法通过点击侧边栏收起的问题 (by 辞庐)
+- GP-5131: 修复缓存目录设置进入时默认未勾选的问题 (by 辞庐)
+- GP-5133: 修复第三方构建下禁用账户刷新的 tooltip 展示不支持的超链接标签的问题 (by Wulian233, 3gf8jv4dv)
+- GP-5144: 修复 `FetchTask` 未捕获部分异常的问题 (by Glavo)
+- GP-5146, GP-5148, GP-5151: 修复无法读取部分包含特殊字符的整合包的问题 (by Glavo)
+- GP-5153: 修复窗口重新获取焦点时 `JFXRadioButton` 显示阴影的问题 (by Glavo)
+- GP-5166: 修复未下载陶瓦联机时打开陶瓦联机页面抛出异常的问题 (by Glavo)
+- GP-5167: 修复游戏设置中 Java 路径过长时可能与 Java 版本号标签冲突的问题 (by ENC_Euphony)
+- GP-5170: 修复无法安装 `Aether Enhanced` 整合包的问题 (by 3gf8jv4dv)
+- GP-5178: 修复窗口重新获取焦点时 `JFXButton` 意外地显示阴影的问题 (by Glavo)
+- GP-5179: 修复窗口重新获取焦点时 `JFXCheckBox` 意外地显示阴影的问题 (by Glavo)
+- GP-5183: 修复重置字体后未遵循 `hmcl.font.override`/`HMCL_FONT` 设置的问题 (by 辞庐, Glavo)
+- GP-5184: 修复安装页面选择模组加载器按钮波纹没有正常显示的问题 (by 辞庐, Glavo)
+- GP-5186: 修复弹出菜单在 Windows HiDPI 显示器上异常模糊的问题 (by 辞庐)
+- GP-5197: 修复默认窗口大小下进入高级版本设置会向下滚动一段距离的问题 (by 辞庐)

_changelogs/stable/3.10/3.10.2.md

@@ -0,0 +1,17 @@
+---
+---
+
+[详细版本介绍 (Bilibili)](https://www.bilibili.com/opus/1162953401517998137)
+
+- 世界管理
+  - GP-5198: 将世界管理界面“生成启动脚本”按钮折叠到二级菜单 (by Glavo)
+- 错误修复
+  - GP-5239: 修复下载页面滚动时图标未及时更新的问题 (by Glavo)
+  - GP-5243: 修复实例列表中可能意外出现水平滚动条的问题 (by OrzMiku)
+  - GP-5251: 修复自动安装界面卡片上按钮无法点击的问题 (by OrzMiku)
+  - GP-5257: 修复 Cleanroom 本地安装完成后会删除安装器的问题 (by 辞庐)
+  - GP-5261: 修复下载页面选择游戏版本对话框包含 `_unobfuscated` 版本的问题 (by Glavo)
+  - GP-5262: 修复使用 GIF 背景时调整背景不透明度导致启动器崩溃的问题 (by Glavo)
+  - GP-5267: 修复 Unzipper 解压空 zip 文件时抛出异常的问题 (by Glavo)
+  - GP-5305: 修复返回页面时可能卡进空白页面的问题 (by 辞庐)
+  - GP-5310: 修复点击实例列表条目的中央区域无法触发涟漪效果的问题 (by 辞庐)

_changelogs/stable/3.10/3.10.3.md

@@ -0,0 +1,7 @@
+---
+---
+
+[详细版本介绍 (Bilibili)](https://www.bilibili.com/opus/1167780910401060864)
+
+- 联机
+  - GP-5504: 修复陶瓦联机无法正常使用的问题 (by Glavo)

_changelogs/stable/3.10/3.10.4.md

@@ -0,0 +1,10 @@
+---
+---
+
+[详细版本介绍 (Bilibili)](https://www.bilibili.com/opus/1171507155298156547)
+
+- 错误修复
+  - GP-5265: 修复未正确为游戏设置 `java.net.useSystemProxies` JVM 参数的问题 (by Xirren)
+  - GP-5508: 修复部分请求头中 `Accept-Language` 字段包含 Java 版本的问题 (by Glavo)
+  - GP-5550: 修复安装整合包时任务弹窗可能空白的问题 (by 辞庐)
+  - GP-5585: 修复下载源失效时刷新版本列表不会回退到备用下载源的问题 (by Glavo)

_changelogs/stable/3.11/3.11.1.md

@@ -0,0 +1,87 @@
+---
+---
+
+[详细版本介绍 (Bilibili)](https://www.bilibili.com/opus/1169614354625069063)
+
+**启动器**
+
+- GP-5391: 将 XZ for Java 更新至 1.11 (by Glavo)
+- GP-5390: 将 TwelveMonkeys 更新至 3.13.0 (by Glavo)
+- GP-5392: 将 Gradle Shadow 插件更新至 9.3.1 (by Glavo)
+- GP-4733: 导出日志时允许重名文件 (by Glavo)
+- GP-5172: 支持通过拖动标题栏退出最大化 (by neveler)
+- GP-5259, GP-5272: 优化非法路径检查 (by 辞庐)
+- GP-5273: 优化游戏代理参数设置 (by Glavo)
+- GP-5274: 对 Java 26 默认启用压缩对象头 (by Glavo)
+- GP-5364: 在 NBT 查看器页面启用平滑滚动 (by Glavo)
+- GP-5426: 导出运行栈时附加 `-e` 和 `-l` 参数 (by 辞庐)
+- GP-5462: 未安装实例时点击主页“开始游戏”按钮不选择不支持当前平台的版本 (by 辞庐, Glavo)
+- GP-5467: 自动展开 NBT 查看器中部分子标签 (by Calboot)
+- GP-5527: 增加弹窗图标与内容间距 (by 辞庐)
+**游戏设置**
+
+- GP-4975: 调整渲染器名称 (by Chen Meng)
+**模组管理**
+
+- GP-5029: 优化检查模组更新功能 (by Burning_TNT)
+- GP-5196: 使用 Forge/Quilt 加载器时模组管理页面应当扫描子文件夹 (by Wulian233)
+- GP-5296: 扫描模组子目录时忽略 `.connector` 文件夹 (by 辞庐)
+**世界管理**
+
+- GP-5215: 优化世界管理与世界信息页面 (by mineDiamond, 3gf8jv4dv, Glavo)
+**账户**
+
+- GP-5330, GP-5531, GP-5538: 优化微软登录流程，更新微软账户登录对话框 (by 辞庐, 3gf8jv4dv, Glavo)
+**下载**
+
+- GP-4792: 优化 Fabric API / Quilt API 安装提示 (by 辞庐, 3gf8jv4dv)
+- GP-5090: 支持 Legacy Fabric 自动安装 (by 辞庐)
+- GP-5250: Modrinth 默认不获取更新日志 (by Calboot)
+- GP-5304: 取消游戏下载页面中高版本游戏对 Windows 7/8/8.1 的不兼容提示 (by 辞庐)
+- GP-5394: Java 下载页面支持选择多个 Java 版本下载 (by NoClassDefFoundError, Glavo)
+- GP-5465, GP-5474: 优化下载页面条目中标签的展示方式 (by Glavo)
+**外观**
+
+- GP-5279: 更新下载页面条目样式 (by Glavo)
+- GP-5283, GP-5317, GP-5319: 优化深色模式支持 (by Glavo)
+- GP-5292, GP-5398: 更新文本输入框的右键菜单样式 (by 辞庐)
+- GP-5337: 使用 `LineSelectButton` 代替 `JFXComboBox` (by Glavo)
+- GP-5368: 自定义颜色对话框添加输入验证，阻止输入非法信息 (by WhatDamon)
+- GP-5395, GP-5408, GP-5416, GP-5446: 统一列表卡片样式 (by Glavo)
+- GP-5405: 统一加载指示器大小 (by 辞庐)
+- GP-5406: 统一实例管理页面子页面刷新时的样式 (by 辞庐)
+- GP-5422: 优化日志窗口无日志行的背景色 (by 辞庐)
+- GP-5456: 优化工具栏按钮图标 (by Glavo)
+- GP-5481: 优化设置页面检查更新设置项的样式 (by Glavo)
+**本地化**
+
+- 优化软件文案，修订简繁英翻译，清理过时翻译 (by 3gf8jv4dv)
+**错误修复**
+
+- GP-5012: 修复 Modrinth 模组依赖已经被删除的条目时无法加载版本列表的问题 (by Burning_TNT)
+- GP-5195: 修复导出 Modrinth 整合包时勾选“包含启动器”选项时导出的整合包不是 ZIP 格式的问题 (by 辞庐)
+- GP-5245: 修复主页公告阴影被裁切的问题 (by 辞庐)
+- GP-5265: 修复系统代理 JVM 参数格式 (by Xirren)
+- GP-5284: 修复部分列表页面出现横向滚动条的问题 (by Glavo)
+- GP-5299: 修复添加认证服务器对话框非 CJK 语言下宽度异常的问题 (by 辞庐)
+- GP-5300: 修复下载页面模组简介只会显示一行的问题 (by 辞庐)
+- GP-5308: 修复 `JFXTabPane` 指示器偏移的问题 (by 辞庐)
+- GP-5328: 修复弹出菜单在 RTL 布局下弹出位置错误的问题 (by 辞庐)
+- GP-5333: 修复启动服务端自动更新整合包时会下载并启用已禁用的模组的问题 (by Luo Chen)
+- GP-5369: 修复在 ZIP 文件中遇到重名目录条目时读取失败的问题 (by NoClassDefFoundError)
+- GP-5374: 修复不透明度数值标签可能被折叠的问题 (by NoClassDefFoundError)
+- GP-5375: 修复部分列表点击后无法通过 Esc 返回的问题 (by NoClassDefFoundError)
+- GP-5379: 修复版本设置页面滚动条总是显示的问题 (by Dime)
+- GP-5388: 修复导出的 PowerShell 脚本中路径可能无效的问题 (by Xirren)
+- GP-5411: 修复离线账户换肤对话框中对 Custom Skin API 地址的校验未生效的问题 (by 辞庐)
+- GP-5423: 修复安装游戏时选择版本后返回已选择的版本会被清除的问题 (by 辞庐)
+- GP-5432: 修复部分页面弹出菜单会被重复触发的问题 (by Glavo)
+- GP-5433: 修复部分环境中进入下载页面时启动器崩溃的问题 (by Glavo)
+- GP-5434: 修复日志级别选择按钮背景颜色溢出的问题 (by 辞庐)
+- GP-5449: 修复 SVG 图标对齐错误的问题 (by Glavo)
+- GP-5477: 修复部分页面意外的显示滚动条的问题 (by Glavo)
+- GP-5479: 修复无法正确识别 Minecraft 2.0 实例版本号的问题 (by Glavo)
+- GP-5480: 修复无法归一化版本号 "1.16.2 Pre-release 1" 的问题 (by Glavo)
+- GP-5508: 修复部分请求头中 Accept-Language 字段包含 Java 版本的问题 (by Glavo)
+- GP-5520: 下载游戏版本列表点击左侧图标无法触发水波纹效果、光标没有变成手型的问题 (by 辞庐)
+- GP-5522: 修复安装卡片部分区域点击无法触发水波纹效果的问题 (by 辞庐)

_changelogs/stable/3.11/3.11.2.md

@@ -0,0 +1,13 @@
+---
+---
+
+[详细版本介绍 (Bilibili)](https://www.bilibili.com/opus/1173336042553475112)
+
+- 账户
+  - GP-5610: 优化设备代码流登录流程 (by Glavo)
+- 错误修复
+  - GP-5550: 修复安装整合包时任务弹窗可能空白的问题 (by 辞庐)
+  - GP-5549: 修复微软登录报错的超链接显示 (by Xirren)
+  - GP-5584: 修复打开登录微软对话框时加载指示器一闪而过的问题 (by 辞庐)
+  - GP-5585, GP-5602: 修复下载源失效时刷新版本列表不会回退到备用下载源的问题 (by Glavo)
+  - GP-5575: 修复无法使用授权代码流登录微软账户的问题 (by 辞庐)

_changelogs/stable/3.12/3.12.1.md

@@ -0,0 +1,76 @@
+---
+---
+
+[详细版本介绍 (Bilibili)](https://www.bilibili.com/opus/1181883220765966343)
+
+- 启动器
+  - GP-4706: 添加"关闭启动时的更新弹窗"选项 (by An5w1r, Glavo)
+  - GP-5583, GP-5624: 支持在 FreeBSD x86-64、Linux Arm64、Linux LoongArch64 和 Linux RISC-V64 平台上启动 Minecraft 26.1-snapshot-8 及更高版本 (by Glavo)
+  - GP-5586: 优化无法补全 JavaFX 时的报错信息 (by Glavo)
+  - GP-5631: 重启 HMCL 时继承所有 JVM 参数 (by 辞庐, Glavo)
+  - GP-5655: 添加对 `1.21.11-rc3_unobfuscated` 的支持 (by TNTyep520, Glavo)
+  - GP-5697: 导出 BAT 脚本时将单行长度限制放宽至 32767 字符 (by 辞庐)
+  - GP-5759: 为主页启动按钮添加冷却时间 (by Glavo)
+  - GP-5773: 更新模组和整合包数据 (by Glavo)
+  - GP-5791: 支持愚人节模式 (by Glavo)
+- 实例管理
+  - GP-5242: 支持在实例列表页面搜索实例 (by 辞庐, Zkitefly)
+- 游戏设置
+  - GP-5514: 为渲染器设置项添加描述 (by Damon Lu)
+  - GP-5638: 切换版本隔离设置后自动刷新其他子页面 (by 辞庐)
+- 世界管理
+  - GP-5552: 支持新版本世界指定资源包位置 (by mineDiamond)
+  - GP-5652: 在世界管理页面隐藏 `.zip` 格式的世界 (by Wulian233)
+  - GP-5675: 支持读取 26.1-snapshot-6 及更高版本的存档数据 (by mineDiamond)
+- 整合包
+  - GP-5710: 导出 Modrinth 整合包时不再要求填写作者 (by MovTery)
+- 外观
+  - GP-5521: 优化下载页面条目水波纹样式 (by 辞庐)
+  - GP-5554: 向图标添加圆角 (by Dime)
+  - GP-5565, GP-5800, GP-5803, GP-5804: 更新进度条和进度指示器样式 (by Glavo)
+  - GP-5636: 支持在 `LineSelectButton` 弹出菜单中使用键盘上下键进行选择 (by 辞庐)
+  - GP-5663: 调整导出游戏运行栈加载指示器大小 (by 辞庐)
+  - GP-5664: 优化“删除”按钮的图标 (by 辞庐)
+  - GP-5690: 优化文件选择器按钮样式 (by 辞庐)
+  - GP-5707: 优化 `LineSelectButton` 弹出菜单中标签的配色 (by 辞庐)
+  - GP-5716: 向滚动条添加圆角 (by Calboot)
+  - GP-5760: 优化 `JFXToggleButton` 的配色 (by Glavo)
+  - GP-5769: 当背景自定义路径是文件夹时随机在文件夹中选取图片作为背景 (by 辞庐)
+  - GP-5805: 平滑进度条 (by Glavo)
+- 下载
+  - GP-5030, GP-5798: 重新启用 MCIM 加速 (by Glavo)
+  - GP-5313: 支持从 CurseForge 下载光影 (by 辞庐)
+  - GP-5458, GP-5463: 使下载界面简介不滚动 (by Calboot)
+  - GP-5603: 下载文件失败时在重试前添加等待延迟 (by Glavo)
+  - GP-5698: 优化实例默认实例名称 (by 辞庐)
+  - GP-5739: 移除下载页面超链接多余 Tooltip (by 辞庐)
+- 本地化
+  - GP-5714: 更新阿拉伯语翻译 (by Hommam-Prom)
+  - 优化软件文案，修订翻译 (by 3gf8jv4dv, 辞庐)
+- 错误修复
+  - GP-4876: 修复 macOS 平台上空闲内存识别错误的问题 (by Damon Lu, Glavo)
+  - GP-5359: 修复语言为文言时下载游戏的选择模组加载器页面的版本号未本地化的问题 (by Wulian233)
+  - GP-5430: 修复启动游戏补全文件时，任务没有正确归类的问题 (by 辞庐, Glavo)
+  - GP-5532: 修复高分屏下新建账户标签页文字模糊的问题 (by 辞庐)
+  - GP-5536: 修复更新整合包后模组加载器版本号不会及时更新的问题 (by 小宇)
+  - GP-5539: 修复解析 Yggdrasil 服务器地址时不遵循重定向的问题 (by Glavo)
+  - GP-5556: 修复通过 CurseForge/Modrinth 安装整合包时可以返回到整合包类型选择页面的问题 (by 辞庐)
+  - GP-5558: 修复光影下载搜索栏中错误地显示“支持中英文搜索”提示的问题 (by 辞庐)
+  - GP-5581: 修复日志窗口中复制日志时会在主窗口中显示提示的问题 (by 辞庐)
+  - GP-5600: 修复部分对话框中取消按钮行为异常的问题 (by 辞庐)
+  - GP-5605: 修复选择角色弹窗未适配深色模式的问题 (by 辞庐)
+  - GP-5607: 修复账号列表复制 UUID 按钮样式异常的问题 (by 辞庐)
+  - GP-5633: 修复部分弹窗标题未本地化的问题 (by 辞庐)
+  - GP-5659: 修复不支持导出游戏运行栈的提示未正确展示的问题 (by 辞庐)
+  - GP-5662: 修复无法导出使用 Java 11 启动的游戏进程的运行栈的问题 (by 辞庐)
+  - GP-5669: 修复无法导入部分 Modrinth 整合包的问题 (by 辞庐)
+  - GP-5691: 修复安装整合包界面实例名称重复提示显示不全的问题 (by 辞庐)
+  - GP-5693: 修复 `SpinnerPane` 会裁切元素的问题 (by 辞庐)
+  - GP-5705: 修复手动取消模组更新检查时会弹窗提示操作失败的问题 (by 辞庐)
+  - GP-5706: 修复 `LineComponent` 副标题样式未正确应用 (by 辞庐)
+  - GP-5728: 修复“从互联网下载整合包”选项对话框可能会意外被关闭的问题 (by Glavo)
+  - GP-5737: 修复运行路径中包含非法字符 `=` 时的提示 (by 辞庐)
+  - GP-5765, GP-5810: 修复无法归一化 26.1 的预发布版和发布候选版本号的问题 (by mineDiamond)
+  - GP-5772: 修复 Windows 平台 125% 缩放的屏幕上弹出菜单内容模糊的问题 (by 辞庐)
+  - GP-5776: 修复颜色选择器中“自定义颜色”对话框初始值不会与当前颜色同步的问题 (by Damon Lu)
+  - GP-5782: 修复对高版本 Cleanroom 选择的 Java 版本错误的问题 (by 辞庐, Glavo)

_changelogs/stable/3.12/3.12.2.md

@@ -0,0 +1,14 @@
+---
+---
+
+[详细版本介绍 (Bilibili)](https://www.bilibili.com/opus/1183364799797395474)
+
+- 启动器
+  - GP-5833: 优化对 26.1 正式版/预发布版/候选版的支持 (by Glavo)
+- 下载
+  - GP-5841: 将 Java 下载页面默认 Java 版本更新至 Java 25 (by Glavo)
+- 本地化
+  - GP-5845: 更新文言文翻译 (by Glavo)
+- 错误修复
+  - GP-5839: 修复文本框导致 GPU 占用率异常高的问题 (by Glavo)
+

_changelogs/stable/3.12/3.12.4.md

@@ -0,0 +1,15 @@
+---
+---
+
+[详细版本介绍 (Bilibili)](https://www.bilibili.com/opus/1188175055790538753)
+
+**启动器**
+
+- GP-5870, GP-5873, GP-5874, GP-5882: 优化 Minecraft 26.1 性能 (by Glavo, 3gf8jv4dv) [BV1mPXSBEEBx](https://www.bilibili.com/video/BV1mPXSBEEBx)
+- GP-5892: 优化对 26w14a 愚人节版本的支持，更新模组下载页游戏版本列表至 26.1.1 (by Glavo)
+**世界管理**
+
+- GP-5860: 种子地图、要塞地图、下届要塞地图和末地城地图支持 26.1 (by Glavo,neveler)
+**错误修复**
+
+- GP-5910: 修复无法为 Minecraft 26.1.1 从官方源安装 NeoForge 的问题 (by Glavo, Burning_TNT)

_changelogs/stable/3.13.1/README.md

@@ -0,0 +1,73 @@
+---
+---
+
+[详细版本介绍 (Bilibili)](https://www.bilibili.com/opus/1192242668981190663)
+
+**启动器**
+
+- GP-5851: 将 kala-compress 更新至 1.27.1-3 (by Glavo)
+- GP-5854: 将 twelvemonkeys 更新至 3.13.1 (by Glavo)
+- GP-5883: 将 XZ for Java 更新至 1.12 (by Glavo)
+- GP-4716: 优化 Java 信息识别功能 (by Glavo)
+- GP-5316: 更新 AMD 显卡信息数据 (by 辞庐, Glavo)
+- GP-5518: 在 Wine 环境中启动时发出警告 (by Damon Lu)
+- GP-5667: 优化 NBT 读取功能 (by Glavo)
+- GP-5660: 在游戏进程结束后禁用“结束游戏进程”与“导出游戏运行栈”按钮 (by 辞庐)
+- GP-5694: 为游戏崩溃界面导出和启动器日志导出添加加载指示器 (by 辞庐)
+- GP-5702: 优化标签的展示逻辑 (by 辞庐)
+- GP-5703: 更新更新渠道选择选项 (by 辞庐, 3gf8jv4dv, Glavo)
+- GP-5730: 支持通过版本 json 安装实例 (by 辞庐, Glavo)
+- GP-5738: 为在临时目录中启动 HMCL 时弹出的提示对话框添加 5 秒倒计时 (by 辞庐)
+- GP-5879: 安装模组时检查文件是否已存在 (by 辞庐)
+- GP-5880: 优化手动更新 URL (by Xirren)
+- GP-5923: 优化原理图管理和世界界面中部分输入框的校验方式 (by 辞庐)
+- GP-5928: 支持在 FreeBSD x86-64、Linux Arm64、Linux LoongArch64 和 Linux RISC-V64 平台上启动 Minecraft 26.2-snapshot-1+ (by Glavo)
+**游戏设置**
+
+- GP-5813: 将“不适用于当前系统的选项”的系统支持信息移到子标题 (by Damon Lu)
+- GP-5930, GP-5940: 支持设置 Vulkan 的渲染器 (by Glavo, 3gf8jv4dv) [BV1Nhd5B9ENc](https://www.bilibili.com/video/BV1Nhd5B9ENc)
+**账户**
+
+- GP-5949: 上传微软账户皮肤时校验图片尺寸 (by 辞庐)
+**整合包**
+
+- GP-5786, GP-5837: 安装 CurseForge 整合包时下载图标 (by Calboot)
+**外观**
+
+- GP-5484: 支持加载 SVG 图片 (by Glavo)
+- GP-5775: 为自定义颜色选择对话框添加确认和取消按钮 (by mineDiamond, Glavo)
+- GP-5829: 更新内存状态栏样式 (by Glavo)
+- GP-5830: 在颜色选择器中隐藏透明度值 (by neveler)
+- GP-5832, GP-5836: 为弹窗添加圆角 (by neveler)
+- GP-5861: 优化“关于”页面组件间距 (by neveler)
+- GP-5905: 优化组合框样式 (by Wulian233)
+- GP-5917: 优化组合框展开图标 (by 辞庐, Glavo)
+- GP-5924: 优化 Java 下载弹窗旋转指示器样式 (by 辞庐)
+- GP-5925: 优化添加认证服务器 http 警告颜色 (by 辞庐)
+- GP-5944: 优化菜单分隔符颜色 (by 辞庐, Glavo)
+- GP-5945: 增大自动安装界面加载器名称和版本号之间的间距 (by 辞庐)
+**下载**
+
+- GP-5601, GP-5899: 下载页面折叠快照 Minecraft 版本 (by 辞庐, Glavo, Calboot)
+- GP-5781: 支持设置游戏内容默认下载源 (by Calboot, Glavo, 3gf8jv4dv)
+- GP-5859: 增强 Java 下载功能可靠性 (by Glavo)
+- GP-5872: 优化下载页面依赖项展示 (by 辞庐)
+- GP-5934: 更新游戏内容下载页游戏版本列表至 26.1.2 (by Glavo)
+- GP-5946: 隐藏 CurseForge 源中游戏内容的不重要标签 (by 辞庐)
+**本地化**
+
+- GP-5931: 支持将新格式快照版本号翻译为文言 (by Glavo)
+- 优化软件文案，修订翻译 (by 3gf8jv4dv)
+**错误修复**
+
+- GP-5301: 修复清理游戏资源/库操作在 JavaFX 线程运行的问题 (by 辞庐)
+- GP-5609: 修复涟漪无法完整覆盖大型控件的问题 (by 辞庐)
+- GP-5688: 修复 Alex 模型皮肤 3D 预览手臂背后有一列侧面的异常像素的问题 (by 辞庐)
+- GP-5877: 修复弹窗过程中模糊 (by 辞庐)
+- GP-5888: 修复模组管理页面对于 1.20.1+NeoForge 实例会将部分 Forge 模组识别为 `MixinExtras` 的问题 (by Calboot)
+- GP-5911: 修复多次打开微软登录弹窗后报错的问题 (by Glavo)
+- GP-5914: 修复导入整合包界面箭头颜色错误的问题 (by Calboot)
+- GP-5915: 修复长按标题栏中部分按钮时可以拖动窗口的问题 (by 辞庐)
+- GP-5922: 修复安装整合包时部分任务未正确归类的问题 (by 辞庐)
+- GP-5935: 修复日志窗口中可能显示横向滚动条的问题 (by Glavo)
+- GP-5943: 修复模组名字过长时下载页面布局异常的问题 (by 辞庐)

_changelogs/stable/3.6/3.6.12.md

@@ -52,21 +52,21 @@
   - GP-3490: 修复 OAuth 登录时轮询过于频繁的问题
   - GP-3464: 修复在更新日志界面无法拖动启动器窗口的问题
   - GP-3503: 使用 Zink 渲染器时禁用 DRI3
-  - GC-`5fd52bb`: 皮肤缓存不再保存到 .minecraft 目录
+  - GC-5fd52bb: 皮肤缓存不再保存到 .minecraft 目录
-  - GC-`81b3911`: 修复按 ESC 键时文本框内的值没有保存的问题
+  - GC-81b3911: 修复按 ESC 键时文本框内的值没有保存的问题
-  - GC-`260f4b6`: 修复输入对话框中 ESC 键不起作用的问题
+  - GC-260f4b6: 修复输入对话框中 ESC 键不起作用的问题
-  - GC-`7d12ef6`: 修复内存滑块提示被设备内存进度条覆盖的问题
+  - GC-7d12ef6: 修复内存滑块提示被设备内存进度条覆盖的问题
-  - GC-`78e15d1`: 修复游戏设置中内存没有实时刷新的问题
+  - GC-78e15d1: 修复游戏设置中内存没有实时刷新的问题
-  - GC-`6f53da1`: 完善模组下载界面
+  - GC-6f53da1: 完善模组下载界面
   - GP-3252: 修复无法补全部分第三方 Minecraft 客户端游戏资源的问题
-  - GC-`56d20a5`, GC-`397edae`: 修复 Linux 平台调整窗口大小的问题
+  - GC-56d20a5, GC-397edae: 修复 Linux 平台调整窗口大小的问题
   - GP-3531: 修复在 FreeBSD x86-64 平台未正确替换 LWJGL 本地库的问题
   - GP-3541: 修复安装 MultiMC 整合包后没有设置版本图标的问题
   - GP-3549: 修复 macOS 平台 HMCLauncher.sh 不会显示 Java 下载页面的问题
   - GP-3594: Java 下载对话框中切换包类型时不应重置版本字段
   - GP-3598: 修复使用自定义字体时未正确设置字重的问题
   - GP-3602: 修复使用系统 GLFW/OpenAL 时无法启动部分游戏版本的问题
-  - GC-`ecafc9d`: 修复安装新游戏页面中组件框的高度问题
+  - GC-ecafc9d: 修复安装新游戏页面中组件框的高度问题
   - GP-3618: 修复无法识别 Intel64 架构的问题
   - GP-3626: 修复离线账户选择 Steve/Alex 皮肤时模型错误的问题
   - GP-3622: 修复在非官方支持的平台上 Minecraft 1.21 与 Sodium 不兼容的问题

_changelogs/stable/3.6/3.6.16.md

@@ -1,8 +1,10 @@
 ---
 ---
 
-- 启动器
+**启动器**
-    - GP-4262: 更新 AMD 显卡信息 (by Glavo)
+
-    - GP-4274: 更新 chunkbase 种子地图链接 (by Wulian233)
+- GP-4262: 更新 AMD 显卡信息 (by Glavo)
-- 错误修复：
+- GP-4274: 更新 chunkbase 种子地图链接 (by Wulian233)
-    - GP-4174: 修复无法从 BMCLAPI 下载部分 NeoForge 所需文件的问题 (by 辞庐)
+**错误修复：**
+
+- GP-4174: 修复无法从 BMCLAPI 下载部分 NeoForge 所需文件的问题 (by 辞庐)

_changelogs/stable/3.6/3.6.17.md

@@ -3,31 +3,37 @@
 
 版本介绍: [cv43005407](https://www.bilibili.com/opus/1111270122956259346)
 
-- 启动器
+**启动器**
-    - GP-4422: 弃用 Java 11 支持 (by Glavo)
+
-    - GP-4164: 支持通过环境变量强制使用 GPU 渲染和控制动画帧率 (by Glavo)
+- GP-4422: 弃用 Java 11 支持 (by Glavo)
-    - GP-4179: 在 `./.hmcl/java` 中搜索 Java (by Glavo)
+- GP-4164: 支持通过环境变量强制使用 GPU 渲染和控制动画帧率 (by Glavo)
-    - GP-4365: 修复首次打开子页面时切换动画丢失的问题 (by Glavo)
+- GP-4179: 在 `./.hmcl/java` 中搜索 Java (by Glavo)
-    - GP-4439: 更新模组和整合包数据 (by Glavo)
+- GP-4365: 修复首次打开子页面时切换动画丢失的问题 (by Glavo)
-    - GP-4414: 检测到配置文件由高版本启动器创建时禁止保存配置文件 (by Glavo)
+- GP-4439: 更新模组和整合包数据 (by Glavo)
-- 游戏管理
+- GP-4414: 检测到配置文件由高版本启动器创建时禁止保存配置文件 (by Glavo)
-    - GP-4224: 支持在 Windows 7/8/8.1 上使用软渲染器 (by Glavo)
+**游戏管理**
-- 下载
+
-    - GP-4170: 模组下载列表翻页后自动回到顶部 (by 辞庐)
+- GP-4224: 支持在 Windows 7/8/8.1 上使用软渲染器 (by Glavo)
-    - GP-4171: 支持加载 WebP 图标，解决部分模组/整合包图标无法加载的问题 (by Glavo)
+**下载**
-- 外观
+
-    - GP-4185: 新增内存显示条禁用样式 (by OrzMiku)
+- GP-4170: 模组下载列表翻页后自动回到顶部 (by 辞庐)
-- 本地化
+- GP-4171: 支持加载 WebP 图标，解决部分模组/整合包图标无法加载的问题 (by Glavo)
-    - GP-4376: 将“版本”重命名为“实例” (by 3gf8jv4dv)
+**外观**
-    - 优化软件文案，完善英语、西班牙语、俄语翻译
+
-- 错误修复
+- GP-4185: 新增内存显示条禁用样式 (by OrzMiku)
-    - GP-4121: 修复多次启动游戏时内存泄露的问题 (by roj234)
+**本地化**
-    - GP-4066: 修复游戏版本列表错误地过滤掉部分版本的问题 (by Wulian233)
+
-    - GP-4152: 修复导入异常格式的数据包时启动器崩溃的问题 (by Glavo)
+- GP-4376: 将“版本”重命名为“实例” (by 3gf8jv4dv)
-    - GP-4241: 修复非 Windows 平台上游戏进程的 `user.home` 可能被设置为 `null` 的问题 (by Glavo)
+- 优化软件文案，完善英语、西班牙语、俄语翻译
-    - GP-4437: 修复 backgroundType 为 `null` 时启动器崩溃的问题 (by Glavo)
+**错误修复**
-    - GP-4153: 修复“下载线程数”的指示器被提示覆盖的问题 (by 辞庐)
+
-    - GP-4238: 修复 `RemoteMod::getIntegrityCheck` 未选择正确的算法的问题 (by Glavo)
+- GP-4121: 修复多次启动游戏时内存泄露的问题 (by roj234)
-    - GP-4176: 修复整合包格式不匹配提示未被正确格式化的问题 (by 辞庐)
+- GP-4066: 修复游戏版本列表错误地过滤掉部分版本的问题 (by Wulian233)
-    - GP-4321: 世界管理页面添加对极限模式的支持 (by Wulian233)
+- GP-4152: 修复导入异常格式的数据包时启动器崩溃的问题 (by Glavo)
-    - GP-4192: 修复 LWJGL 路径显示错误的问题 (by 辞庐)
+- GP-4241: 修复非 Windows 平台上游戏进程的 `user.home` 可能被设置为 `null` 的问题 (by Glavo)
+- GP-4437: 修复 backgroundType 为 `null` 时启动器崩溃的问题 (by Glavo)
+- GP-4153: 修复“下载线程数”的指示器被提示覆盖的问题 (by 辞庐)
+- GP-4238: 修复 `RemoteMod::getIntegrityCheck` 未选择正确的算法的问题 (by Glavo)
+- GP-4176: 修复整合包格式不匹配提示未被正确格式化的问题 (by 辞庐)
+- GP-4321: 世界管理页面添加对极限模式的支持 (by Wulian233)
+- GP-4192: 修复 LWJGL 路径显示错误的问题 (by 辞庐)

_changelogs/stable/3.6/3.6.18.md

@@ -3,9 +3,11 @@
 
 版本介绍: [cv43162536](https://www.bilibili.com/opus/1116529228834144258)
 
-- 游戏管理
+**游戏管理**
-    - GP-4515: 优化 Java 自动选择规则 (by Glavo)
+
-- 错误修复
+- GP-4515: 优化 Java 自动选择规则 (by Glavo)
-    - GP-4508: 修复使用 JavaFX 25 时游戏下载界面布局错误的问题 (by Glavo)
+**错误修复**
-    - GP-4465: 修复启用代理身份认证且未设置密码时启动器崩溃的问题 (by Glavo)
+
-    - GP-4466: 修复滚动切换游戏实例/账户功能 (by Glavo)
+- GP-4508: 修复使用 JavaFX 25 时游戏下载界面布局错误的问题 (by Glavo)
+- GP-4465: 修复启用代理身份认证且未设置密码时启动器崩溃的问题 (by Glavo)
+- GP-4466: 修复滚动切换游戏实例/账户功能 (by Glavo)

_changelogs/stable/3.6/3.6.20.md

@@ -1,12 +1,14 @@
----
+---
----
+---
-
+
-版本介绍: [cv43348716](https://www.bilibili.com/opus/1123235936240402439)
+版本介绍: [cv43348716](https://www.bilibili.com/opus/1123235936240402439)
-
+
-- 启动器
+**启动器**
-    - GP-4223: 在“设置 > 通用”添加“提前预览 HMCL 版本”选项 (by Glavo)<br>
+
-      详情请见完整更新日志: [cv43348716](https://www.bilibili.com/opus/1123235936240402439)
+- GP-4223: 在“设置 > 通用”添加“提前预览 HMCL 版本”选项 (by Glavo)<br>
-    - GP-4088: 当离线账户名称超过 16 字符时弹出警告 (by ShulkerSakura)
+  详情请见完整更新日志: [cv43348716](https://www.bilibili.com/opus/1123235936240402439)
-- 下载
+- GP-4088: 当离线账户名称超过 16 字符时弹出警告 (by ShulkerSakura)
-    - GP-4120: 更新 unlisted-versions-of-minecraft 镜像源地址 (by 8Mi_Yile)
+**下载**
-    - GP-4626: 更新模组下载页游戏版本列表至 1.21.10 (by Glavo)
+
+- GP-4120: 更新 unlisted-versions-of-minecraft 镜像源地址 (by 8Mi_Yile)
+- GP-4626: 更新模组下载页游戏版本列表至 1.21.10 (by Glavo)

_changelogs/stable/3.7/3.7.5.md

@@ -3,10 +3,13 @@
 
 详细版本介绍: [cv43648491](https://www.bilibili.com/opus/1132495430464045104)
 
-- 启动器
+**启动器**
-    - GP-4742: 更新 Chunkbase 种子地图链接 (by Wulian233)
+
-- 联机
+- GP-4742: 更新 Chunkbase 种子地图链接 (by Wulian233)
-    - GP-4723: 将陶瓦联机更新至 0.3.13 (by Burning_TNT)
+**联机**
-    - GP-4735: 在不支持的平台上打开陶瓦联机页面时弹出提示 (by Glavo)
+
-- 错误修复
+- GP-4723: 将陶瓦联机更新至 0.3.13 (by Burning_TNT)
-    - GP-4736: 修复 FreeBSD x86-64 平台上错误的将所有版本视作未经测试的版本的问题 (by Glavo)
+- GP-4735: 在不支持的平台上打开陶瓦联机页面时弹出提示 (by Glavo)
+**错误修复**
+
+- GP-4736: 修复 FreeBSD x86-64 平台上错误的将所有版本视作未经测试的版本的问题 (by Glavo)

_changelogs/stable/3.7/3.7.6.md

@@ -3,16 +3,19 @@
 
 详细版本介绍: [cv43836292](https://www.bilibili.com/opus/1138359439513878544)
 
-- 下载
+**下载**
-    - GP-4767: 添加对 25w45a_unobfuscated 的支持 (by Glavo)
-    - GP-4782: 添加对 25w46a_unobfuscated 的支持 (by Glavo)
-    - GP-4829: 添加对 1.21.11-pre1/2_unobfuscated 的支持 (by mineDiamond)
-    - GP-4841: 更新 HMCL 元数据链接 (by Glavo)
 
-- 联机
+- GP-4767: 添加对 25w45a_unobfuscated 的支持 (by Glavo)
-    - GP-4816: 更新陶瓦联机用户须知 (by Glavo)
+- GP-4782: 添加对 25w46a_unobfuscated 的支持 (by Glavo)
-    - GP-4838: 将陶瓦联机更新至 0.3.14 (by Burning_TNT)
+- GP-4829: 添加对 1.21.11-pre1/2_unobfuscated 的支持 (by mineDiamond)
+- GP-4841: 更新 HMCL 元数据链接 (by Glavo)
 
-- 错误修复
+**联机**
-    - GP-4795: 修复初次打开部分页面时页面闪烁的问题 (by Glavo)
+
-    - GP-4808: 修复 Windows 下全局设置中本地库路径路径分隔符显示错误的问题 (by 辞庐)
+- GP-4816: 更新陶瓦联机用户须知 (by Glavo)
+- GP-4838: 将陶瓦联机更新至 0.3.14 (by Burning_TNT)
+
+**错误修复**
+
+- GP-4795: 修复初次打开部分页面时页面闪烁的问题 (by Glavo)
+- GP-4808: 修复 Windows 下全局设置中本地库路径路径分隔符显示错误的问题 (by 辞庐)

_changelogs/stable/3.8/3.8.1.md

@@ -3,29 +3,33 @@
 
 详细版本介绍: [cv43836921](https://www.bilibili.com/opus/1138376365938049027)
 
-- 启动器
+**启动器**
-    - GP-4703， GP-4743: 优化更新日志展示功能 (by Glavo)
+
-    - GP-4696: 在外链按钮上添加 tooltip (by neveler)
+- GP-4703， GP-4743: 优化更新日志展示功能 (by Glavo)
-    - GP-4749: 恢复对 JavaFX 14 的兼容性 (by Glavo)
+- GP-4696: 在外链按钮上添加 tooltip (by neveler)
-    - GP-4760: 从注册表中读取 Windows 版本信息 (by Glavo)
+- GP-4749: 恢复对 JavaFX 14 的兼容性 (by Glavo)
-    - GP-4540: 删除实例失败时弹出对话框 (by Glavo)
+- GP-4760: 从注册表中读取 Windows 版本信息 (by Glavo)
-    - GP-4770: 更新模组数据 (by Glavo)
+- GP-4540: 删除实例失败时弹出对话框 (by Glavo)
-    - GP-4776: 优化游戏实例默认图标 (by Glavo)
+- GP-4770: 更新模组数据 (by Glavo)
-    - GP-4672: 优化数据包管理功能 (by mineDiamond)
+- GP-4776: 优化游戏实例默认图标 (by Glavo)
-    - GP-4612: 增强解析数据包/资源包元数据的能力 (by mineDiamond)
+- GP-4672: 优化数据包管理功能 (by mineDiamond)
-    - GP-4826: 从首页打开子页面时打开默认标签页 (by Glavo)
+- GP-4612: 增强解析数据包/资源包元数据的能力 (by mineDiamond)
-    - GP-4845: 更新 amdgpu.ids (by 辞庐)
+- GP-4826: 从首页打开子页面时打开默认标签页 (by Glavo)
-- 外观/动画
+- GP-4845: 更新 amdgpu.ids (by 辞庐)
-    - GP-4780, GP-4790, GP-4803, GP-4815: 优化界面动画效果 (by Glavo)
+**外观/动画**
-    - GP-4698: 被打包为 `.app` 文件时使用 `.app` 文件内置的 Dock 栏图标 (by 风花AnemoFlower)
+
-    - GP-4779: 预加载页面以减少动画卡顿 (by Glavo)
+- GP-4780, GP-4790, GP-4803, GP-4815: 优化界面动画效果 (by Glavo)
-    - GP-4762: 在 macOS 平台使用系统默认最小化动画 (by Damon Lu)
+- GP-4698: 被打包为 `.app` 文件时使用 `.app` 文件内置的 Dock 栏图标 (by 风花AnemoFlower)
-    - GP-4809: 在更多页面上启用平滑滚动 (by Glavo)
+- GP-4779: 预加载页面以减少动画卡顿 (by Glavo)
-- 本地化
+- GP-4762: 在 macOS 平台使用系统默认最小化动画 (by Damon Lu)
-    - GP-4709: 本地化下载速度显示 (by Glavo)
+- GP-4809: 在更多页面上启用平滑滚动 (by Glavo)
-    - 优化软件文案，修订翻译 (by 3gf8jv4dv, Glavo)
+**本地化**
-- 错误修复
+
-    - GP-4775: 修复无法获取部分远古版本版本号的问题 (by Glavo)
+- GP-4709: 本地化下载速度显示 (by Glavo)
-    - GP-4783: 修复模组管理页面点击搜索按钮后未聚焦到搜索栏的问题 (by mineDiamond)
+- 优化软件文案，修订翻译 (by 3gf8jv4dv, Glavo)
-    - GP-4805: 修复复制实例时使用非法实例 ID 启动器行为异常的问题 (by Haowei Wen)
+**错误修复**
-    - GP-4844: 修复缓存异常时下载任务无限循环的问题 (by Glavo)
+
+- GP-4775: 修复无法获取部分远古版本版本号的问题 (by Glavo)
+- GP-4783: 修复模组管理页面点击搜索按钮后未聚焦到搜索栏的问题 (by mineDiamond)
+- GP-4805: 修复复制实例时使用非法实例 ID 启动器行为异常的问题 (by Haowei Wen)
+- GP-4844: 修复缓存异常时下载任务无限循环的问题 (by Glavo)

_changelogs/stable/3.8/3.8.2.md

@@ -0,0 +1,14 @@
+---
+---
+
+[详细版本介绍 (Bilibili)](https://www.bilibili.com/opus/1148470393780043777)
+
+**启动器**
+
+- GP-4886: 优化对 Linux MIPS64el 平台的支持 (by Glavo)
+- GP-4917: 支持 Minecraft 新版本号规则 (by Glavo)
+**错误修复**
+
+- GP-4850: 修复 `FetchTask` 未设置 User-Agent 的问题 (by Glavo)
+- GP-4913: 修复游戏进程结束时点击日志窗口的“结束游戏进程”按钮会导致启动器无响应的问题 (by Glavo)
+- GP-4981: 修复从 BMCLAPI 下载部分旧文件时校验失败的问题 (by Glavo)

_changelogs/stable/3.9/3.9.1.md

@@ -0,0 +1,48 @@
+---
+---
+
+[详细版本介绍 (Bilibili)](https://www.bilibili.com/opus/1148770448825122832)
+
+**启动器**
+
+- GP-4837: 实验性支持阿拉伯语 (by Hommam-Prom)
+- GP-4911, GP-4963: 添加对 1.21.11_unobfuscated 及其预发布版的支持 (by mineDiamond)
+- GP-4927: 在 macOS 平台上导出启动脚本时支持导出 `.command` 文件 (by WhatDamon)
+- GP-5019: 使用子标题注解“提前预览 HMCL 版本”选项 (by neveler)
+- GP-5008: 优化反馈页面 (by Glavo)
+**游戏设置**
+
+- GP-4144: 添加输出游戏调试日志选项 (by 辞庐)
+**实例管理**
+
+- GP-4475: 添加资源包管理功能 (by 辞庐)
+- GP-4872: 添加快速进入世界功能 (by mineDiamond)
+**账户管理**
+
+- GP-4932: 在主页右键点击账户按钮时弹出快速切换账户菜单 (by zimzaza4)
+**外观**
+
+- GP-4835: 更新至 Material Design 3 颜色系统 (by Glavo)
+- 支持深色模式 (by Glavo, Wulian233, neveler)
+- GP-4854: 更新表格控件的样式 (by Calboot)
+- GP-4865: 更新颜色选择器样式 (by Glavo)
+- GP-4915: 在 `HintPane` 提示框中为图标和文本添加间距 (by neveler)
+- GP-4951: 更新选择框下拉菜单滚动条样式 (by Glavo)
+- GP-4964: 更新表格中复选框的样式 (by Glavo)
+**下载**
+
+- GP-4856: 优化下载源选择逻辑 (by Glavo)
+- GP-4990: 支持下载 Java 25 (by OrzMiku)
+**联机**
+
+- GP-4869: 在陶瓦联机页面向非中国内地用户添加提示框 (by Glavo)
+- GP-4916: 在陶瓦联机界面启动游戏时禁用离线皮肤功能 (by Glavo)
+**错误修复**
+
+- GP-4857: 修复惯性滚动可能导致弹出菜单错位的问题 (by Glavo)
+- GP-4871: 修复修改主题色后 `JFXCheckBox` 颜色不会及时变化的问题 (by Glavo)
+- GP-4874: 修复 `JFXRadioButton` 在 Windows 平台上中心圆点偏移的问题 (by Glavo)
+- GP-4895: 修复模组更新列表界面按 esc 无法正确退出的问题 (by Calboot)
+- GP-4935: 修复本地安装新版本 Forge 时未移除版本号中 `forge-` 前缀的问题 (by 辞庐)
+- GP-4946: 修复模组管理页面中 OptiFine HD U G6 pre1 与 CurseForge 上的无关模组相关联的问题 (by Burning_TNT)
+- GP-4945: 修复无法识别部分 Forge/NeoForge 模组的问题 (by Burning_TNT)

_changelogs/stable/3.9/3.9.2.md

@@ -0,0 +1,15 @@
+---
+---
+
+[详细版本介绍 (Bilibili)](https://www.bilibili.com/opus/1157751599072804904)
+
+**启动器**
+
+- GP-5046: 禁用日志窗口的平滑滚动效果 (by Glavo)
+- GP-5052: 优化列表的平滑滚动效果 (by Glavo)
+- GP-5110: 更新 NeoForge 版本号规则 (by 辞庐)
+**错误修复**
+
+- GP-5128: 修复使用 BMCLAPI 下载源时选择 `Liteloader` 版本时可能报错的问题 (by Wulian233)
+- GP-5125: 修复未正确归类 NeoForge alpha 版本的问题 (by 辞庐)
+- GP-5220: 修复 CurseForge 源无法搜索到内容的问题 (by Glavo)

_config.yml

@@ -9,10 +9,12 @@
 # data_dir: _data
 # includes_dir: _includes
 # cache_dir: .jekyll-cache
+disable_disk_cache: true
 sass:
   # sass_dir: _sass
   # minimal-mistakes
   style: compressed # https://sass-lang.com/documentation/file.SASS_REFERENCE.html#output_style
+  sourcemap: development
   quiet_deps: true
   silence_deprecations:
     - import
@@ -104,10 +106,7 @@ defaults:
       path: ""
     values:
       layout: document
-      read_time: false
+      show_date: true
-      author_profile: false
-      share: false
-      comments: false
       sidebar:
         nav: docs
       hits: true
@@ -158,7 +157,7 @@ title: HMCL 文档
 # title_separator: -
 # subtitle:
 # name: ""
-description: HMCL 启动器 | 跨平台 | 整合包管理 | 自动安装 | 十二年历史 | 三亿次使用
+description: HMCL 启动器 \| 跨平台 \| 整合包管理 \| 自动安装 \| 十二年历史 \| 三亿次使用
 url: https://docs.hmcl.net
 # repository:
 # teaser:

_data/groups.csv

@@ -1,11 +1,11 @@
 name,link,status
-HMCL 用户群 ① (633640264),https://qm.qq.com/q/fvJueufsvC,
+HMCL 用户群 ① (633640264),https://qm.qq.com/q/fvJueufsvC,已满
 HMCL 用户群 ② (203232161),https://qm.qq.com/q/N7hgdNYfy,
-HMCL 用户群 ③ (201034984),https://qm.qq.com/q/7sbMrFm9CE,
+HMCL 用户群 ③ (201034984),https://qm.qq.com/q/7sbMrFm9CE,已满
 HMCL 用户群 ④ (533529045),https://qm.qq.com/q/ACmZa98tGg,已满
-HMCL 用户群 ⑤ (744304553),https://qm.qq.com/q/MlVArSCMwM,已满
+HMCL 用户群 ⑤ (744304553),https://qm.qq.com/q/MlVArSCMwM,
-HMCL 用户群 ⑥ (282845310),https://qm.qq.com/q/S782Skmu0U,
+HMCL 用户群 ⑥ (282845310),https://qm.qq.com/q/S782Skmu0U,已满
 HMCL 用户群 ⑦ (482624681),https://qm.qq.com/q/WFsZ65F6MY,
-HMCL 用户群 ⑧ (991620626),https://qm.qq.com/q/ECVKkslPqi,
+HMCL 用户群 ⑧ (991620626),https://qm.qq.com/q/ECVKkslPqi,已满
-HMCL 用户群 ⑨ (657677715),https://qm.qq.com/q/DVj9tTrwze,已满
+HMCL 用户群 ⑨ (657677715),https://qm.qq.com/q/DVj9tTrwze,
 HMCL 用户群 ⑩ (775084843),https://qm.qq.com/q/V5F9DswQEu,已满

_data/navigation.yml

@@ -1,6 +1,4 @@
 main:
-  - title: 常见问题
-    url: /faq.html
   - title: 设置
     url: /settings.html
 
@@ -43,13 +41,21 @@ docs:
       - title: 添加默认 authlib-injector 验证服务器
         url: /launcher/authlib-injector.html
         description: 本文将告诉你如何设置默认的验证服务器。
+  - title: 更新日志
+    children:
+      - title: 稳定版
+        url: /changelog/stable.html
+      - title: 开发版
+        url: /changelog/dev.html
   - title: 其他
     children:
-      - title: 为 HMCL 做出贡献
+      - title: 用户协议
+        url: /eula/hmcl.html
+      - title: 贡献指南
         url: /contribution.html
-      - title: HMCL GitHub 地址
+      - title: 项目官网
-        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
+      - title: 项目仓库
+        url: https://github.com/HMCL-dev/HMCL
+      - title: 文档仓库
+        url: https://github.com/HMCL-dev/HMCL-docs

_data/settings.yaml

@@ -5,9 +5,19 @@ appearance_color:
     - light
     - dark
     - auto
-appearance_skin_light:
+appearance_color_switcher:
   type: radio
-  default: default
+  default: enable
+  options:
+    - enable
+    - disable
+appearance_skin:
+  type: multi-radio
+  children:
+    light:
+      default: default
+    dark:
+      default: dark
   options:
     - default
     - air
@@ -19,17 +29,11 @@ appearance_skin_light:
     - mint
     - plum
     - sunrise
-appearance_skin_dark:
+    - catppuccin_latte
+    - catppuccin_mocha
+miscellaneous_hits:
   type: radio
-  default: dark
+  default: enable
   options:
-    - default
+    - enable
-    - air
+    - disable
-    - aqua
-    - contrast
-    - dark
-    - dirt
-    - neon
-    - mint
-    - plum
-    - sunrise

_data/ui-text.yml

@@ -0,0 +1,2 @@
+zh:
+  follow_label: false

_docs/contribution.md

@@ -1,7 +1,9 @@
 ---
-title: 为 HMCL 帮助文档出一份力
+title: 贡献指南
 date: 2021-10-09 23:18:02 +0800
 author: huanghongxun
+classes: wide
+toc: false
 ---
 
 如果你认为你有能力为 HMCL 添加高质量的帮助文档，或希望修改错误，你可以到 [https://github.com/HMCL-dev/HMCL-docs](https://github.com/HMCL-dev/HMCL-docs) 仓库中发 Pull Request，或者提 Issue。

_downloads/linux/arm32.md

@@ -5,7 +5,7 @@ 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://bell-sw.com/pages/downloads/?version=java-25&os=linux&package=jre-full&bitness=32&architecture=arm#:~:text=All%20versions)
 
 或者你也可以根据[教程](https://docs.bell-sw.com/liberica-jdk/latest/general/install-guide/#linux)来添加仓库到你的软件包管理器。
 
@@ -13,6 +13,6 @@ date: 2022-12-03 17:30:00 +0800
 
 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)
+[Link](https://bell-sw.com/pages/downloads/?version=java-25&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).

_downloads/linux/arm64.md

@@ -5,7 +5,7 @@ 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://bell-sw.com/pages/downloads/?version=java-25&os=linux&package=jre-full&bitness=64&architecture=arm#:~:text=All%20versions)
 
 或者你也可以根据[教程](https://docs.bell-sw.com/liberica-jdk/latest/general/install-guide/#linux)来添加仓库到你的软件包管理器。
 
@@ -13,6 +13,6 @@ date: 2022-12-03 17:30:00 +0800
 
 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)
+[Link](https://bell-sw.com/pages/downloads/?version=java-25&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).

_downloads/linux/loongarch64.md

@@ -16,7 +16,7 @@ redirect_from:
 
 如果你正在使用新世界龙芯系统，请下载新世界 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)
+直接下载 (需自行安装)：[loongson25.3.20-fx-jdk25.0.1_8-linux-loongarch64-glibc2.34.tar.gz](https://ftp.loongnix.cn/Java/openjdk25/loongson25.3.20-fx-jdk25.0.1_8-linux-loongarch64-glibc2.34.tar.gz)
 
 通过包管理器安装：
 
@@ -38,6 +38,8 @@ redirect_from:
 
 如果你正在使用旧世界龙芯系统，请下载旧世界 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)
+- `.tar.gz`: [loongson25.3.20-fx-jdk25.0.1_8-linux-loongarch64.tar.gz](https://ftp.loongnix.cn/Java/openjdk25/loongson25.3.20-fx-jdk25.0.1_8-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)
+- `.deb`: [loongson25.3.20-fx-jdk25.0.1_8-linux-loongarch64.deb](https://ftp.loongnix.cn/Java/openjdk25/loongson25.3.20-fx-jdk25.0.1_8-linux-loongarch64.deb)
+
+- `.rpm`: [loongson25.3.20-fx-jdk25.0.1_8-linux.loongarch64.rpm](https://ftp.loongnix.cn/Java/openjdk25/loongson25.3.20-fx-jdk25.0.1_8-linux.loongarch64.rpm)

_downloads/linux/riscv64.md

@@ -5,7 +5,7 @@ date: 2024-10-06 22:00:00 +0800
 
 点下面的链接以下载 Java ，然后使用软件包管理器或者手动解压安装。
 
-[链接](https://bell-sw.com/pages/downloads/?version=java-21&os=linux&package=jre&bitness=64&architecture=riscv#:~:text=All%20versions)
+[链接](https://bell-sw.com/pages/downloads/?version=java-25&os=linux&package=jre&bitness=64&architecture=riscv#:~:text=All%20versions)
 
 或者你也可以根据[教程](https://docs.bell-sw.com/liberica-jdk/latest/general/install-guide/#linux)来添加仓库到你的软件包管理器。
 
@@ -13,6 +13,6 @@ date: 2024-10-06 22:00:00 +0800
 
 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&bitness=64&architecture=riscv#:~:text=All%20versions)
+[Link](https://bell-sw.com/pages/downloads/?version=java-25&os=linux&package=jre&bitness=64&architecture=riscv#:~: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).

_downloads/linux/x86.md

@@ -5,7 +5,7 @@ date: 2022-12-03 17:30:00 +0800
 
 点下面的链接以下载 Java ，然后使用软件包管理器或者手动解压安装。
 
-[链接](https://bell-sw.com/pages/downloads/?version=java-21&os=linux&package=jre&bitness=32&architecture=x86#:~:text=All%20versions)
+[链接](https://bell-sw.com/pages/downloads/?version=java-25&os=linux&package=jre&bitness=32&architecture=x86#:~:text=All%20versions)
 
 或者你也可以根据[教程](https://docs.bell-sw.com/liberica-jdk/latest/general/install-guide/#linux)来添加仓库到你的软件包管理器。
 
@@ -13,6 +13,6 @@ date: 2022-12-03 17:30:00 +0800
 
 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&bitness=32&architecture=x86#:~:text=All%20versions)
+[Link](https://bell-sw.com/pages/downloads/?version=java-25&os=linux&package=jre&bitness=32&architecture=x86#:~: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).

_downloads/linux/x86_64.md

@@ -5,7 +5,7 @@ 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=x86#:~:text=All%20versions)
+[链接](https://bell-sw.com/pages/downloads/?version=java-25&os=linux&package=jre-full&bitness=64&architecture=x86#:~:text=All%20versions)
 
 或者你也可以根据[教程](https://docs.bell-sw.com/liberica-jdk/latest/general/install-guide/#linux)来添加仓库到你的软件包管理器。
 
@@ -13,6 +13,6 @@ date: 2022-12-03 17:30:00 +0800
 
 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=x86#:~:text=All%20versions)
+[Link](https://bell-sw.com/pages/downloads/?version=java-25&os=linux&package=jre-full&bitness=64&architecture=x86#:~: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).

_downloads/macos/arm64.md

@@ -7,19 +7,19 @@ date: 2022-12-03 17:30:00 +0800
 
 ![macos-arm64-1](/assets/img/docs/java-download-pages/macos-arm64-1.gif)
 
-没有下载？[点击此处开始下载](https://bell-sw.com/pages/downloads/?version=java-21&os=macos&architecture=arm&package=jre-full&bitness=64#:~:text=All%20versions)
+没有下载？[点击此处开始下载](https://bell-sw.com/pages/downloads/?version=java-25&os=macos&architecture=arm&package=jre-full&bitness=64#:~:text=All%20versions)
 
 ---
 
 You are going to the Java download page. Please scroll down and click `DMG` download button, then wait for the Java installer to finish downloading, and finally open the installer and follow the prompts to install Java.
 
-No redirect? [Click here to start downloading](https://bell-sw.com/pages/downloads/?version=java-21&os=macos&architecture=arm&package=jre-full&bitness=64#:~:text=All%20versions)
+No redirect? [Click here to start downloading](https://bell-sw.com/pages/downloads/?version=java-25&os=macos&architecture=arm&package=jre-full&bitness=64#:~:text=All%20versions)
 
 
 <script>
     /* 等待 5 秒. */
     setTimeout(function() {
-        window.location.href = "https://bell-sw.com/pages/downloads/?version=java-21&os=macos&architecture=arm&package=jre-full&bitness=64#:~:text=All%20versions";
+        window.location.href = "https://bell-sw.com/pages/downloads/?version=java-25&os=macos&architecture=arm&package=jre-full&bitness=64#:~:text=All%20versions";
     }, 5000);
 </script>
 

_downloads/macos/x86_64.md

@@ -7,19 +7,19 @@ date: 2022-12-03 17:30:00 +0800
 
 ![macos-x86_64-1](/assets/img/docs/java-download-pages/macos-x86_64-1.gif)
 
-没有下载？[点击此处开始下载](https://bell-sw.com/pages/downloads/?version=java-21&os=macos&architecture=x86&package=jre-full&bitness=64#:~:text=All%20versions)
+没有下载？[点击此处开始下载](https://bell-sw.com/pages/downloads/?version=java-25&os=macos&architecture=x86&package=jre-full&bitness=64#:~:text=All%20versions)
 
 ---
 
 You are going to the Java download page. Please scroll down and click `DMG` download button, then wait for the Java installer to finish downloading, and finally open the installer and follow the prompts to install Java.
 
-No redirect? [Click here to start downloading](https://bell-sw.com/pages/downloads/?version=java-21&os=macos&architecture=x86&package=jre-full&bitness=64#:~:text=All%20versions)
+No redirect? [Click here to start downloading](https://bell-sw.com/pages/downloads/?version=java-25&os=macos&architecture=x86&package=jre-full&bitness=64#:~:text=All%20versions)
 
 
 <script>
     /* 等待 5 秒. */
     setTimeout(function() {
-        window.location.href = "https://bell-sw.com/pages/downloads/?version=java-21&os=macos&architecture=x86&package=jre-full&bitness=64#:~:text=All%20versions";
+        window.location.href = "https://bell-sw.com/pages/downloads/?version=java-25&os=macos&architecture=x86&package=jre-full&bitness=64#:~:text=All%20versions";
     }, 5000);
 </script>
 

_downloads/windows/arm64.md

@@ -9,17 +9,17 @@ Java 安装包已开始下载，请等待 Java 安装程序下载完成，最后
 
 ![windows-x86_64-2](/assets/img/docs/java-download-pages/windows-x86_64-2.gif)
 
-没有下载？[点击此处开始下载](https://alist.8mi.tech/d/mirror/ms-jdk/Auto/microsoft-jdk-21-windows-aarch64.msi)
+没有下载？[点击此处开始下载](https://alist.8mi.tech/d/mirror/ms-jdk/Auto/microsoft-jdk-25-windows-aarch64.msi)
 
-无法下载？[点击此处开始下载（备用）](https://aka.ms/download-jdk/microsoft-jdk-21-windows-aarch64.msi)
+无法下载？[点击此处开始下载（备用）](https://aka.ms/download-jdk/microsoft-jdk-25-windows-aarch64.msi)
 
 ---
 
 The Java installation package has started to download. Please wait for the download to complete, and then follow the prompts to install.
 
-No redirect? [Click here to start downloading](https://aka.ms/download-jdk/microsoft-jdk-21-windows-aarch64.msi)
+No redirect? [Click here to start downloading](https://aka.ms/download-jdk/microsoft-jdk-25-windows-aarch64.msi)
 
-Can't download? [Click here to download (alternative)](https://alist.8mi.tech/d/mirror/ms-jdk/Auto/microsoft-jdk-21-windows-aarch64.msi)
+Can't download? [Click here to download (alternative)](https://alist.8mi.tech/d/mirror/ms-jdk/Auto/microsoft-jdk-25-windows-aarch64.msi)
 
 
 <script>
@@ -27,8 +27,8 @@ Can't download? [Click here to download (alternative)](https://alist.8mi.tech/d/
     setTimeout(function() {
         const isZhCN = /^zh-CN/i.test(navigator.language);
         const url = isZhCN 
-            ? "https://alist.8mi.tech/d/mirror/ms-jdk/Auto/microsoft-jdk-21-windows-aarch64.msi" 
+            ? "https://alist.8mi.tech/d/mirror/ms-jdk/Auto/microsoft-jdk-25-windows-aarch64.msi" 
-            : "https://aka.ms/download-jdk/microsoft-jdk-21-windows-aarch64.msi";
+            : "https://aka.ms/download-jdk/microsoft-jdk-25-windows-aarch64.msi";
         location.href = url;
     }, 5000);
 </script>

_downloads/windows/x86.md

@@ -11,19 +11,19 @@ date: 2022-12-03 17:30:00 +0800
 
 ![windows-x86-3](/assets/img/docs/java-download-pages/windows-x86-3.gif)
 
-没有下载？[点击此处开始下载](https://bell-sw.com/pages/downloads/?version=java-21&os=windows&architecture=x86&bitness=32&package=jre-full#:~:text=All%20versions)
+没有下载？[点击此处开始下载](https://bell-sw.com/pages/downloads/?version=java-25&os=windows&architecture=x86&bitness=32&package=jre-full#:~:text=All%20versions)
 
 ---
 
 You are going to the Java download page. Please scroll down and click `MSI` download button, then wait for the Java installer to finish downloading, and finally open the installer and follow the prompts to install Java.
 
-No redirect? [Click here to start downloading](https://bell-sw.com/pages/downloads/?version=java-21&os=windows&architecture=x86&bitness=32&package=jre-full#:~:text=All%20versions)
+No redirect? [Click here to start downloading](https://bell-sw.com/pages/downloads/?version=java-25&os=windows&architecture=x86&bitness=32&package=jre-full#:~:text=All%20versions)
 
 
 <script>
     /* 等待 5 秒. */
     setTimeout(function() {
-        window.location.href = "https://bell-sw.com/pages/downloads/?version=java-21&os=windows&architecture=x86&bitness=32&package=jre-full#:~:text=All%20versions";
+        window.location.href = "https://bell-sw.com/pages/downloads/?version=java-25&os=windows&architecture=x86&bitness=32&package=jre-full#:~:text=All%20versions";
     }, 5000);
 </script>
 

_downloads/windows/x86_64.md

@@ -9,17 +9,17 @@ Java 安装包已开始下载，请等待 Java 安装程序下载完成，最后
 
 ![windows-x86_64-2](/assets/img/docs/java-download-pages/windows-x86_64-2.gif)
 
-没有下载？[点击此处开始下载](https://alist.8mi.tech/d/mirror/ms-jdk/Auto/microsoft-jdk-21-windows-x64.msi)
+没有下载？[点击此处开始下载](https://alist.8mi.tech/d/mirror/ms-jdk/Auto/microsoft-jdk-25-windows-x64.msi)
 
-无法下载？[点击此处开始下载（备用）](https://aka.ms/download-jdk/microsoft-jdk-21-windows-x64.msi)
+无法下载？[点击此处开始下载（备用）](https://aka.ms/download-jdk/microsoft-jdk-25-windows-x64.msi)
 
 ---
 
 The Java installation package has started to download. Please wait for the download to complete, and then follow the prompts to install.
 
-No redirect? [Click here to start downloading](https://aka.ms/download-jdk/microsoft-jdk-21-windows-x64.msi)
+No redirect? [Click here to start downloading](https://aka.ms/download-jdk/microsoft-jdk-25-windows-x64.msi)
 
-Can't download? [Click here to download (alternative)](https://alist.8mi.tech/d/mirror/ms-jdk/Auto/microsoft-jdk-21-windows-x64.msi)
+Can't download? [Click here to download (alternative)](https://alist.8mi.tech/d/mirror/ms-jdk/Auto/microsoft-jdk-25-windows-x64.msi)
 
 
 <script>
@@ -27,8 +27,8 @@ Can't download? [Click here to download (alternative)](https://alist.8mi.tech/d/
     setTimeout(function() {
         const isZhCN = /^zh-CN/i.test(navigator.language);
         const url = isZhCN 
-            ? "https://alist.8mi.tech/d/mirror/ms-jdk/Auto/microsoft-jdk-21-windows-x64.msi" 
+            ? "https://alist.8mi.tech/d/mirror/ms-jdk/Auto/microsoft-jdk-25-windows-x64.msi" 
-            : "https://aka.ms/download-jdk/microsoft-jdk-21-windows-x64.msi";
+            : "https://aka.ms/download-jdk/microsoft-jdk-25-windows-x64.msi";
         window.location.href = url;
     }, 5000);
 </script>

_includes/head.html

@@ -1,6 +1,7 @@
+{% assign locale = include.locale | default: site.locale %}
 <meta charset="utf-8">
 
-{% include seo.html %}
+{% include seo.html locale=locale %}
 
 {% unless site.atom_feed.hide %}
   <link href="{% if site.atom_feed.path %}{{ site.atom_feed.path }}{% else %}{{ '/feed.xml' | relative_url }}{% endif %}" type="application/atom+xml" rel="alternate" title="{{ site.title }} Feed">

_launcher/auto-installing.md

@@ -1,85 +1,127 @@
 ---
-title: 自动安装与模组下载简介
+title:  "自动安装与模组下载简介"
 excerpt: 安装 Forge、Fabric、LiteLoader、OptiFine 及模组的教程
-date: 2021-10-09 23:18:02 +0800
+date:   2025-11-02 09:06:30 +0800
-author: asdqp233
+author: asdqp233,Mine-diamond
 ---
 
-## 安装 Mod 加载器
+要为 Minecraft 安装模组，你首先需要安装一个“模组加载器”（例如 NeoForge 或 Fabric），然后再安装你想要的模组。HMCL 为这两个步骤都提供了强大的支持。
 
-当你在安装新的游戏客户端时候, 会看到其中有
+在安装前，最关键的一点是**兼容性**。请记住以下核心原则：
 
-`Forge, LiteLoader, Fabric, Quilt` 这 4 个 Mod 加载器可供选择。
+- 通常，你只能为单个游戏实例安装一种模组加载器。
+- 你下载的**模组**，必须同时兼容你的**游戏版本**（如 1.20.4）和**模组加载器**（如 Fabric）。
 
-以及 `Fabric API, QSL/QFAPI` 这两个随 Fabric 与 Quilt 的 API（实际是模组）可供选择。
+简单来说，为游戏安装模组总共分三步，本指南将带你逐一完成：
+1. 开启版本隔离，为模组创建一个独立干净的环境。
+2. 安装模组加载器（如 Forge, Fabric）。
+3. 安装你喜欢的模组。
+
+## 启用版本隔离
+
+在安装模组之前，必须开启版本隔离以隔离为不同实例安装的模组：
+
+在 HMCL 主界面，点击「设置」，在「全局游戏设置」选项卡中，找到「版本隔离」，点击「版本隔离」，选择「各实例独立」即可
+
+![Working_Directory](/assets/img/docs/auto-installing/Working_Directory.png)
+
+更详细的介绍见 [全局版本隔离](/_launcher/isolation.md)
+
+## 安装模组加载器  
+
+### 模组加载器简介
+
+常见的模组加载器有以下几个：
+
+`Forge`,`NeoForge`,`Fabric`,`Quilt`,`Cleanroom`,`LiteLoader` 是 6 个常见的 Mod 加载器。  
+`Fabric API`,`QSL/QFAPI` 是两个随 `Fabric` 与 `Quilt` 的官方 API（实际是模组）。
+
+
+**兼容性：**
+-  ***LiteLoader* 和 *Forge* 是兼容的 (*Forge* 较新版本和 *LiteLoader* 较老版本可能不兼容)，可以同时安装**  
+-  **其它所有模组加载器几乎互不兼容，即你无法同时安装两个模组加载器**  
+
+**Fabric与Quilt 说明：**  
+非常多的 *Fabric Mod* 需要 *Fabric API* 作为前置模组， *Quilt Mod* 需要 *QSL/QFAPI* 作为前置模组。  
+在安装 *Fabric* 或 *Quilt* 加载器时候如果没有其它原因，建议安装 *Fabric API* 或 *QSL/QFAPI* , 否则很多 *Fabric Mod* 或 *Quilt Mod* 则有可能无法被加载!
+
+### 安装新实例时安装模组加载器
+
+当你在安装新的游戏客户端时候, 会看到其中有该版本支持的模组加载器安装选项，点击你想安装的模组加载器（根据你想安装模组所支持的加载器进行选择）  
 
 ![AutoInstaller_ModLoader](/assets/img/docs/auto-installing/AutoInstaller_ModLoader.png)
 
-当你使用 1.14 及以上的游戏版本时, 推荐使用 *Fabric*
+- 点击你想要的加载器（如 Fabric）。
+- 在弹出的版本选择页面，若无特殊需求，**选择最新稳定版**（通常是第一个）。
+- 如果你选择 `Fabric` 或 `Quilt`，最好同时安装`Fabric API` 或 `QSL/QFAPI`。
+- 点击「安装」即可。
 
-1.14 以下的版本推荐使用 *Forge*
+### 为已有实例安装或更换模组加载器
 
-*LiteLoader* 只适用于 1.12.2 及以前的版本 (目前已停更)
+如果你想为已安装好的纯净版游戏添加加载器，或者更换、更新加载器版本：
 
-**注意：**
+1.  在 HMCL 主界面，点击「实例管理」，然后选择你想要修改的游戏实例。
+2.  在左侧菜单中，点击「自动安装」。
 
-选择完合适的Mod加载器之后就可以点击右下角的`安装`继续进行安装。
+![Auto_Install_Page](/assets/img/docs/auto-installing/Auto_Install_Page.png)
 
-**注意：**
+- **安装**：点击你想要的加载器图标（如 Forge），选择版本（推荐最新版），然后点击安装。
+- **更新**：点击已安装的加载器，选择一个更新的版本，然后点击安装。
+- **删除**：点击加载器右侧的「X」按钮即可删除。
+- **更换**：先删除旧的加载器，再安装新的。
 
-***LiteLoader* 和 *Forge* 是兼容的 (*Forge* 较新版本和 *LiteLoader* 较老版本可能不兼容)**
+> **注意**：此处的自动安装页面不支持安装 `Fabric API` 或 `QSL/QFAPI`。请将它们当作普通模组进行安装。
 
-***Fabric* 和 *Forge* 不兼容!**
 
-**如果选择 *Fabric* , 那么建议同时选择 *Fabric API***
+## 安装模组
 
-**如果选择 *Quilt* ，那么建议同时选择 *QSL/QFAPI***
+安装好加载器后，就可以开始添加模组了。你可以在下列网站获取模组信息，并在 HMCL 内下载和安装：
+- [MC 百科](https://www.mcmod.cn/) - 中文社区，资料详尽。
+- [CurseForge](https://www.curseforge.com/minecraft/search?class=mc-mods) - 最大的模组发布站之一。
+- [Modrinth](https://modrinth.com/mods) - 新兴的现代化模组发布站。
 
-## 安装 Mod
+在安装任何模组前，请先确认三件事：
+1.  **游戏版本**：模组是否支持你当前的游戏版本？(例如, 1.20.4)
+2.  **加载器类型**：模组是给 Forge、Fabric 还是其它模组加载器用的？
+3.  **前置模组**：模组是否需要其他模组作为前置？（模组页面通常会说明）
 
-### 自动安装
+### 自动安装 (推荐)
 
-#### Forge Mod
+HMCL 内置了 CurseForge 和 Modrinth 的搜索和下载功能，非常方便。
 
-HMCL 内置了 CurseForge 和 Modrinth 下载源的搜索和下载功能, 目前已支持中文搜索 (匹配结果不一定准确) 。
+1.  在 HMCL 主界面，点击「下载」->「模组」。
+2.  在搜索框输入模组名（支持中英文），然后点击搜索。如果搜不到，可以尝试切换右上角的下载源。
+3.  点击你想要的模组，进入版本列表页面。
+4.  根据**游戏版本**和**加载器**，找到你需要的版本，点击并选择「安装到当前实例」。
+5.  如果该模组有前置，HMCL 会自动提示，请先安装所有前置模组（但是请不要重复安装前置模组）。
 
-点开 Mod 下载页面, 最上方会显示当前 Mod 需要的前置 Mod (如果有) , 以及 Mod 支持的全部版本, 请根据你当前安装的游戏版本选择恰当的版本。
+注：点击模组下载页面 上方的蓝色的链接可以到对应的网站查看模组的信息，这会告诉你模组的功能和有可能会提示你一些注意事项
 
-**注意: 请区分 *Forge Mod* 和 *Fabric Mod* , 大部分 Mod 在文件名中会注明, 请不要选择错误, 否则 Mod 将无法被正确加载。**
+**注意: 请查看你要下载的模组是否正常你要安装的游戏版本以及模组加载器，否则模组无法被正常加载!**
-
-**建议点击上方的蓝色的 模组详情链接 查看模组的信息，这有可能会提示你些什么注意事项**
 
 ![AddingModAutomatically](/assets/img/docs/auto-installing/AutoInstaller_ModAutoAdding.png)
 
-#### Fabric Mod / Quilt Mod
+### 安装OptiFine 或其它光影模组
 
-*Fabric Mod* 和 *Quilt Mod* 的安装和 *Forge Mod* 的安装类似, [参照上文](#forge-mod)。
+光影的安装方式略有不同，请参考专门的指南 [光影安装](/_launcher/shader.md)
-
-**注意：**
-
-- **几乎所有的 *Fabric Mod* 或 *Quilt Mod* 都需要 *Fabric API* 或 *QSL/QFAPI*。在安装 Mod 加载器时候如果没有选择, 请选择安装 *Fabric API* 或 *QSL/QFAPI* , 否则 *Fabric Mod* 或 *Quilt Mod* 则有可能无法被加载!**
-
-- ***Fabric* 对应 *Fabric API* ，*Quilt Mod* 对应 *QSL/QFAPI* ，请不要搞错。**
-
-#### LiteLoader Mod
-
-*LiteLoader Mod* 安装和 *Forge Mod* 的安装类似, [参照上文](#forge-mod)。
-
-**注意: LiteLoader 只能加载文件后缀为 litemod 的模组, *Forge Mod*、*Fabric Mod* 和 *Quilt Mod*等修改后缀的方法 LiteLoader 是无法检测。**
-
-#### OptiFine
-
-[详情请查阅此](/_launcher/shader.md)
 
 ### 手动安装
 
-一般的 Mod 文件后缀为 `jar` 或者 `litemod` 。
+当你在网站或其它位置手动下载了模组文件，你可以参照以下步骤完成安装：
 
-将这个 jar 文件复制到 `\.minecraft\Mods` 文件夹中即可 (没有这个文件夹就自己新建一个) 。
+一般的 Mod 文件后缀为 `jar` 或者 `litemod`，请确认后缀是正确的。其中`jar`为大多数模组加载器支持的格式，`litemod`仅`LiteLoader`支持。  
 
-若开启了版本隔离, 那么文件夹是`\.minecraft\version\<版本名称>\Mods`。
+#### 通过模组管理页面
 
-或者在 HMCL 的 `游戏管理页面—模组管理` 页面点击添加模组或直接将文件拖入启动器窗口。
+1.  进入「实例管理」-> 选择你的游戏实例 ->「模组管理」。
+2.  点击「添加模组」并选择你的模组文件，或直接将文件拖拽到窗口内即可。  
+
+#### 通过模组文件夹安装
+
+1.  进入「实例管理」-> 选择你的游戏实例 ->「浏览」->「模组文件夹」。
+2.  这会打开该实例的 `mods` 文件夹。
+3.  将你下载的 `.jar` 模组文件复制或移动到这个文件夹里。
+    （如果 `mods` 文件夹不存在，请自行创建一个。）
 
 ![AddingModManually](/assets/img/docs/auto-installing/AutoInstaller_ModManualAdding.png)
 
@@ -87,10 +129,51 @@ HMCL 内置了 CurseForge 和 Modrinth 下载源的搜索和下载功能, 目前
 
 造成游戏报错的原因有很多, 比如 Mod 之间不兼容, Fabric API 的版本过高, 缺少前置 Mod 等等。
 
-1. 新版本的 HMCL 拥有错误分析功能, 可以根据HMCL的提示来排查原因。
+**第一步：基础检查（最常见问题）**
+- **查看 HMCL 错误报告**：新版 HMCL 会直接提示大部分常见错误，这是你的首选信息来源。
+- **检查兼容性**：确认模组版本、游戏版本、模组加载器三者是否匹配。
+- **检查前置模组**：是否忘记安装必要的API（如 Fabric API）或其他前置模组？
 
-2. 也可以使用二分法来解决——每次加入 / 删除一半的 Mod , 挨个排除, 直到找到导致游戏报错的 Mod 为止。
+**第二步：自己排查**
+- **使用“二分法”**：在“模组管理”页面，先禁用一半的模组，看游戏能否启动或出错。如果可以，说明问题出在被禁用的那一半里。不断重复此过程，直到找到引发问题的具体模组。
+- **查看日志文件**：如果你有能力，可以自行查看游戏日志来定位问题。
 
-3. 如果你的能力很优秀, 也可以直接查看游戏日志来找出问题的原因。
+**第三步：有效求助**
+如果无法自行解决，你需要向社区求助。但请记住，一个有效的求助包含**完整的日志文件**。
 
-4. 如果无法理解日志内容, 那么请将 `\.minecraft\crash-reports` 和 `\.minecraft\logs` 文件夹打包发给其他人寻求帮助。
+**如何正确求助**：
+1. 在游戏崩溃后，点击 HMCL 弹出的错误窗口上的「**导出游戏日志**」按钮，它会生成一个 `minecraft-exported-crash-info-时间戳.zip` 文件。
+2. 带着**这个文件**去社区、论坛或群里提问，并具体描述你遇到的问题。
+
+> **重要**：对于向他人求助，千万不要只截图，不要只说“游戏出错怎么办”这种及其笼统的话语。**没有日志，谁也帮不了你。**
+
+![CrashReportPage](/assets/img/docs/auto-installing/Crash_Report_Page.png)
+
+
+## 补充：常见模组加载器简单介绍和支持版本一览  
+
+模组加载器简单介绍：  
+
+| 模组加载器 | 简单介绍 |
+| --------- | ------- |
+| <span style="white-space: nowrap;"><img src="/assets/img/docs/auto-installing/forge.png" alt="Forge icon" width="16"> Forge</span> | 老牌的模组加载器，功能强大，支持的模组众多，推荐在1.21之前安装。 |
+| <span style="white-space: nowrap;"><img src="/assets/img/docs/auto-installing/neoforge.png" alt="NeoForge icon" width="16"> NeoForge</span> | 1.20.1后Forge的继任者，推荐在1.21版本后安装NeoForge。 |
+| <span style="white-space: nowrap;"><img src="/assets/img/docs/auto-installing/fabric.png" alt="Fabric icon" width="16"> Fabric</span> | 轻型模组加载器，非常适合安装优化模组或纯净生存增强类模组。 |
+| <span style="white-space: nowrap;"><img src="/assets/img/docs/auto-installing/quilt.png" alt="Quilt icon" width="16"> Quilt</span> | Fabric的一个分支，同样轻量。 |
+| <span style="white-space: nowrap;"><img src="/assets/img/docs/auto-installing/fabric.png" alt="Fabric api icon" width="16"> Fabric API</span><br><span style="white-space: nowrap;"><img src="/assets/img/docs/auto-installing/quilt.png" alt="QSL/QFAPI icon" width="16"> QSL/QFAPI</span> | 由于`Fabric`和`Quilt`比较轻功能有限，因此提供了增强功能的api，很多模组依赖于此api。 |
+| <span style="white-space: nowrap;"><img src="/assets/img/docs/auto-installing/cleanroom.png" alt="Cleanroom icon" width="16"> Cleanroom</span> | 1.12.2版本Forge的一个优化代替，提供了相对更强的功能，仅支持1.12.2。 |
+| <span style="white-space: nowrap;"><img src="/assets/img/docs/auto-installing/chicken.png" alt="LiteLoader icon" width="16"> LiteLoader</span> | 轻量模组加载器，为Forge的轻量代替，现在已停止维护。 |
+
+
+支持版本一览：  
+
+| 模组加载器  | 最老版本| 最新版本    |
+| ---------- | ------ | ------      |
+| <img src="/assets/img/docs/auto-installing/forge.png" alt="Forge icon" width="16"> Forge      | 1.5.2  | 游戏最新版本 |
+| <img src="/assets/img/docs/auto-installing/neoforge.png" alt="NeoForge icon" width="16"> NeoForge   | 1.20.1 | 游戏最新版本 |
+| <img src="/assets/img/docs/auto-installing/fabric.png" alt="Fabric icon" width="16"> Fabric     | 1.16.3 | 游戏最新版本 |
+| <img src="/assets/img/docs/auto-installing/fabric.png" alt="Fabric api icon" width="16"> Fabric api | 1.16.3 | 游戏最新版本 |
+| <img src="/assets/img/docs/auto-installing/quilt.png" alt="Quilt icon" width="16"> Quilt        | 1.16.3 | 游戏最新版本 |
+| <img src="/assets/img/docs/auto-installing/quilt.png" alt="QSL/QFAPI icon" width="16"> QSL/QFAPI  | 1.18.2 | 1.21        |
+| <img src="/assets/img/docs/auto-installing/cleanroom.png" alt="Cleanroom icon" width="16"> Cleanroom  | 1.12.2 |             |
+| <img src="/assets/img/docs/auto-installing/chicken.png" alt="LiteLoader icon" width="16"> LiteLoader | 1.5.2  | 1.12.2      |

_launcher/fabric_and_optifine_install.md

@@ -1,5 +1,6 @@
 ---
 title: 同时安装 Fabric & OptiFine
+excerpt: 本文介绍了如何在 HMCL 中同时安装 OptiFine 和 Fabric
 date: 2023-01-04 11:30:00 +0800
 author: zkitefly
 ---

_launcher/gui-features.md

@@ -0,0 +1,96 @@
+---
+title: 界面功能介绍
+excerpt: 本文整理了启动器部分界面的功能介绍
+date: 2026-01-09T15:19:02+08:00
+---
+
+![启动器预览图](/assets/img/docs/launcher/gui-features/global.png)
+
+启动器界面整体由顶部工具栏和页面容器构成。
+
+## 顶部工具栏
+
+![顶部工具栏](/assets/img/docs/launcher/gui-features/topbar.png)
+
+> [!TIP]
+> 用户可以通过双击工具栏在最大化与普通窗口状态之间切换。
+
+此区域为全局显示，共分为左右两部分。其中左侧由返回按钮（仅在二级或多级页面显示）和标题构成，右侧由帮助按钮、最小化按钮和关闭按钮构成。
+
+**返回按钮**：点击后返回上一页，仅在二级或多级页面上显示，首页不显示。\
+**标题**：通常用于显示页面名称，首页显示为启动器版本信息。\
+**帮助按钮**：点击后跳转至文档帮助页面。\
+**最小化按钮**：点击后最小化启动器。\
+**关闭按钮**：点击后关闭启动器。
+
+## 首页
+
+![首页](/assets/img/docs/launcher/gui-features/home.png)
+
+首页是启动器的起始页面，该页面由侧边导航栏、提示面板（仅限开发版和预览版）、更新面板（仅在存在可用更新时显示）和启动游戏面板构成。
+
+### 侧边导航栏（首页）
+
+![侧边导航栏（首页）](/assets/img/docs/launcher/gui-features/home-sidebar.png)
+
+此区域共分为三部分：账户分组、游戏分组及通用分组。
+
+**账户分组**：该分组中包含一个列表项，该项会显示当前选定的账户头像、名称及账户类型，用户点击该项可进入账户列表页面；右键点击该项可呼出账户切换的快捷菜单。
+
+> [!TIP]
+> 用户在该项上滚动鼠标滚轮可在不同账户之间进行快捷切换。
+
+**游戏分组**：该分组中包含三个列表项，分别是：实例管理、实例列表及下载。
+
+- 实例管理：该项会显示当前选定的游戏实例图标及名称。用户点击该项后进入实例管理页面；在该项上滚动鼠标滚轮可在不同游戏实例之间进行快捷切换。
+- 实例列表：用户点击该项后进入实例列表页面，用于查看和管理游戏实例。
+- 下载：用户点击该项后进入下载页面，用于下载游戏、整合包或者安装模组、资源包、光影或者世界。
+
+**通用分组**：该分组中包含三个列表项，分别是：设置、多人联机及官方群组。
+
+- 设置：用户点击该项后进入[设置](#设置)页面。
+- 多人联机：用户点击该项后进入多人联机页面。
+- 官方群组：用户点击该项后跳转至设置·反馈页。
+
+### 提示面板
+
+![提示面板](/assets/img/docs/launcher/gui-features/home-tip.png)
+
+> [!TIP]
+> 用户可通过点击右上角关闭按钮隐藏该提示。
+
+仅在开发版或预览版中显示，用于提示用户当前启动器不是稳定版本。
+
+### 更新面板
+
+![更新面板](/assets/img/docs/launcher/gui-features/home-update.png)
+
+仅在存在可用更新时显示，此区域用于启动器更新提示。
+
+### 启动游戏面板
+
+![更新面板](/assets/img/docs/launcher/gui-features/home-launch.png)
+
+此区域共分为两部分：启动（开始）游戏按钮、切换实例菜单。
+
+**启动（开始）游戏按钮**：若用户当前存在实例，点击后则会启动当前应用的游戏实例；若当前不存在游戏实例，点击后会自动下载最新正式版然后启动游戏。\
+**切换实例菜单**：点击显示快捷切换游戏实例列表菜单。
+
+## 设置
+
+![设置](/assets/img/docs/launcher/gui-features/settings.png)
+
+该页面由侧边导航栏和页面容器构成。
+
+### 侧边导航栏（设置）
+
+此区域共分为四部分：全局游戏设置、Java 管理、启动器分组及帮助分组。
+
+**全局游戏设置**：用户点击该项后进入[全局游戏设置](#设置-全局游戏设置)页面。\
+**Java 管理**：用户点击该项后进入 Java 管理页面。\
+**启动器分组**：该分组中包含三个列表项，分别是：通用、外观及下载。\
+**帮助分组**：该分组中包含三个列表项，分别是：帮助、反馈及关于。
+
+## 设置-全局游戏设置
+
+![设置-全局游戏设置](/assets/img/docs/launcher/gui-features/settings-global.png)

_launcher/offline-skin.md

@@ -1,70 +1,64 @@
 ---
 title: 离线模式下更换皮肤
 excerpt: 使用本地皮肤文件、LittleSkin 或 Blessing Skin 设置离线皮肤
-date: 2021-10-09 23:18:02 +0800
+date: 2025-12-05 22:25:00 +0800
 author: qiaoshouzi
 contributors:
   - kitefly
+  - TyMxy
 ---
 
-# 离线模式下更换皮肤
+> [!NOTE]
-**注意：**
+> 使用 Steve、Alex、本地皮肤图片文件: 可能无法加入多人联机，其他玩家可能看不到您的皮肤\
-> 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, 进入 **账号列表** , 点击下图离线账号的【上传皮肤】红框处:
+打开 HMCL 进入**账户列表**，点击下图离线模式账户的 `上传/编辑皮肤` 按钮（红框处）。
 
 ![](/assets/img/docs/offline-skin/img1_1.png)
 
 ![](/assets/img/docs/offline-skin/img1_2.png)
 
-> 默认: 使用默认随机的皮肤显示
+- `默认` 使用默认随机的皮肤显示
->
+- `Steve` 使用 Steve（史蒂夫）皮肤显示
-> Steve: 使用Steve (史蒂夫) 皮肤显示
+- `Alex` 使用 Alex（艾利克斯）皮肤显示
->
+- [本地皮肤图片文件](#本地皮肤图片文件)
-> Alex: 使用Alex (艾利克斯) 皮肤显示
+- [LittleSkin](#littleskin)
->
+- [Blessing Skin 服务器](#blessing-skin-服务器)
-> [本地皮肤图片文件](#本地皮肤图片文件)、[LittleSkin](#littleskin)、[Blessing Skin 服务器](#blessing-skin-服务器): 请见下文↓
 
 ## 本地皮肤图片文件
 
-点击 **本地皮肤图片文件** , 设置 **皮肤/披风**皮肤图片 路径, 点击 **确认**, 即可
+选中本地皮肤图片文件后，根据需求分别设置皮肤与披风的资源路径然后点击确认即可。
 
 ![](/assets/img/docs/offline-skin/img2.png)
 
 ## LittleSkin
 
-首先您需要一个LittleSkin的账号, [注册](https://mcskin.littleservice.cn/auth/register)并[登录](https://mcskin.littleservice.cn/auth/login)
+首先您需要一个 LittleSkin 的账户，[注册](https://mcskin.littleservice.cn/auth/register)并[登录](https://mcskin.littleservice.cn/auth/login)。
 
-然后前往 [角色管理](https://mcskin.littleservice.cn/user/player), 查看您的角色名, 如果没有, 请点击 **添加新角色** 进行添加
+然后前往[角色管理](https://mcskin.littleservice.cn/user/player)，查看您的角色名，如果没有可以点击添加新角色按钮进行添加。
 
-你可在 [我的衣柜](https://mcskin.littleservice.cn/user/closet) 修改此账户名的皮肤与披风
+你可在[我的衣柜](https://mcskin.littleservice.cn/user/closet)修改此账户名的皮肤与披风。
 
 ![](/assets/img/docs/offline-skin/img3_1.png)
 
-在HMCL中创建的离线账户的 账户名 **必须**和角色名相等, 如果不相等, 请 **重新在HMCL中创建离线账户**
+角色名必须与 HMCL 中离线模式账户的角色名一致。如不一致，请在 HMCL 中切换至对应的离线模式账户，或新建与角色名匹配的离线模式账户。
 
 ![](/assets/img/docs/offline-skin/img3_2.png)
 
-确认相等后, 点击 **LittleSkin** 即可同步在LittleSkin上此账户名的皮肤
+确认离线模式账户的角色名一致后，点击 **LittleSkin** 即可同步在 LittleSkin 上的皮肤。
 
 ![](/assets/img/docs/offline-skin/img3_3.png)
 
 ## Blessing Skin 服务器
 
-**Blessing Skin 服务器, 进入 **角色管理** , 查看角色名 , 确认 **角色名** 和 **HMCL中创建的离线账号角色名** 相同, 如果不相等, **请重新在HMCL中创建离线账户**
+进入角色管理核对角色名与 HMCL 中离线模式账户的角色名是否一致。如不一致，请在 HMCL 中切换至对应的离线模式账户，或新建与角色名匹配的离线模式账户。
 
-你可在 我的衣柜 修改此账户名的皮肤与披风
+你可在我的衣柜修改此账户名的皮肤与披风。
 
 ![](/assets/img/docs/offline-skin/img4_1.png)
 
-进入 **配置生成**, 按下图找到 `CustomSkinLoader` 中的网址, 复制到HMCL中即可同步在Blessing Skin 服务器上此账户名的皮肤
+进入配置生成并按下图找到 `CustomSkinLoader` 中的网址，复制到 HMCL 中即可同步在 Blessing Skin 服务器上此账户名的皮肤。
-
-> 注意: **V3.4.205**需把链接末尾的 / 去掉, 这个BUG已经在**V3.4.206**修复
 
 ![](/assets/img/docs/offline-skin/img4_2.png)
 
-![](/assets/img/docs/offline-skin/img4_3.png)
+![](/assets/img/docs/offline-skin/img4_3.png)

_launcher/use-password-login-microsoft-account.md

@@ -1,5 +1,6 @@
 ---
 title: 使用密码登录微软账户
+excerpt: 本文介绍了如何使用密码登录微软账户及修改密码
 date: 2024-07-21 17:50:00 +0800
 author: zkitefly
 ---

_layouts/changelog.html

@@ -5,7 +5,7 @@ layout: document
 {{ content }}
 
 {% assign channel = page.channel | default: 'stable' %}
-{% assign changelogs = site.changelogs | where: "channel", channel | reverse %}
+{% assign changelogs = site.changelogs | where: "channel", channel | version_sort: "slug" | reverse %}
 {% for item in changelogs %}
   {% assign version = item.slug %}
   <h1 id="{% if forloop.index == 1 %}nowchange{% else %}HMCL-{{ version }}{% endif %}" data-version="{{ version }}">HMCL {{ version }}</h1>

_layouts/default.html

@@ -1,12 +1,13 @@
 ---
 layout: compress
 ---
+{%- assign locale = page.locale | default: layout.locale | default: site.locale %}
 
 <!doctype html>
 {% include copyright.html %}
-<html lang="{{ site.locale | replace: "_", "-" | default: "en" }}" class="no-js">
+<html lang="{{ locale | replace: "_", "-" | default: "en" }}" class="no-js">
   <head>
-    {% include head.html %}
+    {% include head.html locale=locale %}
     {% include head/custom.html %}
   </head>
 
@@ -15,8 +16,8 @@ layout: compress
     <div class="notice--warning text-center m0" style="position: sticky; top: 0; z-index: 999; padding: 0.4em;">当前站点为预览构建而非官方文档。如需反馈问题，请前往 <a href="https://github.com/HMCL-dev/HMCL-docs/pull/{{ site.preview.pr-number }}">#{{ site.preview.pr-number }}</a> 留言。</div>
     {% endif %}
 
-    {% include_cached skip-links.html %}
+    {% include_cached skip-links.html locale=locale %}
-    {% include_cached masthead.html %}
+    {% include_cached masthead.html locale=locale %}
 
     <div class="initial-content">
       {{ content }}
@@ -25,17 +26,17 @@ layout: compress
 
     {% if site.search == true %}
       <div class="search-content">
-        {% include_cached search/search_form.html %}
+        {% include_cached search/search_form.html locale=locale %}
       </div>
     {% endif %}
 
     <div id="footer" class="page__footer">
       <footer>
         {% include footer/custom.html %}
-        {% include_cached footer.html %}
+        {% include_cached footer.html locale=locale %}
       </footer>
     </div>
 
-    {% include scripts.html %}
+    {% include scripts.html locale=locale %}
   </body>
 </html>

_layouts/document.html

@@ -2,12 +2,13 @@
 layout: single
 ---
 
-{% if jekyll.environment == 'production' and page.hits %}
-<img src="https://hits.zkitefly.eu.org/?tag={{ page.url | absolute_url | url_encode }}" alt="Hits" decoding="async">
-{% endif %}
-
-<div class="notice--info">
-  <p>本文由 {{ page.author | default: '未署名用户' }} 创建{% if page.contributors %}，并由 {{ page.contributors | join: ' ' }} 编辑{% endif %}。</p>
-</div>
-
 {{ content }}
+
+{% if page.author or page.contributors or jekyll.environment == 'production' and page.hits  %}
+<script src="{{ '/assets/js/meta.js' | relative_url }}"></script>
+<script>
+  {%- if page.author %}appendMeta("{{ page.author }}", "fas fa-user-pen");{% endif -%}
+  {%- for contributor in page.contributors %}appendMeta("{{ contributor }}", "fas fa-user-pen");{% endfor -%}
+  {%- if jekyll.environment == 'production' and page.hits %}hits({{ page.url | absolute_url | jsonify }});{% endif -%}
+</script>
+{% endif %}

_layouts/home.html

@@ -1,19 +0,0 @@
----
-layout: document
----
-
-{{ content }}
-
-{% capture list %}
-{% for group in site.data.navigation.docs -%}
-## {{ group.title }}
-{% for item in group.children -%}
-1. [{{ item.title }}]({{ item.url | relative_url }})
-{%- if item.description %}\
-   {{ item.description }}
-{%- endif %}
-{% endfor %}
-{% endfor %}
-{% endcapture %}
-
-{{ list | markdownify }}

_layouts/settings.html

@@ -1,46 +1,55 @@
 ---
-layout: document
+layout: single
 ---
 
-{% for group in page.data %}
+{%- for group in page.data %}
-
+<h2 id="{{ group.title }}">{{ group.title }}</h2>
-{% capture notice %}
-
-## {{ group.title }}
-
 {% for pair in group.settings %}
 {% assign name = pair[0] %}
 {% assign value = pair[1] %}
 {% assign setting = site.data.settings[name] %}
-
-{% if setting.type == 'radio' %}
 <div class="notice">
-  <ul class="task-list">
+  <h3 id="{{ name }}">{{ value.title }}</h3>
-    <li><strong>{{ value.title }}</strong></li>
+  {% if value.description %}<p>{{ value.description }}</p>{% endif %}
-    <li>{{ value.description }}</li>
+  {% if setting.type == 'radio' %}
-    {% for option in setting.options %}
+  {% for option in setting.options %}
-    <li class="task-list-item">
+  <label>
-      <input type="radio" class="task-list-item-checkbox" name="{{ name }}" value="{{ option }}" id="{{ name }}_{{ option }}"{% if setting.default == option %} checked{% endif %}><label for="{{ name }}_{{ option }}">{{ value.options[option] }}</label>
+    <input type="radio"{% if setting.default == option %} checked{% endif %} class="setting-item" name="{{ name }}" value="{{ option }}">
-    </li>
+    {{ value.options[option] }}
-    {% endfor %}
+  </label>
-  </ul>
+  {% endfor %}
+  {% elsif setting.type == 'multi-radio' %}
+  <table class="setting-multi-radio">
+    <thead>
+      <tr>
+        <th>{{ value.title }}</th>
+        {% for item in setting.children %}
+        {% capture item_name %}{{ item[0] }}{% endcapture %}
+        <th>{{ value.children[item_name] }}</th>
+        {% endfor %}
+      </tr>
+    </thead>
+    <tbody>
+      {% for option in setting.options %}
+      <tr>
+        <th>{{ value.options[option] }}</th>
+        {% for item in setting.children %}
+        <td><input class="setting-item"{% if item[1].default == option %} checked{% endif %} type="radio" name="{{ name }}.{{ item[0] }}" value="{{ option }}"></td>
+        {% endfor %}
+      </tr>
+      {% endfor %}
+    </tbody>
+  </table>
+  {% endif %}
 </div>
+{% endfor %}
+{% endfor %}
 
 <script>
-  settings.onChange("{{ name }}", function (newValue, oldValue) {
+  for (const settingItem of document.getElementsByClassName("setting-item")) {
-    var list = document.getElementsByName("{{ name }}");
+    settingItem.addEventListener("change", ({ target }) => settings.set(target.name, target.value));
-    for (var i = 0; i < list.length; i++) {
+    settings.onChange(settingItem.name, (value) => settingItem.type === "radio" && (settingItem.checked = settingItem.value === value));
-      list[i].checked = list[i].value === newValue;
+  }
-      list[i].onchange = function () {
-        if (this.checked) {
-          settings.set(this.name, this.value);
-        }
-      }
-    }
-  });
 </script>
-{% endif %}
+
-{% endfor %}
+<style>.notice label input { display: inline }</style>
-{% endcapture %}
-{{ notice | markdownify }}
-{% endfor %}

_modpack/bundled-java.md

@@ -1,5 +1,6 @@
 ---
 title: 整合包自带 Java 教程
+excerpt: 本文介绍了如何在整合包配置中自带 Java 环境
 date: 2021-10-09 23:18:02 +0800
 ---
 

_modpack/serverpack.md

@@ -1,25 +1,28 @@
 ---
 title: 服务端自动更新整合包制作教程
 excerpt: 创建可自动更新的服务器整合包
-date: 2021-08-22 23:18:02 +0800
+date: 2021-08-22T23:18:02+08:00
+last_modified_at: 2025-12-06T09:37:00+08:00
 author: huanghongxun
 ---
 
 HMCL 允许服务器管理员借助服务端自动更新整合包来实现自动分发整合包更新，这将大大方便有需要频繁更新游戏客户端 Mod、配置等信息的服务器管理员。
+
 HMCL 需要服务器管理员额外提供一个 HTTP 服务器（只需要能提供静态文件服务，比如 Apache 和 Nginx 皆可）来提供检查整合包更新并允许 HMCL 下载更新文件。
 
 ## 第一步：导出整合包
+
 在 HMCL 中右键做好的客户端版本，选择`导出整合包`：
 
-![](/assets/img/docs/serverpack/1.png)
+![](/assets/img/docs/serverpack/img1.png)
 
 选择导出为`服务器自动更新整合包`：
 
-![](/assets/img/docs/serverpack/1-1.png)
+![](/assets/img/docs/serverpack/img2.png)
 
 填写整合包信息，整合包下载链接前缀如何填写请看下文
 
-![](/assets/img/docs/serverpack/1-2.png)
+![](/assets/img/docs/serverpack/img3.png)
 
 选择需要包含在整合包内的文件后将产生整合包压缩文件
 
@@ -27,21 +30,22 @@ HMCL 需要服务器管理员额外提供一个 HTTP 服务器（只需要能提
 
 接着创建一个全新的空文件夹，将启动器复制进去
 
-![](/assets/img/docs/serverpack/1-3.png)
+![](/assets/img/docs/serverpack/img4.png)
 
 运行启动器，并导入刚才导出的整合包，导入完成后，这个文件夹（这里叫“新整合包”）可以打包发给玩家。
 
-## 第三步，部署整合包更新服务器
+## 第三步：部署整合包更新服务器
+
 你可以借助 Apache、Nginx 等支持静态文件的 HTTP 服务器软件提供文件。首先，决定好整合包下载链接前缀，比如我希望 HMCL 从远程服务器的 http://www.site.com/modpack 目录下存放整合包的更新信息，则在之前导出整合包的整合包下载前缀中填写 http://www.site.com/modpack。
 
-![](/assets/img/docs/serverpack/1-4.png)
+![](/assets/img/docs/serverpack/img5.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)
+![](/assets/img/docs/serverpack/img6.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 文件夹下即可完成新整合包的部署。
+如果你需要更新整合包，那么将新的整合包经过第一步导出新的整合包压缩文件，并解压到类似 http://www.site.com/modpack 文件夹下即可完成新整合包的部署。

_modpack/serverpack2.md

@@ -1,14 +1,15 @@
 ---
-title: 使用HMCL启动器配置服务器客户端自动更新
+title: 配置客户端自动更新（宝塔面板）
+excerpt: 本文介绍了如何使用宝塔面板配置客户端自动更新
 date: 2021-08-22 23:18:02 +0800
 ---
 
 ## 备注
 
-> 文章原作者：[hy黑影](https://www.mcbbs.net/home.php?mod=space&uid=3051111)
+> 文章原作者：[hy黑影](https://www.mcbbs.net/home.php?mod=space&uid=3051111)\
-> 转载：Zkitfly
+> 转载：Zkitfly\
-> 部分内容进行了稍作打磨
+> 部分内容进行了稍作打磨\
-> 本教程转载至[https://www.mcbbs.net/thread-1103864-1-1.html?action=printable](https://www.mcbbs.net/thread-1103864-1-1.html?action=printable)
+> 本教程转载自 https://www.mcbbs.net/thread-1103864-1-1.html
 
 ## **前言**
 

_modpack/serverpack3.md

@@ -1,6 +1,6 @@
 ---
-title: Nginx作为静态资源服务器，使用HMCL启动器配置服务器客户端自动更新
+title: 配置客户端自动更新 (Nginx)
-excerpt: 使用 Nginx 搭建整合包更新服务
+excerpt: 本文介绍了如何使用 Nginx 服务器配置客户端自动更新
 date: 2023-01-11 14:13:45 +0800
 author: buggzd
 ---

_multiplayer/feedback.md

@@ -1,22 +1,16 @@
 ---
 title: 多人联机反馈
-date: 2025-12-03 16:39:00 +0800
+date: 2025-10-07T18:44:00+08:00
+last_modified_at: 2025-12-03T16:39:00+08:00
 author: Burning_TNT
 contributors:
-  -TyMxy
+  - TyMxy
 ---
 
 ## Terracotta | 陶瓦联机
 
-<!--{% comment %}-->
 > [!TIP]
-> 欢迎您填写[反馈表单](https://f.kdocs.cn/ksform/w/write/njMwdtgD?channel=mdlsjp)。
-<!--{% endcomment %}-->
-
-<!----{{ '>' }}
 > 欢迎您填写<a href="https://f.kdocs.cn/ksform/w/write/njMwdtgD?channel=mdlsjp" data-delay="10" data-redirect>反馈表单</a>。
-{: .notice--success }
-{{ '<' }}!---->
 
 我们注意到了 EasyTier 项目。它提供了一种简单、安全、去中心化的异地组网方案，足以承载 Minecraft 的联机需求。
 在 EasyTier 开发团队的帮助下，我们决定重新在启动器内提供联机服务。
@@ -31,4 +25,4 @@ contributors:
 需要特别提醒的是：联机功能不会更不能取代 Minecraft: Java Edition 服务器。
 它的主要目标依然是让朋友之间能共同游玩，而不是长时间的对外开放。
 
-最后，我想感谢一切参与到 EasyTier、Terracotta \| 陶瓦联机开发和测试、为 EasyTier 提供打洞和中继服务器的社区志愿者。欢迎大家访问 easytier.cn 深入了解这一项目。
+最后，我想感谢一切参与到 EasyTier、Terracotta \| 陶瓦联机开发和测试、为 EasyTier 提供打洞和中继服务器的社区志愿者。欢迎大家访问 [easytier.cn](https://easytier.cn) 深入了解这一项目。

_plugins/auto-link.rb

@@ -1,30 +0,0 @@
-require "nokogiri"
-require "addressable/uri"
-
-Jekyll::Hooks.register [:pages, :documents], :post_convert do |doc|
-  next unless doc.output_ext == ".html"
-
-  site = doc.site
-  liquid_context = Liquid::Context.new({}, {}, { site: site })
-
-  process_uri = lambda do |path|
-    uri = Addressable::URI.parse(path)
-    if uri&.path
-      uri.path = Liquid::Template.parse("{% link #{uri.path[1..]} %}").render!(liquid_context)
-    end
-    uri.to_s
-  end
-
-  fragment = Nokogiri::HTML::DocumentFragment.parse(doc.content)
-  fragment.css("[src^=\"/assets/\"],[src^=\"/\"][src$=\".md\"],[src^=\"/\"][src*=\".md#\"]").each do |item|
-    if item["src"]
-      item["src"] = process_uri.call(item["src"])
-    end
-  end
-  fragment.css("[href^=\"/assets/\"],[href^=\"/\"][href$=\".md\"],[href^=\"/\"][href*=\".md#\"]").each do |item|
-    if item["href"]
-      item["href"] = process_uri.call(item["href"])
-    end
-  end
-  doc.content = fragment.to_html
-end

_plugins/filter-version-sort.rb

@@ -0,0 +1,21 @@
+module VersionSortFilter
+  def version_sort(input, property)
+    raise ArgumentError, "Cannot sort a null object." if input.nil?
+    raise ArgumentError, "Cannot sort an object with a null property." if property.nil?
+    raise ArgumentError, "Property #{property} is not an array of strings." unless valid_string_array?(input, property)
+
+    input.sort_by { |version| version_to_numbers(version[property]) }
+  end
+
+  private
+
+  def valid_string_array?(array, property)
+    array.is_a?(Array) && array.all? { |element| element[property].is_a?(String) }
+  end
+
+  def version_to_numbers(version_string)
+    version_string.split('.').map { |n| n.to_i }
+  end
+end
+
+Liquid::Template.register_filter(VersionSortFilter)

_plugins/kramdown_enhancer.rb

@@ -0,0 +1,195 @@
+begin
+  require "webp-ffi"
+rescue LoadError; end
+
+module KramdownEnhancer
+  GITHUB_LINK_REGEX = /\b(GP-\d+|GC-[0-9a-f]{7})\b/
+  BLOCKQUOTE_TYPES = {
+    note: "notice--info",
+    tip: "notice--success",
+    important: "notice--primary",
+    warning: "notice--warning",
+    caution: "notice--danger",
+  }
+
+  class << self
+    def webp
+      @webp ||= {}
+    end
+
+    def file
+      @file ||= {}
+    end
+
+    def baseurl
+      @baseurl
+    end
+
+    def baseurl=(input)
+      @baseurl =
+        if input.is_a?(String) && !input.empty?
+          str = input.start_with?("/") ? input : "/#{input}"
+          str.chomp("/")
+        else
+          ""
+        end
+    end
+  end
+
+  class WebpFile < Jekyll::StaticFile
+    def write(dest)
+      true
+    end
+  end
+
+  module Html
+    def convert_a(el, indent)
+      if el.attr["href"].is_a?(String) && !el.options[:relative]
+        el.attr["href"] = relative_url(el.attr["href"])
+        el.options[:relative] = true
+      end
+
+      super
+    end
+
+    def convert_img(el, indent)
+      if el.attr["src"].is_a?(String) && !el.options[:relative]
+        src = el.attr["src"]
+        el.attr["src"] = relative_url(src)
+        el.options[:relative] = true
+
+        if KramdownEnhancer.webp[src] && !el.options[:webp] && !el.options[:picture]
+          webp_src = KramdownEnhancer.webp[src]
+          pic = Kramdown::Element.new(:html_element, "picture")
+          pic.children << Kramdown::Element.new(:html_element, "source", { "srcset" => relative_url(webp_src), "type" => "image/webp" })
+          el.options[:picture] = true
+          el.options[:webp] = true
+          pic.children << el
+          return convert_html_element(pic, indent)
+        end
+      end
+
+      super
+    end
+
+    def convert_blockquote(el, indent)
+      p = el.children.first
+      return super if p&.type != :p || p.children.empty?
+
+      first = p.children.first
+      return super unless first&.type == :text
+
+      text = first.value.downcase
+      KramdownEnhancer::BLOCKQUOTE_TYPES.each do |type, class_name|
+        prefix = "[!#{type}]"
+        prefix_with_newline = "#{prefix}\n"
+
+        # case A: <p>[!NOTE]</p>
+        if text == prefix
+          el.attr["class"] = [el.attr["class"], class_name].compact.join(" ")
+          p.children.shift
+          break
+        # case B: <p>[!NOTE]\n some text</p>
+        elsif text.start_with?(prefix_with_newline)
+          el.attr["class"] = [el.attr["class"], class_name].compact.join(" ")
+          first.value = first.value[prefix_with_newline.length..-1] || ""
+          break
+        end
+      end
+
+      super
+    end
+
+    def convert_html_element(el, indent)
+      unless el.options[:relative]
+        if el.value == "a" && el.attr["href"].is_a?(String)
+          el.attr["href"] = relative_url(el.attr["href"])
+          el.options[:relative] = true
+        elsif el.value == "img" && el.attr["src"].is_a?(String)
+          src = el.attr["src"]
+          el.attr["src"] = relative_url(el.attr["src"])
+          el.options[:relative] = true
+
+          if KramdownEnhancer.webp[src] && !el.options[:webp] && !el.options[:picture]
+            webp_src = KramdownEnhancer.webp[src]
+            pic = Kramdown::Element.new(:html_element, "picture")
+            pic.children << Kramdown::Element.new(:html_element, "source", { "srcset" => relative_url(webp_src), "type" => "image/webp" })
+            el.options[:webp] = true
+            pic.children << el
+            return convert_html_element(pic, indent)
+          end
+        elsif el.value == "picture"
+          el.children.each do |child|
+            child.options[:picture] = true
+          end
+        end
+      end
+      super(el, indent)
+    end
+
+    def convert_text(el, indent)
+      return super(el, indent) unless !el.options[:github_link] && KramdownEnhancer::GITHUB_LINK_REGEX.match?(el.value)
+      list = el.value.split(KramdownEnhancer::GITHUB_LINK_REGEX)
+      el.type = :html_element
+      el.value = "span"
+      el.children = list.reject(&:empty?).map do |item|
+        if KramdownEnhancer::GITHUB_LINK_REGEX.match(item)
+          href =
+            if item.start_with?("GP-")
+              "https://github.com/HMCL-dev/HMCL/pull/#{item[3..]}"
+            else
+              "https://github.com/HMCL-dev/HMCL/commit/#{item[3..]}"
+            end
+          link = Kramdown::Element.new(:a, nil, {"href": href, "target": "_blank"})
+          link.children = [Kramdown::Element.new(:text, item, nil, :github_link => true)]
+          link
+        else
+          Kramdown::Element.new(:text, item, nil, :github_link => true)
+        end
+      end
+      convert_html_element(el, indent)
+    end
+
+    private
+
+    def relative_url(input)
+      if input.is_a?(String) && input.start_with?("/")
+        input = input.start_with?("/") ? input : "/#{input}"
+        uri = Addressable::URI.parse(input)
+        if uri
+          if uri.path.length > 1
+            file = KramdownEnhancer.file[uri.path[1..]]
+            uri.path = file.url if file
+          end
+          uri.path = "#{KramdownEnhancer.baseurl}#{uri.path}"
+          return uri.to_s
+        end
+      end
+      input
+    end
+  end
+end
+
+Jekyll::Hooks.register :site, :post_read do |site|
+  KramdownEnhancer.baseurl = site.config["baseurl"]
+  webp_list = []
+  webp_enabled = defined?(WebP)
+  site.each_site_file do |file|
+    KramdownEnhancer.file[file.relative_path] = file
+    if file.is_a?(Jekyll::StaticFile)
+      url = "#{file.url}.webp"
+      source = "#{file.path}.webp"
+      destination = File.join(site.dest, url)
+      if File.exist?(source)
+        KramdownEnhancer.webp[file.url] = url
+      elsif webp_enabled && %w[.png .jpg .jpeg .tif .tiff].include?(file.extname.downcase)
+        FileUtils.mkdir_p(File.dirname(destination))
+        WebP.encode(file.path, destination)
+        webp_list.push(KramdownEnhancer::WebpFile.new(site, site.dest, File.dirname(url), File.basename(url)))
+        KramdownEnhancer.webp[file.url] = url
+      end
+    end
+  end
+  site.static_files.concat(webp_list)
+  Kramdown::Converter::Html.prepend(KramdownEnhancer::Html)
+end

_sass/minimal-mistakes-plus.scss

@@ -1,4 +1,40 @@
-@import "minimal-mistakes";
+/* Copyright comment */
+@import "minimal-mistakes/copyright";
+
+/* Variables */
+@import "minimal-mistakes/variables";
+
+/* Mixins and functions */
+@import "minimal-mistakes/vendor/breakpoint/breakpoint";
+@include breakpoint-set("to ems", true);
+@import "minimal-mistakes/vendor/magnific-popup/magnific-popup"; // Magnific Popup
+@import "minimal-mistakes/vendor/susy/susy";
+@import "minimal-mistakes/mixins";
+
+/* Core CSS */
+@import "minimal-mistakes/reset";
+@import "minimal-mistakes/base";
+@import "minimal-mistakes/forms";
+@import "minimal-mistakes/tables";
+@import "minimal-mistakes/animations";
+
+/* Components */
+@import "minimal-mistakes/buttons";
+@import "minimal-mistakes/notices";
+@import "minimal-mistakes/masthead";
+@import "minimal-mistakes/navigation";
+@import "minimal-mistakes/footer";
+@import "minimal-mistakes/search";
+@import "minimal-mistakes/syntax";
+
+/* Utility classes */
+@import "minimal-mistakes/utilities";
+
+/* Layout specific */
+@import "minimal-mistakes/page";
+@import "minimal-mistakes-plus/archive";
+@import "minimal-mistakes/sidebar";
+@import "minimal-mistakes/print";
 
 blockquote {
   margin-inline: 0;
@@ -11,14 +47,27 @@ blockquote {
   word-break: break-word;
 }
 
-.notice ul:first-child {
-  margin-top: 0;
-}
-
-.task-list-item label {
-  display: inline
-}
-
 .m0 {
   margin: 0 !important;
 }
+
+table.setting-multi-radio td {
+  border: 0;
+  text-align: center;
+  border-left: 1px solid mix(#000, $border-color, 25%);
+}
+
+input[type="radio"] {
+  width: 0;
+  margin: 0;
+  margin-inline-end: 1em;
+  font-family: var(--fa-family-classic);
+}
+
+input[type="radio"]::before {
+  content: "\f111";
+}
+
+input[type="radio"]:checked::before {
+  content: "\f192";
+}

_sass/minimal-mistakes-plus/_archive.scss

@@ -0,0 +1,398 @@
+/* ==========================================================================
+   ARCHIVE
+   ========================================================================== */
+
+.archive {
+  margin-top: 1em;
+  margin-bottom: 2em;
+
+  @include breakpoint($large) {
+    float: inline-end;
+    width: calc(100% - #{$right-sidebar-width-narrow});
+    padding-inline-end: $right-sidebar-width-narrow;
+  }
+
+  @include breakpoint($x-large) {
+    width: calc(100% - #{$right-sidebar-width});
+    padding-inline-end: $right-sidebar-width;
+  }
+}
+
+.archive__item {
+  position: relative;
+
+  a {
+    position: relative;
+    z-index: 10;
+  }
+
+  a[rel="permalink"] {
+    position: static;
+  }
+}
+
+.archive__subtitle {
+  margin: 1.414em 0 0.5em;
+  padding-bottom: 0.5em;
+  font-size: $type-size-5;
+  color: $muted-text-color;
+  border-bottom: 1px solid $border-color;
+
+  + .list__item .archive__item-title {
+    margin-top: 0.5em;
+  }
+}
+
+.archive__item-title {
+  margin-bottom: 0.25em;
+  font-family: $sans-serif-narrow;
+  line-height: initial;
+  overflow: hidden;
+  text-overflow: ellipsis;
+
+  a[rel="permalink"]::before {
+    content: '';
+    position: absolute;
+    inset: 0;
+  }
+
+  a + a {
+    opacity: 0.5;
+  }
+}
+
+/* remove border*/
+.page__content {
+  .archive__item-title {
+    margin-top: 1em;
+    border-bottom: none;
+  }
+}
+
+.archive__item-excerpt {
+  margin-top: 0;
+  font-size: $type-size-6;
+
+  & + p {
+    text-indent: 0;
+  }
+
+  a {
+    position: relative;
+  }
+}
+
+.archive__item-teaser {
+  position: relative;
+  border-radius: $border-radius;
+  overflow: hidden;
+
+  img {
+    width: 100%;
+  }
+}
+
+.archive__item-caption {
+  position: absolute;
+  bottom: 0;
+  inset-inline-end: 0;
+  margin: 0 auto;
+  padding: 2px 5px;
+  color: #fff;
+  font-family: $caption-font-family;
+  font-size: $type-size-8;
+  background: #000;
+  text-align: end;
+  z-index: 5;
+  opacity: 0.5;
+  border-radius: $border-radius 0 0 0;
+
+  @include breakpoint($large) {
+    padding: 5px 10px;
+  }
+
+  a {
+    color: #fff;
+    text-decoration: none;
+  }
+}
+
+/*
+   List view
+   ========================================================================== */
+
+.list__item {
+  .page__meta {
+    margin: 0 0 4px;
+    font-size: 0.6em;
+  }
+}
+
+/*
+   Grid view
+   ========================================================================== */
+
+.archive {
+  .grid__wrapper {
+    /* extend grid elements to the right */
+
+    @include breakpoint($large) {
+      margin-inline-end: -1 * $right-sidebar-width-narrow;
+    }
+
+    @include breakpoint($x-large) {
+      margin-inline-end: -1 * $right-sidebar-width;
+    }
+  }
+}
+
+.grid__item {
+  margin-bottom: 2em;
+
+  @include breakpoint($small) {
+    float: inline-start;
+    width: span(5 of 10);
+
+    &:nth-child(2n + 1) {
+      clear: both;
+      margin-inline-start: 0;
+    }
+
+    &:nth-child(2n + 2) {
+      clear: none;
+      margin-inline-start: gutter(of 10);
+    }
+  }
+
+  .page__meta {
+    margin: 0 0 4px;
+    font-size: 0.6em;
+  }
+
+  .page__meta-sep {
+    display: block;
+
+    &::before {
+      display: none;
+    }
+  }
+
+  .archive__item-title {
+    margin-top: 0.5em;
+    font-size: $type-size-5;
+  }
+
+  .archive__item-excerpt {
+    font-size: $type-size-6;
+  }
+
+  .archive__item-teaser {
+    @include breakpoint($small) {
+      max-height: 200px;
+    }
+
+    @include breakpoint($medium) {
+      max-height: 120px;
+    }
+  }
+}
+
+/*
+   Features
+   ========================================================================== */
+
+.feature__wrapper {
+  @include clearfix();
+  margin-bottom: 2em;
+  border-bottom: 1px solid $border-color;
+
+  .archive__item-title {
+    margin-bottom: 0;
+  }
+}
+
+.feature__item {
+  position: relative;
+  margin-bottom: 2em;
+  font-size: 1.125em;
+
+  @include breakpoint($small) {
+    float: inline-start;
+    margin-bottom: 0;
+    width: span(4 of 12);
+
+    &:nth-child(3n + 1) {
+      clear: both;
+      margin-inline-start: 0;
+    }
+
+    &:nth-child(3n + 2) {
+      clear: none;
+      margin-inline-start: gutter(of 12);
+    }
+
+    &:nth-child(3n + 3) {
+      clear: none;
+      margin-inline-start: gutter(of 12);
+    }
+
+    .feature__item-teaser {
+      max-height: 200px;
+      overflow: hidden;
+    }
+  }
+
+  .archive__item-body {
+    padding-inline: gutter(1 of 12);
+  }
+
+  a.btn::before {
+    content: '';
+    position: absolute;
+    inset: 0;
+  }
+
+  &--left, &--right {
+    position: relative;
+    margin-inline: 0;
+    width: 100%;
+    clear: both;
+    font-size: 1.125em;
+
+    a.btn::before {
+      content: '';
+      position: absolute;
+      inset: 0;
+    }
+
+    .archive__item-teaser {
+      margin-bottom: 2em;
+    }
+  }
+
+  &--left {
+    float: inline-start;
+
+    .archive__item {
+      float: inline-start;
+    }
+
+    @include breakpoint($small) {
+      .archive__item-teaser {
+        float: inline-start;
+        width: span(5 of 12);
+      }
+
+      .archive__item-body {
+        float: inline-end;
+        width: span(7 of 12);
+        padding-inline-start: gutter(0.5 of 12);
+        padding-inline-end: gutter(1 of 12);
+      }
+    }
+  }
+
+  &--right {
+    float: inline-end;
+
+    .archive__item {
+      float: inline-end;
+    }
+
+    @include breakpoint($small) {
+      text-align: end;
+
+      .archive__item-teaser {
+        float: inline-end;
+        width: span(5 of 12);
+      }
+
+      .archive__item-body {
+        float: inline-start;
+        width: span(7 of 12);
+        padding-inline-start: gutter(1 of 12);
+        padding-inline-end: gutter(0.5 of 12);
+      }
+    }
+  }
+
+  &--center {
+    position: relative;
+    float: inline-start;
+    margin-inline: 0;
+    width: 100%;
+    clear: both;
+    font-size: 1.125em;
+
+    .archive__item {
+      float: inline-start;
+      width: 100%;
+    }
+
+    .archive__item-teaser {
+      margin-bottom: 2em;
+    }
+
+    a.btn::before {
+      content: '';
+      position: absolute;
+      inset: 0;
+    }
+
+    @include breakpoint($small) {
+      text-align: center;
+
+      .archive__item-teaser {
+        margin: 0 auto;
+        width: span(5 of 12);
+      }
+
+      .archive__item-body {
+        margin: 0 auto;
+        width: span(7 of 12);
+      }
+    }
+  }
+}
+
+/* Place inside an archive layout */
+
+.archive {
+  .feature__wrapper {
+    .archive__item-title {
+      margin-top: 0.25em;
+      font-size: 1em;
+    }
+  }
+
+  .feature__item,
+  .feature__item--left,
+  .feature__item--center,
+  .feature__item--right {
+    font-size: 1em;
+  }
+}
+
+/*
+   Wide Pages
+   ========================================================================== */
+
+.wide {
+  .archive {
+    @include breakpoint($large) {
+      padding-inline-end: 0;
+    }
+
+    @include breakpoint($x-large) {
+      padding-inline-end: 0;
+    }
+  }
+}
+
+/* Place inside a single layout */
+
+.layout--single {
+  .feature__wrapper {
+    display: inline-block;
+  }
+}

assets/css/skins/catppuccin_latte.scss

@@ -0,0 +1,8 @@
+---
+---
+
+@charset "utf-8";
+
+$sans-serif: -apple-system, BlinkMacSystemFont, "Roboto", "Segoe UI", "Noto Sans", Helvetica, Arial, sans-serif, "Apple Color Emoji", "Segoe UI Emoji";
+@import "minimal-mistakes/skins/catppuccin_latte";
+@import "minimal-mistakes-plus";

assets/css/skins/catppuccin_mocha.scss

@@ -0,0 +1,8 @@
+---
+---
+
+@charset "utf-8";
+
+$sans-serif: -apple-system, BlinkMacSystemFont, "Roboto", "Segoe UI", "Noto Sans", Helvetica, Arial, sans-serif, "Apple Color Emoji", "Segoe UI Emoji";
+@import "minimal-mistakes/skins/catppuccin_mocha";
+@import "minimal-mistakes-plus";