feat: 新增 HMCLMonitor 子项目，降低启动器隐藏时的内存占用

.gitignore

@@ -33,6 +33,7 @@ language-subtag-registry
 /HMCL/build/
 /HMCLCore/build/
 /HMCLBoot/build/
+/HMCLMonitor/build/
 /minecraft/libraries/HMCLTransformerDiscoveryService/build/
 /minecraft/libraries/HMCLMultiMCBootstrap/build/
 /buildSrc/build/
@@ -42,6 +43,7 @@ language-subtag-registry
 /out/
 /HMCL/out/
 /HMCLCore/out/
+/HMCLMonitor/out/
 /minecraft/libraries/HMCLTransformerDiscoveryService/out/
 /minecraft/libraries/HMCLMultiMCBootstrap/out/
 
@@ -50,6 +52,7 @@ language-subtag-registry
 /HMCL/bin/
 /HMCLBoot/bin/
 /HMCLCore/bin/
+/HMCLMonitor/bin/
 /minecraft/libraries/HMCLTransformerDiscoveryService/bin/
 /minecraft/libraries/HMCLMultiMCBootstrap/bin/
 .classpath

HMCL/build.gradle.kts

@@ -59,6 +59,7 @@ val embedResources = configurations.register("embedResources")
 dependencies {
     implementation(project(":HMCLCore"))
     implementation(project(":HMCLBoot"))
+    implementation(project(":HMCLMonitor"))
     implementation("libs:JFoenix")
     implementation(libs.jwebp)
     implementation(libs.fxsvgimage)
@@ -212,6 +213,7 @@ tasks.shadowJar {
         exclude(dependency("net.java.dev.jna:jna:.*"))
         exclude(dependency("libs:JFoenix:.*"))
         exclude(project(":HMCLBoot"))
+        exclude(project(":HMCLMonitor"))
     }
 
     manifest.attributes(

HMCL/src/main/java/org/jackhuang/hmcl/EntryPoint.java

@@ -20,6 +20,7 @@
 import org.jackhuang.hmcl.util.FileSaver;
 import org.jackhuang.hmcl.util.SelfDependencyPatcher;
 import org.jackhuang.hmcl.util.SwingUtils;
+import org.jackhuang.hmcl.monitor.Monitor;
 import org.jackhuang.hmcl.java.JavaRuntime;
 import org.jackhuang.hmcl.util.io.FileUtils;
 import org.jackhuang.hmcl.util.io.JarUtils;
@@ -50,6 +51,11 @@ public static void main(String[] args) {
         createHMCLDirectories();
         LOG.start(Metadata.HMCL_LOCAL_HOME.resolve("logs"));
 
+        // start HMCL monitor before JavaFX initialized
+        if (Monitor.processArguments(args)) {
+            exit(0);
+        }
+
         checkWine();
 
         if (OperatingSystem.CURRENT_OS == OperatingSystem.MACOS) {

HMCL/src/main/java/org/jackhuang/hmcl/Launcher.java

@@ -34,7 +34,9 @@
 import javafx.stage.Screen;
 import javafx.stage.Stage;
 import javafx.util.Duration;
+import org.jackhuang.hmcl.monitor.MonitorCrashReporter;
 import org.jackhuang.hmcl.game.HMCLCacheRepository;
+import org.jackhuang.hmcl.monitor.Monitor;
 import org.jackhuang.hmcl.setting.*;
 import org.jackhuang.hmcl.task.AsyncTaskExecutor;
 import org.jackhuang.hmcl.task.Schedulers;
@@ -145,6 +147,10 @@ public void start(Stage primaryStage) {
                 UpdateChecker.init();
 
                 primaryStage.show();
+
+                // check whether to show log from HMCL monitor
+                if (Monitor.wasCrashed() && Monitor.getResult() != null)
+                    MonitorCrashReporter.show(Monitor.getResult());
             });
         } catch (Throwable e) {
             CRASH_REPORTER.uncaughtException(Thread.currentThread(), e);

HMCL/src/main/java/org/jackhuang/hmcl/game/HMCLGameLauncher.java

@@ -21,16 +21,18 @@
 import org.jackhuang.hmcl.auth.AuthInfo;
 import org.jackhuang.hmcl.launch.DefaultLauncher;
 import org.jackhuang.hmcl.launch.ProcessListener;
+import org.jackhuang.hmcl.monitor.MonitorLauncher;
 import org.jackhuang.hmcl.util.NativePatcher;
 import org.jackhuang.hmcl.util.i18n.LocaleUtils;
 import org.jackhuang.hmcl.util.io.FileUtils;
 import org.jackhuang.hmcl.util.io.JarUtils;
 import org.jackhuang.hmcl.util.platform.CommandBuilder;
-import org.jackhuang.hmcl.util.platform.ManagedProcess;
+import org.jackhuang.hmcl.util.platform.ProcessInfo;
 import org.jackhuang.hmcl.util.versioning.GameVersionNumber;
 
 import java.io.IOException;
 import java.io.InputStream;
+import java.nio.charset.Charset;
 import java.nio.file.*;
 import java.util.*;
 import java.util.stream.Stream;
@@ -154,11 +156,20 @@ private static String normalizedLanguageTag(Locale locale, GameVersionNumber gam
     }
 
     @Override
-    public ManagedProcess launch() throws IOException, InterruptedException {
+    public ProcessInfo launch() throws IOException, InterruptedException {
         generateOptionsTxt();
         return super.launch();
     }
 
+    @Override
+    protected ProcessInfo startProcess(List<String> commandLine, Map<String, String> envVars, Charset encoding) throws IOException {
+        if (!MonitorLauncher.MONITOR_ENABLED || !(instance instanceof HMCLGameInstance hmclGameInstance))
+            return super.startProcess(commandLine, envVars, encoding);
+
+        /// using monitor to launch game if enabled
+        return MonitorLauncher.launchNewMonitor(commandLine, envVars, encoding, listener, hmclGameInstance, options);
+    }
+
     @Override
     public void makeLaunchScript(Path scriptFile) throws IOException {
         generateOptionsTxt();

HMCL/src/main/java/org/jackhuang/hmcl/game/LauncherHelper.java

@@ -23,6 +23,7 @@
 import org.jackhuang.hmcl.auth.*;
 import org.jackhuang.hmcl.auth.authlibinjector.AuthlibInjectorDownloadException;
 import org.jackhuang.hmcl.auth.offline.OfflineAccount;
+import org.jackhuang.hmcl.monitor.MonitorGameProcess;
 import org.jackhuang.hmcl.download.DefaultDependencyManager;
 import org.jackhuang.hmcl.download.DownloadProvider;
 import org.jackhuang.hmcl.download.game.*;
@@ -836,7 +837,7 @@ private final class HMCLProcessListener implements ProcessListener {
 
         private final ReentrantLock lock = new ReentrantLock();
         private final LaunchOptions launchOptions;
-        private ManagedProcess process;
+        private ProcessInfo process;
         private volatile boolean lwjgl;
         private LogWindow logWindow;
         private final boolean detectWindow;
@@ -855,14 +856,14 @@ public HMCLProcessListener(AuthInfo authInfo, LaunchOptions launchOptions, Count
         }
 
         @Override
-        public void setProcess(ManagedProcess process) {
+        public void setProcess(ProcessInfo process) {
             this.process = process;
 
-            String command = new CommandBuilder().addAll(process.getCommands()).toString();
+            String command = new CommandBuilder().addAll(process.commands()).toString();
 
             LOG.info("Launched process: " + command);
 
-            String classpath = process.getClasspath();
+            String classpath = process.classpath();
             if (classpath != null) {
                 LOG.info("Process ClassPath: " + classpath);
             }
@@ -970,7 +971,7 @@ public void onLog(String log, boolean isErrorStream) {
             if (forbiddenAccessToken != null)
                 log = log.replace(forbiddenAccessToken, "<access token>");
 
-            Log4jLevel level = isErrorStream && !log.startsWith("[authlib-injector]") ? Log4jLevel.ERROR : null;
+            @Nullable Log4jLevel level = isErrorStream && !log.startsWith("[authlib-injector]") ? Log4jLevel.ERROR : null;
             if (showLogs) {
                 if (level == null)
                     level = Objects.requireNonNullElse(Log4jLevel.guessLevel(log), Log4jLevel.INFO);
@@ -993,7 +994,13 @@ public void onLog(String log, boolean isErrorStream) {
                     try {
                         if (!lwjgl) {
                             lwjgl = true;
-                            finishLaunch();
+                            if (process instanceof MonitorGameProcess monitorProcess && !showLogs && launcherVisibility != LauncherVisibility.KEEP) {
+                                monitorProcess.detach();
+                                launchingLatch.countDown();
+                                runLater(Launcher::stopApplication);
+                            } else {
+                                finishLaunch();
+                            }
                         }
                     } finally {
                         lock.unlock();
@@ -1040,18 +1047,18 @@ public void onExit(int exitCode, ExitType exitType) {
 
     }
 
-    private static final Queue<WeakReference<ManagedProcess>> PROCESSES = new ConcurrentLinkedQueue<>();
+    private static final Queue<WeakReference<ProcessInfo>> PROCESSES = new ConcurrentLinkedQueue<>();
 
     public static int countMangedProcesses() {
         PROCESSES.removeIf(it -> {
-            ManagedProcess process = it.get();
+            ProcessInfo process = it.get();
             return process == null || !process.isRunning();
         });
         return PROCESSES.size();
     }
 
     public static void stopManagedProcesses() {
         while (!PROCESSES.isEmpty())
-            Optional.ofNullable(PROCESSES.poll()).map(WeakReference::get).ifPresent(ManagedProcess::stop);
+            Optional.ofNullable(PROCESSES.poll()).map(WeakReference::get).ifPresent(ProcessInfo::stop);
     }
 }

HMCL/src/main/java/org/jackhuang/hmcl/monitor/MonitorCrashReporter.java

@@ -0,0 +1,90 @@
+/*
+ * Hello Minecraft! Launcher
+ * Copyright (C) 2026 huangyuhui <huanghongxun2008@126.com> and contributors
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
+package org.jackhuang.hmcl.monitor;
+
+import javafx.application.Platform;
+import org.jackhuang.hmcl.game.GameInstanceID;
+import org.jackhuang.hmcl.game.HMCLGameInstance;
+import org.jackhuang.hmcl.game.HMCLGameRepository;
+import org.jackhuang.hmcl.game.Log;
+import org.jackhuang.hmcl.setting.GameDirectory;
+import org.jackhuang.hmcl.setting.GameDirectoryID;
+import org.jackhuang.hmcl.setting.GameDirectoryManager;
+import org.jackhuang.hmcl.task.Schedulers;
+import org.jackhuang.hmcl.task.Task;
+import org.jackhuang.hmcl.ui.GameCrashWindow;
+import org.jackhuang.hmcl.util.Log4jLevel;
+import org.jackhuang.hmcl.util.logging.Logger;
+import org.jetbrains.annotations.NotNullByDefault;
+import org.jetbrains.annotations.Nullable;
+import org.jetbrains.annotations.Unmodifiable;
+
+import java.util.List;
+import java.util.Optional;
+
+import static org.jackhuang.hmcl.util.logging.Logger.LOG;
+
+/// @see show
+@NotNullByDefault
+public final class MonitorCrashReporter {
+
+    private MonitorCrashReporter() {
+    }
+
+    /// find [HMCLGameInstance] from [Monitor.Result] and show [GameCrashWindow]
+    public static void show(Monitor.Result result) {
+        findInstanceAsync(result).thenAcceptAsync(Schedulers.javafx(), instance -> {
+            if (instance == null) {
+                LOG.warning("Cannot resolve the launched instance " + result.launchOptions().getInstanceId() + ", skip showing the crash window");
+                return;
+            }
+            instance.markLaunchedAbnormally();
+            @Unmodifiable List<String> logs = result.process().getLines(null);
+            Platform.runLater(() -> new GameCrashWindow(
+                    result.process(),
+                    result.exitType(),
+                    instance,
+                    result.launchOptions(),
+                    logs.subList(Math.max(0, logs.size() - Log.getLogLines()), logs.size()).stream()
+                            .map(line -> new Log(Logger.filterForbiddenToken(line), Log4jLevel.guessLevel(line)))
+                            .toList()).show());
+        }).start();
+    }
+
+    /// find [HMCLGameInstance] from [Monitor.Result]
+    private static Task<@Nullable HMCLGameInstance> findInstanceAsync(Monitor.Result result) {
+        // find repository first
+        GameDirectoryID id = GameDirectoryID.parse(result.gameDirectoryId());
+        Optional<GameDirectory> match = GameDirectoryManager.getGameDirectories().stream()
+                .filter(directory -> directory.getId().equals(id))
+                .findFirst();
+        if (match.isEmpty())
+            return Task.completed(null);
+        GameDirectoryManager.setSelectedGameDirectory(match.get());
+        HMCLGameRepository repository = GameDirectoryManager.getSelectedRepository();
+
+        GameInstanceID instanceId = result.launchOptions().getInstanceId();
+        HMCLGameInstance instance = repository.findInstance(instanceId);
+
+        if (instance != null)  // instance found
+            return Task.completed(instance);
+
+        LOG.info("Waiting for the game repository to load before showing the crash window");
+        return repository.refreshAsync().thenSupplyAsync(() -> repository.findInstance(instanceId));
+    }
+}