From 1cdd64e8510328608ba1491073e6c23ad9cf3a3b Mon Sep 17 00:00:00 2001
From: Ciilu <109708109+Ciilu@users.noreply.github.com>
Date: Sun, 2 Nov 2025 19:41:34 +0800
Subject: [PATCH 1/2] update

---
 .../org/jackhuang/hmcl/setting/Config.java    | 15 +++++++
 .../hmcl/ui/construct/TwoLineListItem.java    | 10 ++++-
 .../jackhuang/hmcl/ui/main/SettingsPage.java  |  1 +
 .../jackhuang/hmcl/ui/main/SettingsView.java  |  8 ++++
 .../hmcl/ui/versions/DownloadListPage.java    | 15 ++++++-
 .../hmcl/ui/versions/DownloadPage.java        | 17 ++++++-
 .../versions/ModDescriptionTranslation.java   | 44 +++++++++++++++++++
 .../resources/assets/lang/I18N.properties     |  1 +
 .../resources/assets/lang/I18N_zh.properties  |  1 +
 .../assets/lang/I18N_zh_CN.properties         |  1 +
 10 files changed, 109 insertions(+), 4 deletions(-)
 create mode 100644 HMCL/src/main/java/org/jackhuang/hmcl/ui/versions/ModDescriptionTranslation.java

diff --git a/HMCL/src/main/java/org/jackhuang/hmcl/setting/Config.java b/HMCL/src/main/java/org/jackhuang/hmcl/setting/Config.java
index 46004c63ed..f7f311bcbc 100644
--- a/HMCL/src/main/java/org/jackhuang/hmcl/setting/Config.java
+++ b/HMCL/src/main/java/org/jackhuang/hmcl/setting/Config.java
@@ -250,6 +250,21 @@ public void setPromptedVersion(String promptedVersion) {
         this.promptedVersion.set(promptedVersion);
     }
 
+    @SerializedName("translateModDescription")
+    private final BooleanProperty translateModDescription = new SimpleBooleanProperty(false);
+
+    public BooleanProperty translateModDescriptionProperty() {
+        return translateModDescription;
+    }
+
+    public boolean getmodDescriptionTranslation() {
+        return translateModDescription.get();
+    }
+
+    public void setmodDescriptionTranslation(boolean translateModDescription) {
+        this.translateModDescription.set(translateModDescription);
+    }
+
     @SerializedName("acceptPreviewUpdate")
     private final BooleanProperty acceptPreviewUpdate = new SimpleBooleanProperty(false);
 
