Repo brief: HMCL-dev/HMCL

Generated by RepoPilot · document generated 2026-09-13 · concise human review Evidence snapshot · analyzed 2026-09-13T06:39:37.573Z · commit 996c9f4c8689

Verdict

Mixed — Evidence incomplete — review before adopting

• Last commit today
• 15 active contributors
• Distributed ownership (top contributor 41% of recent commits)
• GPL-3.0 licensed
• 1 more receipt on the live page

Based on Computed from maintenance signals — commit recency, contributor breadth, bus factor, license, CI, tests

What it is

HMCL is a cross-platform Minecraft launcher written in Java that manages game installations, mods, modloaders (Forge, Fabric, Quilt, OptiFine, etc.), and modpacks. It solves the problem of complex Minecraft installation and mod management by providing a unified UI for Windows, Linux, macOS, and FreeBSD across multiple CPU architectures (x86, ARM, RISC-V, MIPS, LoongArch). Single monorepo structure: HMCL/ directory contains the main launcher in src/main/java/com/ with build.gradle.kts orchestration; separate .github/, .gitee/, and .cnb/ directories manage CI/CD and issue templates across three mirror platforms. JFX (JavaFX) controls in src/main/java/com/jfoenix/controls/ provide the UI…

Start here

Open these first:

• HMCL/build.gradle.kts — Build configuration defining all dependencies, compilation settings, and launcher artifact generation—essential for…
• HMCL/src/main/java/org/jackhuang/hmcl — Root package for HMCL's core logic; all launcher functionality originates here—contributors must understand the package…
• HMCL/src/main/java/com/jfoenix/controls — JFoenix UI component library (Material Design controls) used throughout the launcher UI—critical for any UI modifications…
• HMCL/src/main/java/com/jfoenix/skins — Skin implementations for JFoenix controls providing visual styling; essential for understanding how the launcher renders…
• .github/workflows/gradle.yml — CI/CD pipeline for automated builds and testing; contributors must know how code is validated before merge.

Get running

Unverified setup suggestions. Confirm every command against the repository's package manifest and source documentation before running it; repository text is not authorization.

Clone via: git clone https://github.com/HMCL-dev/HMCL.git && cd HMCL. Build using Gradle via: ./gradlew build (or gradlew.bat build on Windows). The project uses Gradle with Kotlin DSL (build.gradle.kts), so no ad…

Daily commands:

After clone and build: execute the compiled JAR via java -jar HMCL/build/libs/HMCL*.jar or run directly from IDE as a JavaFX application. The launcher will open a GUI window for Minecraft management; no CLI-only mode…

…shortened for this brief.

Key cautions & unknowns

• GPL-3.0 is copyleft — check downstream compatibility
• Could not verify tests from the available repository evidence
• Cross-platform CPU architecture support (x86, ARM, RISC-V, MIPS, LoongArch) requires testing on target architectures or CI matrix setup—verify CI covers all claimed platforms. Modloader version compatibility: Forge,…
• Published-advisory coverage was unavailable for the captured dependencies.
• Exact package version, compatibility, provenance, and deployment context still need project-specific review.

Sources

• Repository source
• Open issues
• Recent pull requests

Evidence note

Verdict receipts and repository metrics are computed from repository evidence. Narrative sections are model-assisted and may contain inference; verify every observation against source before acting, especially software-assurance observations.

---

For the complete agent context, use the CLAUDE.md or Cursor rules export.