播放过渡动画时缓存节点至位图 (#4815)

HMCL/src/main/java/org/jackhuang/hmcl/ui/animation/TransitionPane.java

@@ -20,6 +20,7 @@ package org.jackhuang.hmcl.ui.animation;
 import javafx.animation.Animation;
 import javafx.animation.Interpolator;
 import javafx.application.Platform;
+import javafx.scene.CacheHint;
 import javafx.scene.Node;
 import javafx.scene.layout.Pane;
 import javafx.scene.layout.StackPane;
@@ -74,6 +75,15 @@ public class TransitionPane extends StackPane {
         setMouseTransparent(true);
         transition.init(this, previousNode, newView);
 
+        CacheHint cacheHint = newView instanceof Cacheable cacheable
+                ? cacheable.getCacheHint(transition)
+                : null;
+
+        if (cacheHint != null) {
+            newView.setCache(true);
+            newView.setCacheHint(cacheHint);
+        }
+
         // runLater or "init" will not work
         Platform.runLater(() -> {
             Animation newAnimation = transition.animate(
@@ -84,6 +94,10 @@ public class TransitionPane extends StackPane {
             newAnimation.setOnFinished(e -> {
                 setMouseTransparent(false);
                 getChildren().remove(previousNode);
+
+                if (cacheHint != null) {
+                    newView.setCache(false);
+                }
             });
             FXUtils.playAnimation(this, "transition_pane", newAnimation);
         });
@@ -103,4 +117,14 @@ public class TransitionPane extends StackPane {
             return null;
         }
     }
+
+    /// Marks a node as cacheable as a bitmap during animation.
+    public interface Cacheable {
+        /// @return the [cache hint][CacheHint] to use when caching this node during the given animation,
+        ///         or `null` to not cache it.
+        default @Nullable CacheHint getCacheHint(AnimationProducer animationProducer) {
+            // https://github.com/HMCL-dev/HMCL/issues/4789
+            return animationProducer == ContainerAnimations.SLIDE_UP_FADE_IN ? CacheHint.SPEED : null;
+        }
+    }
 }

HMCL/src/main/java/org/jackhuang/hmcl/ui/terracotta/TerracottaControllerPage.java

@@ -83,7 +83,6 @@ import java.util.Locale;
 import java.util.concurrent.ThreadLocalRandom;
 
 import static org.jackhuang.hmcl.setting.ConfigHolder.config;
-import static org.jackhuang.hmcl.setting.ConfigHolder.globalConfig;
 import static org.jackhuang.hmcl.util.i18n.I18n.i18n;
 
 public class TerracottaControllerPage extends StackPane {
@@ -182,31 +181,20 @@ public class TerracottaControllerPage extends StackPane {
                 download.setSubtitle(i18n("terracotta.status.uninitialized.desc"));
                 download.setRightIcon(SVG.ARROW_FORWARD);
                 FXUtils.onClicked(download, () -> {
-                    if (globalConfig().getTerracottaAgreementVersion() >= 1) {
-                        TerracottaState.Preparing s = TerracottaManager.install(null);
-                        if (s != null) {
-                            UI_STATE.set(s);
-                        }
+                    TerracottaState.Preparing s = TerracottaManager.install(null);
+                    if (s != null) {
+                        UI_STATE.set(s);
+                    }
 
-                        if (uninitialized.hasLegacy() && I18n.isUseChinese()) {
-                            Object feedback = config().getShownTips().get(FEEDBACK_TIP);
-                            if (!(feedback instanceof Number number) || number.intValue() < 1) {
-                                Controllers.confirm(i18n("terracotta.feedback.desc"), i18n("terracotta.feedback.title"), () -> {
-                                    FXUtils.openLink(TerracottaMetadata.FEEDBACK_LINK);
-                                    config().getShownTips().put(FEEDBACK_TIP, 1);
-                                }, () -> {
-                                });
-                            }
+                    if (uninitialized.hasLegacy() && I18n.isUseChinese()) {
+                        Object feedback = config().getShownTips().get(FEEDBACK_TIP);
+                        if (!(feedback instanceof Number number) || number.intValue() < 1) {
+                            Controllers.confirm(i18n("terracotta.feedback.desc"), i18n("terracotta.feedback.title"), () -> {
+                                FXUtils.openLink(TerracottaMetadata.FEEDBACK_LINK);
+                                config().getShownTips().put(FEEDBACK_TIP, 1);
+                            }, () -> {
+                            });
                         }
-                    } else {
-                        Controllers.confirmWithCountdown(i18n("terracotta.confirm.desc"), i18n("terracotta.confirm.title"), 5, MessageDialogPane.MessageType.INFO, () -> {
-                            globalConfig().setTerracottaAgreementVersion(1);
-                            TerracottaState.Preparing s = TerracottaManager.install(null);
-                            if (s != null) {
-                                UI_STATE.set(s);
-                            }
-                        }, () -> {
-                        });
                     }
                 });
 

HMCL/src/main/java/org/jackhuang/hmcl/ui/terracotta/TerracottaPage.java

@@ -32,9 +32,7 @@ import org.jackhuang.hmcl.ui.Controllers;
 import org.jackhuang.hmcl.ui.FXUtils;
 import org.jackhuang.hmcl.ui.SVG;
 import org.jackhuang.hmcl.ui.animation.TransitionPane;
-import org.jackhuang.hmcl.ui.construct.AdvancedListBox;
-import org.jackhuang.hmcl.ui.construct.PageAware;
-import org.jackhuang.hmcl.ui.construct.TabHeader;
+import org.jackhuang.hmcl.ui.construct.*;
 import org.jackhuang.hmcl.ui.decorator.DecoratorAnimatedPage;
 import org.jackhuang.hmcl.ui.decorator.DecoratorPage;
 import org.jackhuang.hmcl.ui.main.MainPage;
@@ -42,9 +40,12 @@ import org.jackhuang.hmcl.ui.versions.Versions;
 import org.jackhuang.hmcl.util.Lang;
 import org.jackhuang.hmcl.util.StringUtils;
 
+import static org.jackhuang.hmcl.setting.ConfigHolder.globalConfig;
 import static org.jackhuang.hmcl.util.i18n.I18n.i18n;
 
 public class TerracottaPage extends DecoratorAnimatedPage implements DecoratorPage, PageAware {
+    private static final int TERRACOTTA_AGREEMENT_VERSION = 2;
+
     private final ReadOnlyObjectWrapper<State> state = new ReadOnlyObjectWrapper<>(State.fromTitle(i18n("terracotta.terracotta")));
     private final TabHeader tab;
     private final TabHeader.Tab<TerracottaControllerPage> statusPage = new TabHeader.Tab<>("statusPage");
@@ -94,6 +95,12 @@ public class TerracottaPage extends DecoratorAnimatedPage implements DecoratorPa
     @Override
     public void onPageShown() {
         tab.onPageShown();
+
+        if (globalConfig().getTerracottaAgreementVersion() < TERRACOTTA_AGREEMENT_VERSION) {
+            Controllers.confirmWithCountdown(i18n("terracotta.confirm.desc"), i18n("terracotta.confirm.title"), 5, MessageDialogPane.MessageType.INFO, () -> {
+                globalConfig().setTerracottaAgreementVersion(TERRACOTTA_AGREEMENT_VERSION);
+            }, () -> fireEvent(new PageCloseEvent()));
+        }
     }
 
     @Override

HMCL/src/main/java/org/jackhuang/hmcl/ui/versions/InstallerListPage.java

@@ -29,6 +29,7 @@ import org.jackhuang.hmcl.task.Task;
 import org.jackhuang.hmcl.task.TaskExecutor;
 import org.jackhuang.hmcl.task.TaskListener;
 import org.jackhuang.hmcl.ui.*;
+import org.jackhuang.hmcl.ui.animation.TransitionPane;
 import org.jackhuang.hmcl.ui.download.UpdateInstallerWizardProvider;
 import org.jackhuang.hmcl.util.TaskCancellationAction;
 import org.jackhuang.hmcl.util.io.FileUtils;
@@ -42,7 +43,7 @@ import java.util.concurrent.CompletableFuture;
 import static org.jackhuang.hmcl.ui.FXUtils.runInFX;
 import static org.jackhuang.hmcl.util.i18n.I18n.i18n;
 
-public class InstallerListPage extends ListPageBase<InstallerItem> implements VersionPage.VersionLoadable {
+public class InstallerListPage extends ListPageBase<InstallerItem> implements VersionPage.VersionLoadable, TransitionPane.Cacheable {
     private Profile profile;
     private String versionId;
     private Version version;

HMCL/src/main/java/org/jackhuang/hmcl/ui/versions/ModListPage.java

@@ -34,6 +34,7 @@ import org.jackhuang.hmcl.task.Task;
 import org.jackhuang.hmcl.ui.Controllers;
 import org.jackhuang.hmcl.ui.FXUtils;
 import org.jackhuang.hmcl.ui.ListPageBase;
+import org.jackhuang.hmcl.ui.animation.TransitionPane;
 import org.jackhuang.hmcl.ui.construct.MessageDialogPane;
 import org.jackhuang.hmcl.ui.construct.PageAware;
 import org.jackhuang.hmcl.util.TaskCancellationAction;
@@ -49,7 +50,7 @@ import java.util.concurrent.locks.ReentrantLock;
 import static org.jackhuang.hmcl.util.logging.Logger.LOG;
 import static org.jackhuang.hmcl.util.i18n.I18n.i18n;
 
-public final class ModListPage extends ListPageBase<ModListPageSkin.ModInfoObject> implements VersionPage.VersionLoadable, PageAware {
+public final class ModListPage extends ListPageBase<ModListPageSkin.ModInfoObject> implements VersionPage.VersionLoadable, PageAware, TransitionPane.Cacheable {
     private final BooleanProperty modded = new SimpleBooleanProperty(this, "modded", false);
 
     private final ReentrantLock lock = new ReentrantLock();

HMCL/src/main/java/org/jackhuang/hmcl/ui/versions/SchematicsPage.java

@@ -37,6 +37,7 @@ import org.jackhuang.hmcl.setting.Theme;
 import org.jackhuang.hmcl.task.Schedulers;
 import org.jackhuang.hmcl.task.Task;
 import org.jackhuang.hmcl.ui.*;
+import org.jackhuang.hmcl.ui.animation.TransitionPane;
 import org.jackhuang.hmcl.ui.construct.*;
 import org.jackhuang.hmcl.util.Lang;
 import org.jackhuang.hmcl.util.StringUtils;
@@ -60,7 +61,7 @@ import static org.jackhuang.hmcl.util.logging.Logger.LOG;
 /**
  * @author Glavo
  */
-public final class SchematicsPage extends ListPageBase<SchematicsPage.Item> implements VersionPage.VersionLoadable {
+public final class SchematicsPage extends ListPageBase<SchematicsPage.Item> implements VersionPage.VersionLoadable, TransitionPane.Cacheable {
 
     private static String translateAuthorName(String author) {
         if (I18n.isUseChinese() && "hsds".equals(author)) {

HMCL/src/main/java/org/jackhuang/hmcl/ui/versions/WorldListPage.java

@@ -27,6 +27,7 @@ import org.jackhuang.hmcl.setting.Profile;
 import org.jackhuang.hmcl.task.Schedulers;
 import org.jackhuang.hmcl.task.Task;
 import org.jackhuang.hmcl.ui.*;
+import org.jackhuang.hmcl.ui.animation.TransitionPane;
 import org.jackhuang.hmcl.util.io.FileUtils;
 
 import java.io.IOException;
@@ -41,7 +42,7 @@ import java.util.stream.Stream;
 import static org.jackhuang.hmcl.util.i18n.I18n.i18n;
 import static org.jackhuang.hmcl.util.logging.Logger.LOG;
 
-public final class WorldListPage extends ListPageBase<WorldListItem> implements VersionPage.VersionLoadable {
+public final class WorldListPage extends ListPageBase<WorldListItem> implements VersionPage.VersionLoadable, TransitionPane.Cacheable {
     private final BooleanProperty showAll = new SimpleBooleanProperty(this, "showAll", false);
 
     private Path savesDir;

HMCL/src/main/resources/assets/lang/I18N.properties

@@ -1441,8 +1441,8 @@ terracotta.status.uninitialized.update.title=Update Multiplayer Core (~ 8MiB)
 terracotta.status.uninitialized.desc=You legally promise to strictly abide by all laws and regulations of your country or region during the multiplayer process.
 terracotta.confirm.title=User Notice
 terracotta.confirm.desc=Terracotta is a third-party open source free software. Please provide feedback on any issues you encounter through the relevant channels during use.\n\
-  Terracotta is based on P2P, so that the final experience depends greatly on your network condition.\n\
-  You promise to strictly abide by all laws and regulations in your country or region when playing online.
+  Terracotta uses P2P technology. After a successful connection, users in the room will connect directly to each other, and no third-party server will relay your traffic. The final multiplayer experience largely depends on the network conditions of the participants.\n\
+  During the entire multiplayer process, you must strictly comply with all laws and regulations of your country and region.
 terracotta.status.preparing=Multiplayer Core: Downloading (DO NOT exit HMCL)
 terracotta.status.launching=Multiplayer Core: Initializing
 terracotta.status.unknown=Multiplayer Core: Initializing

HMCL/src/main/resources/assets/lang/I18N_zh.properties

@@ -1229,8 +1229,8 @@ terracotta.status.uninitialized.update.title=更新聯機核心 (約 8MiB)
 terracotta.status.uninitialized.desc=您承諾，在多人聯機全過程中，您將嚴格遵守您所在國家或地區的全部法律法規
 terracotta.confirm.title=使用者須知
 terracotta.confirm.desc=陶瓦聯機是第三方開源自由軟體，您在使用過程中所遇到的問題請通過相關管道進行回饋。\n\
-  多人連線基於 p2p，最終線上體驗和您的網路情況有較大關係。\n\
-  您承諾，在多人連線全過程中，您將嚴格遵守您所在國家或地區的全部法律法規。
+  陶瓦聯機使用 P2P 技術，聯機成功後房間內用戶之間將直接連接，不會使用第三方伺服器對您的流量進行轉發。最終聯機體驗和參與聯機者的網路情況有較大關係。\n\
+  在多人聯機全過程中，您必須嚴格遵守您所在國家與地區的全部法律法規。
 terracotta.status.preparing=正在下載聯機核心 (請勿退出啟動器)
 terracotta.status.launching=正在初始化聯機核心
 terracotta.status.unknown=正在初始化聯機核心

HMCL/src/main/resources/assets/lang/I18N_zh_CN.properties

@@ -1239,8 +1239,8 @@ terracotta.status.uninitialized.update.title=更新联机核心 (约 8MiB)
 terracotta.status.uninitialized.desc=您承诺，在多人联机全过程中，您将严格遵守您所在国家或地区的全部法律法规
 terracotta.confirm.title=用户须知
 terracotta.confirm.desc=陶瓦联机是第三方开源自由软件，您在使用过程中所遇到的问题请通过相关渠道进行反馈。\n\
-  多人联机基于 p2p，最终联机体验和您的网络情况有较大关系。\n\
-  在多人联机全过程中，您将严格遵守您所在国家或地区的全部法律法规。
+  陶瓦联机使用 P2P 技术，联机成功后房间内用户之间将直接连接，不会使用第三方服务器对您的流量进行转发。最终联机体验和参与联机者的网络情况有较大关系。\n\
+  在多人联机全过程中，您必须严格遵守您所在国家与地区的全部法律法规。
 terracotta.status.preparing=正在下载联机核心 (请勿退出启动器)
 terracotta.status.launching=正在初始化联机核心
 terracotta.status.unknown=正在初始化联机核心

HMCLBoot/src/main/java/org/jackhuang/hmcl/DesktopUtils.java

@@ -0,0 +1,99 @@
+/*
+ * Hello Minecraft! Launcher
+ * Copyright (C) 2025 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;
+
+import java.io.File;
+import java.net.URI;
+import java.nio.file.Files;
+import java.nio.file.Path;
+import java.nio.file.Paths;
+import java.util.Locale;
+
+/// @author Glavo
+public final class DesktopUtils {
+    private static final String[] linuxBrowsers = {
+            "xdg-open",
+            "google-chrome",
+            "firefox",
+            "microsoft-edge",
+            "opera",
+            "konqueror",
+            "mozilla"
+    };
+
+    public static Path which(String command) {
+        String path = System.getenv("PATH");
+        if (path == null)
+            return null;
+
+        try {
+            for (String item : path.split(File.pathSeparator)) {
+                try {
+                    Path program = Paths.get(item, command);
+                    if (Files.isExecutable(program))
+                        return program.toRealPath();
+                } catch (Throwable ignored) {
+                }
+            }
+        } catch (Throwable ignored) {
+        }
+
+        return null;
+    }
+
+    public static void openLink(String link) {
+        String osName = System.getProperty("os.name").toLowerCase(Locale.ROOT);
+
+        Throwable e1 = null;
+        try {
+            if (osName.startsWith("windows")) {
+                Runtime.getRuntime().exec(new String[]{"rundll32.exe", "url.dll,FileProtocolHandler", link});
+                return;
+            } else if (osName.startsWith("mac") || osName.startsWith("darwin")) {
+                Runtime.getRuntime().exec(new String[]{"open", link});
+                return;
+            } else {
+                for (String browser : linuxBrowsers) {
+                    Path path = which(browser);
+                    if (path != null) {
+                        try {
+                            Runtime.getRuntime().exec(new String[]{path.toString(), link});
+                            return;
+                        } catch (Throwable ignored) {
+                        }
+                    }
+                }
+                System.err.println("No known browser found");
+            }
+        } catch (Throwable e) {
+            e1 = e;
+        }
+
+        try {
+            java.awt.Desktop.getDesktop().browse(new URI(link));
+        } catch (Throwable e2) {
+            if (e1 != null)
+                e2.addSuppressed(e1);
+
+            e2.printStackTrace(System.err);
+        }
+    }
+
+    private DesktopUtils() {
+    }
+}

HMCLBoot/src/main/java/org/jackhuang/hmcl/Main.java

@@ -19,11 +19,15 @@ package org.jackhuang.hmcl;
 
 import org.jackhuang.hmcl.util.SwingUtils;
 
+import javax.swing.*;
+import java.util.ResourceBundle;
+
 /**
  * @author Glavo
  */
 public final class Main {
     private static final int MINIMUM_JAVA_VERSION = 17;
+    private static final String DOWNLOAD_PAGE = "https://hmcl.huangyuhui.net/download/";
 
     private Main() {
     }
@@ -73,14 +77,36 @@ public final class Main {
         }
     }
 
+    static void showErrorAndExit(String[] args) {
+        SwingUtils.initLookAndFeel();
+
+        ResourceBundle resourceBundle = BootProperties.getResourceBundle();
+        String errorTitle = resourceBundle.getString("boot.message.error");
+
+        if (args.length > 0 && args[0].equals("--apply-to")) {
+            String errorMessage = resourceBundle.getString("boot.manual_update");
+            System.err.println(errorMessage);
+            int result = JOptionPane.showOptionDialog(null, errorMessage, errorTitle, JOptionPane.YES_NO_OPTION,
+                    JOptionPane.ERROR_MESSAGE, null, null, null);
+
+            if (result == JOptionPane.YES_OPTION) {
+                System.out.println("Open " + DOWNLOAD_PAGE);
+                DesktopUtils.openLink(DOWNLOAD_PAGE);
+            }
+        } else {
+            String errorMessage = resourceBundle.getString("boot.unsupported_java_version");
+            System.err.println(errorMessage);
+            SwingUtils.showErrorDialog(errorMessage, errorTitle);
+        }
+
+        System.exit(1);
+    }
+
     public static void main(String[] args) throws Throwable {
         if (getJavaFeatureVersion(System.getProperty("java.version")) >= MINIMUM_JAVA_VERSION) {
             EntryPoint.main(args);
         } else {
-            String errorMessage = BootProperties.getResourceBundle().getString("boot.unsupported_java_version");
-            System.err.println(errorMessage);
-            SwingUtils.showErrorDialog(errorMessage);
-            System.exit(1);
+            showErrorAndExit(args);
         }
     }
 }

HMCLBoot/src/main/java/org/jackhuang/hmcl/util/SwingUtils.java

@@ -40,14 +40,26 @@ public final class SwingUtils {
     }
 
     public static void showInfoDialog(Object message) {
-        JOptionPane.showMessageDialog(null, message, "Info", JOptionPane.INFORMATION_MESSAGE);
+        showInfoDialog(message, "Info");
+    }
+
+    public static void showInfoDialog(Object message, String title) {
+        JOptionPane.showMessageDialog(null, message, title, JOptionPane.INFORMATION_MESSAGE);
     }
 
     public static void showWarningDialog(Object message) {
-        JOptionPane.showMessageDialog(null, message, "Warning", JOptionPane.WARNING_MESSAGE);
+        showWarningDialog(message, "Warning");
+    }
+
+    public static void showWarningDialog(Object message, String title) {
+        JOptionPane.showMessageDialog(null, message, title, JOptionPane.WARNING_MESSAGE);
     }
 
     public static void showErrorDialog(Object message) {
-        JOptionPane.showMessageDialog(null, message, "Error", JOptionPane.ERROR_MESSAGE);
+        showErrorDialog(message, "Error");
+    }
+
+    public static void showErrorDialog(Object message, String title) {
+        JOptionPane.showMessageDialog(null, message, title, JOptionPane.ERROR_MESSAGE);
     }
 }

HMCLBoot/src/main/resources/assets/lang/boot.properties

@@ -17,3 +17,6 @@
 #
 
 boot.unsupported_java_version=HMCL requires Java 17 or later to run, but still supports launching games with Java 6~16. Please install the latest version of Java and try opening HMCL again.\nYou can keep your old version of Java. HMCL can detect and manage multiple Java installations, and will automatically select the appropriate Java version for your game.
+boot.manual_update=HMCL cannot complete automatic updates in the current environment. Please download the latest version of HMCL manually.\nWould you like to go to the download page?
+
+boot.message.error=Error

HMCLBoot/src/main/resources/assets/lang/boot_zh.properties

@@ -17,3 +17,6 @@
 #
 
 boot.unsupported_java_version=HMCL 需要 Java 17 或更高版本才能运行，但依然支持使用 Java 6~16 启动游戏。请安装最新版本的 Java 再尝试启动 HMCL。\n你可以继续保留旧版本 Java。HMCL 能够识别与管理多个 Java，并会自动根据游戏版本为你选择合适的 Java。\n你可以访问 https://docs.hmcl.net/help.html 页面寻求帮助。
+boot.manual_update=HMCL 在当前环境无法完成自动更新，请手动下载最新版本的 HMCL。\n是否前往下载页面？
+
+boot.message.error=错误

HMCLBoot/src/main/resources/assets/lang/boot_zh_Hant.properties

@@ -17,3 +17,6 @@
 #
 
 boot.unsupported_java_version=HMCL 需要 Java 17 或更高版本才能執行，但依然支援使用 Java 6~16 啟動遊戲。請安裝最新版本的 Java 再嘗試開啟 HMCL。\n你可以繼續保留舊版本 Java。HMCL 能夠識別與管理多個 Java，並會自動根據遊戲版本為你選取合適的 Java。
+boot.manual_update=HMCL 在當前環境無法完成自動更新，請手動下載最新版本的 HMCL。\n是否前往下載頁面？
+
+boot.message.error=錯誤