构建前执行分支合并 (#320 )

为预览站点添加提示信息 (#319 )
Co-authored-by: Burning_TNT <pangyl08@163.com>
2026-09-27 06:31:12 +08:00 · 2025-11-02 22:32:51 +08:00 · 2025-11-02 22:32:42 +08:00 · 2025-11-02 22:30:46 +08:00 · 2025-11-02 22:01:30 +08:00 · 2025-11-02 20:24:55 +08:00
375 changed files with 6864 additions and 23100 deletions
@@ -0,0 +1,37 @@
+kind: pipeline
+type: docker
+name: default
+
+clone:
+  depth: 1
+
+steps:
+- name: build
+  image: ruby:3.4
+  environment:
+    JEKYLL_ENV: production
+    BUNDLE_PATH: vendor/bundle
+  commands:
+    - bundle config mirror.https://rubygems.org https://mirrors.cloud.tencent.com/rubygems
+    - bundle install --verbose
+    - bundle exec jekyll build --trace --verbose
+  volumes:
+  - name: dist
+    path: /drone/src/_site
+  - name: vendor
+    path: /drone/src/vendor
+  - name: jekyll-cache
+    path: /drone/src/.jekyll-cache
+  when:
+    branch: [main]
+
+volumes:
+- name: dist
+  host:
+    path: /home/ubuntu/docs.hmcl.net/www
+- name: vendor
+  host:
+    path: /home/ubuntu/docs.hmcl.net/cache/vendor
+- name: jekyll-cache
+  host:
+    path: /home/ubuntu/docs.hmcl.net/cache/jekyll-cache
@@ -0,0 +1,21 @@
+name: Sync to Gitee
+
+on:
+  push
+
+jobs:
+  run:
+    if: ${{ github.repository_owner == 'HMCL-dev' }}
+    runs-on: ubuntu-latest
+    steps:
+      - name: Mirror Github to Gitee
+        uses: Yikun/hub-mirror-action@v1.4
+        with:
+          src: github/HMCL-dev
+          dst: gitee/huanghongxun
+          static_list: 'HMCL-docs'
+          force_update: true
+          debug: true
+          dst_key: ${{ secrets.GITEE_SYNC_BOT_PRIVATE_KEY }}
+          dst_token: ${{ secrets.GITEE_SYNC_BOT_TOKEN }}
+          cache_path: /github/workspace/hub-mirror-cache
@@ -0,0 +1,391 @@
+name: PR Preview
+on:
+  issue_comment:
+    types: [created]
+  pull_request_target:
+    types: [labeled, synchronize, closed]
+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
+jobs:
+  preview-remove:
+    if: >-
+      ${{
+        !github.event.repository.fork && (
+          ( github.event_name == 'pull_request_target' && (
+              github.event.action == 'closed' || (
+                github.event.action == 'labeled' &&
+                github.event.label.name == 'preview/remove'
+              )
+            )
+          ) || (
+            github.event_name == 'issue_comment' &&
+            github.event.issue.pull_request &&
+            github.event.comment.body == '/preview remove' &&
+            contains('OWNER,MEMBER', github.event.comment.author_association)
+          )
+        )
+      }}
+    runs-on: ubuntu-latest
+    permissions:
+      actions: write
+      contents: write
+      pull-requests: write
+    steps:
+      - id: restore-pages
+        name: Restore Pages
+        uses: actions/cache/restore@v4
+        with:
+          key: pages-${{ github.run_id }}
+          path: /home/runner/gh-pages
+          restore-keys: pages-
+      - name: Prepare Pages
+        run: |
+          mkdir -p /home/runner/gh-pages/data/{files,refs}
+          rm -rf /home/runner/gh-pages/PR${{ env.GITHUB_PR_NUMBER }}
+          grep -rlw 'PR${{ env.GITHUB_PR_NUMBER }}' /home/runner/gh-pages/data/refs | xargs -r sed -i '/\<PR${{ env.GITHUB_PR_NUMBER }}\>/d'
+          for ref in /home/runner/gh-pages/data/refs/*; do
+            if [ ! -s "$ref" ]; then
+              base=$(basename "$ref")
+              rm -f "/home/runner/gh-pages/data/files/$base"
+              rm -f "$ref"
+            fi
+          done
+          echo "[$(date)] Remove Preview PR${{ env.GITHUB_PR_NUMBER }}" > /home/runner/gh-pages/index.html
+      - name: Save Pages
+        uses: actions/cache/save@v4
+        with:
+          key: pages-${{ github.run_id }}
+          path: /home/runner/gh-pages
+      - if: ${{ github.event_name == 'issue_comment' }}
+        id: comment-message
+        name: Comment Message (issue_comment)
+        uses: actions/github-script@v8
+        with:
+          script: |
+            github.rest.issues.updateComment({
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              comment_id: context.payload.comment.id,
+              issue_number: context.issue.number,
+              body: "[Preview] Preview has been removed."
+            });
+      - if: ${{ github.event_name == 'pull_request_target' || steps.comment-message.outcome == 'failure' }}
+        name: Comment Message
+        uses: actions/github-script@v8
+        with:
+          script: |
+            github.rest.issues.createComment({
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              issue_number: context.issue.number,
+              body: "[Preview] Preview has been removed."
+            });
+      - if: ${{ steps.restore-pages.outputs.cache-matched-key }}
+        name: Remove History Cache
+        uses: actions/github-script@v8
+        with:
+          script: |
+            github.rest.actions.deleteActionsCacheByKey({
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              key: "${{ steps.restore-pages.outputs.cache-matched-key }}"
+            });
+      - if: ${{ contains(github.event.pull_request.labels.*.name, 'preview/remove') || contains(github.event.issue.labels.*.name, 'preview/remove') }}
+        name: Remove Label (preview/remove)
+        continue-on-error: true
+        uses: actions/github-script@v8
+        with:
+          script: |
+            github.rest.issues.removeLabel({
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              issue_number: context.issue.number,
+              name: "preview/remove"
+            });
+      - if: ${{ contains(github.event.pull_request.labels.*.name, 'preview/watch') || contains(github.event.issue.labels.*.name, 'preview/watch') }}
+        name: Remove Label (preview/watch)
+        continue-on-error: true
+        uses: actions/github-script@v8
+        with:
+          script: |
+            github.rest.issues.removeLabel({
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              issue_number: context.issue.number,
+              name: "preview/watch"
+            });
+  preview-create-init:
+    if: >-
+      ${{
+        !github.event.repository.fork && (
+          ( github.event_name == 'pull_request_target' && (
+              ( github.event.action == 'labeled' && contains(fromJSON('["preview/create", "preview/watch"]'), github.event.label.name) ) ||
+              ( github.event.action == 'synchronize' && contains(github.event.pull_request.labels.*.name, 'preview/watch') )
+            )
+          ) || (
+            github.event_name == 'issue_comment' &&
+            github.event.issue.pull_request &&
+            contains(fromJSON('["/preview create", "/preview watch"]'), github.event.comment.body) &&
+            contains('OWNER,MEMBER', github.event.comment.author_association)
+          )
+        )
+      }}
+    runs-on: ubuntu-latest
+    permissions:
+      checks: write
+      pull-requests: write
+    outputs:
+      sha: ${{ steps.init.outputs.sha }}
+      domain: ${{ steps.init.outputs.domain }}
+      pathname: ${{ steps.init.outputs.pathname }}
+      repository: ${{ steps.init.outputs.repository }}
+      check-id: ${{ steps.init.outputs.check-id }}
+    steps:
+      - id: init
+        name: Init
+        uses: actions/github-script@v8
+        with:
+          script: |
+            const { owner, repo } = context.repo;
+            const pages = (await octokit.rest.repos.getPages({ owner, repo })).data;
+            const domain = pages.cname || `${owner.toLowerCase()}.github.io`;
+            core.setOutput('domain', domain);
+            core.setOutput('pathname', (pages.cname || repo.toLowerCase() === domain) ? '' : `/${repo}`);
+            const pr = context.payload.pull_request || (await github.rest.pulls.get({
+              owner, repo,
+              pull_number: context.issue.number
+            })).data;
+            core.setOutput('sha', pr.head.sha);
+            core.setOutput('repository', pr.head.repo.full_name);
+            const { data: check } = await github.rest.checks.create({
+              owner, repo,
+              name: "Create preview",
+              head_sha: pr.head.sha,
+              status: "in_progress",
+              started_at: new Date().toISOString(),
+              details_url: `https://github.com/${context.repo.owner}/${context.repo.repo}/actions/runs/${{ github.run_id }}`,
+              output: {
+                title: "Create preview by command",
+                summary: "Preview is being created..."
+              }
+            });
+            core.setOutput('check-id', check.id);
+      - if: ${{ github.event_name == 'issue_comment' && github.event.comment.body == '/preview watch' }}
+        name: Add Label (preview/watch)
+        continue-on-error: true
+        uses: actions/github-script@v8
+        with:
+          script: |
+            github.rest.issues.addLabels({
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              issue_number: context.issue.number,
+              labels: ["preview/watch"]
+            });
+  preview-create-build:
+    needs: preview-create-init
+    runs-on: ubuntu-latest
+    outputs:
+      artifact-id: ${{ steps.upload-site.outputs.artifact-id }}
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v5
+        with:
+          fetch-depth: 0
+      - name: Merge PR
+        run: |
+          git config user.name "github-actions[bot]"
+          git config user.email "41898282+github-actions[bot]@users.noreply.github.com"
+          git fetch https://github.com/${{ needs.preview-create-init.outputs.repository }} ${{ needs.preview-create-init.outputs.sha }}
+          git merge --squash ${{ needs.preview-create-init.outputs.sha }} --no-edit
+          git commit -m "Merge #${{ env.GITHUB_PR_NUMBER }} for preview build"
+      - name: Setup Ruby
+        uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: "3.4"
+          bundler-cache: true
+          cache-version: pr${{ env.GITHUB_PR_NUMBER }}
+      - name: Jekyll Build
+        run: |
+          echo "url: https://${{ needs.preview-create-init.outputs.domain }}" > _action.yml
+          echo "baseurl: ${{ needs.preview-create-init.outputs.pathname }}/PR${{ env.GITHUB_PR_NUMBER }}" >> _action.yml
+          echo "source: ${{ github.workspace }}" >> _action.yml
+          echo "destination: /home/runner/site" >> _action.yml
+          echo "preview:" >> _action.yml
+          echo "  pr-number: ${{ env.GITHUB_PR_NUMBER }}" >> _action.yml
+          bundle exec jekyll build --config _config.yml,_action.yml
+      - id: upload-site
+        name: Upload Site
+        uses: actions/upload-artifact@v4
+        with:
+          name: site
+          path: /home/runner/site
+  preview-create-deploy:
+    needs: [preview-create-init, preview-create-build]
+    runs-on: ubuntu-latest
+    environment:
+      name: github-pages
+      url: https://${{ needs.preview-create-init.outputs.domain }}${{ needs.preview-create-init.outputs.pathname }}/PR${{ env.GITHUB_PR_NUMBER }}
+    permissions:
+      actions: write
+      pages: write
+      id-token: write
+      contents: write
+    steps:
+      - id: restore-pages
+        name: Restore Pages
+        uses: actions/cache/restore@v4
+        with:
+          key: pages-${{ github.run_id }}
+          path: /home/runner/gh-pages
+          restore-keys: pages-
+      - name: Merge Site Before
+        run: |
+          mkdir -p /home/runner/gh-pages/data/{files,refs}
+          rm -rf /home/runner/gh-pages/PR${{ env.GITHUB_PR_NUMBER }}
+          grep -rlw 'PR${{ env.GITHUB_PR_NUMBER }}' /home/runner/gh-pages/data/refs | xargs -r sed -i '/\<PR${{ env.GITHUB_PR_NUMBER }}\>/d'
+      - name: Merge Site
+        uses: actions/download-artifact@v5
+        with:
+          name: site
+          path: /home/runner/gh-pages/PR${{ env.GITHUB_PR_NUMBER }}
+      - name: Merge Site After
+        run: |
+          find /home/runner/gh-pages/PR${{ env.GITHUB_PR_NUMBER }} -type f | while read file; do
+            hash=$(sha256sum "$file" | cut -d' ' -f1)
+            size=$(stat -c%s "$file")
+            key="${hash}-${size}"
+            target="/home/runner/gh-pages/data/files/$key"
+            if [ ! -f "$target" ]; then
+              mv "$file" "$target"
+            else
+              rm -f "$file"
+            fi
+            ln -s "$(realpath --relative-to="$(dirname "$file")" "$target")" "$file"
+            echo "PR${{ env.GITHUB_PR_NUMBER }}" >> "/home/runner/gh-pages/data/refs/$key"
+          done
+          for ref in /home/runner/gh-pages/data/refs/*; do
+            if [ ! -s "$ref" ]; then
+              base=$(basename "$ref")
+              rm -f "/home/runner/gh-pages/data/files/$base"
+              rm -f "$ref"
+            fi
+          done
+          echo "[$(date)] Preview PR${{ env.GITHUB_PR_NUMBER }}" > /home/runner/gh-pages/index.html
+      - id: upload-pages
+        name: Upload Pages
+        uses: actions/upload-pages-artifact@v4
+        with:
+          name: github-pages
+          path: /home/runner/gh-pages
+      - name: Deploy Pages
+        uses: actions/deploy-pages@v4
+        with:
+          artifact_name: github-pages
+      - name: Save Pages
+        uses: actions/cache/save@v4
+        with:
+          key: pages-${{ github.run_id }}
+          path: /home/runner/gh-pages
+      - if: ${{ steps.restore-pages.outputs.cache-matched-key }}
+        name: Remove History Cache
+        uses: actions/github-script@v8
+        with:
+          script: |
+            github.rest.actions.deleteActionsCacheByKey({
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              key: "${{ steps.restore-pages.outputs.cache-matched-key }}"
+            });
+      - if: ${{ steps.upload-pages.outputs.artifact_id }}
+        name: Remove Pages Artifact
+        uses: actions/github-script@v8
+        with:
+          script: |
+            github.rest.actions.deleteArtifact({
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              artifact_id: "${{ steps.upload-pages.outputs.artifact_id }}",
+            });
+      - if: ${{ needs.preview-create-build.outputs.artifact-id }}
+        name: Remove Temp Artifact
+        uses: actions/github-script@v8
+        with:
+          script: |
+            github.rest.actions.deleteArtifact({
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              artifact_id: "${{ needs.preview-create-build.outputs.artifact-id }}"
+            });
+  preview-create-finally:
+    if: ${{ always() && needs.preview-create-init.result == 'success' }}
+    needs: [preview-create-init, preview-create-deploy]
+    runs-on: ubuntu-latest
+    permissions:
+      checks: write
+      pull-requests: write
+    steps:
+      - if: ${{ github.event_name == 'issue_comment' }}
+        id: comment-message
+        name: Comment Message (issue_comment)
+        env:
+          PREVIEW_URL: https://${{ needs.preview-create-init.outputs.domain }}${{ needs.preview-create-init.outputs.pathname }}/PR${{ env.GITHUB_PR_NUMBER }}
+        continue-on-error: true
+        uses: actions/github-script@v8
+        with:
+          script: |
+            github.rest.issues.updateComment({
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              comment_id: context.payload.comment.id,
+              issue_number: context.issue.number,
+              body: "${{ needs.preview-create-deploy.result == 'success' && format('[Preview] {0}', env.PREVIEW_URL) || '[Preview] Failed, see logs for more information.' }}"
+            });
+      - if: ${{ steps.comment-message.outcome == 'failure' }}
+        name: Comment Message
+        env:
+          PREVIEW_URL: https://${{ needs.preview-create-init.outputs.domain }}${{ needs.preview-create-init.outputs.pathname }}/PR${{ env.GITHUB_PR_NUMBER }}
+        uses: actions/github-script@v8
+        with:
+          script: |
+            github.rest.issues.createComment({
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              issue_number: context.issue.number,
+              body: "${{ needs.preview-create-deploy.result == 'success' && format('[Preview] {0}', env.PREVIEW_URL) || '[Preview] Failed, see logs for more information.' }}"
+            });
+      - if: ${{ contains(github.event.pull_request.labels.*.name, 'preview/create') || contains(github.event.issue.labels.*.name, 'preview/create') }}
+        name: Remove Label (preview/create)
+        continue-on-error: true
+        uses: actions/github-script@v8
+        with:
+          script: |
+            github.rest.issues.removeLabel({
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              issue_number: context.issue.number,
+              name: "preview/create"
+            });
+      - name: Check Over
+        env:
+          PREVIEW_URL: https://${{ needs.preview-create-init.outputs.domain }}${{ needs.preview-create-init.outputs.pathname }}/PR${{ env.GITHUB_PR_NUMBER }}
+        uses: actions/github-script@v8
+        with:
+          script: |
+            github.rest.checks.update({
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              check_run_id: ${{ needs.preview-create-init.outputs.check-id }},
+              status: "completed",
+              conclusion: "${{ needs.preview-create-deploy.result == 'success' && 'success' || 'failure' }}",
+              completed_at: new Date().toISOString(),
+              details_url: `https://github.com/${context.repo.owner}/${context.repo.repo}/runs/${{ github.run_id }}`,
+              output: {
+                title: "Create preview ${{ needs.preview-create-deploy.result == 'success' && 'success' || 'failure' }}",
+                summary: "${{ needs.preview-create-deploy.result == 'success' && format('[Preview] {0}', env.PREVIEW_URL) || '[Preview] Failed, see logs for more information.' }}"
+              }
+            });
@@ -0,0 +1,8 @@
+_site
+.sass-cache
+.jekyll-cache
+.jekyll-metadata
+vendor
+Gemfile.lock
+.bundle
+/.idea/
@@ -1 +0,0 @@
-<!doctype html><html lang="zh" class="no-js"><head><meta charset="utf-8"><title>HMCL 文档</title><meta name="description" content="HMCL 启动器 | 跨平台 | 整合包管理 | 自动安装 | 十二年历史 | 三亿次使用"><meta property="og:type" content="website"><meta property="og:locale" content="zh"><meta property="og:site_name" content="HMCL 文档"><meta property="og:title" content="HMCL 文档"><meta property="og:url" content="https://docs.hmcl.net/404.html"><meta property="og:description" content="HMCL 启动器 | 跨平台 | 整合包管理 | 自动安装 | 十二年历史 | 三亿次使用"><link rel="canonical" href="https://docs.hmcl.net/404.html"><link href="/feed.xml" type="application/atom+xml" rel="alternate" title="HMCL 文档 Feed"><meta name="viewport" content="width=device-width, initial-scale=1.0"> <script> document.documentElement.className = document.documentElement.className.replace(/\bno-js\b/g, '') + ' js '; window.enable_copy_code_button = true; </script><link rel="stylesheet" href="/assets/css/main.css"><link rel="stylesheet" href="/assets/lib/fontawesome/css/all.min.css"> <noscript><link rel="stylesheet" href="/assets/lib/fontawesome/css/all.min.css"></noscript> <script src="/assets/js/settings.js"></script> <script src="/assets/js/theme.js"></script><link rel="shortcut icon" href="/favicon.ico"><link rel="stylesheet" id="skin"></head><body class="layout--splash" dir="ltr"><nav class="skip-links"><ul><li><a href="#site-nav" class="screen-reader-shortcut">转到主导航栏</a></li><li><a href="#main" class="screen-reader-shortcut">转到内容</a></li><li><a href="#footer" class="screen-reader-shortcut">转到底部</a></li></ul></nav><div class="masthead"><div class="masthead__inner-wrap"><div class="masthead__menu"><nav id="site-nav" class="greedy-nav"> <a class="site-logo" href="/"><img src="/assets/img/hmcl.png" alt="HMCL 文档"></a> <a class="site-title" href="/"> HMCL 文档 </a><ul class="visible-links"><li class="masthead__menu-item"> <a href="/settings.html" >设置</a></li></ul><button class="greedy-nav__toggle hidden" type="button"> <span class="visually-hidden">切换菜单</span><div class="navicon"></div></button><ul class="hidden-links hidden"></ul></nav></div></div></div><div class="initial-content"><div id="main" role="main"><article class="splash" itemscope itemtype="https://schema.org/CreativeWork"><meta itemprop="description" content=""><section class="page__content" itemprop="text"><div class="notice--danger"><h1>404</h1><p><strong>页面不存在</strong></p></div></section></article></div></div><div id="footer" class="page__footer"><footer><div class="page__footer-follow"><ul class="social-icons"><li><strong>关注:</strong></li><li><a href="https://github.com/HMCL-dev/HMCL" rel="nofollow noopener noreferrer"><i class="fab fa-fw fa-github" aria-hidden="true"></i> Github</a></li><li><a href="https://beian.miit.gov.cn" rel="nofollow noopener noreferrer"><i class="fas fa-link" aria-hidden="true"></i> 粤ICP备18071565号</a></li><li><a href="/feed.xml"><i class="fas fa-fw fa-rss-square" aria-hidden="true"></i> Feed</a></li></ul></div><div class="page__footer-copyright">&copy; 2026 <a href="mailto:hmcl@huangyuhui.net">huanghongxun</a>. 技术来自于 <a href="https://jekyllrb.com" rel="nofollow">Jekyll</a> &amp; <a href="https://mademistakes.com/work/jekyll-themes/minimal-mistakes/" rel="nofollow">Minimal Mistakes</a>.</div></footer></div><script src="/assets/js/main.min.js"></script> <script src="/assets/js/plugins/jquery.auto-redirect.js"></script></body></html>
@@ -0,0 +1,32 @@
+source "https://rubygems.org"
+# Hello! This is where you manage which Jekyll version is used to run.
+# When you want to use a different version, change it below, save the
+# file and run `bundle install`. Run Jekyll with `bundle exec`, like so:
+#
+#     bundle exec jekyll serve
+#
+# This will help ensure the proper Jekyll version is running.
+# Happy Jekylling!
+gem "jekyll", "4.4.1"
+gem "minimal-mistakes-jekyll", "4.27.3"
+
+group :jekyll_plugins do
+  gem "jekyll-paginate", "1.1.0"
+  gem "jekyll-sitemap", "1.4.0"
+  gem "jekyll-gist", "1.5.0"
+  gem "jekyll-feed", "0.17.0"
+  gem "jekyll-include-cache", "0.2.1"
+  gem "jekyll-redirect-from", "0.16.0"
+end
+
+# Windows and JRuby does not include zoneinfo files, so bundle the tzinfo-data gem
+# and associated library.
+platforms :windows, :jruby do
+  gem "tzinfo", "2.0.6"
+  gem "tzinfo-data", "1.2025.2"
+end
+
+# Performance-booster for watching directories on Windows
+gem "wdm", "0.2.0", :platforms => [:windows]
+
+gem "http_parser.rb", "0.8.0", :platforms => [:jruby]
@@ -0,0 +1,448 @@
+Attribution-NonCommercial-ShareAlike 4.0 International
+
+=======================================================================
+
+Additional License
+
+If anyone contributes to this document, the contribution is 
+granted right to huangyuhui <huanghongxun2008@126.com> for Commercial usage.
+
+If anyone copy, redistribute, remix, transform and build upon
+the material licensed with this license, your changes is considered
+as a contribution to the origin repository.
+
+=======================================================================
+
+Creative Commons Corporation ("Creative Commons") is not a law firm and
+does not provide legal services or legal advice. Distribution of
+Creative Commons public licenses does not create a lawyer-client or
+other relationship. Creative Commons makes its licenses and related
+information available on an "as-is" basis. Creative Commons gives no
+warranties regarding its licenses, any material licensed under their
+terms and conditions, or any related information. Creative Commons
+disclaims all liability for damages resulting from their use to the
+fullest extent possible.
+
+Using Creative Commons Public Licenses
+
+Creative Commons public licenses provide a standard set of terms and
+conditions that creators and other rights holders may use to share
+original works of authorship and other material subject to copyright
+and certain other rights specified in the public license below. The
+following considerations are for informational purposes only, are not
+exhaustive, and do not form part of our licenses.
+
+     Considerations for licensors: Our public licenses are
+     intended for use by those authorized to give the public
+     permission to use material in ways otherwise restricted by
+     copyright and certain other rights. Our licenses are
+     irrevocable. Licensors should read and understand the terms
+     and conditions of the license they choose before applying it.
+     Licensors should also secure all rights necessary before
+     applying our licenses so that the public can reuse the
+     material as expected. Licensors should clearly mark any
+     material not subject to the license. This includes other CC-
+     licensed material, or material used under an exception or
+     limitation to copyright. More considerations for licensors:
+    wiki.creativecommons.org/Considerations_for_licensors
+
+     Considerations for the public: By using one of our public
+     licenses, a licensor grants the public permission to use the
+     licensed material under specified terms and conditions. If
+     the licensor's permission is not necessary for any reason--for
+     example, because of any applicable exception or limitation to
+     copyright--then that use is not regulated by the license. Our
+     licenses grant only permissions under copyright and certain
+     other rights that a licensor has authority to grant. Use of
+     the licensed material may still be restricted for other
+     reasons, including because others have copyright or other
+     rights in the material. A licensor may make special requests,
+     such as asking that all changes be marked or described.
+     Although not required by our licenses, you are encouraged to
+     respect those requests where reasonable. More considerations
+     for the public:
+    wiki.creativecommons.org/Considerations_for_licensees
+
+=======================================================================
+
+Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International
+Public License
+
+By exercising the Licensed Rights (defined below), You accept and agree
+to be bound by the terms and conditions of this Creative Commons
+Attribution-NonCommercial-ShareAlike 4.0 International Public License
+("Public License"). To the extent this Public License may be
+interpreted as a contract, You are granted the Licensed Rights in
+consideration of Your acceptance of these terms and conditions, and the
+Licensor grants You such rights in consideration of benefits the
+Licensor receives from making the Licensed Material available under
+these terms and conditions.
+
+
+Section 1 -- Definitions.
+
+  a. Adapted Material means material subject to Copyright and Similar
+     Rights that is derived from or based upon the Licensed Material
+     and in which the Licensed Material is translated, altered,
+     arranged, transformed, or otherwise modified in a manner requiring
+     permission under the Copyright and Similar Rights held by the
+     Licensor. For purposes of this Public License, where the Licensed
+     Material is a musical work, performance, or sound recording,
+     Adapted Material is always produced where the Licensed Material is
+     synched in timed relation with a moving image.
+
+  b. Adapter's License means the license You apply to Your Copyright
+     and Similar Rights in Your contributions to Adapted Material in
+     accordance with the terms and conditions of this Public License.
+
+  c. BY-NC-SA Compatible License means a license listed at
+     creativecommons.org/compatiblelicenses, approved by Creative
+     Commons as essentially the equivalent of this Public License.
+
+  d. Copyright and Similar Rights means copyright and/or similar rights
+     closely related to copyright including, without limitation,
+     performance, broadcast, sound recording, and Sui Generis Database
+     Rights, without regard to how the rights are labeled or
+     categorized. For purposes of this Public License, the rights
+     specified in Section 2(b)(1)-(2) are not Copyright and Similar
+     Rights.
+
+  e. Effective Technological Measures means those measures that, in the
+     absence of proper authority, may not be circumvented under laws
+     fulfilling obligations under Article 11 of the WIPO Copyright
+     Treaty adopted on December 20, 1996, and/or similar international
+     agreements.
+
+  f. Exceptions and Limitations means fair use, fair dealing, and/or
+     any other exception or limitation to Copyright and Similar Rights
+     that applies to Your use of the Licensed Material.
+
+  g. License Elements means the license attributes listed in the name
+     of a Creative Commons Public License. The License Elements of this
+     Public License are Attribution, NonCommercial, and ShareAlike.
+
+  h. Licensed Material means the artistic or literary work, database,
+     or other material to which the Licensor applied this Public
+     License.
+
+  i. Licensed Rights means the rights granted to You subject to the
+     terms and conditions of this Public License, which are limited to
+     all Copyright and Similar Rights that apply to Your use of the
+     Licensed Material and that the Licensor has authority to license.
+
+  j. Licensor means the individual(s) or entity(ies) granting rights
+     under this Public License.
+
+  k. NonCommercial means not primarily intended for or directed towards
+     commercial advantage or monetary compensation. For purposes of
+     this Public License, the exchange of the Licensed Material for
+     other material subject to Copyright and Similar Rights by digital
+     file-sharing or similar means is NonCommercial provided there is
+     no payment of monetary compensation in connection with the
+     exchange.
+
+  l. Share means to provide material to the public by any means or
+     process that requires permission under the Licensed Rights, such
+     as reproduction, public display, public performance, distribution,
+     dissemination, communication, or importation, and to make material
+     available to the public including in ways that members of the
+     public may access the material from a place and at a time
+     individually chosen by them.
+
+  m. Sui Generis Database Rights means rights other than copyright
+     resulting from Directive 96/9/EC of the European Parliament and of
+     the Council of 11 March 1996 on the legal protection of databases,
+     as amended and/or succeeded, as well as other essentially
+     equivalent rights anywhere in the world.
+
+  n. You means the individual or entity exercising the Licensed Rights
+     under this Public License. Your has a corresponding meaning.
+
+
+Section 2 -- Scope.
+
+  a. License grant.
+
+       1. Subject to the terms and conditions of this Public License,
+          the Licensor hereby grants You a worldwide, royalty-free,
+          non-sublicensable, non-exclusive, irrevocable license to
+          exercise the Licensed Rights in the Licensed Material to:
+
+            a. reproduce and Share the Licensed Material, in whole or
+               in part, for NonCommercial purposes only; and
+
+            b. produce, reproduce, and Share Adapted Material for
+               NonCommercial purposes only.
+
+       2. Exceptions and Limitations. For the avoidance of doubt, where
+          Exceptions and Limitations apply to Your use, this Public
+          License does not apply, and You do not need to comply with
+          its terms and conditions.
+
+       3. Term. The term of this Public License is specified in Section
+          6(a).
+
+       4. Media and formats; technical modifications allowed. The
+          Licensor authorizes You to exercise the Licensed Rights in
+          all media and formats whether now known or hereafter created,
+          and to make technical modifications necessary to do so. The
+          Licensor waives and/or agrees not to assert any right or
+          authority to forbid You from making technical modifications
+          necessary to exercise the Licensed Rights, including
+          technical modifications necessary to circumvent Effective
+          Technological Measures. For purposes of this Public License,
+          simply making modifications authorized by this Section 2(a)
+          (4) never produces Adapted Material.
+
+       5. Downstream recipients.
+
+            a. Offer from the Licensor -- Licensed Material. Every
+               recipient of the Licensed Material automatically
+               receives an offer from the Licensor to exercise the
+               Licensed Rights under the terms and conditions of this
+               Public License.
+
+            b. Additional offer from the Licensor -- Adapted Material.
+               Every recipient of Adapted Material from You
+               automatically receives an offer from the Licensor to
+               exercise the Licensed Rights in the Adapted Material
+               under the conditions of the Adapter's License You apply.
+
+            c. No downstream restrictions. You may not offer or impose
+               any additional or different terms or conditions on, or
+               apply any Effective Technological Measures to, the
+               Licensed Material if doing so restricts exercise of the
+               Licensed Rights by any recipient of the Licensed
+               Material.
+
+       6. No endorsement. Nothing in this Public License constitutes or
+          may be construed as permission to assert or imply that You
+          are, or that Your use of the Licensed Material is, connected
+          with, or sponsored, endorsed, or granted official status by,
+          the Licensor or others designated to receive attribution as
+          provided in Section 3(a)(1)(A)(i).
+
+  b. Other rights.
+
+       1. Moral rights, such as the right of integrity, are not
+          licensed under this Public License, nor are publicity,
+          privacy, and/or other similar personality rights; however, to
+          the extent possible, the Licensor waives and/or agrees not to
+          assert any such rights held by the Licensor to the limited
+          extent necessary to allow You to exercise the Licensed
+          Rights, but not otherwise.
+
+       2. Patent and trademark rights are not licensed under this
+          Public License.
+
+       3. To the extent possible, the Licensor waives any right to
+          collect royalties from You for the exercise of the Licensed
+          Rights, whether directly or through a collecting society
+          under any voluntary or waivable statutory or compulsory
+          licensing scheme. In all other cases the Licensor expressly
+          reserves any right to collect such royalties, including when
+          the Licensed Material is used other than for NonCommercial
+          purposes.
+
+
+Section 3 -- License Conditions.
+
+Your exercise of the Licensed Rights is expressly made subject to the
+following conditions.
+
+  a. Attribution.
+
+       1. If You Share the Licensed Material (including in modified
+          form), You must:
+
+            a. retain the following if it is supplied by the Licensor
+               with the Licensed Material:
+
+                 i. identification of the creator(s) of the Licensed
+                    Material and any others designated to receive
+                    attribution, in any reasonable manner requested by
+                    the Licensor (including by pseudonym if
+                    designated);
+
+                ii. a copyright notice;
+
+               iii. a notice that refers to this Public License;
+
+                iv. a notice that refers to the disclaimer of
+                    warranties;
+
+                 v. a URI or hyperlink to the Licensed Material to the
+                    extent reasonably practicable;
+
+            b. indicate if You modified the Licensed Material and
+               retain an indication of any previous modifications; and
+
+            c. indicate the Licensed Material is licensed under this
+               Public License, and include the text of, or the URI or
+               hyperlink to, this Public License.
+
+       2. You may satisfy the conditions in Section 3(a)(1) in any
+          reasonable manner based on the medium, means, and context in
+          which You Share the Licensed Material. For example, it may be
+          reasonable to satisfy the conditions by providing a URI or
+          hyperlink to a resource that includes the required
+          information.
+       3. If requested by the Licensor, You must remove any of the
+          information required by Section 3(a)(1)(A) to the extent
+          reasonably practicable.
+
+  b. ShareAlike.
+
+     In addition to the conditions in Section 3(a), if You Share
+     Adapted Material You produce, the following conditions also apply.
+
+       1. The Adapter's License You apply must be a Creative Commons
+          license with the same License Elements, this version or
+          later, or a BY-NC-SA Compatible License.
+
+       2. You must include the text of, or the URI or hyperlink to, the
+          Adapter's License You apply. You may satisfy this condition
+          in any reasonable manner based on the medium, means, and
+          context in which You Share Adapted Material.
+
+       3. You may not offer or impose any additional or different terms
+          or conditions on, or apply any Effective Technological
+          Measures to, Adapted Material that restrict exercise of the
+          rights granted under the Adapter's License You apply.
+
+
+Section 4 -- Sui Generis Database Rights.
+
+Where the Licensed Rights include Sui Generis Database Rights that
+apply to Your use of the Licensed Material:
+
+  a. for the avoidance of doubt, Section 2(a)(1) grants You the right
+     to extract, reuse, reproduce, and Share all or a substantial
+     portion of the contents of the database for NonCommercial purposes
+     only;
+
+  b. if You include all or a substantial portion of the database
+     contents in a database in which You have Sui Generis Database
+     Rights, then the database in which You have Sui Generis Database
+     Rights (but not its individual contents) is Adapted Material,
+     including for purposes of Section 3(b); and
+
+  c. You must comply with the conditions in Section 3(a) if You Share
+     all or a substantial portion of the contents of the database.
+
+For the avoidance of doubt, this Section 4 supplements and does not
+replace Your obligations under this Public License where the Licensed
+Rights include other Copyright and Similar Rights.
+
+
+Section 5 -- Disclaimer of Warranties and Limitation of Liability.
+
+  a. UNLESS OTHERWISE SEPARATELY UNDERTAKEN BY THE LICENSOR, TO THE
+     EXTENT POSSIBLE, THE LICENSOR OFFERS THE LICENSED MATERIAL AS-IS
+     AND AS-AVAILABLE, AND MAKES NO REPRESENTATIONS OR WARRANTIES OF
+     ANY KIND CONCERNING THE LICENSED MATERIAL, WHETHER EXPRESS,
+     IMPLIED, STATUTORY, OR OTHER. THIS INCLUDES, WITHOUT LIMITATION,
+     WARRANTIES OF TITLE, MERCHANTABILITY, FITNESS FOR A PARTICULAR
+     PURPOSE, NON-INFRINGEMENT, ABSENCE OF LATENT OR OTHER DEFECTS,
+     ACCURACY, OR THE PRESENCE OR ABSENCE OF ERRORS, WHETHER OR NOT
+     KNOWN OR DISCOVERABLE. WHERE DISCLAIMERS OF WARRANTIES ARE NOT
+     ALLOWED IN FULL OR IN PART, THIS DISCLAIMER MAY NOT APPLY TO YOU.
+
+  b. TO THE EXTENT POSSIBLE, IN NO EVENT WILL THE LICENSOR BE LIABLE
+     TO YOU ON ANY LEGAL THEORY (INCLUDING, WITHOUT LIMITATION,
+     NEGLIGENCE) OR OTHERWISE FOR ANY DIRECT, SPECIAL, INDIRECT,
+     INCIDENTAL, CONSEQUENTIAL, PUNITIVE, EXEMPLARY, OR OTHER LOSSES,
+     COSTS, EXPENSES, OR DAMAGES ARISING OUT OF THIS PUBLIC LICENSE OR
+     USE OF THE LICENSED MATERIAL, EVEN IF THE LICENSOR HAS BEEN
+     ADVISED OF THE POSSIBILITY OF SUCH LOSSES, COSTS, EXPENSES, OR
+     DAMAGES. WHERE A LIMITATION OF LIABILITY IS NOT ALLOWED IN FULL OR
+     IN PART, THIS LIMITATION MAY NOT APPLY TO YOU.
+
+  c. The disclaimer of warranties and limitation of liability provided
+     above shall be interpreted in a manner that, to the extent
+     possible, most closely approximates an absolute disclaimer and
+     waiver of all liability.
+
+
+Section 6 -- Term and Termination.
+
+  a. This Public License applies for the term of the Copyright and
+     Similar Rights licensed here. However, if You fail to comply with
+     this Public License, then Your rights under this Public License
+     terminate automatically.
+
+  b. Where Your right to use the Licensed Material has terminated under
+     Section 6(a), it reinstates:
+
+       1. automatically as of the date the violation is cured, provided
+          it is cured within 30 days of Your discovery of the
+          violation; or
+
+       2. upon express reinstatement by the Licensor.
+
+     For the avoidance of doubt, this Section 6(b) does not affect any
+     right the Licensor may have to seek remedies for Your violations
+     of this Public License.
+
+  c. For the avoidance of doubt, the Licensor may also offer the
+     Licensed Material under separate terms or conditions or stop
+     distributing the Licensed Material at any time; however, doing so
+     will not terminate this Public License.
+
+  d. Sections 1, 5, 6, 7, and 8 survive termination of this Public
+     License.
+
+
+Section 7 -- Other Terms and Conditions.
+
+  a. The Licensor shall not be bound by any additional or different
+     terms or conditions communicated by You unless expressly agreed.
+
+  b. Any arrangements, understandings, or agreements regarding the
+     Licensed Material not stated herein are separate from and
+     independent of the terms and conditions of this Public License.
+
+
+Section 8 -- Interpretation.
+
+  a. For the avoidance of doubt, this Public License does not, and
+     shall not be interpreted to, reduce, limit, restrict, or impose
+     conditions on any use of the Licensed Material that could lawfully
+     be made without permission under this Public License.
+
+  b. To the extent possible, if any provision of this Public License is
+     deemed unenforceable, it shall be automatically reformed to the
+     minimum extent necessary to make it enforceable. If the provision
+     cannot be reformed, it shall be severed from this Public License
+     without affecting the enforceability of the remaining terms and
+     conditions.
+
+  c. No term or condition of this Public License will be waived and no
+     failure to comply consented to unless expressly agreed to by the
+     Licensor.
+
+  d. Nothing in this Public License constitutes or may be interpreted
+     as a limitation upon, or waiver of, any privileges and immunities
+     that apply to the Licensor or You, including from the legal
+     processes of any jurisdiction or authority.
+
+=======================================================================
+
+Creative Commons is not a party to its public
+licenses. Notwithstanding, Creative Commons may elect to apply one of
+its public licenses to material it publishes and in those instances
+will be considered the “Licensor.” The text of the Creative Commons
+public licenses is dedicated to the public domain under the CC0 Public
+Domain Dedication. Except for the limited purpose of indicating that
+material is shared under a Creative Commons public license or as
+otherwise permitted by the Creative Commons policies published at
+creativecommons.org/policies, Creative Commons does not authorize the
+use of the trademark "Creative Commons" or any other trademark or logo
+of Creative Commons without its prior written consent including,
+without limitation, in connection with any unauthorized modifications
+to any of its public licenses or any other arrangements,
+understandings, or agreements concerning use of licensed material. For
+the avoidance of doubt, this paragraph does not form part of the
+public licenses.
+
+Creative Commons may be contacted at creativecommons.org.
@@ -0,0 +1,109 @@
+# HMCL-docs
+
+[![Build Status](https://drone.hmcl.net/api/badges/huanghongxun/HMCL-docs/status.svg)](https://drone.hmcl.net/huanghongxun/HMCL-docs)
+
+Hello Minecraft! Launcher 帮助文档仓库
+
+您可以通过对本仓库提交 Pull Request 的方式来为 HMCL 帮助文档贡献自己的力量！
+本仓库内容使用 Attribution-NonCommercial 4.0 International (CC BY-NC 4.0) 协议（附带额外条款）开放，协议内容请参见 LICENSE 文件。
+
+## 相关链接
+
+[Hello Minecraft! Launcher 帮助文档仓库网站](https://docs.hmcl.net)
+
+## Markdown
+
+每篇文章由 Markdown 编写。如果你不知道什么是 Markdown，我们推荐你先大概了解一下这个排版工具。
+
+我们推荐你使用 Typora 编写 Markdown 文章，该软件的使用方法和 Word 等传统文字排版软件相似，易于使用。
+
+请注意，你在使用 Typora 时，请在 文件->偏好设置->图像 中，将 `插入图片时...` 选项修改为复制到指定路径为 `/assets/img/docs/${filename}` 目录
+
+## 贡献
+
+本仓库组织方式为一篇文章放在一个目录中。如果你要提交 PR，请不要将 md 文件直接放在根目录下。
+
+每篇文章结构如下：
+```
+_<collection>/<article>.md
+
+assets
+ * img
+   * docs
+     * <article>
+       * img1.png
+       * img2.png
+       * ...
+```
+
+其中，`<collection>` 表示集合，如 `multiplayer` 表示多人游戏、`modpack` 表示整合包，`<article>` 表示你的文章的英文唯一标识（尖括号表示占位符，不要直接提交 `<article>`，请确保其唯一且简短）请仅使用英文字母、数字、中划线、下划线字符作为唯一标识，不要使用空格、英文句点、中文字符。请确保资源文件夹名和 md 文件名一致，具体可以参考已有文章目录格式。
+
+每篇文章由 Markdown 编写的 `<article>.md` 文件及附带图片组成（文章的图片请放置到 `/assets/img/docs/<article>` 目录中）在 Markdown 文件中请确保包含 [Front Matter](https://jekyllrb.com/docs/front-matter/) 其中应提供文章的一些元数据（如标题 `title` 更新日期 `date` 等）在 `_config.yml` 的 `defaults` 中配置有默认值的可以不指定。
+
+### 添加新文章
+
+添加新文章时，请确保将内容按照上述格式要求存放。你也可以参考已经写好的文章格式。
+
+切记不要在一个添加新文章的 PR 里修改其他文章的内容。
+
+### 修改已有文章
+
+修改已有文章时，请确保你的 PR 仅修改一个文章内容，并在该文章里署名。
+
+### 更新索引
+
+在添加或修改文章后，请更新索引文件 `index.json`，以便 HMCL 展示你新添加的文件。
+
+### 本地部署
+
+项目是基于 Jekyll 实现的静态网站，使用 Minimal Mistakes 主题。
+
+如果您想更深入的参与项目文档的维护，可参阅以下内容。
+
+#### 前置条件
+
+- `Ruby` 版本大于等于 `3.1` （项目构建版本 `3.4`）
+
+#### 安装 bundle
+
+> 环境中已安装 `bundle` 可跳过本节
+
+```shell
+gem install bundler
+```
+
+#### 下载源码
+
+> 以 `git` 为例，您也可以通过 `github` 下载源码压缩包或其它方式下载源码。
+
+```shell
+# 克隆项目到本地
+git clone https://github.com/HMCL-dev/HMCL-docs.git
+# 进入项目根目录
+cd HMCL-docs
+```
+
+#### 安装依赖
+
+```shell
+# 配置镜像（请自行根据网络环境决定是否需要使用镜像，此处以腾讯云镜像为例）
+bundle config mirror.https://rubygems.org https://mirrors.cloud.tencent.com/rubygems
+# 配置项目依赖安装路径
+bundle config path vendor/bundle
+# 安装项目依赖
+bundle install
+```
+
+#### 启动本地开发服务器
+
+```shell
+bundle exec jekyll serve
+```
+
+#### 本地构建产物
+
+> 根据需要配置环境变量，配置 `JEKYLL_ENV=production` 表示生产环境构建。
+
+```shell
+bundle exec jekyll build
+```
@@ -0,0 +1,7 @@
+---
+layout: changelog
+channel: dev
+title: 开发版更新日志
+date: 2021-08-22 23:18:02 +0800
+note: Changelogs are written in Chinese.
+---
@@ -0,0 +1,7 @@
+---
+layout: changelog
+channel: stable
+title: 稳定版更新日志
+date: 2021-08-22 23:18:02 +0800
+note: Changelogs are written in Chinese.
+---
@@ -0,0 +1,6 @@
+---
+---
+
+- 修复导入整合包时的乱码问题
+- 更新 authlib-injector
+- 从 Cursemeta 上下载 Curse 上被删除的 Mod 文件
@@ -0,0 +1,5 @@
+---
+---
+
+- 修复安装游戏后不显示游戏的问题
+- 修复下载资源文件时潜在的崩溃问题
@@ -0,0 +1,14 @@
+---
+---
+
+- 在缓存目录无效时自动更改设置
+- 在安装游戏失败时删除不完全的游戏
+- 自动检测整合包、游戏存档、数据包的编码以增强兼容性
+- 在更新整合包时进行游戏文件的备份
+- 添加打开存档文件夹的菜单
+- 添加刷新模组列表的按钮
+- 支持拖拽游戏存档压缩包到游戏界面以便安装游戏存档
+- 修复皮肤图片文件损坏时导致的崩溃问题
+- 修复配置文件格式不正确时导致的崩溃问题
+- 修复 Curse 整合包更新失败的问题
+- 修复自动更新弹出气泡的界面错乱问题
@@ -0,0 +1,7 @@
+---
+---
+
+- 提醒用户在修改版本独立选项时需要注意游戏文件的转移
+- 修复 Java 10 上 UI 错位的问题
+- 修复游戏认证服务器列表的渲染问题
+- 修复启动 Curse 整合包时尝试下载被禁用的模组的问题
@@ -0,0 +1,12 @@
+---
+---
+
+- 添加提示部分版本的 Forge 和 LiteLoader 不兼容的问题
+- 在模组管理面板添加加载进度条
+- 支持整合包拖拽到主页面打开安装向导
+- 支持新版 MultiMC 整合包的导入
+- 删除在版本管理页面中的删除游戏和重命名按钮
+- 加载游戏存档过程更加流畅
+- 在登录对话框中添加注册链接
+- 修复标题栏中没有显示返回主页按钮的问题
+- 修复保存设置时的潜在问题
@@ -0,0 +1,4 @@
+---
+---
+
+- 修复打开版本管理时的崩溃
@@ -0,0 +1,11 @@
+---
+---
+
+- 支持 Forge 1.13 的自动安装
+- 安装游戏时更新资源文件
+- 启动时下载缺失的 Minecraft 本体文件
+- 支持自动检测整合包自带的 Java 运行时
+- 更新 authlib-injector
+- 下载库文件失败时提供更友好的提示
+- 重构正版登录
+- 修复启动按钮无法根据背景颜色更改字体颜色的问题
@@ -0,0 +1,9 @@
+---
+---
+
+- 启动前检查是否是 Java 8~10
+- 模组管理面板支持多选
+- 下载库文件失败时提供更友好的提示
+- 只从 BMCLAPI 获取 Forge 列表
+- 添加 BMCLAPI 赞助信息
+- 修复头像不显示头盔层的问题
@@ -0,0 +1,5 @@
+---
+---
+
+- 修复无法正版登录的问题
+- 修复 mods 不是文件夹时无法安装模组的问题
@@ -0,0 +1,9 @@
+---
+---
+
+- 重构任务执行器
+- 修复填写账号时崩溃的问题
+- 修复添加账号面板中认证服务器列表显示不正确的问题
+- 修复刷新版本列表时的卡顿问题
+- 修复无法刷新 Forge 列表的问题
+- 修复 Forge 1.13 安装问题
@@ -0,0 +1,4 @@
+---
+---
+
+- 禁止用户同时安装 Forge 1.13.2 和 OptiFine
@@ -0,0 +1,12 @@
+---
+---
+
+- 在未安装 Mod API 的情况下禁用模组管理面板
+- 为自动安装中的 Forge、LiteLoader、OptiFine 添加更新按钮
+- 忽略游戏存档名中的颜色转移符
+- 隐藏游戏版本不匹配的游戏存档
+- 允许数据包列表页面多选
+- 修复无法下载安装 Forge 的问题
+- 修复下载失败后无法删除游戏版本的问题
+- 修复设置页面下方有大面积空白区域的问题
+- 回滚 JFoenix 组件库以修复一些 UI 的细节问题
@@ -0,0 +1,17 @@
+---
+---
+
+- 添加对 Fabric 模组的管理支持
+- 将游戏依赖的动态链接库解压到 .minecraft 中而不是系统临时文件夹
+- 在遇到 SocketTimeoutException 时弹窗提示用户超时
+- 在遇到 404 时提示用户找不到文件而不是 IOException
+- 在 HMCL 本体不完整时提示用户而不是崩溃
+- 在启动器更新时显示更新日志
+- 禁止导出 1.13.2 游戏整合包
+- 修复删除游戏版本时消息框重复显示的问题
+- 修复删除模组时可能出现的 NullPointerException
+- 修复尝试更新 OptiFine 时却没有可用版本时导致的崩溃
+- 修复刷新数据包列表时崩溃的问题
+- 修复不能导入 Fabric 官方网站提供的 MultiMC 整合包的问题
+- 修复启动器皮肤预览异常的问题
+- 修复 macOS 无法安装 1.13.2 Forge 的问题
@@ -0,0 +1,7 @@
+---
+---
+
+- 添加 Fabric 自动安装
+- 添加西班牙语
+- 支持导出 MultiMC 整合包
+- 修复无法下载 Curse 模组的问题
@@ -0,0 +1,10 @@
+---
+---
+
+- 新安装的游戏支持修改游戏版本
+- 支持在打开启动器后的主页面按回车键启动游戏
+- 支持游戏列表内点击列表项进入游戏设置，右键列表项打开游戏管理菜单
+- 修复 OptiFine 自动安装（需要重新安装 OptiFine 生效）
+- 修复无法从本地安装 OptiFine 的问题
+- 修复同时安装 Forge 和 OptiFine 自动安装失败的问题
+- 不再强制使用 java.exe
@@ -0,0 +1,6 @@
+---
+---
+
+- 修复了某些情况下无法安装 1.12.2 及以下版本的 Forge 的问题
+- 修复输入某些错误的 Java 路径时导致的崩溃
+- 修复了浏览 Mod 列表时可能出现的崩溃问题
@@ -0,0 +1,8 @@
+---
+---
+
+- 添加 authlib-injectors.json，允许服主将添加账号页面更改为默认添加指定服务器的 Authlib Injector 账户
+- 访问 <a href="https://www.huangyuhui.net/index.php/2019/09/09/109/">https://www.huangyuhui.net/index.php/2019/09/09/109/</a> 以查看添加方法
+- 检查安装游戏时输入的名称是否符合 Windows 系统需求
+- 修复导出整合包导入时无法安装 1.13 Forge 和 OptiFine 的问题
+- 修复部分情况下无法下载 Forge 安装包的问题
@@ -0,0 +1,5 @@
+---
+---
+
+- 修复 tryCacheLibrary 可能导致崩溃的问题
+- 修复无法安装 1.14.4 及 1.15 快照的问题
@@ -0,0 +1,8 @@
+---
+---
+
+- 更新了英语和俄语翻译
+- 修复了一些导致启动器崩溃的问题
+- 修复了无法识别 Java 12 的问题
+- 修复了无法下载 Curse 整合包模组的问题
+- 修复了下载 Curse 整合包失败后删除了对应版本的问题
@@ -0,0 +1,9 @@
+---
+---
+
+- 添加服务器自动更新整合包，允许服务器远程更新游戏客户端
+- 允许直接从给定链接下载整合包并安装
+- 日志窗口允许关闭自动滚动
+- 更新了英语翻译
+- 修复了部分情况下可能导致崩溃的问题
+- 修复了无法获取使用 authlib-injectors.json 添加的服务器的服务器名称的问题
@@ -0,0 +1,5 @@
+---
+---
+
+- 修复服务器整合包下载时可能丢失文件的问题
+- 修复读取 authlib-injectors.json 时对链接格式要求过严的问题
@@ -0,0 +1,7 @@
+---
+---
+
+- 修复关闭 JVM 检查时仍然会检查 java.exe 是否合法的问题
+- 修复下载服务端整合包没有对链接转义而无法下载的问题
+- 修复下载游戏时可能出现的 “HTTP 302” 错误
+- 导出整合包时将剔除所有日志文件和 CustomSkinLoader 的缓存
@@ -0,0 +1,10 @@
+---
+---
+
+- 修复导入 HMCL 整合包时无法安装 Forge 的问题
+- 修复无法下载 Curse 整合包部分 Mod（如潘马斯）的问题
+- 修复下载 Curse 整合包 Mod 失败后会删除整合包的问题
+- 修复无法启动使用 Vivecraft 安装器新安装的游戏的问题
+- 修复启动 1.15 时不会停止等待的问题
+- 修复 Windows 下导出启动脚本对双引号的错误转义
+- 修复部分正版账号登录 1.7.10 会导致游戏崩溃的问题
@@ -0,0 +1,7 @@
+---
+---
+
+- 修复无法取消下载的问题
+- 添加 MCBBS 下载源
+- 在资源索引文件不合法时尝试重新下载
+- 修复切换游戏版本后启动失败的问题
@@ -0,0 +1,12 @@
+---
+---
+
+- 改进部分错误提示
+- 更新繁体中文语言文件
+- 修复重复下载游戏依赖文件的问题
+- 修复原版游戏用熔炉图标标识的问题
+- 修复取消登录时导致启动器崩溃的问题
+- 修复无法取消启动过程和安装过程的问题
+- 修复无法正常更新 authlib-injector 的问题
+- 修复在缺失资源索引文件时无法启动游戏的问题
+- 现官方下载源下载 Forge 时依赖文件不再强制从 BMCLAPI 下载
@@ -0,0 +1,5 @@
+---
+---
+
+- 修复正版登录失败的问题
+- 修复无法正常显示错误信息的问题
@@ -0,0 +1,6 @@
+---
+---
+
+- 更新 Fabric 的 BMCLAPI 和 MCBBS 下载源支持
+- 更新繁体中文语言文件
+- 当 Curse 整合包部分 Mod 因服务器上文件不存在而下载失败时不删除游戏
@@ -0,0 +1,5 @@
+---
+---
+
+- 在主界面账户栏添加鼠标悬浮提示以查看完整游戏名
+- 在主界面账户栏添加鼠标滚轮便捷切换游戏账户
@@ -0,0 +1,17 @@
+---
+---
+
+- 加快界面动画速度
+- 改善游戏下载速度
+- 添加清理缓存文件夹按钮
+- 修改安装游戏向导的界面
+- 在启动游戏、安装游戏等界面显示总下载速度
+- 在资源索引文件为空时自动重新下载资源文件
+- 在当前下载源下载失败后自动重试其他下载源
+- 在删除 Mod、世界、数据包时弹出删除确认提示
+- 在启动游戏、安装游戏等界面显示明确的安装步骤
+- 在游戏崩溃后的第二次启动时自动检查资源和支持库文件是否完整
+- 修复启动器崩溃时可能再次崩溃的问题
+- 修复部分整合包无法修改启动时游戏窗口大小的问题
+- 修复在 Curse 整合包安装部分成功时删除游戏的问题
+- 修复从 MCBBS 下载源下载文件可能会下载到空文件的问题
@@ -0,0 +1,6 @@
+---
+---
+
+- 修复 3.2.150 部分游戏启动失败的问题
+- 修改 Mod、数据包页面的界面样式
+- 修复终止游戏后启动器不会停止等待的问题
@@ -0,0 +1,7 @@
+---
+---
+
+- 调整界面样式
+- 修改默认下载源为 MCBBS
+- 允许在启动游戏按钮上滑动鼠标滚轮切换游戏
+- 显示资源和 Curse Mod 下载总进度
@@ -0,0 +1,7 @@
+---
+---
+
+- 调整界面样式
+- 提升自动安装功能与其他启动器的兼容性
+- 修复快速切换游戏时可能导致的一些问题
+- 支持调整启动器窗口大小
@@ -0,0 +1,4 @@
+---
+---
+
+- 修复 3.3.153 导致的启动失败问题
@@ -0,0 +1,4 @@
+---
+---
+
+- 修复 3.3.154 导致的启动失败问题
@@ -0,0 +1,5 @@
+---
+---
+
+- 修复 3.3.155 导致的启动失败问题
+- 在修改游戏版本时要求重新安装相关库
@@ -0,0 +1,7 @@
+---
+---
+
+- 更新俄语翻译
+- 在游戏设置页面添加重命名等只能在游戏列表操作的功能
+- 在自动安装页面可以删除已选择安装的第三方库
+- 添加复制游戏实例功能
@@ -0,0 +1,6 @@
+---
+---
+
+- 调整界面细节
+- 修复游戏安装失败时提示安装完成的问题
+- 在自动安装 Forge、OptiFine 等库时若下载失败，自动重试其他下载源
@@ -0,0 +1,6 @@
+---
+---
+
+- 调整界面细节
+- 在日志窗口添加导出游戏日志功能
+- 修复复制游戏实例后的新游戏无效的问题
@@ -0,0 +1,6 @@
+---
+---
+
+- 主界面标题栏透明
+- 游戏崩溃后弹出的日志窗口直接显示游戏崩溃报告（而不是游戏日志）
+- 修复游戏崩溃后弹出的日志窗口无法显示日志的问题
@@ -0,0 +1,7 @@
+---
+---
+
+- 调整界面细节
+- 修复无法安装 Forge 1.12.2 2852 的问题
+- 提升与 ServerSync 的兼容性
+- 安装游戏向导内可直接切换下载源，而不需要返回启动器设置页面
@@ -0,0 +1,6 @@
+---
+---
+
+- 修复无法下载资源文件的问题
+- 修复无法同时安装 Forge 1.12.2 2852 和 OptiFine 的问题
+- 加强对支持库文件完整/损坏的检查能力
@@ -0,0 +1,6 @@
+---
+---
+
+- 修复日志窗口无法清除日志的问题
+- 检查下载的 Fabric 安装包是否完整，避免 MCBBS 源带来的错误
+- 启动提示内存过大时允许停止启动
@@ -0,0 +1,6 @@
+---
+---
+
+- 更新俄语翻译
+- 修复在“在游戏启动后关闭启动器”启用时游戏无法启动的问题
+- 修复弹出对话框时无法拖动窗口的问题
@@ -0,0 +1,4 @@
+---
+---
+
+- 修复无法自动更新的问题
@@ -0,0 +1,7 @@
+---
+---
+
+- 修复进入游戏设置后无法重命名部分游戏版本的问题
+- 修复 Curse 整合包下载时遗漏 Mod 的问题
+- 修复部分情况下弹框消失的问题
+- 在 OptiFine 库缺失时可以自动补全
@@ -0,0 +1,11 @@
+---
+---
+
+- 将主界面的版本列表弹框的滚动条改为黑色
+- 修复某些情况下启动游戏时，提示 NullPointerException 的问题
+- 允许使用在启动器同目录下的 authlib-injector.jar 文件
+- 修复刷新下载列表时可能提示 ConcurrentModificationException 的问题
+- 修复重命名被依赖的版本后，会破坏其他依赖这个版本的版本的问题
+- 更正重命名版本时，输入不合法的新名字后的错误提示
+- 修复在自定义游戏运行目录时，输入不合法的路径会导致崩溃的问题
+- 修复在输入特定错误的 authlib-injector 服务器地址时会导致启动器崩溃的问题
@@ -0,0 +1,9 @@
+---
+---
+
+- 修复 1.12.2 同时安装 Forge, OptiFine 时无法进入游戏存档的问题
+- 修复服务器自动更新整合包更新时可能会出现 AccessDeniedException 的问题
+- 现在会记住启动器上次使用的窗口大小
+- 游戏设置页面也可以安装游戏、添加整合包和刷新版本列表
+- 游戏设置页面可以修改默认启动游戏版本
+- 使用外置登录账户时，主页面的账户将显示认证服务器名称
@@ -0,0 +1,5 @@
+---
+---
+
+- 修复部分情况下崩溃的问题
+- 支持同时安装 Minecraft 1.14.4 及以上版本的 Forge 和 OptiFine
@@ -0,0 +1,15 @@
+---
+---
+
+- 添加窗口阴影
+- 添加为正版账号上传皮肤的功能
+- 现在会校验资源索引文件的完整性
+- 现在启动器代理设置对启动后的游戏有效
+- 自动安装页面将提示不兼容的第三方库，比如 Forge 和 Fabric 不兼容
+- 添加启动器的 JVM 参数 -Dhmcl.font.override=fontfamily 以允许 Linux 用户更换字体以解决白屏问题
+- 修复无法安装 Curse 整合包的问题
+- 修复下载资源文件时不能自动切换下载源的问题
+- 修复 1.5.2 及以下版本不能下载资源文件的问题
+- 修复 1.5.2 及以下版本安装 Forge 后启动失败的问题
+- 修复不能在 Java 17 下载 Forge 和自动更新的问题
+- 修复整合包配置丢失后整合包游戏版本不能修改配置的问题
@@ -0,0 +1,11 @@
+---
+---
+
+- 修复启动 Minecraft 1.0 时不会停止等待游戏启动的问题
+- 更新游戏整合包后会显示新的版本号
+- 修复更新整合包下载地址不能使用在线下载自动更新整合包的问题
+- 修复首次打开整合包会弹出 3 个新建账户窗口的问题
+- 配置文件会优先选择启动器同目录而不是工作目录
+- 修复运行在 Java 12+ 时列表和下拉菜单不能正常显示的问题
+- 修复鼠标指针不正常的问题
+- 修复添加外置登录的正版账号后会与普通正版账号冲突的问题
@@ -0,0 +1,7 @@
+---
+---
+
+- 允许第三方修改 HMCL 的 BMCLAPI 下载源，从而支持第三方下载源
+- 自动设置游戏的默认语言为中文
+- 修复因为线程过多导致在 macOS 系统上运行崩溃的问题
+- 修复重命名游戏版本点击移动窗口而不是移动光标的问题
@@ -0,0 +1,4 @@
+---
+---
+
+- 修复部分情况误修改 options.txt 的问题
@@ -0,0 +1,9 @@
+---
+---
+
+- 支持微软正版账户登录
+- 支持 Authlib-injector 账户上传皮肤
+- 支持 Authlib-injector 服务器用邮箱以外的账户登录
+- 尝试修复在游戏启动后启动器直接关闭时导致游戏卡死的问题
+- 修复启动器设置 HTTP 代理后，游戏无法访问网络的问题
+- 修复下载支持库文件失败时启动器崩溃的问题
@@ -0,0 +1,4 @@
+---
+---
+
+- 修复下载失败导致游戏无法启动的问题
@@ -0,0 +1,5 @@
+---
+---
+
+- 修复不能检测 20w45a+ 以上游戏的版本号
+- 修复同时只有一个文件在下载的问题
@@ -0,0 +1,5 @@
+---
+---
+
+- 修复微软账号在设置了皮肤之后不能登录的问题
+- 修复不能显示微软账号皮肤的问题
@@ -0,0 +1,5 @@
+---
+---
+
+- 支持我的世界中文论坛整合包标准
+- 修复下载失败的问题
@@ -0,0 +1,5 @@
+---
+---
+
+- 微软登录页添加加载进度条
+- 修复整合包导出页无法点击下一步的问题
@@ -0,0 +1,8 @@
+---
+---
+
+- 修复服务端自动更新整合包不能更新游戏、Forge 版本的问题
+- 兼容 Java11+，在 Java 11+ 上运行时会自动下载 JavaFX
+- 修复不能识别部分数据包的问题
+- 刷新账户时将显示进度条
+- 上传皮肤时自动检测 Steve、Alex 模型
@@ -0,0 +1,6 @@
+---
+---
+
+- 修复 macOS 下启动器图标和 Finder 相同的问题，仅在 Java 9+ 生效
+- 修复与 Java 16 的兼容性问题
+- 允许在导出的整合包内包含启动器程序
@@ -0,0 +1,6 @@
+---
+---
+
+- 解决 Java 16 下部分 mod 不能正常运行的问题
+- 修复对系统平台的识别错误导致部分平台不能正确下载 JavaFX 的问题
+- 启动 Minecraft 1.17 时自动下载官方提供的 Java 16
@@ -0,0 +1,7 @@
+---
+---
+
+- 自定义本地库路径，允许 M1 设备运行 ARM 版本的 Minecraft
+- 自动检测系统内安装的 OpenJDK，包括 Liberica/Microsoft/Zulu/AdoptOpenJDK
+- 修复 exe 版本不能正常下载 JavaFX 的问题
+- 修复 Windows 下打开使用 Unicode UTF-8 提供全球语言支持选项后启动器无法打开的问题
@@ -0,0 +1,13 @@
+---
+---
+
+- 支持使用 Fabric 作为 Mod 加载器的 CurseForge 整合包
+- 修复尝试下载 Java16 时只有确定没有取消按钮的问题
+- 修复下载 Java16 时取消下载过程后启动器崩溃的问题
+- 自动选择新添加的 Authlib-injector 服务器
+- 修复安装整合包时可能崩溃的问题
+- 压缩了启动器本体文件大小
+- 修复 MCBBS 整合包实现不符合规范的问题
+- 允许在 Minecraft 自定义参数内使用 ${game_directory} 等占位符
+- 支持官方启动器为 Minecraft 启动参数提供的一些占位符
+- 允许在 Java 自定义参数内覆盖启动器默认提供的启动参数，而不需要再禁止启动器生成默认参数
@@ -0,0 +1,5 @@
+---
+---
+
+- 支持 1.17 Forge 的自动安装与游戏启动
+- 修复不能正常启动 Minecraft 1.5 及以下版本的问题（需要手动删除 options.txt）
@@ -0,0 +1,6 @@
+---
+---
+
+- 支持 CurseForge 整合包和 Mod 下载
+- 改进版本管理和游戏设置的界面
+- 修复不能启动 BakaXL 安装后的游戏的问题
@@ -0,0 +1,7 @@
+---
+---
+
+- 添加查看模组详细介绍及打开其官方页面的功能
+- Mod 下载列表会按照发布时间排序
+- 修复 Mod 下载页面存在空白区域的问题
+- 修复操作账户时崩溃的问题
@@ -0,0 +1,4 @@
+---
+---
+
+- 修复进入 Mod 下载页面时崩溃的问题
@@ -0,0 +1,5 @@
+---
+---
+
+- 修复不能启动 Forge 1.17.1-37.0.29 及以上版本的问题
+- 修复英文语言设置下版本管理页面的标题错误的问题
@@ -0,0 +1,14 @@
+---
+---
+
+- 在整合包下载页按回车也可以发起搜索
+- 支持我的世界中文论坛整合包规范第二版，兼容 CurseForge 整合包格式，允许导入 MultiMC
+- 重新设计关于页面
+- 修改创建账号页面
+- 新增赞助列表页面
+- 修复微软登录页可能白屏的问题
+- 修复微软登录很快过期的问题
+- 修复错误检测 Forge 版本号以至于不能导出正确的整合包的问题
+- 修复在主页按多次回车键会重复启动游戏的问题
+- 修复安装整合包时没有检查名字是否符合 Windows 文件名规范的问题
+- 修复 Forge 安装器部分内容仍需从官方源下载的问题
@@ -0,0 +1,4 @@
+---
+---
+
+- 修复微软登录超时后崩溃的问题
@@ -0,0 +1,21 @@
+---
+---
+
+- 添加帮助页面
+- 添加修改游戏进程优先级的功能
+- 任意页面按 ESC 键可返回上一页
+- 支持自动选择游戏内存大小
+- 添加 Linux 下使用系统 GLFW 及 OpenAL 的功能
+- 添加自动选择下载源的功能
+- 允许修改默认的下载并发数
+- 添加单独的下载页面，额外支持资源包和存档的下载功能
+- 更换默认背景图
+- 调整界面外观
+- 支持自动安装 Fabric-API（该功能尚未完成，需要在 Java 虚拟机参数中添加 -Dfabric.development 方能使用）
+- 修复微软登录成功页乱码的问题
+- 修复微软账号年龄不满 18 岁显示的错误信息不易于阅读等问题
+- 修复不能启动 PCL 安装的部分游戏的问题
+- 修复不能启动 Fabric 安装器安装的 1.18 版本的问题
+- 修复模组下载页面没有按时间排序的问题
+- 修复 Java 11 以上滚动条的样式问题
+- 修复部分 Linux 发行版下不能打开微软登录页面的问题
@@ -0,0 +1,19 @@
+---
+---
+
+- 更新至 JavaFX 17，额外支持 Mac M1 设备下自动下载 JavaFX
+- Authlib-Injector 认证服务器管理页面移动至账户管理页侧边栏
+- 支持修改离线账户的 UUID
+- Mod 管理页面和下载页面尽可能显示 Mod 的中文名称
+- Mod 下载页面允许中文搜索
+- Mod 下载页面允许选择搜索 CurseForge 或者 Modrinth
+- Mod 下载页面允许查看 Mod 的 MC 百科页面与 MCBBS 页面
+- Mod 下载页面允许选择要安装到的目标游戏版本
+- 下载页面首页修改为游戏安装页，而不是 Mod 下载页
+- 自动安装 Fabric-API 至新游戏的 Mod 目录
+- 微软登录时无法自动打开浏览器时允许手动复制链接
+- 修复微软登录时提示 NullPointerException 或者部分情况下的无法连接认证服务器的问题
+- 修复安装新游戏失败的问题
+- 修复自动选择内存大小后内存大小过小的问题
+- 修复返回主页卡死的问题
+- 修复 Mod 下载页无法显示 Emoji 字符的问题
@@ -0,0 +1,16 @@
+---
+---
+
+- 添加多人联机，由于处于试验阶段，如果出现问题请反馈
+- 调整界面外观
+- 背景路径支持网络链接
+- 允许修改启动器字体
+- 添加崩溃分析报告窗口，尽量分析崩溃信息，而不是直接打开日志窗口
+- Mod 下载页面按游戏版本分类
+- Mod 下载页面显示前置 Mod
+- EXE 版本优先选择独立显卡
+- 打开不检查游戏完整性选项时，同时不检查服务端自动更新整合包的更新
+- 修复点击 Mod 列表页 Mod 文件夹按钮后不能打开正确文件夹的问题
+- 修复下载 Mod 时无法取消的问题
+- 修复不能正确识别 MCBBS V2 整合包的问题
+- 修复 PATH 格式不正确时导致启动器崩溃的问题
@@ -0,0 +1,18 @@
+---
+---
+
+- 添加联机房间准入功能，房主同意后玩家才能加入房间
+- 添加联机房间管理功能，可以查看已经在房间中的玩家
+- 添加联机 Token 设置和中继模式
+- 联机时不再需要正版登录，但玩家必须在多人游戏页面直连 HMCL 多人联机房间
+- 添加修改离线账户皮肤的功能，允许使用本地图片和 LittleSkin 等皮肤站
+- 添加自动选择 Java 选项，省去提示用户需要更改 Java 版本的步骤
+- 添加模组批量更新功能
+- 修改页面跳转动画
+- 支持导入由玩家手动打包的包含 .minecraft 文件夹的整合包
+- Fabric Mod 崩溃时提示 Mod 冲突或缺失前置 Mod 原因
+- 在全局游戏设置中提示当前版本正在使用游戏独立设置，以避免玩家在错误的地方修改设置
+- 支持 1.17 下 OptiFine 与 Forge 同时安装
+- 修复由于 Java 损坏导致无法检测 Java 版本时，启动游戏卡死的问题
+- 修复 Mojang 账号和 Authlib-Injector 账号登录时卡死，看不到密码框的问题
+- 修复 Mojang 账号和 Authlib-Injector 账号刷新时崩溃的问题
@@ -0,0 +1,18 @@
+---
+---
+
+- 联机: 更新 cato 至 1.0.c，支持 macOS M1 芯片设备
+- 联机: 网络测试改用快速测试方法
+- 联机: 添加加入申请选项，默认不再需要房主手动同意加入申请
+- 联机: 在需要房主手动同意加入申请时，提供 30 秒超时，超时后自动拒绝申请
+- 在调试选项下和本地目录设置下显示警告信息
+- 离线账户皮肤选择本地文件时，允许修改人物模型为 Slim
+- 启用标题栏透明选项时，标题栏背景色调为半透明
+- 现启动器更新通道将与启动器本身发布为开发版或稳定版绑定，避免玩家使用开发版时因为忘记调整更新通道，不能收到后续开发版更新推送
+- 修改页面跳转动画
+- 修复游戏崩溃报告页面崩溃的问题
+- 修复进入联机页面时没有下载 cato 的问题
+- 修复离线账户皮肤选择 Blessing Skin 时，网址末尾添加斜杠会无法加载皮肤的问题
+- 修复复制游戏实例时崩溃的问题
+- 修复点击反馈页面空白处弹出反馈详细信息页面的问题
+- 修复批量更新模组时，将 Forge Mod 更新为 Fabric Mod 的问题
@@ -0,0 +1,10 @@
+---
+---
+
+- 在杀毒软件删除 cato 时，弹出警告提示，而不是崩溃启动器
+- 资源包下载页面添加版本选择
+- 微软账号登录时被服务器要求重新手动登录时弹出登录提示框而不是登录失败
+- 修复运行在 32 位 Java 上时不能正确提示游戏不应使用 32 位 Java 运行的问题
+- 修复模组页、游戏下载页等页面标签错乱的问题
+- 修复游戏崩溃报告窗口不显示内存和 Java 版本的问题
+- 修复联机加入房间失败时将连接无法建立显示为被房主踢出的问题
@@ -0,0 +1,5 @@
+---
+---
+
+- 运行环境缺少 JavaFX 时，直接开始下载而不是等待用户选择下载源
+- 修复联机断联的问题
@@ -0,0 +1,34 @@
+---
+---
+
+- 不再翻译 id 为 examplemod 的 Mod 名称以避免歧义
+- 如果在 macOS/Windows ARM 设备上使用 HMCL，HMCL 会优先使用 x86 的 JDK 运行游戏
+- 提供更多预设的游戏版本图标以供设置
+- 完善显卡驱动问题提示语
+- 完善 Linux 用户因使用 Java9+ 版本导致游戏崩溃的提示语
+- 导出游戏启动脚本时，可以导出 PowerShell 格式的脚本
+- 支持游戏需要 Java 8 时提示并下载 Java 8
+- 下载 Mod 时，可以自定义文件名称
+- 添加透明背景选项
+- 添加日语翻译
+- 更新俄语翻译
+- 兼容 TLauncher 游戏客户端
+- 联机: 修复使用 32 位 Java 时提示多人联机不支持当前平台的问题
+- 联机: 修复 NAT 检测状态一直为检测中的问题
+- 联机: 支持 Windows ARM64 平台
+- 联机: 更新 cato 至 1.1.1
+- 联机: 校验 cato 可执行文件的完整性，避免病毒等程序篡改 cato 导致安全风险
+- 联机: 缩短联机码长度，避免联机码中因为包含斜杠，与 QQ 的表情转义符冲突的问题
+- 修复 macOS 上不能启动远古版本游戏的问题
+- 修复启动器打开时提示找不到 DST ROOT CA X3 证书的问题
+- 修复因为调整了游戏进程优先级设置，导致游戏不能运行，提示命令行过长的问题
+- 修复游戏版本名过长时布局混乱的问题
+- 修复离线帐户披风显示错误的问题
+- 修复不能复制游戏实例的问题
+- 修复不能选择自定义 Java 路径的问题
+- 修复不能修改没有 jar 文件的游戏实例的问题
+- 修复远古测试版启动时提示需要 Java 7 的问题
+- 修复背景网址不合法时启动器背景全透明的问题
+- 修复 Linux 下无法启动在中文目录下的游戏的问题
+- 修复下载 Java 失败时提示启动器崩溃的问题
+- 修复取消下载 Java 时无法取消游戏启动进程的问题
@@ -0,0 +1,10 @@
+---
+---
+
+- 提示下载 Java 时，额外提供手动下载链接
+- 更新 cato 至 1.1.0
+- 修复部分页面进入时崩溃的问题
+- 修复设置系统环境变量 classpath 后游戏无法启动的问题
+- 修复删除所有游戏文件夹配置项后崩溃的问题
+- 修复删除游戏版本后不退出游戏设置页面的问题
+- 修复重命名游戏版本后游戏设置页面未刷新的问题
@@ -0,0 +1,5 @@
+---
+---
+
+- 修复 Log4j 远程代码执行漏洞
+- 修复解压 zip 文件时丢失文件属性的问题
@@ -0,0 +1,5 @@
+---
+---
+
+- 修复 Log4j 远程代码执行漏洞
+- 修复取消启动警告框后，启动游戏进度框不退出的问题
@@ -0,0 +1,5 @@
+---
+---
+
+- 修复 Log4j 远程代码执行漏洞
+- 更新 cato 至 1.2.0
@@ -0,0 +1,11 @@
+---
+---
+
+- 重命名某个游戏版本后，该游戏版本将会被选中为当前游戏版本
+- 修复 cato 选项名称错误的问题
+- 修复 1.17/1.18 Forge 客户端不能启动的问题
+- 修复在定制离线帐户皮肤后，导出的游戏脚本不能正常启动游戏的问题
+- 修复 Mod 下载页面加载失败后点击刷新页面提示无反应的问题
+- 修复游戏崩溃分析窗口内显示了不知道是什么库的版本号的问题
+- 修复 Fabric-API 下载不完整的问题
+- 修复 Fabric-API 列表中存在与游戏版本不匹配的版本的问题
@@ -0,0 +1,10 @@
+---
+---
+
+- 修复在包含等于号的路径下运行时无法正确加载漏洞修复工具的问题
+- 修复 Mod 下载页选择 Modrinth 源时，排序选项不可用的问题
+- 修复下载游戏向导中，在某些情况下加载了错误的 Fabric API 列表的问题
+- 修复启动游戏时，如果 Java 版本不正确，某些情况下会导致启动器崩溃的问题
+- 修复某些情况下不能更新游戏版本为 Minecraft 1.18 所安装的 Forge
+- 修复多人联机页面在快速点击打开房间时导致启动器崩溃的问题
+- 修复删除离线帐户使用的本地皮肤文件后游戏不能启动的问题
@@ -0,0 +1,13 @@
+---
+---
+
+- 支持整合包下载页使用中文搜索
+- 支持下载安装 Modrinth 整合包
+- 修复在语言为英文时仍翻译 Mod 名称的问题
+- 修复离线模式帐户无法使用 LittleSkin 皮肤站的问题
+- 修复下载 Mod 和整合包时，没有显示下载进度的问题
+- 修复在 macOS 和 Linux 系统下不能打开模组文件路径的问题
+- 修复部分情况下因 Zip 包编码无法检测，以致无法安装整合包的问题
+- 修复无法启动包含 LabyMod 的游戏的问题
+- 在系统内没有检测到 Java 时，自动尝试安装 Java，而不只提示用户手动安装
+- 更新 cato 网站链接
@@ -0,0 +1,4 @@
+---
+---
+
+- 修复 CurseForge 整合包无法下载安装的问题
@@ -0,0 +1,13 @@
+---
+---
+
+- 支持在文件管理器中显示文件，或者在 Linux 中直接打开父目录。
+- 默认开启“自动选择合适的 Java”
+- 修复部分 UI 问题
+- 修复更换资源类别后不更新列表的问题
+- 修复无法获取前置模组信息
+- 更新翻译
+- 修复整合包的 mcmod 网址不正确问题
+- 修复无法将 mrpack 文件拖拽至主页面安装整合包的问题
+- 在 JDK 安装不完整时提醒重新安装
+- 修改微软账户上传皮肤链接
@@ -0,0 +1,17 @@
+---
+---
+
+- 修复翻译错误
+- 适配 Apple Silicon Mac 与龙芯平台
+- 修复不会自动补全缺失的 OptiFine 文件的问题
+- 更新官方下载源链接
+- 修复 OptiFine 自动安装后启动崩溃的问题
+- 微软账户相关调整
+- 添加世界信息界面（允许玩家在启动器内查看更详细的世界信息以及调整一些基本设置）
+- 修复使用 Java 9+ 编译时的错误
+- 修复资源搜索获取信息失败相关问题
+- 添加 Quilt 自动安装
+- 回滚 HMCLauncher.exe ,减少杀毒软件报毒
+- 为非 x86 平台提供开箱即用的启动支持
+- 更新自动安装页面
+- 修复在创建账户页面下认证服务器未知的问题
@@ -0,0 +1,20 @@
+---
+---
+
+- 在启动游戏时刷新账户失败时提示重试登录
+- 修复在授权过期时不会显示重新登录对话框
+- 微软登录相关优化
+- 修复通过自动安装更新游戏时的崩溃
+- 支持 Github Action 的构建产物微软登录
+- 更多平台的原生适配
+- 修复在找不到合适的 Java 时启动时卡住的问题
+- 支持在 linux-loongarch64_ow 上自动下载 JavaFX
+- 更新翻译
+- 添加 sh 二进制文件支持
+- 修复 Modrinth 整合包安装
+- 更新多人联机
+- 日志分析器显示相关优化
+- 修复 Modrinth 格式的 Quilt 整合包安装错误
+- 修复 Modrinth 模组包解析错误
+- Quilt 自动安装相关调整
+- 修复下载 Java 链接错误
@@ -0,0 +1,8 @@
+---
+---
+
+- 多人联机功能暂时下线维护[详情](https://hmcl.huangyuhui.net/api/redirect/multiplayer-migrate)
+- 修复中文路径下启动 <= 1.12.2 的版本没有声音的问题
+- 修复 提示弹窗 的文本显示问题
+- 更新相关翻译
+- 优化未存在可用的 Java 环境启动 HMCL 时的提示
--- a/Show More
+++ b/Show More
				`@@ -1 +0,0 @@`
				<!doctype html><html lang="zh" class="no-js"><head><meta charset="utf-8"><title>HMCL 文档</title><meta name="description" content="HMCL 启动器 \| 跨平台 \| 整合包管理 \| 自动安装 \| 十二年历史 \| 三亿次使用"><meta property="og:type" content="website"><meta property="og:locale" content="zh"><meta property="og:site_name" content="HMCL 文档"><meta property="og:title" content="HMCL 文档"><meta property="og:url" content="https://docs.hmcl.net/404.html"><meta property="og:description" content="HMCL 启动器 \| 跨平台 \| 整合包管理 \| 自动安装 \| 十二年历史 \| 三亿次使用"><link rel="canonical" href="https://docs.hmcl.net/404.html"><link href="/feed.xml" type="application/atom+xml" rel="alternate" title="HMCL 文档 Feed"><meta name="viewport" content="width=device-width, initial-scale=1.0"> <script> document.documentElement.className = document.documentElement.className.replace(/\bno-js\b/g, '') + ' js '; window.enable_copy_code_button = true; </script><link rel="stylesheet" href="/assets/css/main.css"><link rel="stylesheet" href="/assets/lib/fontawesome/css/all.min.css"> <noscript><link rel="stylesheet" href="/assets/lib/fontawesome/css/all.min.css"></noscript> <script src="/assets/js/settings.js"></script> <script src="/assets/js/theme.js"></script><link rel="shortcut icon" href="/favicon.ico"><link rel="stylesheet" id="skin"></head><body class="layout--splash" dir="ltr"><nav class="skip-links"><ul><li><a href="#site-nav" class="screen-reader-shortcut">转到主导航栏</a></li><li><a href="#main" class="screen-reader-shortcut">转到内容</a></li><li><a href="#footer" class="screen-reader-shortcut">转到底部</a></li></ul></nav><div class="masthead"><div class="masthead__inner-wrap"><div class="masthead__menu"><nav id="site-nav" class="greedy-nav"> <a class="site-logo" href="/"><img src="/assets/img/hmcl.png" alt="HMCL 文档"></a> <a class="site-title" href="/"> HMCL 文档 </a><ul class="visible-links"><li class="masthead__menu-item"> <a href="/settings.html" >设置</a></li></ul><button class="greedy-nav__toggle hidden" type="button"> <span class="visually-hidden">切换菜单</span><div class="navicon"></div></button><ul class="hidden-links hidden"></ul></nav></div></div></div><div class="initial-content"><div id="main" role="main"><article class="splash" itemscope itemtype="https://schema.org/CreativeWork"><meta itemprop="description" content=""><section class="page__content" itemprop="text"><div class="notice--danger"><h1>404</h1><p><strong>页面不存在</strong></p></div></section></article></div></div><div id="footer" class="page__footer"><footer><div class="page__footer-follow"><ul class="social-icons"><li><strong>关注:</strong></li><li><a href="https://github.com/HMCL-dev/HMCL" rel="nofollow noopener noreferrer"><i class="fab fa-fw fa-github" aria-hidden="true"></i> Github</a></li><li><a href="https://beian.miit.gov.cn" rel="nofollow noopener noreferrer"><i class="fas fa-link" aria-hidden="true"></i> 粤ICP备18071565号</a></li><li><a href="/feed.xml"><i class="fas fa-fw fa-rss-square" aria-hidden="true"></i> Feed</a></li></ul></div><div class="page__footer-copyright">© 2026 <a href="mailto:hmcl@huangyuhui.net">huanghongxun</a>. 技术来自于 <a href="https://jekyllrb.com" rel="nofollow">Jekyll</a> & <a href="https://mademistakes.com/work/jekyll-themes/minimal-mistakes/" rel="nofollow">Minimal Mistakes</a>.</div></footer></div><script src="/assets/js/main.min.js"></script> <script src="/assets/js/plugins/jquery.auto-redirect.js"></script></body></html>