How hmcl-dev/hmcl works
HMCL is a cross-platform Minecraft launcher. A player opens the launcher UI, selects or configures a game instance, installs required game components, and launches Minecraft. The repository separates launcher UI and settings from game-instance management, downloads, authentication, and addon features. The README also documents mod management, mod-loader installation, modpack creation, and UI customization. Some major features are represented by their implementing directories because their source was not sampled; uncertain wiring is left unasserted.
Main entry points: Controllers.java UI Controllers · download Download UI · DefaultGameInstance.java Game Instances · game Game UI
Components 16
Launcher UI
- UI Controllers
HMCL/src/main/java/org/jackhuang/hmcl/ui/Controllers.java - Launcher Settings
HMCL/src/main/java/org/jackhuang/hmcl/setting/SettingsManager.java - Game UI
HMCL/src/main/java/org/jackhuang/hmcl/ui/game
Game Instances
- Game Instances
HMCLCore/src/main/java/org/jackhuang/hmcl/game/DefaultGameInstance.java - Instance Repository
HMCLCore/src/main/java/org/jackhuang/hmcl/game/DefaultGameRepository.java - Instance Manifest
HMCLCore/src/main/java/org/jackhuang/hmcl/game/GameInstanceManifest.java - Game Launch
HMCL/src/main/java/org/jackhuang/hmcl/game/HMCLGameLauncher.java
Install and Download
- Download UI
HMCL/src/main/java/org/jackhuang/hmcl/ui/download - Dependency Install
HMCLCore/src/main/java/org/jackhuang/hmcl/download/DefaultDependencyManager.java - Java Management
HMCL/src/main/java/org/jackhuang/hmcl/java/JavaManager.java - Modpack Install
HMCL/src/main/java/org/jackhuang/hmcl/game/HMCLModpackInstallTask.java - Async Task Layer
HMCLCore/src/main/java/org/jackhuang/hmcl/task/Task.java
Accounts and Customization
- Mod Management
HMCLCore/src/main/java/org/jackhuang/hmcl/addon/LocalAddonManager.java - Account Login
HMCLCore/src/main/java/org/jackhuang/hmcl/auth/microsoft/MicrosoftService.java - Theme Packs
HMCL/src/main/java/org/jackhuang/hmcl/theme/ThemePackManager.java
Other components
- Player
Connections 16
- Player → UI Controllers: uses
- UI Controllers → Launcher Settings: initializes
HMCL/src/main/java/org/jackhuang/hmcl/ui/Controllers.java - UI Controllers → Java Management: starts search
HMCL/src/main/java/org/jackhuang/hmcl/ui/Controllers.java - Player → Game UI: selects instance
- Game UI → Game Instances: configures
- Instance Repository → Game Instances: provides snapshots
HMCLCore/src/main/java/org/jackhuang/hmcl/game/DefaultGameInstance.java - Game Instances → Instance Manifest: reads metadata
HMCLCore/src/main/java/org/jackhuang/hmcl/game/DefaultGameInstance.java - Player → Download UI: requests install
- Download UI → Dependency Install: installs components
- Download UI → Modpack Install: installs pack
- Dependency Install → Async Task Layer: runs tasks
HMCLCore/src/main/java/org/jackhuang/hmcl/download/DefaultDependencyManager.java - Java Management → Async Task Layer: runs tasks
HMCL/src/main/java/org/jackhuang/hmcl/java/JavaManager.java - Player → Game Launch: launches game
- Player → Mod Management: manages mods
- Player → Account Login: authenticates
- Player → Theme Packs: customizes UI