diff --git a/HMCL/src/main/java/org/jackhuang/hmcl/ui/construct/TwoLineListItem.java b/HMCL/src/main/java/org/jackhuang/hmcl/ui/construct/TwoLineListItem.java
index 0405202e3f..f39c7846f6 100644
--- a/HMCL/src/main/java/org/jackhuang/hmcl/ui/construct/TwoLineListItem.java
+++ b/HMCL/src/main/java/org/jackhuang/hmcl/ui/construct/TwoLineListItem.java
@@ -43,6 +43,8 @@ private static Label createTagLabel(String tag) {
     private final StringProperty title = new SimpleStringProperty(this, "title");
     private final ObservableList<Label> tags = FXCollections.observableArrayList();
     private final StringProperty subtitle = new SimpleStringProperty(this, "subtitle");
+    private final Label lblSubtitle;
+    private final Label lblTitle;
 
     private final AggregatedObservableList<Node> firstLineChildren;
 
@@ -59,7 +61,7 @@ public TwoLineListItem() {
         HBox firstLine = new HBox();
         firstLine.getStyleClass().add("first-line");
 
-        Label lblTitle = new Label();
+        lblTitle = new Label();
         lblTitle.getStyleClass().add("title");
         lblTitle.textProperty().bind(title);
 
@@ -68,7 +70,7 @@ public TwoLineListItem() {
         firstLineChildren.appendList(tags);
         Bindings.bindContent(firstLine.getChildren(), firstLineChildren.getAggregatedList());
 
-        Label lblSubtitle = new Label();
+        lblSubtitle = new Label();
         lblSubtitle.getStyleClass().add("subtitle");
         lblSubtitle.textProperty().bind(subtitle);
 
@@ -109,6 +111,10 @@ public void setSubtitle(String subtitle) {
         this.subtitle.set(subtitle);
     }
 
+    public void setSubtitleWarp(boolean warp) {
+        lblSubtitle.setWrapText(warp);
+    }
+
     public void addTag(String tag) {
         Label tagLabel = createTagLabel(tag);
         tagLabel.getStyleClass().add("tag");
diff --git a/HMCL/src/main/java/org/jackhuang/hmcl/ui/main/SettingsPage.java b/HMCL/src/main/java/org/jackhuang/hmcl/ui/main/SettingsPage.java
index ddc700a719..30ff8e7713 100644
--- a/HMCL/src/main/java/org/jackhuang/hmcl/ui/main/SettingsPage.java
+++ b/HMCL/src/main/java/org/jackhuang/hmcl/ui/main/SettingsPage.java
@@ -69,6 +69,7 @@ public SettingsPage() {
         selectedItemPropertyFor(cboLanguage).bindBidirectional(config().localizationProperty());
 
         disableAutoGameOptionsPane.selectedProperty().bindBidirectional(config().disableAutoGameOptionsProperty());
+        autoTranslateModDescriptionOptionsPane.selectedProperty().bindBidirectional(config().translateModDescriptionProperty());
         // ====
 
         fileCommonLocation.selectedDataProperty().bindBidirectional(config().commonDirTypeProperty());
diff --git a/HMCL/src/main/java/org/jackhuang/hmcl/ui/main/SettingsView.java b/HMCL/src/main/java/org/jackhuang/hmcl/ui/main/SettingsView.java
index 6b90221640..0f3ee79720 100644
--- a/HMCL/src/main/java/org/jackhuang/hmcl/ui/main/SettingsView.java
+++ b/HMCL/src/main/java/org/jackhuang/hmcl/ui/main/SettingsView.java
@@ -51,6 +51,7 @@
 public abstract class SettingsView extends StackPane {
     protected final JFXComboBox<SupportedLocale> cboLanguage;
     protected final OptionToggleButton disableAutoGameOptionsPane;
+    protected final OptionToggleButton autoTranslateModDescriptionOptionsPane;
     protected final MultiFileItem<EnumCommonDirectory> fileCommonLocation;
     protected final ComponentSublist fileCommonLocationSublist;
     protected final Label lblUpdate;
@@ -212,6 +213,13 @@ else if (locale.isSameLanguage(currentLocale))
                     settingsPane.getContent().add(disableAutoGameOptionsPane);
                 }
 
+                {
+                    autoTranslateModDescriptionOptionsPane = new OptionToggleButton();
+                    autoTranslateModDescriptionOptionsPane.setTitle(i18n("settings.launcher.translate_mod_description"));
+
+                    settingsPane.getContent().add(autoTranslateModDescriptionOptionsPane);
+                }
+
                 {
                     BorderPane debugPane = new BorderPane();
 
diff --git a/HMCL/src/main/java/org/jackhuang/hmcl/ui/versions/DownloadListPage.java b/HMCL/src/main/java/org/jackhuang/hmcl/ui/versions/DownloadListPage.java
index 4a679ed301..0a264eed28 100644
--- a/HMCL/src/main/java/org/jackhuang/hmcl/ui/versions/DownloadListPage.java
+++ b/HMCL/src/main/java/org/jackhuang/hmcl/ui/versions/DownloadListPage.java
@@ -70,6 +70,7 @@
 import static org.jackhuang.hmcl.ui.FXUtils.stringConverter;
 import static org.jackhuang.hmcl.util.i18n.I18n.i18n;
 import static org.jackhuang.hmcl.util.javafx.ExtendedProperties.selectedItemPropertyFor;
+import static org.jackhuang.hmcl.util.logging.Logger.LOG;
 
 public class DownloadListPage extends Control implements DecoratorPage, VersionPage.VersionLoadable {
     protected final ReadOnlyObjectWrapper<State> state = new ReadOnlyObjectWrapper<>();
@@ -544,7 +545,19 @@ protected void updateControl(RemoteMod dataItem, boolean empty) {
                         if (empty) return;
                         ModTranslations.Mod mod = ModTranslations.getTranslationsByRepositoryType(getSkinnable().repository.getType()).getModByCurseForgeId(dataItem.getSlug());
                         content.setTitle(mod != null && I18n.isUseChinese() ? mod.getDisplayName() : dataItem.getTitle());
-                        content.setSubtitle(dataItem.getDescription());
+                        String orignalDescription = dataItem.getDescription();
+                        if (ModDescriptionTranslation.enabled()) {
+                            ModDescriptionTranslation.translate(dataItem).whenComplete(Schedulers.javafx(), (result, exception) -> {
+                                if (exception != null) {
+                                    LOG.warning("Failed to translate mod description", exception);
+                                    content.setSubtitle(orignalDescription);
+                                    return;
+                                }
+                                content.setSubtitle(result.translated);
+                            }).start();
+                        } else {
+                            content.setSubtitle(orignalDescription);
+                        }
                         content.getTags().clear();
                         dataItem.getCategories().stream()
                                 .map(category -> getSkinnable().getLocalizedCategory(category))
diff --git a/HMCL/src/main/java/org/jackhuang/hmcl/ui/versions/DownloadPage.java b/HMCL/src/main/java/org/jackhuang/hmcl/ui/versions/DownloadPage.java
index c62da41ee1..9689f38395 100644
--- a/HMCL/src/main/java/org/jackhuang/hmcl/ui/versions/DownloadPage.java
+++ b/HMCL/src/main/java/org/jackhuang/hmcl/ui/versions/DownloadPage.java
@@ -61,6 +61,7 @@
 
 import static org.jackhuang.hmcl.ui.FXUtils.onEscPressed;
 import static org.jackhuang.hmcl.util.i18n.I18n.i18n;
+import static org.jackhuang.hmcl.util.logging.Logger.LOG;
 
 public class DownloadPage extends Control implements DecoratorPage {
     private final ReadOnlyObjectWrapper<State> state = new ReadOnlyObjectWrapper<>();
@@ -230,7 +231,21 @@ protected ModDownloadPageSkin(DownloadPage control) {
                 HBox.setHgrow(content, Priority.ALWAYS);
                 ModTranslations.Mod mod = getSkinnable().translations.getModByCurseForgeId(getSkinnable().addon.getSlug());
                 content.setTitle(mod != null && I18n.isUseChinese() ? mod.getDisplayName() : getSkinnable().addon.getTitle());
-                content.setSubtitle(getSkinnable().addon.getDescription());
+                String orignalDescription = getSkinnable().addon.getDescription();
+                if (ModDescriptionTranslation.enabled()) {
+                    ModDescriptionTranslation.translate(getSkinnable().addon).whenComplete(Schedulers.javafx(), (result, exception) -> {
+                        if (exception != null) {
+                            LOG.warning("Failed to translate mod description", exception);
+                            content.setSubtitle(orignalDescription);
+                            return;
+                        }
+                        FXUtils.installFastTooltip(descriptionPane, orignalDescription);
+                        content.setSubtitle(result.translated);
+                    }).start();
+                } else {
+                    content.setSubtitle(orignalDescription);
+                }
+                content.setSubtitleWarp(true);
                 getSkinnable().addon.getCategories().stream()
                         .map(category -> getSkinnable().page.getLocalizedCategory(category))
                         .forEach(content::addTag);
diff --git a/HMCL/src/main/java/org/jackhuang/hmcl/ui/versions/ModDescriptionTranslation.java b/HMCL/src/main/java/org/jackhuang/hmcl/ui/versions/ModDescriptionTranslation.java
new file mode 100644
index 0000000000..9da62cdf6b
--- /dev/null
+++ b/HMCL/src/main/java/org/jackhuang/hmcl/ui/versions/ModDescriptionTranslation.java
@@ -0,0 +1,44 @@
+package org.jackhuang.hmcl.ui.versions;
+
+import org.jackhuang.hmcl.mod.RemoteMod;
+import org.jackhuang.hmcl.mod.curse.CurseAddon;
+import org.jackhuang.hmcl.mod.modrinth.ModrinthRemoteModRepository;
+import org.jackhuang.hmcl.task.CacheFileTask;
+import org.jackhuang.hmcl.task.Task;
+import org.jackhuang.hmcl.util.gson.JsonSerializable;
+import org.jackhuang.hmcl.util.gson.JsonUtils;
+import org.jackhuang.hmcl.util.i18n.I18n;
+
+import java.util.Locale;
+
+import static org.jackhuang.hmcl.setting.ConfigHolder.config;
+
+public final class ModDescriptionTranslation {
+    public static final String API_ROOT = "https://mod.mcimirror.top/translate/";
+
+    private ModDescriptionTranslation() {
+    }
+
+    public static Task<Response> translate(RemoteMod mod) {
+        String url;
+        if (mod.getData() instanceof CurseAddon) {
+            url = API_ROOT + "curseforge/" + mod.getSlug();
+        } else if (mod.getData() instanceof ModrinthRemoteModRepository.ProjectSearchResult project) {
+            url = API_ROOT + "modrinth/" + project.getProjectId();
+        } else if (mod.getData() instanceof ModrinthRemoteModRepository.Project project) {
+            url = API_ROOT + "modrinth/" + project.getId();
+        } else {
+            throw new AssertionError();
+        }
+        return new CacheFileTask(url).thenApplyAsync(path -> JsonUtils.fromJsonFile(path, Response.class));
+    }
+
+    public static boolean enabled() {
+        return config().getmodDescriptionTranslation() && I18n.isUseChinese();
+    }
+
+    @JsonSerializable
+    public static class Response {
+        String translated;
+    }
+}
\ No newline at end of file
diff --git a/HMCL/src/main/resources/assets/lang/I18N.properties b/HMCL/src/main/resources/assets/lang/I18N.properties
index 31d4f83e96..20012b2283 100644
--- a/HMCL/src/main/resources/assets/lang/I18N.properties
+++ b/HMCL/src/main/resources/assets/lang/I18N.properties
@@ -1355,6 +1355,7 @@ settings.launcher.appearance=Appearance
 settings.launcher.common_path.tooltip=HMCL will put all game assets and dependencies here. If there are existing libraries in the game directory, then HMCL will prefer to use them first.
 settings.launcher.debug=Debug
 settings.launcher.disable_auto_game_options=Do not switch game language
+settings.launcher.translate_mod_description=(Chinese only) Auto translate mod descriptions
 settings.launcher.download=Download
 settings.launcher.download.threads=Threads
 settings.launcher.download.threads.auto=Automatically Determine
diff --git a/HMCL/src/main/resources/assets/lang/I18N_zh.properties b/HMCL/src/main/resources/assets/lang/I18N_zh.properties
index de461166dd..50b9151852 100644
--- a/HMCL/src/main/resources/assets/lang/I18N_zh.properties
+++ b/HMCL/src/main/resources/assets/lang/I18N_zh.properties
@@ -1143,6 +1143,7 @@ settings.launcher.appearance=外觀
 settings.launcher.common_path.tooltip=啟動器將所有遊戲資源及相依元件庫檔案放於此集中管理。如果遊戲目錄內有現成的將不會使用公共庫檔案。
 settings.launcher.debug=除錯
 settings.launcher.disable_auto_game_options=不自動切換遊戲語言
+settings.launcher.translate_mod_description=自動翻譯模組簡介
 settings.launcher.download=下載
 settings.launcher.download.threads=執行緒數
 settings.launcher.download.threads.auto=自動選取執行緒數
diff --git a/HMCL/src/main/resources/assets/lang/I18N_zh_CN.properties b/HMCL/src/main/resources/assets/lang/I18N_zh_CN.properties
index a578361f56..c4f56a6f8d 100644
--- a/HMCL/src/main/resources/assets/lang/I18N_zh_CN.properties
+++ b/HMCL/src/main/resources/assets/lang/I18N_zh_CN.properties
@@ -1153,6 +1153,7 @@ settings.launcher.appearance=外观
 settings.launcher.common_path.tooltip=启动器将所有游戏资源及依赖库文件存放于此集中管理。如果游戏文件夹内有现成的将不会使用公共库文件。
 settings.launcher.debug=调试
 settings.launcher.disable_auto_game_options=不自动切换游戏语言
+settings.launcher.translate_mod_description=自动翻译模组简介
 settings.launcher.download=下载
 settings.launcher.download.threads=线程数
 settings.launcher.download.threads.auto=自动选择线程数

From da26ae62b80a4f1866fd7a2828e493b74b94a3f6 Mon Sep 17 00:00:00 2001
From: Ciilu <109708109+Ciilu@users.noreply.github.com>
Date: Sun, 2 Nov 2025 20:05:02 +0800
Subject: [PATCH 2/2] fix: Checkstyle

---
 .../jackhuang/hmcl/ui/versions/ModDescriptionTranslation.java | 4 +---
 1 file changed, 1 insertion(+), 3 deletions(-)

diff --git a/HMCL/src/main/java/org/jackhuang/hmcl/ui/versions/ModDescriptionTranslation.java b/HMCL/src/main/java/org/jackhuang/hmcl/ui/versions/ModDescriptionTranslation.java
index 9da62cdf6b..2bb3a3bf88 100644
--- a/HMCL/src/main/java/org/jackhuang/hmcl/ui/versions/ModDescriptionTranslation.java
+++ b/HMCL/src/main/java/org/jackhuang/hmcl/ui/versions/ModDescriptionTranslation.java
@@ -9,8 +9,6 @@
 import org.jackhuang.hmcl.util.gson.JsonUtils;
 import org.jackhuang.hmcl.util.i18n.I18n;
 
-import java.util.Locale;
-
 import static org.jackhuang.hmcl.setting.ConfigHolder.config;
 
 public final class ModDescriptionTranslation {
@@ -41,4 +39,4 @@ public static boolean enabled() {
     public static class Response {
         String translated;
     }
-}
\ No newline at end of file
+}