{"id":15031225,"url":"https://github.com/hmcl-dev/hmcl","last_synced_at":"2026-05-03T10:04:40.410Z","repository":{"id":34058613,"uuid":"37844001","full_name":"HMCL-dev/HMCL","owner":"HMCL-dev","description":"A Minecraft Launcher which is multi-functional, cross-platform and popular","archived":false,"fork":false,"pushed_at":"2025-05-09T02:08:08.000Z","size":30055,"stargazers_count":7584,"open_issues_count":219,"forks_count":714,"subscribers_count":99,"default_branch":"main","last_synced_at":"2025-05-09T03:24:39.469Z","etag":null,"topics":["javafx","minecraft","minecraft-launcher"],"latest_commit_sha":null,"homepage":"https://hmcl.huangyuhui.net","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/HMCL-dev.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2015-06-22T08:06:03.000Z","updated_at":"2025-05-09T03:07:35.000Z","dependencies_parsed_at":"2023-09-29T13:55:43.928Z","dependency_job_id":"646f49fd-7bfe-4865-84fe-3d769190833f","html_url":"https://github.com/HMCL-dev/HMCL","commit_stats":{"total_commits":2973,"total_committers":88,"mean_commits":33.78409090909091,"dds":0.6444668684830137,"last_synced_commit":"54188bf8f211baec994e81c2d2a9e8a5d318d1ee"},"previous_names":["hmcl-dev/hmcl","huanghongxun/hmcl"],"tags_count":250,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HMCL-dev%2FHMCL","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HMCL-dev%2FHMCL/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HMCL-dev%2FHMCL/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HMCL-dev%2FHMCL/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/HMCL-dev","download_url":"https://codeload.github.com/HMCL-dev/HMCL/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253990470,"owners_count":21995774,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["javafx","minecraft","minecraft-launcher"],"created_at":"2024-09-24T20:15:12.091Z","updated_at":"2025-12-29T12:44:21.754Z","avatar_url":"https://github.com/HMCL-dev.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"# ⛏ Hello Minecraft! Launcher 💎\n\n[![Build Status](https://ci.huangyuhui.net/job/HMCL/badge/icon?.svg)](https://ci.huangyuhui.net/job/HMCL)\n![Downloads](https://img.shields.io/github/downloads/HMCL-dev/HMCL/total?style=flat)\n![Stars](https://img.shields.io/github/stars/HMCL-dev/HMCL?style=flat)\n[![Discord](https://img.shields.io/discord/995291757799538688.svg?label=\u0026logo=discord\u0026logoColor=ffffff\u0026color=7389D8\u0026labelColor=6A7EC2)](https://discord.gg/jVvC7HfM6U)\n[![QQ Group](https://img.shields.io/badge/QQ-HMCL-bright?label=\u0026logo=qq\u0026logoColor=ffffff\u0026color=1EBAFC\u0026labelColor=1DB0EF\u0026logoSize=auto)](https://docs.hmcl.net/groups.html)\n\n**English** | [简体中文](README_cn.md) | [繁體中文](README_tw.md)\n\n## Introduction\n\nHMCL is an open-source, cross-platform Minecraft launcher that supports Mod Management, Game Customizing, ModLoader Installing (Forge, NeoForge, Fabric, Quilt, LiteLoader, and OptiFine), Modpack Creating, UI Customization, and more.\n\nHMCL has amazing cross-platform capabilities. Not only does it run on different operating systems like Windows, Linux, and macOS, but it also supports various CPU architectures such as x86, ARM, RISC-V, MIPS, and LoongArch. You can easily enjoy Minecraft across different platforms through HMCL.\n\nFor systems and CPU architectures supported by HMCL, please refer to [this table](PLATFORM.md).\n\n## Download\n\nDownload the latest version from the [official website](https://hmcl.huangyuhui.net/download).\n\nYou can also find the latest version of HMCL in [GitHub Releases](https://github.com/HMCL-dev/HMCL/releases).\n\nAlthough not necessary, it is recommended only to download releases from the official websites listed above.\n\n## License\n\nThe software is distributed under [GPLv3](https://www.gnu.org/licenses/gpl-3.0.html) license with the following additional terms:\n\n### Additional terms under GPLv3 Section 7\n\n1. When you distribute a modified version of the software, you must change the software name or the version number in a reasonable way in order to distinguish it from the original version. (Under [GPLv3, 7(c)](https://github.com/HMCL-dev/HMCL/blob/11820e31a85d8989e41d97476712b07e7094b190/LICENSE#L372-L374))\n\n   The software name and the version number can be edited [here](https://github.com/HMCL-dev/HMCL/blob/javafx/HMCL/src/main/java/org/jackhuang/hmcl/Metadata.java#L33-L35).\n\n2. You must not remove the copyright declaration displayed in the software. (Under [GPLv3, 7(b)](https://github.com/HMCL-dev/HMCL/blob/11820e31a85d8989e41d97476712b07e7094b190/LICENSE#L368-L370))\n\n## Contribution\n\nIf you want to submit a pull request, here are some requirements:\n\n* IDE: IntelliJ IDEA\n* Compiler: Java 1.8 or Java 11+\n* Do NOT modify `gradle` files\n\n### Compilation\n\nSimply execute the following command in the project root directory:\n\n```bash\n./gradlew clean build\n```\n\nMake sure you have at least JavaFX 8 installed. Liberica Full JDK 8 or later is recommended.\n\n## JVM Options (for debugging)\n\n| Parameter                                    | Description                                                                                   |\n| -------------------------------------------- | --------------------------------------------------------------------------------------------- |\n| `-Dhmcl.home=\u003cpath\u003e`                         | Override HMCL directory                                                                       |\n| `-Dhmcl.self_integrity_check.disable=true`   | Bypass the self integrity check when checking for updates                                     |\n| `-Dhmcl.bmclapi.override=\u003curl\u003e`              | Override API Root of BMCLAPI download provider. Defaults to `https://bmclapi2.bangbang93.com` |\n| `-Dhmcl.font.override=\u003cfont family\u003e`         | Override font family                                                                          |\n| `-Dhmcl.version.override=\u003cversion\u003e`          | Override the version number                                                                   |\n| `-Dhmcl.update_source.override=\u003curl\u003e`        | Override the update source for HMCL itself                                                    |\n| `-Dhmcl.authlibinjector.location=\u003cpath\u003e`     | Use the specified authlib-injector (instead of downloading one)                               |\n| `-Dhmcl.openjfx.repo=\u003cmaven repository url\u003e` | Add custom Maven repository for downloading OpenJFX                                           |\n| `-Dhmcl.native.encoding=\u003cencoding\u003e`          | Override the native encoding                                                                  |\n| `-Dhmcl.microsoft.auth.id=\u003cApp ID\u003e`          | Override Microsoft OAuth App ID                                                               |\n| `-Dhmcl.microsoft.auth.secret=\u003cApp Secret\u003e`  | Override Microsoft OAuth App Secret                                                           |\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhmcl-dev%2Fhmcl","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhmcl-dev%2Fhmcl","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhmcl-dev%2Fhmcl/lists"}