HMCL-dev / HMCL-dev/HMCL

[Feature] 增强启动器的可定制性

Open
#4,375 3 comments 4 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

enhancement
Dominant language
Java
Stars
10.1k
Forks
934
Avg merge
1d 5h
Merged PRs (30d)
82

Description

概述 | Summary

允许用户(尤其是整合包作者)在不需要修改 HMCL 源码的情况下配置启动器的更多功能。

详情 | Description

我们希望用户能够通过以下方式,在不需要修改 HMCL 的情况下更自由地配置 HMCL。

  1. 新的配置文件 ./.hmcl/config.json
    hmcl.json 不同,这是一个只读的配置文件,用户无法在 HMCL 内修改该文件的内容,只能通过外部编辑器创建该文件。
    在这个文件中,用户可以配置以下功能:
    • HMCL 的更新源
    • 右上角的「帮助」按钮的链接
    • 左下角的「官方群组」按钮的链接
    • 启动器的标题
    • 首次打开启动器时的弹出公告
  2. ./.hmcl 中新的可选文件
    • icon.png:用于替换启动器标题栏的图标
    • java/<platform>/default:用于打开启动器的 Java
  3. HMCLauncher 提供新的 Lite HMCLLauncher 模式。
    在这种模式下,HMCL.jar 的内容并不在 HMCLauncher.{exe,sh} 的后面,而是在 ./.hmcl/hmcl.jar 中。HMCLauncher.{exe,sh} 仅负责寻找 Java 和 hmcl.jar 并启动游戏,更新时也不会破坏该文件,以便用户定制 exe 的图标,并保留 HMCL 的自动更新功能。

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start by reviewing the current configuration handling and HMCLauncher packaging, then compare them with the proposed ./.hmcl/config.json, icon.png, java//default, and ./.hmcl/hmcl.jar paths. Define how each listed setting and launcher mode should work, including updates and Java discovery; done means all requested customization options work without modifying HMCL source.

Written by the indexing model from the issue text.

Assessment

Tech stack
java
Domain
desktop
Issue type
Feature
Difficulty
5/5
Estimated time
Over a week
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
25/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.