Compare commits

..
Author SHA1 Message Date
Glavo 97cf9dcf16 Refactor native library checks for improved clarity and efficiency (#6857) 2026-09-12 20:39:34 +08:00
Glavo 7bacc2bb5a Fix #6842: Include tags in TwoLineListItem preferred width (#6844) 2026-09-12 20:20:02 +08:00
Wulian233 c7637079d7 Fix #6851: 修复右键部分选项弹出的弹窗会无限叠加 (#6854)
Close #6851
2026-09-12 20:16:18 +08:00
Glavo 8f3282e9a2 Add version entries for 26.3 snapshots and release candidates (#6849) 2026-09-12 20:13:27 +08:00
Glavo 8e491862b9 对于简体中文资源使用 zh-Hans 语言标签 (#6853) 2026-09-12 14:12:24 +08:00
Glavo e0c276075c 重命名 I18N_zh.properties 和 I18N_zh_CN.properties (#6852) 2026-09-12 13:35:16 +08:00
Glavo 19ea64e14b 同步更新所有语言文件 (#6850) 2026-09-12 10:58:09 +08:00
ToobLac 5b26b8f4eb enhance(macos): 日志、游戏崩溃、HMCL崩溃窗口按下 CMD+W 时退出 (#6813) 2026-09-11 21:37:25 +08:00
NWMA-FYWFandGlavo ed7ef92ad9 feat: 添加实例列表右键编辑功能 (#6000) (#6038)
Co-authored-by: Glavo <[email protected]>
2026-09-11 20:59:44 +08:00
ToobLac cd95891108 [Enhancement] 启动器检查更新失败时显示提示 (#6286) 2026-09-11 20:24:13 +08:00
Burning_TNT df52bc6e81 不再支持导出 MultiMC 整合包 (#4017) 2026-09-10 21:31:27 +08:00
lcxn123 9d9fc78384 fix #6202: Validate Yggdrasil access tokens on every login (#6209) 2026-09-10 21:28:21 +08:00
bluebulletandGlavo e287f672fd Feat/curse retry and cache (#6595)
Co-authored-by: Glavo <[email protected]>
2026-09-10 21:02:07 +08:00
Glavo 24702dc5a0 Fix #6833: Automatically synchronize client JARs when updating game instances (#6843) 2026-09-10 10:14:11 +08:00
ToobLac 886a25a935 [Enhancement] 延后加载并缓存资源包图标 (#6730) 2026-09-09 21:00:08 +08:00
ToobLac 450504ceda [Bugfix] 修复 #6526: macOS 下 主题模式-跟随系统设置 失效 (#6555)
Fixes #6526
2026-09-09 20:58:39 +08:00
ToobLac 8767cc0e98 [Bugfix] 修复 CurseForge 搜索部分内容正确结果很靠下的问题 & 移除没有实际意义的搜索排序方式 (#6619) 2026-09-09 20:06:12 +08:00
ToobLacandGlavo 7331f619cf [Bugfix] 修复未受支持的模组加载器标签在模组版本界面不显示 (#6289)
Fixes #6280

Co-authored-by: Glavo <[email protected]>
2026-09-08 21:57:53 +08:00
ZZZank 7a8f931641 Fix display of mod with extra long display name (#6436) 2026-09-08 21:57:32 +08:00
辞庐 ce51dc4dd7 在修改游戏版本时清除已选的模组加载器 (#6475) 2026-09-08 21:57:16 +08:00
Glavo b97e7fbd55 Move modpack file controls into reusable tree cells (#6840) 2026-09-08 20:46:21 +08:00
辞庐andGlavo 7f578be08e 优化实例图标设置操作按钮 (#6816)
Co-authored-by: Glavo <[email protected]>
2026-09-08 20:33:08 +08:00
Glavo 513f53bc06 修复无法启动安装了 Forge 的 Minecraft 1.6.4 实例的问题 (#6839) 2026-09-08 20:18:25 +08:00
Glavo b2d4d36856 Implement task cleanup and abort functionality in DefaultGameBuilder (#6836)
Fix #6773
2026-09-08 16:39:06 +08:00
Glavo 9c031c5ac1 优化 ArchiveFileTree 构建性能 (#6838) 2026-09-08 16:37:31 +08:00
Glavo e2d3ac847d 打开 zip 文件时忽略 local file header (#6834) 2026-09-08 12:02:17 +08:00
Glavo 0f4152406c Bump kala-compress to 1.27.1-5 (#6837) 2026-09-08 12:02:00 +08:00
Glavo 1a258a2554 Fix #6828: 隐藏父实例缺失的实例 (#6832) 2026-09-07 21:15:16 +08:00
Glavo 3742be0aa8 Add *.jfr to .gitignore (#6835) 2026-09-07 15:54:23 +08:00
辞庐 0e34554344 转化 OptiFineVersion 为 Record (#6821) 2026-09-06 20:20:12 +08:00
Wulian233 1acfc55004 转化 CurseMetaMod 为 Record (#6822) 2026-09-06 20:18:54 +08:00
辞庐 1428183e36 简写部分 Hello Minecraft! Launcher 为 HMCL (#6826) 2026-09-06 20:16:34 +08:00
Wulian233 cbc6daf3d5 Fix #6819: 实例管理工具栏文字变小 (#6823)
Close #6819
2026-09-06 20:16:21 +08:00
辞庐 0ad180c082 fix: 无法启动新版本 Cleanroom (#6824) 2026-09-06 20:14:39 +08:00
Xirren 1da8c8d6ac 修复导出mrpack时,已禁用模组有关bug (#6830) 2026-09-06 20:14:06 +08:00
辞庐 ea232b0976 清理 DialogPane 冗余 progressBar (#6827) 2026-09-06 20:10:45 +08:00
120 changed files with 5162 additions and 1536 deletions

No files matched your search

+2
View File
@@ -4,6 +4,8 @@
hs_err_pid*
*.hprof
*.jfr
.gradle
gradle.properties
+12 -2
View File
@@ -4,6 +4,7 @@ import org.jackhuang.hmcl.gradle.ci.JenkinsUtils
import org.jackhuang.hmcl.gradle.l10n.CheckTranslations
import org.jackhuang.hmcl.gradle.l10n.CreateLanguageList
import org.jackhuang.hmcl.gradle.l10n.CreateLocaleNamesResourceBundle
import org.jackhuang.hmcl.gradle.l10n.SyncTranslations
import org.jackhuang.hmcl.gradle.l10n.UpsideDownTranslate
import org.jackhuang.hmcl.gradle.mod.ParseModDataTask
import org.jackhuang.hmcl.gradle.pack.CreateDeb
@@ -430,13 +431,22 @@ tasks.register<CheckTranslations>("checkTranslations") {
val dir = layout.projectDirectory.dir("src/main/resources/assets/lang")
englishFile.set(dir.file("I18N.properties"))
simplifiedChineseFile.set(dir.file("I18N_zh_CN.properties"))
traditionalChineseFile.set(dir.file("I18N_zh.properties"))
simplifiedChineseFile.set(dir.file("I18N_zh_Hans.properties"))
traditionalChineseFile.set(dir.file("I18N_zh_Hant.properties"))
classicalChineseFile.set(dir.file("I18N_lzh.properties"))
}
// l10n
tasks.register<SyncTranslations>("syncTranslations") {
group = "localization"
description = "Synchronizes translation keys and blank lines with I18N.properties."
val dir = layout.projectDirectory.dir("src/main/resources/assets/lang")
sourceFile.set(dir.file("I18N.properties"))
translationFiles.from(fileTree(dir) { include("I18N_*.properties") })
}
val generatedDir = layout.buildDirectory.dir("generated")
val upsideDownTranslate = tasks.register<UpsideDownTranslate>("upsideDownTranslate") {
@@ -0,0 +1,101 @@
/*
* Hello Minecraft! Launcher
* Copyright (C) 2026 huangyuhui <[email protected]> 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 com.jfoenix.controls;
import com.jfoenix.skins.JFXCheckBoxSkin;
import javafx.geometry.Pos;
import javafx.scene.Node;
import javafx.scene.control.CheckBoxTreeItem;
import javafx.scene.layout.HBox;
import org.jetbrains.annotations.NotNullByDefault;
import org.jetbrains.annotations.Nullable;
/// Displays a [CheckBoxTreeItem] with a material-design checkbox.
///
/// The checkbox's selected and indeterminate states are bidirectionally bound to
/// the current tree item. Reusing or clearing the cell removes the old bindings.
/// Installing a checkbox skin or switching tree items applies the selection state
/// immediately, without playing a selection animation.
/// Ordinary tree items retain the display provided by [JFXTreeCell].
/// Empty cells and `null` values display neither content nor a checkbox.
///
/// @param <T> the type of value stored in each tree item
@NotNullByDefault
public class JFXCheckTreeCell<T> extends JFXTreeCell<T> {
/// The checkbox bound to the currently displayed checkable tree item.
private final JFXCheckBox checkBox = new JFXCheckBox();
/// Places the checkbox before the graphic supplied by the superclass.
private final HBox graphic = new HBox();
/// The tree item whose selection properties are currently bound, if any.
private @Nullable CheckBoxTreeItem<?> boundTreeItem;
/// Creates an empty cell whose checkbox toggles the current tree item's selection.
public JFXCheckTreeCell() {
checkBox.setAllowIndeterminate(false);
checkBox.setFocusTraversable(false);
graphic.setAlignment(Pos.CENTER_LEFT);
graphic.setPickOnBounds(false);
checkBox.skinProperty().addListener(observable -> finishSelectionAnimation());
treeItemProperty().addListener(observable -> updateDisplay(getItem(), isEmpty()));
}
/// Finishes animations from the previous item and immediately displays the current state.
private void finishSelectionAnimation() {
if (checkBox.getSkin() instanceof JFXCheckBoxSkin skin) {
skin.finishSelectionAnimation();
}
}
/// Adds the checkbox to the inherited display and updates its selection bindings.
@Override
protected void updateDisplay(@Nullable T item, boolean empty) {
// Release graphics before the superclass reuses or reparents them.
graphic.getChildren().clear();
super.updateDisplay(item, empty);
@Nullable CheckBoxTreeItem<?> treeItem = !empty && item != null
&& getTreeItem() instanceof CheckBoxTreeItem<?> checkTreeItem ? checkTreeItem : null;
if (boundTreeItem != treeItem) {
if (boundTreeItem != null) {
checkBox.selectedProperty().unbindBidirectional(boundTreeItem.selectedProperty());
checkBox.indeterminateProperty().unbindBidirectional(boundTreeItem.indeterminateProperty());
}
boundTreeItem = treeItem;
if (treeItem != null) {
checkBox.selectedProperty().bindBidirectional(treeItem.selectedProperty());
checkBox.indeterminateProperty().bindBidirectional(treeItem.indeterminateProperty());
} else {
checkBox.setSelected(false);
checkBox.setIndeterminate(false);
}
finishSelectionAnimation();
}
if (treeItem != null) {
@Nullable Node itemGraphic = getGraphic();
graphic.getChildren().add(checkBox);
if (itemGraphic != null) {
graphic.getChildren().add(itemGraphic);
}
setGraphic(graphic);
}
}
}
@@ -28,6 +28,7 @@ import javafx.scene.control.TreeCell;
import javafx.scene.control.TreeItem;
import javafx.scene.layout.*;
import javafx.scene.paint.Color;
import org.jetbrains.annotations.Nullable;
import java.lang.ref.WeakReference;
@@ -83,8 +84,7 @@ public class JFXTreeCell<T> extends TreeCell<T> {
treeItemRef = new WeakReference<>(newTreeItem);
}
};
final WeakInvalidationListener weakTreeItemListener = new WeakInvalidationListener(treeItemInvalidationListener);
treeItemProperty().addListener(weakTreeItemListener);
treeItemProperty().addListener(treeItemInvalidationListener);
if (getTreeItem() != null) {
getTreeItem().graphicProperty().addListener(weakTreeItemGraphicListener);
}
@@ -104,13 +104,20 @@ public class JFXTreeCell<T> extends TreeCell<T> {
selectedPane.setVisible(isSelected());
}
private void updateDisplay(T item, boolean empty) {
/// Updates the text and graphic for the current value and tree item.
///
/// @implSpec Called when the cell value or the current tree item's graphic changes.
/// Subclasses may override this method to decorate the default display.
///
/// @param item the cell value, or `null` to clear the display
/// @param empty whether the cell has no item
protected void updateDisplay(@Nullable T item, boolean empty) {
if (item == null || empty) {
hbox = null;
setText(null);
setGraphic(null);
} else {
TreeItem<T> treeItem = getTreeItem();
@Nullable TreeItem<T> treeItem = getTreeItem();
if (treeItem != null && treeItem.getGraphic() != null) {
if (item instanceof Node) {
setText(null);
@@ -169,11 +169,8 @@ public class JFXCheckBoxSkin extends CheckBoxSkin {
};
}
private void playSelectAnimation(Boolean selection) {
if (selection == null) {
selection = false;
}
/// Animates a selection change, or applies it immediately when animations are disabled.
private void playSelectAnimation(boolean selection) {
JFXCheckBox control = (JFXCheckBox) this.getSkinnable();
this.box.setBorder(new Border(new BorderStroke(
@@ -183,17 +180,7 @@ public class JFXCheckBoxSkin extends CheckBoxSkin {
new BorderWidths(this.lineThick))));
if (!AnimationUtils.isAnimationEnabled()) {
if (selection) {
this.mark.setVisible(true);
this.mark.setScaleX(1.0);
this.mark.setScaleY(1.0);
JFXNodeUtils.updateBackground(box.getBackground(), box, control.getCheckedColor());
} else {
this.mark.setVisible(false);
this.mark.setScaleX(0.0);
this.mark.setScaleY(0.0);
JFXNodeUtils.updateBackground(box.getBackground(), box, Color.TRANSPARENT);
}
finishSelectionAnimation();
return;
}
@@ -203,6 +190,22 @@ public class JFXCheckBoxSkin extends CheckBoxSkin {
this.select.play();
}
/// Stops selection animations and immediately displays the checkbox's current selected state.
///
/// The check mark, fill, and border are updated even if no animation is running.
/// This also suppresses the initial selection animation on the first layout.
/// The skin must not have been disposed.
public void finishSelectionAnimation() {
transition.stop();
select.stop();
invalid = false;
boolean selected = getSkinnable().isSelected();
mark.setVisible(selected);
mark.setScaleX(selected ? 1.0 : 0.0);
mark.setScaleY(selected ? 1.0 : 0.0);
updateColors();
}
private void createFillTransition() {
this.select = new JFXFillTransition(Duration.millis(120.0), this.box, Color.TRANSPARENT,
(Color) ((JFXCheckBox) this.getSkinnable()).getCheckedColor());
@@ -39,8 +39,6 @@ public abstract class LocalizedRemoteAddonRepository implements RemoteAddonRepos
protected abstract RemoteAddonRepository getBackedRemoteModRepository();
protected abstract SortType getBackedRemoteModRepositorySortOrder();
@Override
public String getApiBaseUrl() {
return getBackedRemoteModRepository().getApiBaseUrl();
@@ -80,8 +78,8 @@ public abstract class LocalizedRemoteAddonRepository implements RemoteAddonRepos
SearchResult searchResult = null;
List<RemoteAddon> remoteAddons = List.of();
for (String englishSearchFilter : englishSearchFiltersSet) {
searchResult = getBackedRemoteModRepository().search(downloadProvider, gameVersion, category, pageOffset, pageSize, englishSearchFilter, getBackedRemoteModRepositorySortOrder(), sortOrder);
remoteAddons = searchResult.getUnsortedResults().toList();
searchResult = getBackedRemoteModRepository().search(downloadProvider, gameVersion, category, pageOffset, pageSize, englishSearchFilter, SortType.RELEVANCY, sortOrder);
remoteAddons = searchResult.results().toList();
if (!remoteAddons.isEmpty()) {
break;
}
@@ -100,7 +98,7 @@ public abstract class LocalizedRemoteAddonRepository implements RemoteAddonRepos
searchResultArray[englishIndex--] = remoteAddon;
}
}
totalPages = searchResult.getTotalPages();
totalPages = searchResult.totalPages();
}
StringUtils.LevCalculator levCalculator = new StringUtils.LevCalculator();
@@ -24,8 +24,7 @@ import javafx.beans.binding.Bindings;
import javafx.beans.binding.BooleanBinding;
import javafx.beans.binding.ObjectBinding;
import javafx.beans.binding.ObjectExpression;
import javafx.beans.property.ReadOnlyObjectProperty;
import javafx.beans.property.ReadOnlyObjectWrapper;
import javafx.beans.property.*;
import javafx.beans.value.ChangeListener;
import javafx.beans.value.ObservableValue;
import javafx.collections.SetChangeListener;
@@ -80,6 +79,7 @@ import java.nio.file.Files;
import java.nio.file.Path;
import java.time.Duration;
import java.util.*;
import java.util.function.Supplier;
import java.util.stream.Collectors;
import java.util.stream.Stream;
@@ -283,6 +283,9 @@ public final class Themes {
colorScheme
);
/// Whether the current color scheme brightness is inherited from system.
private static final ReadOnlyBooleanWrapper autoBrightness = new ReadOnlyBooleanWrapper();
/// The current JavaFX launcher background and its node opacity.
private static final ReadOnlyObjectWrapper<LauncherBackground> background = new ReadOnlyObjectWrapper<>(
new LauncherBackground(
@@ -380,6 +383,35 @@ public final class Themes {
}
static {
Supplier<@Nullable Brightness> effectiveBrightnessSupplier = () -> {
try {
return ThemePackManager.resolveCurrentThemeBrightness(ThemePackManager.currentResolveContext());
} catch (IOException | RuntimeException e) {
return null;
}
};
InvalidationListener autoBrightnessListener = o -> {
boolean auto;
if (settings().getThemeAppearanceOverrides().contains(LauncherSettings.THEME_APPEARANCE_BRIGHTNESS_MODE)) {
String val = settings().themeBrightnessModeProperty().get();
auto = val == null || switch (val.trim().toLowerCase(Locale.ROOT)) {
case "light", "dark" -> false;
default -> true;
};
} else {
auto = effectiveBrightnessSupplier.get() == null;
}
autoBrightness.set(auto);
};
settings().selectedThemeProperty().addListener(autoBrightnessListener);
settings().getThemeAppearanceOverrides().addListener(autoBrightnessListener);
settings().themeBrightnessModeProperty().addListener(autoBrightnessListener);
settings().backgroundTypeProperty().addListener(autoBrightnessListener);
if (FXUtils.DARK_MODE != null) {
FXUtils.DARK_MODE.addListener(autoBrightnessListener);
}
autoBrightnessListener.invalidated(null);
ChangeListener<ResolvedTheme> listener = (observable, oldValue, newValue) -> {
if (!Objects.equals(oldValue, newValue)) {
colorScheme.set(newValue.toColorScheme());
@@ -433,7 +465,7 @@ public final class Themes {
}
String themeBrightnessMode = settings().themeBrightnessModeProperty().get();
return switch (Objects.toString(themeBrightnessMode, "").toLowerCase(Locale.ROOT).trim()) {
return switch (Objects.toString(themeBrightnessMode, "").trim().toLowerCase(Locale.ROOT)) {
case "light" -> Brightness.LIGHT;
case "dark" -> Brightness.DARK;
default -> getAutomaticBrightness();
@@ -444,24 +476,16 @@ public final class Themes {
///
/// @return the effective launcher brightness
public static Brightness getCurrentBrightness() {
Brightness contextBrightness = getThemeConditionBrightness();
if (!settings().getThemeAppearanceOverrides().contains(LauncherSettings.THEME_APPEARANCE_BRIGHTNESS_MODE)) {
Brightness contextBrightness = getThemeConditionBrightness();
try {
return Objects.requireNonNullElse(
ThemePackManager.resolveCurrentThemeBrightness(ThemeResolveContext.current(contextBrightness)),
contextBrightness);
} catch (IOException | RuntimeException e) {
return contextBrightness;
} catch (IOException | RuntimeException ignored) {
}
}
String themeBrightnessMode = settings().themeBrightnessModeProperty().get();
return switch (Objects.toString(themeBrightnessMode, "").toLowerCase(Locale.ROOT).trim()) {
case "auto" -> getAutomaticBrightness();
case "dark" -> Brightness.DARK;
case "light" -> Brightness.LIGHT;
default -> getAutomaticBrightness();
};
return contextBrightness;
}
/// Returns the brightness requested by the current system or platform settings.
@@ -1119,6 +1143,11 @@ public final class Themes {
return darkMode;
}
/// Returns whether the current color scheme brightness is inherited from system.
public static ReadOnlyBooleanProperty autoBrightnessProperty() {
return autoBrightness.getReadOnlyProperty();
}
/// Applies native dark-mode integration to a JavaFX stage where the platform supports it.
public static void applyNativeDarkMode(Stage stage) {
if (OperatingSystem.SYSTEM_VERSION.isAtLeast(OSVersion.WINDOWS_11) && NativeUtils.USE_JNA && Dwmapi.INSTANCE != null) {
@@ -72,6 +72,8 @@ public class CrashWindow extends Stage {
FXUtils.setIcon(this);
setTitle(i18n("message.error"));
FXUtils.addMacOSCloseWindowHandler(this, null);
setOnCloseRequest(e -> javafx.application.Platform.exit());
}
@@ -58,9 +58,7 @@ import javafx.scene.paint.Paint;
import javafx.scene.shape.Rectangle;
import javafx.scene.text.Text;
import javafx.scene.text.TextFlow;
import javafx.stage.FileChooser;
import javafx.stage.Screen;
import javafx.stage.Stage;
import javafx.stage.*;
import javafx.util.Duration;
import javafx.util.StringConverter;
import org.glavo.url.WebURL;
@@ -109,10 +107,7 @@ import java.nio.file.Path;
import java.nio.file.PathMatcher;
import java.util.*;
import java.util.concurrent.ConcurrentHashMap;
import java.util.function.Consumer;
import java.util.function.Function;
import java.util.function.Predicate;
import java.util.function.ToIntFunction;
import java.util.function.*;
import java.util.regex.Matcher;
import java.util.regex.Pattern;
@@ -1200,6 +1195,18 @@ public final class FXUtils {
});
}
public static void addMacOSCloseWindowHandler(Window window, @Nullable Supplier<Boolean> restriction) {
window.addEventHandler(KeyEvent.KEY_PRESSED, event -> {
if (OperatingSystem.CURRENT_OS == OperatingSystem.MACOS
&& event.isMetaDown()
&& event.getCode() == KeyCode.W
&& (restriction == null || restriction.get())) {
window.fireEvent(new WindowEvent(window, WindowEvent.WINDOW_CLOSE_REQUEST));
event.consume();
}
});
}
public static <N extends Parent> N prepareNode(N node) {
Scene dummyScene = new Scene(node);
StyleSheets.init(dummyScene);
@@ -114,6 +114,8 @@ public class GameCrashWindow extends Stage {
setTitle(i18n("game.crash.title"));
FXUtils.setIcon(this);
FXUtils.addMacOSCloseWindowHandler(this, null);
analyzeCrashReport();
}
@@ -100,6 +100,8 @@ public final class LogWindow extends Stage {
}
this.gameProcess = gameProcess;
FXUtils.addMacOSCloseWindowHandler(this, () -> !gameProcess.isRunning());
}
public void logLine(Log log) {
@@ -18,6 +18,8 @@
package org.jackhuang.hmcl.ui;
import com.sun.jna.Pointer;
import javafx.beans.property.ReadOnlyBooleanProperty;
import org.jackhuang.hmcl.theme.Themes;
import org.jackhuang.hmcl.util.platform.macos.ObjectiveCRuntime;
import org.jetbrains.annotations.Nullable;
@@ -56,8 +58,30 @@ public final class MacOSNativeUtils {
return pointer == null || Pointer.nativeValue(pointer) == 0;
}
private static final ReadOnlyBooleanProperty autoBrightness = Themes.autoBrightnessProperty();
static {
FXUtils.onChange(autoBrightness, b -> setAppearance(Themes.darkModeProperty().get()));
}
public static void setAppearance(boolean dark) {
setAppearance(dark, false);
if (autoBrightness.get()) {
clearAppearance();
} else {
setAppearance(dark, false);
}
}
public static void clearAppearance() {
if (nsApp == null) return;
try {
var objc = ObjectiveCRuntime.INSTANCE;
Pointer setSel = objc.sel_registerName("setAppearance:");
objc.objc_msgSend(nsApp, setSel, Pointer.NULL);
} catch (Throwable t) {
LOG.warning("Failed to set macOS appearance", t);
}
}
public static void setAppearance(boolean dark, boolean highContrast) {
@@ -19,15 +19,11 @@ package org.jackhuang.hmcl.ui.construct;
import com.jfoenix.controls.JFXButton;
import com.jfoenix.controls.JFXDialogLayout;
import com.jfoenix.controls.JFXProgressBar;
import javafx.beans.property.BooleanProperty;
import javafx.beans.property.SimpleBooleanProperty;
import javafx.beans.property.SimpleStringProperty;
import javafx.beans.property.StringProperty;
import javafx.geometry.Insets;
import javafx.geometry.Pos;
import javafx.scene.control.Label;
import javafx.scene.layout.StackPane;
import static org.jackhuang.hmcl.ui.FXUtils.onEscPressed;
import static org.jackhuang.hmcl.util.i18n.I18n.i18n;
@@ -38,18 +34,11 @@ public class DialogPane extends JFXDialogLayout {
protected final SpinnerPane acceptPane = new SpinnerPane();
protected final JFXButton cancelButton = new JFXButton();
protected final Label warningLabel = new Label();
private final JFXProgressBar progressBar = new JFXProgressBar();
public DialogPane() {
Label titleLabel = new Label();
titleLabel.textProperty().bind(title);
setHeading(titleLabel);
getChildren().add(progressBar);
progressBar.setVisible(false);
StackPane.setMargin(progressBar, new Insets(-24.0D, -24.0D, -16.0D, -24.0D));
StackPane.setAlignment(progressBar, Pos.TOP_CENTER);
progressBar.setMaxWidth(Double.MAX_VALUE);
JFXButton acceptButton = new JFXButton(i18n("button.ok"));
acceptButton.setOnAction(e -> onAccept());
@@ -66,10 +55,6 @@ public class DialogPane extends JFXDialogLayout {
setActions(warningLabel, acceptPane, cancelButton);
}
protected JFXProgressBar getProgressBar() {
return progressBar;
}
public String getTitle() {
return title.get();
}
@@ -60,7 +60,6 @@ import org.jackhuang.hmcl.modpack.mcbbs.McbbsModpackExportTask;
import org.jackhuang.hmcl.modpack.modrinth.ModrinthCompletionTask;
import org.jackhuang.hmcl.modpack.modrinth.ModrinthInstallTask;
import org.jackhuang.hmcl.modpack.modrinth.ModrinthModpackExportTask;
import org.jackhuang.hmcl.modpack.multimc.MultiMCModpackExportTask;
import org.jackhuang.hmcl.modpack.multimc.MultiMCModpackInstallTask;
import org.jackhuang.hmcl.modpack.server.ServerModpackCompletionTask;
import org.jackhuang.hmcl.modpack.server.ServerModpackExportTask;
@@ -204,7 +203,7 @@ public final class TaskListPane extends StackPane {
task.setName(i18n("install.installing") + ": " + i18n("modpack.type.server"));
} else if (task instanceof HMCLModpackInstallTask) {
task.setName(i18n("modpack.installing.given", i18n("modpack.type.hmcl")));
} else if (task instanceof McbbsModpackExportTask || task instanceof MultiMCModpackExportTask || task instanceof ServerModpackExportTask || task instanceof ModrinthModpackExportTask) {
} else if (task instanceof McbbsModpackExportTask || task instanceof ServerModpackExportTask || task instanceof ModrinthModpackExportTask) {
task.setName(i18n("modpack.export"));
} else if (task instanceof MinecraftInstanceTask) {
task.setName(i18n("modpack.scan"));
@@ -24,12 +24,21 @@ import javafx.collections.FXCollections;
import javafx.collections.ObservableList;
import javafx.css.PseudoClass;
import javafx.geometry.Pos;
import javafx.scene.Node;
import javafx.scene.control.Label;
import javafx.scene.control.OverrunStyle;
import javafx.scene.layout.HBox;
import javafx.scene.layout.Priority;
import javafx.scene.layout.VBox;
import org.jackhuang.hmcl.ui.FXUtils;
import org.jetbrains.annotations.NotNullByDefault;
import org.jetbrains.annotations.Nullable;
import java.util.Collection;
import java.util.LinkedHashSet;
import java.util.stream.Collectors;
/// Displays a title with optional tags and a subtitle.
public class TwoLineListItem extends VBox {
private static final String DEFAULT_STYLE_CLASS = "two-line-list-item";
@@ -39,14 +48,28 @@ public class TwoLineListItem extends VBox {
private final Label lblTitle;
private Label lblSubtitle;
/// Creates an empty item whose children do not receive mouse events.
public TwoLineListItem() {
getStyleClass().add(DEFAULT_STYLE_CLASS);
setMouseTransparent(true);
lblTitle = new Label();
lblTitle.getStyleClass().add("title");
lblTitle.setTextOverrun(OverrunStyle.ELLIPSIS);
this.firstLine = new HBox(lblTitle);
this.firstLine = new HBox(lblTitle) {
/// Includes the tags' natural width when requesting space from the parent.
@Override
protected double computePrefWidth(double height) {
double width = super.computePrefWidth(height);
for (Node child : getManagedChildren()) {
if (child instanceof TagsBox tagsBox) {
width += snapSizeX(tagsBox.computeNaturalPrefWidth(height));
}
}
return width;
}
};
firstLine.getStyleClass().add("first-line");
firstLine.setAlignment(Pos.CENTER_LEFT);
@@ -158,17 +181,29 @@ public class TwoLineListItem extends VBox {
return lblSubtitle;
}
private ObservableList<Label> tags;
private static Label createTag(String tag, PseudoClass pseudoClass) {
var tagLabel = new Label(tag);
tagLabel.getStyleClass().add("tag");
tagLabel.setMinWidth(Label.USE_PREF_SIZE);
if (pseudoClass != null)
tagLabel.pseudoClassStateChanged(pseudoClass, true);
return tagLabel;
}
/// Stores the mutable tag list once tag support has been initialized.
private @Nullable ObservableList<Label> tags;
/// Returns the mutable list of tags displayed after the title.
public ObservableList<Label> getTags() {
if (tags == null) {
tags = FXCollections.observableArrayList();
var tagsBox = new HBox(8);
var tagsBox = new TagsBox();
tagsBox.getStyleClass().add("tags");
tagsBox.setAlignment(Pos.CENTER_LEFT);
tagsBox.setMinWidth(0);
HBox.setHgrow(tagsBox, Priority.ALWAYS);
HBox.setHgrow(tagsBox, Priority.SOMETIMES);
Bindings.bindContent(tagsBox.getChildren(), tags);
var isNotEmpty = Bindings.isNotEmpty(tags);
tagsBox.managedProperty().bind(isNotEmpty);
@@ -176,25 +211,53 @@ public class TwoLineListItem extends VBox {
FXUtils.setOverflowHidden(tagsBox);
lblTitle.setMinWidth(Label.USE_PREF_SIZE);
HBox.setHgrow(lblTitle, Priority.ALWAYS);
lblTitle.setMinWidth(0);
firstLine.getChildren().setAll(lblTitle, tagsBox);
}
return tags;
}
/// Reports its natural width separately from the width used to allocate space within the title row.
@NotNullByDefault
private static final class TagsBox extends HBox {
/// Creates a tag container with zero minimum and preferred allocation widths.
private TagsBox() {
super(8);
// Start at zero during HBox allocation so tags do not compete with the title for space.
setPrefWidth(0);
setMinWidth(0);
}
/// Returns the computed preferred width without applying the zero preferred-width override.
///
/// @param height the available height, or -1 if unspecified
/// @return the natural preferred width of the tags and their container
private double computeNaturalPrefWidth(double height) {
return super.computePrefWidth(height);
}
}
public void addTag(String tag, PseudoClass pseudoClass) {
var tagLabel = new Label(tag);
tagLabel.getStyleClass().add("tag");
tagLabel.setMinWidth(Label.USE_PREF_SIZE);
if (pseudoClass != null)
tagLabel.pseudoClassStateChanged(pseudoClass, true);
getTags().add(tagLabel);
getTags().add(createTag(tag, pseudoClass));
}
public void addTag(String tag) {
addTag(tag, null);
}
public void addTags(Collection<String> tags) {
getTags().addAll(tags.stream().map(tag -> createTag(tag, null)).toList());
}
public void addTagsIfNotExist(Collection<String> tags) {
var current = getTags().stream().map(Label::getText).collect(Collectors.toSet());
var target = new LinkedHashSet<>(tags);
target.removeAll(current);
addTags(target);
}
private static final PseudoClass WARNING_PSEUDO_CLASS = PseudoClass.getPseudoClass("warning");
public void addTagWarning(String tag) {
@@ -59,7 +59,7 @@ class AdditionalInstallersPage extends AbstractInstallersPage {
});
}
installable.bind(Bindings.createBooleanBinding(() -> compatible.get() && txtName.validate(), txtName.textProperty(), compatible));
installable.bind(Bindings.createBooleanBinding(() -> txtName.validate(), txtName.textProperty()));
}
@Override
@@ -80,27 +80,14 @@ class AdditionalInstallersPage extends AbstractInstallersPage {
@Override
protected void reload() {
boolean gameVersionChanged = !instance.getVersion().toString().equals(getVersion(GameComponentType.GAME));
boolean compatible = true;
for (InstallerItem component : group.getComponents()) {
GameComponentType componentType = component.getComponentType();
String version = instance.getComponentVersion(component.getComponentType());
String libraryVersion = Lang.requireNonNullElse(getVersion(componentType), version);
boolean alreadyInstalled = version != null && !(controller.getSettings().get(componentType.getPatchId()) instanceof UpdateInstallerWizardProvider.RemoveComponentAction);
if (component.getComponentType() != GameComponentType.GAME && gameVersionChanged && getVersion(componentType) == null && alreadyInstalled) {
// For third-party libraries, if game version is being changed, and the library is not being reinstalled,
// warns the user that we should update the library.
component.versionProperty().set(new InstallerItem.InstalledState(libraryVersion, false, true));
compatible = false;
} else if (alreadyInstalled || getVersion(componentType) != null) {
component.versionProperty().set(new InstallerItem.InstalledState(libraryVersion, false, false));
if (controller.getSettings().containsKey(componentType.getPatchId())) {
component.versionProperty().set(new InstallerItem.InstalledState(getVersion(componentType), false, false));
} else {
component.versionProperty().set(null);
}
}
this.compatible.set(compatible);
}
@Override
@@ -307,7 +307,7 @@ public class DownloadPage extends DecoratorAnimatedPage implements DecoratorPage
/// @param settings the installer selections and target instance id
/// @return the builder task with its stage hints preserved as the outermost task wrapper
private Task<?> finishVersionDownloadingAsync(SettingsMap settings) {
GameInstanceID instanceId = settings.get(AbstractInstallersPage.INSTANCE_ID);
@Nullable GameInstanceID instanceId = settings.get(AbstractInstallersPage.INSTANCE_ID);
if (instanceId == null) {
throw new IllegalStateException("Instance ID is not set");
}
@@ -329,6 +329,7 @@ public class DownloadPage extends DecoratorAnimatedPage implements DecoratorPage
}
Task<?> buildTask = builder.buildAsync();
settings.put(TaskCleanup.KEY, builder::abort);
buildTask.onDone().register(event -> {
if (!event.isFailed()) {
runInFX(() -> repository.setSelectedInstance(repository.getInstance(instanceId)));
@@ -65,6 +65,7 @@ public final class UpdateInstallerWizardProvider implements WizardProvider {
public void start(SettingsMap settings) {
}
/// Creates a task that updates components and synchronizes the client JAR with the resulting manifest.
@Override
public Object finish(SettingsMap settings) {
settings.put("title", i18n("install.change_version.process"));
@@ -83,7 +84,7 @@ public final class UpdateInstallerWizardProvider implements WizardProvider {
}
}
return gameInstance.getRepository().updateInstanceAsync(gameInstance.getId(), publishedInstance -> {
return dependencyManager.updateInstanceAsync(gameInstance.getId(), publishedInstance -> {
Task<GameInstanceManifest> update = Task.supplyAsync(publishedInstance::getManifest);
for (Object value : settings.asStringMap().values()) {
if (value instanceof ComponentRemoteVersion remoteVersion) {
@@ -24,14 +24,11 @@ import org.jackhuang.hmcl.modpack.ModAdviser;
import org.jackhuang.hmcl.modpack.ModpackExportInfo;
import org.jackhuang.hmcl.modpack.mcbbs.McbbsModpackExportTask;
import org.jackhuang.hmcl.modpack.modrinth.ModrinthModpackExportTask;
import org.jackhuang.hmcl.modpack.multimc.MultiMCInstanceConfiguration;
import org.jackhuang.hmcl.modpack.multimc.MultiMCModpackExportTask;
import org.jackhuang.hmcl.modpack.server.ServerModpackExportTask;
import org.jackhuang.hmcl.setting.*;
import org.jackhuang.hmcl.task.Task;
import org.jackhuang.hmcl.ui.wizard.WizardController;
import org.jackhuang.hmcl.ui.wizard.WizardProvider;
import org.jackhuang.hmcl.util.Lang;
import org.jackhuang.hmcl.util.SettingsMap;
import org.jackhuang.hmcl.util.gson.JsonUtils;
import org.jackhuang.hmcl.util.io.JarUtils;
@@ -97,9 +94,6 @@ public final class ExportWizardProvider implements WizardProvider {
case ModpackTypeSelectionPage.MODPACK_TYPE_MCBBS:
exportTask = exportAsMcbbs(exportInfo, dest);
break;
case ModpackTypeSelectionPage.MODPACK_TYPE_MULTIMC:
exportTask = exportAsMultiMC(exportInfo, dest);
break;
case ModpackTypeSelectionPage.MODPACK_TYPE_SERVER:
exportTask = exportAsServer(exportInfo, dest);
break;
@@ -183,55 +177,6 @@ public final class ExportWizardProvider implements WizardProvider {
};
}
private Task<?> exportAsMultiMC(ModpackExportInfo exportInfo, Path modpackFile) {
return new Task<Void>() {
@Nullable Task<?> dependency;
{
setSignificance(TaskSignificance.MODERATE);
}
@Override
public void execute() {
HMCLGameInstance instance = resolveCurrentGameInstance();
GameSettings.Effective setting = instance.getEffectiveSettings();
dependency = new MultiMCModpackExportTask(instance, exportInfo.getWhitelist(),
new MultiMCInstanceConfiguration(
"OneSix",
exportInfo.getName() + "-" + exportInfo.getVersion(),
null,
Lang.toIntOrNull(setting.getInheritable(GameSettings::permSizeProperty)),
setting.getInheritable(GameSettings::commandWrapperProperty),
setting.getInheritable(GameSettings::preLaunchCommandProperty),
null,
exportInfo.getDescription(),
null,
exportInfo.getJavaArguments(),
setting.getInheritable(GameSettings::windowTypeProperty) == GameWindowType.FULLSCREEN,
setting.getWidth(),
setting.getHeight(),
null,
exportInfo.getMinMemory(),
setting.getInheritable(GameSettings::showLogsProperty),
/* showConsoleOnError */ true,
/* autoCloseConsole */ false,
/* overrideMemory */ true,
/* overrideJavaLocation */ false,
/* overrideJavaArgs */ true,
/* overrideConsole */ true,
/* overrideCommands */ true,
/* overrideWindow */ true,
/* iconKey */ null // TODO
), modpackFile);
}
@Override
public Collection<Task<?>> getDependencies() {
return Collections.singleton(dependency);
}
};
}
private Task<?> exportAsServer(ModpackExportInfo exportInfo, Path modpackFile) {
return new Task<Void>() {
@Nullable Task<?> dependency;
@@ -18,17 +18,17 @@
package org.jackhuang.hmcl.ui.export;
import com.jfoenix.controls.JFXButton;
import com.jfoenix.controls.JFXCheckBox;
import com.jfoenix.controls.JFXCheckTreeCell;
import com.jfoenix.controls.JFXTreeView;
import javafx.geometry.Insets;
import javafx.geometry.Pos;
import javafx.scene.Node;
import javafx.scene.control.CheckBoxTreeItem;
import javafx.scene.control.Label;
import javafx.scene.control.TreeItem;
import javafx.scene.layout.BorderPane;
import javafx.scene.layout.HBox;
import javafx.scene.layout.StackPane;
import org.jackhuang.hmcl.game.GameInstanceID;
import org.jackhuang.hmcl.game.HMCLGameInstance;
import org.jackhuang.hmcl.modpack.ModAdviser;
import org.jackhuang.hmcl.task.Schedulers;
@@ -41,6 +41,7 @@ import org.jackhuang.hmcl.util.Pair;
import org.jackhuang.hmcl.util.SettingsMap;
import org.jackhuang.hmcl.util.StringUtils;
import org.jackhuang.hmcl.util.io.FileUtils;
import org.jetbrains.annotations.NotNullByDefault;
import org.jetbrains.annotations.Nullable;
import java.io.IOException;
@@ -66,13 +67,14 @@ public final class ModpackFileSelectionPage extends BorderPane implements Wizard
private final ModAdviser adviser;
private @Nullable ModpackFileTreeItem rootNode;
/// Creates a file-selection page and starts loading the instance's exportable files.
public ModpackFileSelectionPage(WizardController controller, HMCLGameInstance gameInstance, ModAdviser adviser) {
this.controller = controller;
this.gameInstance = gameInstance;
this.adviser = adviser;
GameInstanceID instanceId = gameInstance.getId();
JFXTreeView<String> treeView = new JFXTreeView<>();
treeView.setCellFactory(__ -> new ModpackFileTreeCell());
treeView.setSelectionModel(new NoneMultipleSelectionModel<>());
onEscPressed(treeView, () -> controller.onPrev(true));
@@ -196,14 +198,16 @@ public final class ModpackFileSelectionPage extends BorderPane implements Wizard
return node;
}
private void getFilesNeeded(ModpackFileTreeItem node, String basePath, List<String> list) {
/// Appends selected paths relative to `minecraft/`, traversing partially selected directories.
/// A `null` node contributes no paths.
private void getFilesNeeded(@Nullable ModpackFileTreeItem node, String basePath, List<String> list) {
if (node == null) return;
if (node.isSelected() || node.isIndeterminate()) {
if (basePath.length() > "minecraft/".length())
list.add(StringUtils.substringAfter(basePath, "minecraft/"));
for (TreeItem<String> child : node.getChildren()) {
if (child instanceof ModpackFileTreeItem mChild) {
getFilesNeeded(mChild, basePath + "/" + mChild.getFileName(), list);
getFilesNeeded(mChild, basePath + "/" + mChild.getValue(), list);
}
}
}
@@ -244,39 +248,69 @@ public final class ModpackFileSelectionPage extends BorderPane implements Wizard
pair("minecraft/scripts", i18n("modpack.files.scripts"))
);
/// Stores a file name, optional explanation, and hierarchical selection state.
@NotNullByDefault
private static final class ModpackFileTreeItem extends CheckBoxTreeItem<String> {
private final String fileName;
/// The localized explanation for a recognized path, or `null` if none exists.
private final @Nullable String comment;
/// Creates an item whose value is the file name; only the `minecraft` root starts expanded.
public ModpackFileTreeItem(String fileName, String basePath) {
this.fileName = fileName;
HBox graphic = new HBox();
JFXCheckBox checkBox = new JFXCheckBox();
checkBox.selectedProperty().bindBidirectional(this.selectedProperty());
checkBox.indeterminateProperty().bindBidirectional(this.indeterminateProperty());
graphic.getChildren().add(checkBox);
{
Label text = new Label(fileName);
text.setMouseTransparent(true);
graphic.getChildren().add(text);
}
if (TRANSLATION.containsKey(basePath)) {
Label comment = new Label(TRANSLATION.get(basePath));
comment.setStyle("-fx-text-fill: -monet-on-surface-variant;");
comment.setMouseTransparent(true);
graphic.getChildren().add(comment);
}
graphic.setPickOnBounds(false);
super(fileName);
this.comment = TRANSLATION.get(basePath);
this.setExpanded("minecraft".equals(basePath));
this.setValue(""); // To disable the default display of text
this.setGraphic(graphic);
}
}
/// Renders file names and localized explanations alongside the bound checkbox.
@NotNullByDefault
private static final class ModpackFileTreeCell extends JFXCheckTreeCell<String> {
/// Contains the inherited checkbox graphic followed by the file labels.
private final HBox content = new HBox();
/// Displays the current file name.
private final Label fileName = new Label();
/// Displays the current path's optional explanation.
private final Label comment = new Label();
/// Creates reusable labels whose mouse events pass through to the cell.
private ModpackFileTreeCell() {
fileName.setMouseTransparent(true);
comment.setStyle("-fx-text-fill: -monet-on-surface-variant;");
comment.setMouseTransparent(true);
content.setAlignment(Pos.CENTER_LEFT);
content.setPickOnBounds(false);
}
public String getFileName() {
return fileName;
}
/// Refreshes the file labels and removes content when the cell is cleared.
@Override
protected void updateDisplay(@Nullable String item, boolean empty) {
content.getChildren().clear();
super.updateDisplay(item, empty);
fileName.setText(null);
comment.setText(null);
if (empty || item == null) {
return;
}
// Updating the text makes the skin reattach the current graphic to the cell.
// Clear it before moving the checkbox graphic into the content container.
setText(null);
@Nullable Node graphic = getGraphic();
if (graphic != null) {
content.getChildren().add(graphic);
}
fileName.setText(item);
content.getChildren().add(fileName);
if (getTreeItem() instanceof ModpackFileTreeItem treeItem && treeItem.comment != null) {
comment.setText(treeItem.comment);
content.getChildren().add(comment);
}
setGraphic(content);
}
}
}
@@ -26,7 +26,6 @@ import javafx.scene.layout.BorderPane;
import javafx.scene.layout.VBox;
import org.jackhuang.hmcl.modpack.ModpackExportInfo;
import org.jackhuang.hmcl.modpack.mcbbs.McbbsModpackExportTask;
import org.jackhuang.hmcl.modpack.multimc.MultiMCModpackExportTask;
import org.jackhuang.hmcl.modpack.server.ServerModpackExportTask;
import org.jackhuang.hmcl.modpack.modrinth.ModrinthModpackExportTask;
import org.jackhuang.hmcl.ui.SVG;
@@ -55,7 +54,6 @@ public final class ModpackTypeSelectionPage extends VBox implements WizardPage {
this.getChildren().setAll(
title,
createButton(MODPACK_TYPE_MCBBS, McbbsModpackExportTask.OPTION),
createButton(MODPACK_TYPE_MULTIMC, MultiMCModpackExportTask.OPTION),
createButton(MODPACK_TYPE_SERVER, ServerModpackExportTask.OPTION),
createButton(MODPACK_TYPE_MODRINTH, ModrinthModpackExportTask.OPTION)
);
@@ -98,7 +96,6 @@ public final class ModpackTypeSelectionPage extends VBox implements WizardPage {
public static final SettingsMap.Key<String> MODPACK_TYPE = new SettingsMap.Key<>("modpack.type");
public static final String MODPACK_TYPE_MCBBS = "mcbbs";
public static final String MODPACK_TYPE_MULTIMC = "multimc";
public static final String MODPACK_TYPE_SERVER = "server";
public static final String MODPACK_TYPE_MODRINTH = "modrinth";
}
@@ -27,7 +27,6 @@ import javafx.application.Platform;
import javafx.beans.InvalidationListener;
import javafx.beans.binding.Bindings;
import javafx.beans.property.BooleanProperty;
import javafx.beans.property.ObjectProperty;
import javafx.beans.property.SimpleBooleanProperty;
import javafx.collections.ListChangeListener;
import javafx.collections.transformation.FilteredList;
@@ -46,7 +45,6 @@ import javafx.scene.layout.Priority;
import javafx.scene.layout.StackPane;
import javafx.util.Duration;
import org.jackhuang.hmcl.addon.datapack.DataPack;
import org.jackhuang.hmcl.task.Schedulers;
import org.jackhuang.hmcl.ui.Controllers;
import org.jackhuang.hmcl.ui.FXUtils;
import org.jackhuang.hmcl.ui.SVG;
@@ -55,15 +53,13 @@ import org.jackhuang.hmcl.ui.animation.TransitionPane;
import org.jackhuang.hmcl.ui.construct.*;
import org.jackhuang.hmcl.util.StringUtils;
import org.jackhuang.hmcl.util.io.CompressingUtils;
import org.jackhuang.hmcl.util.javafx.ItemPropertyAsyncCache;
import org.jetbrains.annotations.NotNullByDefault;
import org.jetbrains.annotations.Nullable;
import java.lang.ref.SoftReference;
import java.lang.ref.WeakReference;
import java.nio.file.FileSystem;
import java.nio.file.Files;
import java.nio.file.Path;
import java.util.concurrent.CompletableFuture;
import java.util.concurrent.atomic.AtomicInteger;
import java.util.function.Consumer;
import java.util.stream.IntStream;
@@ -263,11 +259,13 @@ final class DataPackListPageSkin extends SkinBase<DataPackListPage> {
private final BooleanProperty activeProperty;
private final DataPack.Pack packInfo;
private SoftReference<CompletableFuture<Image>> iconCache;
private final ItemPropertyAsyncCache<Image, DataPackInfoObject> iconCache;
DataPackInfoObject(DataPack.Pack packInfo) {
this.packInfo = packInfo;
this.activeProperty = packInfo.activeProperty();
this.iconCache = new ItemPropertyAsyncCache.Soft<>(this, this::loadIcon, this::getDefaultIcon);
}
String getTitle() {
@@ -282,7 +280,11 @@ final class DataPackListPageSkin extends SkinBase<DataPackListPage> {
return packInfo;
}
Image loadIcon() {
private Image getDefaultIcon() {
return FXUtils.newBuiltinImage("/assets/img/unknown_pack.png");
}
private Image loadIcon() {
Image image = null;
Path imagePath;
if (this.getPackInfo().isDirectory()) {
@@ -291,7 +293,6 @@ final class DataPackListPageSkin extends SkinBase<DataPackListPage> {
image = FXUtils.loadImage(imagePath, 64, 64, true, true);
} catch (Exception e) {
LOG.warning("fail to load image, datapack path: " + getPackInfo().getPath(), e);
return FXUtils.newBuiltinImage("/assets/img/unknown_pack.png");
}
} else {
try (FileSystem fs = CompressingUtils.createReadOnlyZipFileSystem(getPackInfo().getPath())) {
@@ -301,7 +302,6 @@ final class DataPackListPageSkin extends SkinBase<DataPackListPage> {
}
} catch (Exception e) {
LOG.warning("fail to load image, datapack path: " + getPackInfo().getPath(), e);
return FXUtils.newBuiltinImage("/assets/img/unknown_pack.png");
}
}
@@ -309,36 +309,9 @@ final class DataPackListPageSkin extends SkinBase<DataPackListPage> {
Math.abs(image.getWidth() - image.getHeight()) < 1) {
return image;
} else {
return FXUtils.newBuiltinImage("/assets/img/unknown_pack.png");
return getDefaultIcon();
}
}
public void loadIcon(ImageContainer imageContainer, @Nullable WeakReference<ObjectProperty<DataPackInfoObject>> current) {
SoftReference<CompletableFuture<Image>> iconCache = this.iconCache;
CompletableFuture<Image> imageFuture;
if (iconCache != null && (imageFuture = iconCache.get()) != null) {
Image image = imageFuture.getNow(null);
if (image != null) {
imageContainer.setImage(image);
return;
}
} else {
imageFuture = CompletableFuture.supplyAsync(this::loadIcon, Schedulers.io());
this.iconCache = new SoftReference<>(imageFuture);
}
imageContainer.setImage(FXUtils.newBuiltinImage("/assets/img/unknown_pack.png"));
imageFuture.thenAcceptAsync(image -> {
if (current != null) {
ObjectProperty<DataPackInfoObject> infoObjectProperty = current.get();
if (infoObjectProperty == null || infoObjectProperty.get() != this) {
// The current ListCell has already switched to another object
return;
}
}
imageContainer.setImage(image);
}, Schedulers.javafx());
}
}
private final class DataPackInfoListCell extends MDListCell<DataPackInfoObject> {
@@ -377,7 +350,7 @@ final class DataPackListPageSkin extends SkinBase<DataPackListPage> {
checkBox.selectedProperty().unbindBidirectional(booleanProperty);
}
checkBox.selectedProperty().bindBidirectional(booleanProperty = dataItem.activeProperty);
dataItem.loadIcon(imageContainer, new WeakReference<>(this.itemProperty()));
dataItem.iconCache.attachValue(imageContainer.imageProperty(), new WeakReference<>(this.itemProperty()));
}
}
@@ -117,7 +117,7 @@ public class DownloadListPage extends Control implements DecoratorPage {
if (!searchInitialized) {
searchInitialized = true;
search("", null, 0, "", RemoteAddonRepository.SortType.POPULARITY);
search("", null, 0, "", RemoteAddonRepository.SortType.RELEVANCY);
}
if (instanceSelection) {
@@ -182,8 +182,8 @@ public class DownloadListPage extends Control implements DecoratorPage {
setLoading(false);
if (exception == null) {
items.setAll(result.getResults().collect(Collectors.toList()));
pageCount.set(result.getTotalPages());
items.setAll(result.results().collect(Collectors.toList()));
pageCount.set(result.totalPages());
failed.set(false);
} else {
failed.set(true);
@@ -371,7 +371,7 @@ public class DownloadListPage extends Control implements DecoratorPage {
sortStackPane.getChildren().setAll(sortComboBox);
sortComboBox.prefWidthProperty().bind(sortStackPane.widthProperty());
sortComboBox.getStyleClass().add("fit-width");
sortComboBox.setConverter(stringConverter(sortType -> i18n("curse.sort." + sortType.name().toLowerCase(Locale.ROOT))));
sortComboBox.setConverter(stringConverter(sortType -> i18n("addon.sort." + sortType.name().toLowerCase(Locale.ROOT))));
sortComboBox.getItems().setAll(RemoteAddonRepository.SortType.values());
sortComboBox.getSelectionModel().select(0);
searchPane.addRow(rowIndex++, new Label(i18n("addon.category")), categoryStackPane, new Label(i18n("search.sort")), sortStackPane);
@@ -29,6 +29,7 @@ import javafx.geometry.Pos;
import javafx.scene.control.*;
import javafx.scene.layout.*;
import javafx.stage.FileChooser;
import org.jackhuang.hmcl.addon.AddonLoader;
import org.jackhuang.hmcl.download.DownloadProvider;
import org.jackhuang.hmcl.game.*;
import org.jackhuang.hmcl.addon.mod.ModLoaderType;
@@ -281,8 +282,8 @@ public class DownloadPage extends Control implements DecoratorPage {
resolve:
for (RemoteAddon.Version addonVersion : addonVersions) {
if (getSkinnable().type == RemoteAddon.Type.MOD) {
for (ModLoaderType loader : addonVersion.loaders()) {
if (targetLoaders.contains(loader)) {
for (AddonLoader loader : addonVersion.loaders()) {
if (loader.type() instanceof ModLoaderType modLoaderType && targetLoaders.contains(modLoaderType)) {
list.getContent().addAll(
ComponentList.createComponentListTitle(i18n("addon.download.recommend", gameVersion)),
new AddonItem(control.addon, addonVersion, control)
@@ -460,31 +461,11 @@ public class DownloadPage extends Control implements DecoratorPage {
graphicPane.getChildren().setAll(icon);
}
for (ModLoaderType modLoaderType : dataItem.loaders()) {
switch (modLoaderType) {
case FORGE:
content.addTag(i18n("install.installer.forge"));
break;
case CLEANROOM:
content.addTag(i18n("install.installer.cleanroom"));
break;
case NEO_FORGE:
content.addTag(i18n("install.installer.neoforge"));
break;
case FABRIC:
content.addTag(i18n("install.installer.fabric"));
break;
case LITE_LOADER:
content.addTag(i18n("install.installer.liteloader"));
break;
case QUILT:
content.addTag(i18n("install.installer.quilt"));
break;
case LEGACY_FABRIC:
content.addTag(i18n("install.installer.legacyfabric"));
break;
}
Set<String> tags = new LinkedHashSet<>();
for (AddonLoader loader : dataItem.loaders()) {
tags.add(I18n.translateLoaderName(loader));
}
content.addTags(tags);
descPane.getChildren().setAll(graphicPane, content);
}
@@ -17,7 +17,10 @@
*/
package org.jackhuang.hmcl.ui.instances;
import com.jfoenix.controls.JFXButton;
import com.jfoenix.controls.JFXDialogLayout;
import javafx.scene.Node;
import javafx.scene.control.Label;
import javafx.scene.image.ImageView;
import javafx.scene.layout.FlowPane;
import javafx.stage.FileChooser;
@@ -27,17 +30,18 @@ import org.jackhuang.hmcl.setting.GameInstanceIconType;
import org.jackhuang.hmcl.ui.Controllers;
import org.jackhuang.hmcl.ui.FXUtils;
import org.jackhuang.hmcl.ui.SVG;
import org.jackhuang.hmcl.ui.construct.DialogPane;
import org.jackhuang.hmcl.ui.construct.DialogCloseEvent;
import org.jackhuang.hmcl.ui.construct.RipplerContainer;
import org.jetbrains.annotations.Nullable;
import java.io.IOException;
import java.nio.file.Path;
import static org.jackhuang.hmcl.ui.FXUtils.onEscPressed;
import static org.jackhuang.hmcl.util.logging.Logger.LOG;
import static org.jackhuang.hmcl.util.i18n.I18n.i18n;
public class GameInstanceIconDialog extends DialogPane {
public class GameInstanceIconDialog extends JFXDialogLayout {
private final HMCLGameInstance gameInstance;
private final Runnable onFinish;
private final GameSettings.@Nullable Instance setting;
@@ -47,10 +51,9 @@ public class GameInstanceIconDialog extends DialogPane {
this.onFinish = onFinish;
this.setting = gameInstance.getSettingsOrCreate();
setTitle(i18n("settings.icon"));
FlowPane pane = new FlowPane();
setBody(pane);
setHeading(new Label(i18n("settings.icon")));
FlowPane pane = new FlowPane();
pane.getChildren().setAll(
createCustomIcon(),
createIcon(GameInstanceIconType.GRASS),
@@ -68,6 +71,14 @@ public class GameInstanceIconDialog extends DialogPane {
createIcon(GameInstanceIconType.FURNACE),
createIcon(GameInstanceIconType.QUILT)
);
setBody(pane);
JFXButton cancelButton = new JFXButton(i18n("button.cancel"));
cancelButton.getStyleClass().add("dialog-cancel");
cancelButton.setOnAction(event -> fireEvent(new DialogCloseEvent()));
onEscPressed(this, cancelButton::fire);
setActions(cancelButton);
}
private void exploreIcon() {
@@ -114,10 +125,9 @@ public class GameInstanceIconDialog extends DialogPane {
return container;
}
@Override
protected void onAccept() {
// Icon file / settings.iconProperty updates already invalidate iconImageProperty.
onFinish.run();
super.onAccept();
fireEvent(new DialogCloseEvent());
}
}
@@ -19,6 +19,7 @@ package org.jackhuang.hmcl.ui.instances;
import com.jfoenix.controls.JFXButton;
import com.jfoenix.controls.JFXListView;
import com.jfoenix.controls.JFXPopup;
import com.jfoenix.controls.JFXTextField;
import javafx.animation.PauseTransition;
import javafx.beans.binding.Bindings;
@@ -38,10 +39,7 @@ import javafx.scene.control.Skin;
import javafx.scene.control.SkinBase;
import javafx.scene.input.KeyCode;
import javafx.scene.input.KeyEvent;
import javafx.scene.layout.HBox;
import javafx.scene.layout.Priority;
import javafx.scene.layout.StackPane;
import javafx.scene.layout.VBox;
import javafx.scene.layout.*;
import javafx.util.Duration;
import org.jackhuang.hmcl.game.HMCLGameRepository;
import org.jackhuang.hmcl.game.ModpackHelper;
@@ -49,10 +47,7 @@ import org.jackhuang.hmcl.setting.GameDirectoryManager;
import org.jackhuang.hmcl.ui.*;
import org.jackhuang.hmcl.ui.animation.ContainerAnimations;
import org.jackhuang.hmcl.ui.animation.TransitionPane;
import org.jackhuang.hmcl.ui.construct.AdvancedListBox;
import org.jackhuang.hmcl.ui.construct.AdvancedListItem;
import org.jackhuang.hmcl.ui.construct.ComponentList;
import org.jackhuang.hmcl.ui.construct.SpinnerPane;
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.directory.GameDirectoryListItem;
@@ -84,6 +79,16 @@ public class GameListPage extends DecoratorAnimatedPage implements DecoratorPage
gameDirectoryListItems = MappedObservableList.create(GameDirectoryManager.getGameDirectories(), gameDirectory -> {
GameDirectoryListItem item = new GameDirectoryListItem(gameDirectory);
FXUtils.setLimitWidth(item, 200);
FXUtils.onSecondaryButtonClicked(item, () -> {
PopupMenu menu = new PopupMenu();
JFXPopup popup = new JFXPopup(menu);
menu.getContent().add(new IconedMenuItem(
SVG.EDIT,
i18n("button.edit"),
() -> Controllers.navigate(new GameDirectoryPage(gameDirectory)),
popup));
popup.show(item, JFXPopup.PopupVPosition.TOP, JFXPopup.PopupHPosition.LEFT, item.getWidth(), 0);
});
return item;
});
@@ -73,7 +73,9 @@ public final class GameListPopupMenu extends StackPane {
public static void show(Node owner, JFXPopup.PopupVPosition vAlign, JFXPopup.PopupHPosition hAlign,
double initOffsetX, double initOffsetY,
List<HMCLGameInstance> instances) {
showAndGetPopup(owner, vAlign, hAlign, initOffsetX, initOffsetY, instances);
if (!hideShowing(owner)) {
showAndGetPopup(owner, vAlign, hAlign, initOffsetX, initOffsetY, instances);
}
}
/// Shows and returns an instance selection popup relative to its owner.
@@ -117,9 +119,7 @@ public final class GameListPopupMenu extends StackPane {
Label placeholder = new Label(i18n("instance.empty"));
placeholder.setStyle("-fx-padding: 10px; -fx-text-fill: -monet-on-surface-variant; -fx-font-style: italic;");
FXUtils.onChangeAndOperate(isEmpty, empty -> {
getChildren().setAll(empty ? placeholder : listView);
});
FXUtils.onChangeAndOperate(isEmpty, empty -> getChildren().setAll(empty ? placeholder : listView));
}
public ObservableList<GameItem> getItems() {
@@ -102,15 +102,6 @@ public final class HMCLLocalizedDownloadListPage extends DownloadListPage {
}
}
@Override
protected SortType getBackedRemoteModRepositorySortOrder() {
if ("addon.modrinth".equals(downloadSource.get())) {
return SortType.NAME;
} else {
return SortType.POPULARITY;
}
}
@Override
public RemoteAddon.Type getType() {
return type;
@@ -66,8 +66,9 @@ public class InstallerListPage extends ListPageBase<InstallerItem> {
return new InstallerListPageSkin();
}
/// Rebuilds the component controls for the selected instance, or clears them if none is selected.
public void loadInstance(HMCLGameInstance.Optional instance) {
HMCLGameInstance gameInstance = instance.instance();
@Nullable HMCLGameInstance gameInstance = instance.instance();
this.gameInstance = gameInstance;
if (gameInstance == null) {
itemsProperty().clear();
@@ -103,7 +104,7 @@ public class InstallerListPage extends ListPageBase<InstallerItem> {
Controllers.getDecorator().startWizard(new UpdateInstallerWizardProvider(gameInstance, component.getComponentType(), libraryVersion));
});
component.setOnRemove(() -> repository.updateInstanceAsync(
component.setOnRemove(() -> repository.getDependency().updateInstanceAsync(
gameInstance.getId(),
publishedInstance -> repository.getDependency().removeComponentAsync(
publishedInstance,
@@ -123,7 +124,7 @@ public class InstallerListPage extends ListPageBase<InstallerItem> {
InstallerItem installerItem = new InstallerItem(mark.componentType(), InstallerItem.Style.LIST_ITEM);
installerItem.versionProperty().set(new InstallerItem.InstalledState(mark.version(), false, false));
installerItem.setOnRemove(() -> repository.updateInstanceAsync(
installerItem.setOnRemove(() -> repository.getDependency().updateInstanceAsync(
gameInstance.getId(),
publishedInstance -> repository.getDependency().removeComponentAsync(
publishedInstance,
@@ -148,13 +149,14 @@ public class InstallerListPage extends ListPageBase<InstallerItem> {
if (file != null) doInstallOffline(file);
}
/// Runs a local component installer for the current modifiable instance and displays its result.
private void doInstallOffline(Path file) {
if (gameInstance == null || !gameInstance.getManifest().isModifiable()) {
return;
}
HMCLGameRepository repository = gameInstance.getRepository();
Task<?> task = repository.updateInstanceAsync(
Task<?> task = repository.getDependency().updateInstanceAsync(
gameInstance.getId(),
publishedInstance -> repository.getDependency().installComponentLocalAsync(publishedInstance, file));
task.setName(i18n("install.installer.install_offline"));
@@ -23,7 +23,6 @@ import javafx.application.Platform;
import javafx.beans.binding.Bindings;
import javafx.beans.binding.DoubleBinding;
import javafx.beans.property.BooleanProperty;
import javafx.beans.property.ObjectProperty;
import javafx.beans.property.SimpleBooleanProperty;
import javafx.beans.value.ObservableValue;
import javafx.collections.ListChangeListener;
@@ -41,6 +40,7 @@ import javafx.scene.layout.Priority;
import javafx.scene.layout.StackPane;
import javafx.stage.FileChooser;
import javafx.util.Duration;
import org.jackhuang.hmcl.addon.AddonLoader;
import org.jackhuang.hmcl.addon.RemoteAddon;
import org.jackhuang.hmcl.addon.RemoteAddonRepository;
import org.jackhuang.hmcl.addon.repository.CurseForgeRemoteAddonRepository;
@@ -63,13 +63,13 @@ import org.jackhuang.hmcl.util.i18n.I18n;
import org.jackhuang.hmcl.util.io.CompressingUtils;
import org.jackhuang.hmcl.util.io.FileUtils;
import org.jackhuang.hmcl.util.io.NetworkUtils;
import org.jackhuang.hmcl.util.javafx.ItemPropertyAsyncCache;
import org.jackhuang.hmcl.util.versioning.GameVersionNumber;
import org.jetbrains.annotations.NotNullByDefault;
import org.jetbrains.annotations.Nullable;
import java.io.IOException;
import java.io.UncheckedIOException;
import java.lang.ref.SoftReference;
import java.lang.ref.WeakReference;
import java.nio.file.FileSystem;
import java.nio.file.Files;
@@ -598,13 +598,15 @@ public final class ModListPage extends ListPageBase<ModListPage.ModInfoObject> i
private final LocalModFile localModFile;
private final @Nullable ModTranslations.Mod modTranslations;
private SoftReference<CompletableFuture<Image>> iconCache;
private final ItemPropertyAsyncCache<Image, ModInfoObject> iconCache;
ModInfoObject(LocalModFile localModFile) {
this.localModFile = localModFile;
this.active = localModFile.activeProperty();
this.modTranslations = ModTranslations.MOD.getMod(localModFile.getId(), localModFile.getName());
this.iconCache = new ItemPropertyAsyncCache.Soft<>(this, this::loadIcon, this::getDefaultIcon);
}
public LocalModFile getModInfo() {
@@ -615,7 +617,10 @@ public final class ModListPage extends ListPageBase<ModListPage.ModInfoObject> i
return modTranslations;
}
@FXThread
private Image getDefaultIcon() {
return GameInstanceIconType.getIconType(this.localModFile.getModLoaderType()).getIcon();
}
private Image loadIcon() {
List<String> iconPaths = new ArrayList<>();
@@ -638,34 +643,7 @@ public final class ModListPage extends ListPageBase<ModListPage.ModInfoObject> i
LOG.warning("Failed to load mod icons", e);
}
return GameInstanceIconType.getIconType(this.localModFile.getModLoaderType()).getIcon();
}
public void loadIcon(ImageContainer imageContainer, @Nullable WeakReference<ObjectProperty<ModInfoObject>> current) {
SoftReference<CompletableFuture<Image>> iconCache = this.iconCache;
CompletableFuture<Image> imageFuture;
if (iconCache != null && (imageFuture = iconCache.get()) != null) {
Image image = imageFuture.getNow(null);
if (image != null) {
imageContainer.setImage(image);
return;
}
} else {
imageFuture = CompletableFuture.supplyAsync(this::loadIcon, Schedulers.io());
this.iconCache = new SoftReference<>(imageFuture);
}
imageContainer.setImage(GameInstanceIconType.getIconType(localModFile.getModLoaderType()).getIcon());
imageFuture.thenAcceptAsync(image -> {
if (current != null) {
ObjectProperty<ModInfoObject> infoObjectProperty = current.get();
if (infoObjectProperty == null || infoObjectProperty.get() != this) {
// The current ListCell has already switched to another object
return;
}
}
imageContainer.setImage(image);
}, Schedulers.javafx());
return getDefaultIcon();
}
}
@@ -682,9 +660,10 @@ public final class ModListPage extends ListPageBase<ModListPage.ModInfoObject> i
var imageContainer = new ImageContainer(40);
titleContainer.setAlignment(Pos.CENTER_LEFT);
modInfo.loadIcon(imageContainer, null);
modInfo.iconCache.attachValue(imageContainer.imageProperty(), null);
TwoLineListItem title = new TwoLineListItem();
title.getTitleLabel().setWrapText(true);
if (modInfo.getModTranslations() != null && I18n.isUseChinese())
title.setTitle(modInfo.getModTranslations().getDisplayName());
else
@@ -735,25 +714,12 @@ public final class ModListPage extends ListPageBase<ModListPage.ModInfoObject> i
if (versionOptional.isPresent()) {
RemoteAddon remoteAddon = repository.getAddonById(DownloadProviders.getDownloadProvider(), versionOptional.get().projectId());
FXUtils.runInFX(() -> {
for (ModLoaderType modLoaderType : versionOptional.get().loaders()) {
String loaderName = switch (modLoaderType) {
case FORGE -> i18n("install.installer.forge");
case CLEANROOM -> i18n("install.installer.cleanroom");
case LEGACY_FABRIC -> i18n("install.installer.legacyfabric");
case NEO_FORGE -> i18n("install.installer.neoforge");
case FABRIC -> i18n("install.installer.fabric");
case LITE_LOADER -> i18n("install.installer.liteloader");
case QUILT -> i18n("install.installer.quilt");
default -> null;
};
if (loaderName == null)
continue;
if (title.getTags()
.stream()
.noneMatch(it -> it.getText().equals(loaderName))) {
title.addTag(loaderName);
}
Set<String> tags = new LinkedHashSet<>();
for (AddonLoader loader : versionOptional.get().loaders()) {
String tag = I18n.translateLoaderName(loader);
if (tag != null) tags.add(tag);
}
title.addTagsIfNotExist(tags);
button.setExternalLink(remoteAddon.pageUrl());
button.setDisable(false);
@@ -856,7 +822,7 @@ public final class ModListPage extends ListPageBase<ModListPage.ModInfoObject> i
ModLoaderType modLoaderType = modInfo.getModLoaderType();
dataItem.loadIcon(imageContainer, new WeakReference<>(this.itemProperty()));
dataItem.iconCache.attachValue(imageContainer.imageProperty(), new WeakReference<>(this.itemProperty()));
String displayName = modInfo.getName();
if (modTranslations != null && I18n.isUseChinese()) {
@@ -892,15 +858,7 @@ public final class ModListPage extends ListPageBase<ModListPage.ModInfoObject> i
content.addTagWarning(i18n("mods.unknown"));
} else if (!page.supportedLoaders.contains(modLoaderType)) {
warning.add(i18n("mods.warning.loader_mismatch"));
switch (dataItem.getModInfo().getModLoaderType()) {
case FORGE -> content.addTagWarning(i18n("install.installer.forge"));
case LEGACY_FABRIC -> content.addTagWarning(i18n("install.installer.legacyfabric"));
case CLEANROOM -> content.addTagWarning(i18n("install.installer.cleanroom"));
case NEO_FORGE -> content.addTagWarning(i18n("install.installer.neoforge"));
case FABRIC -> content.addTagWarning(i18n("install.installer.fabric"));
case LITE_LOADER -> content.addTagWarning(i18n("install.installer.liteloader"));
case QUILT -> content.addTagWarning(i18n("install.installer.quilt"));
}
content.addTagWarning(I18n.translateLoaderType(dataItem.getModInfo().getModLoaderType()));
}
String modVersion = modInfo.getVersion();
@@ -57,14 +57,14 @@ import org.jackhuang.hmcl.ui.WeakListenerHolder;
import org.jackhuang.hmcl.ui.animation.ContainerAnimations;
import org.jackhuang.hmcl.ui.animation.TransitionPane;
import org.jackhuang.hmcl.ui.construct.*;
import org.jackhuang.hmcl.util.Pair;
import org.jackhuang.hmcl.util.StringUtils;
import org.jackhuang.hmcl.util.TaskCancellationAction;
import org.jackhuang.hmcl.util.*;
import org.jackhuang.hmcl.util.javafx.ItemPropertyAsyncCache;
import org.jackhuang.hmcl.util.versioning.GameVersionNumber;
import org.jetbrains.annotations.NotNullByDefault;
import org.jetbrains.annotations.Nullable;
import java.io.IOException;
import java.lang.ref.WeakReference;
import java.nio.file.Path;
import java.util.*;
import java.util.Objects;
@@ -494,13 +494,18 @@ public final class ResourcePackListPage extends ListPageBase<ResourcePackListPag
}
}
public static class ResourcePackInfoObject {
public static final class ResourcePackInfoObject {
private final ResourcePackFile file;
private final BooleanProperty enabled;
private final ItemPropertyAsyncCache<Image, ResourcePackInfoObject> iconCache;
public ResourcePackInfoObject(Pair<ResourcePackFile, Boolean> pair) {
this.file = pair.key();
this.enabled = new SimpleBooleanProperty(this, "enabled", pair.value());
this.iconCache = new ItemPropertyAsyncCache.Soft<>(this, this::loadIcon, this::getDefaultIcon);
}
public ResourcePackFile getFile() {
@@ -511,13 +516,16 @@ public final class ResourcePackListPage extends ListPageBase<ResourcePackListPag
return enabled;
}
Image getIcon() {
Image image = file.getIcon();
if (image == null || image.isError() || image.getWidth() <= 0 || image.getHeight() <= 0 ||
(Math.abs(image.getWidth() - image.getHeight()) >= 1)) {
image = FXUtils.newBuiltinImage("/assets/img/unknown_pack.png");
private Image getDefaultIcon() {
return FXUtils.newBuiltinImage("/assets/img/unknown_pack.png");
}
private Image loadIcon() {
Image icon = file.loadIcon();
if (icon != null && !icon.isError() && icon.getWidth() > 0 && icon.getHeight() > 0 && Math.abs(icon.getWidth() - icon.getHeight()) < 1) {
return icon;
}
return image;
return getDefaultIcon();
}
}
@@ -583,7 +591,7 @@ public final class ResourcePackListPage extends ListPageBase<ResourcePackListPag
if (empty || item == null) return;
ResourcePackFile file = item.getFile();
imageContainer.setImage(item.getIcon());
item.iconCache.attachValue(imageContainer.imageProperty(), new WeakReference<>(itemProperty()));
content.getTags().clear();
content.setTitle(file.getFileName());
@@ -623,7 +631,7 @@ public final class ResourcePackListPage extends ListPageBase<ResourcePackListPag
maxWidthProperty().bind(Controllers.getDecorator().contentWidthProperty().multiply(0.7));
ImageContainer imageContainer = new ImageContainer(40);
imageContainer.setImage(packInfoObject.getIcon());
packInfoObject.iconCache.attachValue(imageContainer.imageProperty(), null);
TwoLineListItem title = new TwoLineListItem();
title.setTitle(pack.getFileName());
@@ -435,7 +435,7 @@ public class PersonalizationPage extends StackPane {
LineSelectButton<String> brightnessPane = new LineSelectButton<>();
brightnessPane.setTitle(i18n("settings.launcher.brightness"));
brightnessPane.setConverter(name -> i18n("settings.launcher.brightness."
+ Objects.requireNonNullElse(name, "auto")));
+ Objects.requireNonNullElse(name, "auto").trim().toLowerCase(Locale.ROOT)));
brightnessPane.setItems(Arrays.asList("auto", "light", "dark"));
bindThemeAppearanceLineSelectButton(
brightnessPane,
@@ -37,10 +37,7 @@ import org.jackhuang.hmcl.ui.FXUtils;
import org.jackhuang.hmcl.ui.SVG;
import org.jackhuang.hmcl.ui.construct.*;
import org.jackhuang.hmcl.ui.construct.MessageDialogPane.MessageType;
import org.jackhuang.hmcl.upgrade.RemoteVersion;
import org.jackhuang.hmcl.upgrade.UpdateChannel;
import org.jackhuang.hmcl.upgrade.UpdateChecker;
import org.jackhuang.hmcl.upgrade.UpdateHandler;
import org.jackhuang.hmcl.upgrade.*;
import org.jackhuang.hmcl.util.Lang;
import org.jackhuang.hmcl.util.StringUtils;
import org.jackhuang.hmcl.util.i18n.I18n;
@@ -121,10 +118,18 @@ public final class SettingsPage extends ScrollPane {
updateButton.setManaged(outdated);
updatePane.pseudoClassStateChanged(PseudoClass.getPseudoClass("active"), outdated);
if (UpdateChecker.isOutdated()) {
if (outdated) {
lblUpdateSubProperty.set(i18n("update.newest_version", UpdateChecker.getLatestVersion().version()));
} else if (UpdateChecker.isCheckingUpdate()) {
lblUpdateSubProperty.set(i18n("update.checking"));
} else if (UpdateChecker.errorProperty().get() != null) {
Throwable t = UpdateChecker.errorProperty().get();
if (t instanceof SelfVerificationException) {
lblUpdateSubProperty.set(i18n("update.unverified"));
} else {
String msg = t.getClass().getSimpleName() + ": " + t.getLocalizedMessage();
lblUpdateSubProperty.set(i18n("update.check_failed", msg));
}
} else {
lblUpdateSubProperty.set(i18n("update.latest"));
}
@@ -132,6 +137,7 @@ public final class SettingsPage extends ScrollPane {
UpdateChecker.latestVersionProperty().addListener(new WeakInvalidationListener(updateListener));
UpdateChecker.outdatedProperty().addListener(new WeakInvalidationListener(updateListener));
UpdateChecker.checkingUpdateProperty().addListener(new WeakInvalidationListener(updateListener));
UpdateChecker.errorProperty().addListener(new WeakInvalidationListener(updateListener));
updateListener.invalidated(null);
}
@@ -28,6 +28,7 @@ import org.jackhuang.hmcl.ui.construct.TaskExecutorDialogPane;
import org.jackhuang.hmcl.util.SettingsMap;
import org.jackhuang.hmcl.util.StringUtils;
import org.jackhuang.hmcl.util.TaskCancellationAction;
import org.jetbrains.annotations.Nullable;
import java.util.Queue;
import java.util.concurrent.CancellationException;
@@ -41,9 +42,16 @@ public abstract class TaskExecutorDialogWizardDisplayer extends AbstractWizardDi
super(cancelQueue);
}
/// Displays a task and releases its optional resources after execution stops.
@Override
public void handleTask(SettingsMap settings, Task<?> task) {
@Nullable WizardProvider.TaskCleanup cleanup = settings.remove(WizardProvider.TaskCleanup.KEY);
TaskExecutorDialogPane pane = new TaskExecutorDialogPane(new TaskCancellationAction(it -> {
if (cleanup != null) {
// Keep the installation modal until onStop has released its repository draft.
it.setCancel(null);
return;
}
it.fireEvent(new DialogCloseEvent());
onEnd();
}));
@@ -61,24 +69,37 @@ public abstract class TaskExecutorDialogWizardDisplayer extends AbstractWizardDi
TaskExecutor executor = task.executor(new TaskListener() {
@Override
public void onStop(boolean success, TaskExecutor executor) {
@Nullable Exception failure = success ? null : executor.getException();
if (cleanup != null) {
try {
cleanup.cleanup();
} catch (Exception cleanupFailure) {
if (failure == null || failure instanceof CancellationException) {
failure = cleanupFailure;
} else if (failure != cleanupFailure) {
failure.addSuppressed(cleanupFailure);
}
}
}
@Nullable Exception completedFailure = failure;
runInFX(() -> {
if (success) {
if (success && completedFailure == null) {
if (settings.get("success_message") instanceof String successMessage)
Controllers.dialog(successMessage, null, MessageType.SUCCESS, () -> onEnd());
else if (!settings.containsKey("forbid_success_message"))
Controllers.dialog(i18n("message.success"), null, MessageType.SUCCESS, () -> onEnd());
} else {
if (executor.getException() == null) {
if (completedFailure == null) {
onEnd();
return;
}
if (executor.getException() instanceof CancellationException) {
if (completedFailure instanceof CancellationException) {
onEnd();
return;
}
if (executor.getException().getCause() instanceof OutOfMemoryError outOfMemoryError) {
if (completedFailure.getCause() instanceof OutOfMemoryError outOfMemoryError) {
try {
Controllers.dialog(StringUtils.getStackTrace(outOfMemoryError), null, MessageType.ERROR, () -> onEnd());
} catch (OutOfMemoryError ignored) {
@@ -87,9 +108,9 @@ public abstract class TaskExecutorDialogWizardDisplayer extends AbstractWizardDi
return;
}
String appendix = StringUtils.getStackTrace(executor.getException());
String appendix = StringUtils.getStackTrace(completedFailure);
if (settings.get(WizardProvider.FailureCallback.KEY) != null)
settings.get(WizardProvider.FailureCallback.KEY).onFail(settings, executor.getException(), () -> onEnd());
settings.get(WizardProvider.FailureCallback.KEY).onFail(settings, completedFailure, () -> onEnd());
else if (settings.get("failure_message") instanceof String failureMessage)
Controllers.dialog(appendix, failureMessage, MessageType.ERROR, () -> onEnd());
else if (!settings.containsKey("forbid_failure_message"))
@@ -19,6 +19,7 @@ package org.jackhuang.hmcl.ui.wizard;
import javafx.scene.Node;
import org.jackhuang.hmcl.util.SettingsMap;
import org.jetbrains.annotations.NotNullByDefault;
public interface WizardProvider {
@@ -39,4 +40,20 @@ public interface WizardProvider {
void onFail(SettingsMap settings, Exception exception, Runnable next);
}
/// Releases resources owned by a task displayed by [TaskExecutorDialogWizardDisplayer].
///
/// Cleanup runs on the executor's completion thread after task execution stops, including
/// cancellation before the first task starts, and before the dialog reports its outcome.
@NotNullByDefault
@FunctionalInterface
interface TaskCleanup {
/// Optional cleanup consumed by the task dialog when it accepts the task.
SettingsMap.Key<TaskCleanup> KEY = new SettingsMap.Key<>("task_cleanup");
/// Releases the completed task's resources.
///
/// @throws Exception if cleanup fails; the task dialog reports the failure
void cleanup() throws Exception;
}
}
@@ -0,0 +1,28 @@
/*
* 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.upgrade;
import java.io.IOException;
public class SelfVerificationException extends IOException {
public SelfVerificationException() {
super("Self verification failed");
}
}
@@ -25,6 +25,7 @@ import javafx.beans.value.ObservableBooleanValue;
import org.jackhuang.hmcl.Metadata;
import org.jackhuang.hmcl.util.io.NetworkUtils;
import org.jackhuang.hmcl.util.versioning.VersionNumber;
import org.jetbrains.annotations.Nullable;
import java.io.IOException;
import java.util.LinkedHashMap;
@@ -54,6 +55,7 @@ public final class UpdateChecker {
},
latestVersion);
private static final ReadOnlyBooleanWrapper checkingUpdate = new ReadOnlyBooleanWrapper(false);
private static final ReadOnlyObjectWrapper<@Nullable Throwable> error = new ReadOnlyObjectWrapper<>();
public static void init() {
requestCheckUpdate(UpdateChannel.getChannel(), settings().acceptPreviewUpdateProperty().get());
@@ -83,9 +85,13 @@ public final class UpdateChecker {
return checkingUpdate.getReadOnlyProperty();
}
public static ReadOnlyObjectProperty<@Nullable Throwable> errorProperty() {
return error.getReadOnlyProperty();
}
private static RemoteVersion checkUpdate(UpdateChannel channel, boolean preview) throws IOException {
if (!IntegrityChecker.DISABLE_SELF_INTEGRITY_CHECK && !IntegrityChecker.isSelfVerified()) {
throw new IOException("Self verification failed");
throw new SelfVerificationException();
}
var query = new LinkedHashMap<String, String>();
@@ -109,16 +115,23 @@ public final class UpdateChecker {
thread(() -> {
RemoteVersion result = null;
Throwable t = null;
try {
result = checkUpdate(channel, preview);
LOG.info("Latest version (" + channel + ", preview=" + preview + ") is " + result);
} catch (Throwable e) {
t = e;
LOG.warning("Failed to check for update", e);
}
Throwable throwable = t;
RemoteVersion finalResult = result;
Platform.runLater(() -> {
if (finalResult != null) {
if (throwable != null) {
latestVersion.set(null);
error.set(throwable);
} else {
error.set(null);
latestVersion.set(finalResult);
}
checkingUpdate.set(false);
@@ -172,7 +172,7 @@ public final class UpdateHandler {
Path self = getCurrentLocation();
if (!IntegrityChecker.DISABLE_SELF_INTEGRITY_CHECK && !IntegrityChecker.isSelfVerified()) {
throw new IOException("Self verification failed");
throw new SelfVerificationException();
}
ExecutableHeaderHelper.copyWithHeader(self, target);
@@ -107,7 +107,7 @@ public final class NativePatcher {
.filter(library -> {
if (library.classifier() != null && library.classifier().startsWith("natives")
&& "org.lwjgl".equals(library.groupId())) {
if ((useNativeGLFWorSDL && ("lwjgl-glfw".equals(library.artifactId()) || library.artifactId().contains("sdl")))
if ((useNativeGLFWorSDL && ("lwjgl-glfw".equals(library.artifactId()) || "lwjgl-sdl".equals(library.artifactId())))
|| (useNativeOpenAL && "lwjgl-openal".equals(library.artifactId()))) {
LOG.info("Filter out " + library.name());
return false;
@@ -17,8 +17,12 @@
*/
package org.jackhuang.hmcl.util.i18n;
import org.jackhuang.hmcl.addon.AddonLoader;
import org.jackhuang.hmcl.addon.AddonLoaderType;
import org.jackhuang.hmcl.addon.mod.ModLoaderType;
import org.jackhuang.hmcl.download.ComponentRemoteVersion;
import org.jackhuang.hmcl.download.game.GameRemoteVersion;
import org.jackhuang.hmcl.util.StringUtils;
import org.jackhuang.hmcl.util.i18n.translator.Translator;
import org.jackhuang.hmcl.util.versioning.GameVersionNumber;
import org.jetbrains.annotations.Nullable;
@@ -124,6 +128,30 @@ public final class I18n {
return MinecraftWiki.getWikiLink(locale, remoteVersion);
}
public static String translateLoaderType(AddonLoaderType loaderType) {
if (loaderType instanceof ModLoaderType modLoaderType) {
return switch (modLoaderType) {
case FORGE -> i18n("install.installer.forge");
case CLEANROOM -> i18n("install.installer.cleanroom");
case NEO_FORGE -> i18n("install.installer.neoforge");
case FABRIC -> i18n("install.installer.fabric");
case LITE_LOADER -> i18n("install.installer.liteloader");
case QUILT -> i18n("install.installer.quilt");
case LEGACY_FABRIC -> i18n("install.installer.legacyfabric");
default -> modLoaderType.displayName();
};
}
return loaderType.displayName();
}
public static String translateLoaderName(AddonLoader loader) {
if (loader.type() != null)
return translateLoaderType(loader.type());
else return "bungeecord".equalsIgnoreCase(loader.name())
? "BungeeCord"
: StringUtils.capitalizeWords(loader.name());
}
public static boolean hasKey(String key) {
return getResourceBundle().containsKey(key);
}
@@ -745,6 +745,7 @@
.jfx-tool-bar-button {
-fx-text-fill: -monet-on-surface;
-fx-font-size: 14px;
-fx-toggle-icon4-size: 37px;
-fx-pref-height: -fx-toggle-icon4-size;
-fx-max-height: -fx-toggle-icon4-size;
@@ -190,6 +190,11 @@ addon.download.recommend=Recommended Version for Minecraft %1s
addon.download.title.release=Minecraft %s
addon.download.title.snapshot=Minecraft %s (Snapshots)
addon.modrinth=Modrinth
addon.sort.date_created=Date Created
addon.sort.last_updated=Last Updated
addon.sort.popularity=Popularity
addon.sort.relevancy=Relevancy
addon.sort.total_downloads=Total Downloads
archive.author=Author(s)
archive.date=Publish Date
@@ -371,13 +376,6 @@ curse.category.6553=Realistic
curse.category.6554=Fantasy
curse.category.6555=Vanilla
curse.sort.author=Author
curse.sort.date_created=Date Created
curse.sort.last_updated=Last Updated
curse.sort.name=Name
curse.sort.popularity=Popularity
curse.sort.total_downloads=Total Downloads
datetime.format=MMM d, yyyy, h\:mm\:ss a
download=Download
@@ -433,32 +431,32 @@ extension.resourcepack=Resource Pack Archive
extension.schematic=Schematic File
extension.world=World Archive
fatal.create_hmcl_current_directory_failure=Hello Minecraft! Launcher cannot create the HMCL directory (%s). Please move HMCL to another location and reopen it.
fatal.create_hmcl_current_directory_failure=HMCL cannot create the HMCL directory (%s). Please move HMCL to another location and reopen it.
fatal.javafx.incomplete=The JavaFX environment is incomplete.\n\
Please try replacing your Java or reinstalling OpenJFX.
fatal.javafx.missing=Missing JavaFX environment. Please open Hello Minecraft! Launcher with Java, which includes OpenJFX.
fatal.config_change_owner_root=You are using the root account to open Hello Minecraft! Launcher. This may prevent you from opening HMCL with another account in the future.\n\
fatal.javafx.missing=Missing JavaFX environment. Please open HMCL with Java, which includes OpenJFX.
fatal.config_change_owner_root=You are using the root account to open HMCL. This may prevent you from opening HMCL with another account in the future.\n\
Do you still want to continue?
fatal.config_in_temp_dir=You are opening Hello Minecraft! Launcher in a temporary directory. Your settings and game data may be lost.\n\
fatal.config_in_temp_dir=You are opening HMCL in a temporary directory. Your settings and game data may be lost.\n\
It is recommended to move HMCL to another location and reopen it.\n\
Do you still want to continue?
fatal.config_loading_failure=Cannot load configuration files.\n\
Please make sure that Hello Minecraft! Launcher has read and write access to "%s" and the files in it.\n\
Please make sure that HMCL has read and write access to "%s" and the files in it.\n\
For macOS, try putting HMCL somewhere with permissions other than "Desktop", "Downloads", and "Documents" and try again.
fatal.config_loading_failure.unix=Hello Minecraft! Launcher could not load the configuration file because it was created by user "%1$s".\n\
fatal.config_loading_failure.unix=HMCL could not load the configuration file because it was created by user "%1$s".\n\
Please open HMCL as root user (not recommended), or execute the following command in the terminal to change the ownership of the configuration file to the current user:\n%2$s
fatal.config_unsupported_version=The current configuration file was created by a newer version of Hello Minecraft! Launcher, and this version of HMCL cannot load it properly.\n\
fatal.config_unsupported_version=The current configuration file was created by a newer version of HMCL, and this version of HMCL cannot load it properly.\n\
Please update and restart HMCL.\n\
Before updating the launcher, any settings you modify will not be saved.
fatal.mac_app_translocation=Hello Minecraft! Launcher is isolated to a temporary directory by the OS due to macOS security mechanisms.\n\
fatal.mac_app_translocation=HMCL is isolated to a temporary directory by the OS due to macOS security mechanisms.\n\
Please move HMCL to a different directory before attempting to open. Otherwise, your settings and game data may be lost after restarting.\n\
Do you still want to continue?
fatal.migration_requires_manual_reboot=Hello Minecraft! Launcher has been upgraded. Please restart the launcher.
fatal.apply_update_failure=We are sorry, but Hello Minecraft! Launcher is unable to update automatically.\n\
fatal.migration_requires_manual_reboot=HMCL has been upgraded. Please restart the launcher.
fatal.apply_update_failure=We are sorry, but HMCL is unable to update automatically.\n\
\n\
You can update manually by downloading a newer launcher version from %s.\n\
If the problem persists, please consider reporting this to us.
fatal.apply_update_need_win7=Hello Minecraft! Launcher cannot automatically update on Windows XP/Vista.\n\
fatal.apply_update_need_win7=HMCL cannot automatically update on Windows XP/Vista.\n\
\n\
You can update manually by downloading a newer launcher version from %s.
fatal.deprecated_java_version=HMCL will require Java 17 or later to run in the future, but will still support launching games with Java 6~16.\n\
@@ -467,14 +465,14 @@ It is recommended to install the latest version of Java to ensure that HMCL work
\n\
You can continue to keep the old version of Java. HMCL can recognize and manage multiple Java versions and will automatically select the appropriate Java for you based on the game version.
fatal.deprecated_java_version.download_link=Download Java %d
fatal.samba=If you opened Hello Minecraft! Launcher from a Samba network drive, some features might not be working. Please try updating your Java or moving the launcher to another directory.
fatal.samba=If you opened HMCL from a Samba network drive, some features might not be working. Please try updating your Java or moving the launcher to another directory.
fatal.illegal_char=Your working directory contains an illegal character "=". You will not be able to use authlib-injector or change the skin of your offline account.
fatal.unsupported_platform=Minecraft is not fully supported on your platform yet, so you may experience missing features or even be unable to launch the game.\n\
\n\
If you cannot launch Minecraft 1.17 and later, you can try switching the "Renderer" to "Mesa LLVMpipe" or "Mesa Lavapipe" in "Global/Instance-specific Settings → Graphics Settings" to use CPU rendering for better compatibility.
fatal.unsupported_platform.loongarch=Hello Minecraft! Launcher has provided support for the Loongson platform.\n\
fatal.unsupported_platform.loongarch=HMCL has provided support for the Loongson platform.\n\
If you encounter problems when playing a game, you can visit https://docs.hmcl.net/groups.html for help.
fatal.unsupported_platform.windows_arm64=Hello Minecraft! Launcher has provided native support for the Windows on Arm platform. If you encounter problems when playing a game, please try launching the game with Java based on x86 architecture.\n\
fatal.unsupported_platform.windows_arm64=HMCL has provided native support for the Windows on Arm platform. If you encounter problems when playing a game, please try launching the game with Java based on x86 architecture.\n\
\n\
If you are using the <b>Qualcomm</b> platform, you may need to install the <a href="ms-windows-store://pdp/?productid=9NQPSL29BFFF">OpenGL Compatibility Pack</a> before playing games.\n\
Click the link to navigate to the Microsoft Store and install the compatibility pack.
@@ -735,7 +733,7 @@ game_directory.use_relative_path=Use a relative path for the game directory if p
game_directory.root=Using the disk root directory as the game folder may cause the game to fail to launch and will create multiple files and folders in the disk root directory.\n\nAre you sure you want to continue?
help=Help
help.doc=Hello Minecraft! Launcher Documentation
help.doc=HMCL Documentation
help.detail=For data pack and modpack makers.
input.email=The username must be an email address.
@@ -954,9 +952,9 @@ launcher.cache_directory.default=Default ("%APPDATA%/.minecraft" or "~/.minecraf
launcher.cache_directory.disabled=Disabled
launcher.cache_directory.invalid=Failed to create a cache directory, falling back to default.
launcher.contact=Contact Us
launcher.crash=Hello Minecraft! Launcher has encountered a fatal error! Please copy the following log and ask for help on our Discord, QQ group, GitHub, or other Minecraft forum.
launcher.crash.java_internal_error=Hello Minecraft! Launcher has encountered a fatal error because your Java is corrupted. Please uninstall your Java and download a suitable Java <a href="https://bell-sw.com/pages/downloads/#downloads">here</a>.
launcher.crash.hmcl_out_dated=Hello Minecraft! Launcher has encountered a fatal error! Your launcher is outdated. Please update your launcher!
launcher.crash=HMCL has encountered a fatal error! Please copy the following log and ask for help on our Discord, QQ group, GitHub, or other Minecraft forum.
launcher.crash.java_internal_error=HMCL has encountered a fatal error because your Java is corrupted. Please uninstall your Java and download a suitable Java <a href="https://bell-sw.com/pages/downloads/#downloads">here</a>.
launcher.crash.hmcl_out_dated=HMCL has encountered a fatal error! Your launcher is outdated. Please update your launcher!
launcher.update_java=Please update your Java version.
libraries.download=Downloading Libraries
@@ -1038,11 +1036,11 @@ modpack.type.curse.error=Failed to download dependencies. Please try again or us
modpack.type.curse.not_found=Some dependencies are no longer available. Please try installing a newer modpack version.
modpack.type.manual.warning=The modpack is manually packaged by the publisher, which may already contain a launcher. It is recommended to try extracting the modpack and running the game with its own launcher. HMCL can still import it, with no guarantee of its usability. Still continue?
modpack.type.mcbbs=MCBBS
modpack.type.mcbbs.export=Can be imported by Hello Minecraft! Launcher
modpack.type.mcbbs.export=Can be imported by HMCL
modpack.type.modrinth=Modrinth
modpack.type.modrinth.export=Can be imported by popular third-party launchers
modpack.type.multimc=MultiMC
modpack.type.multimc.export=Can be imported by Hello Minecraft! Launcher and MultiMC
modpack.type.multimc.export=Can be imported by HMCL and MultiMC
modpack.type.server=Auto-Update Modpack from Server
modpack.type.server.export=Allows server owner to remotely update the game instance
modpack.type.server.malformed=Invalid modpack manifest. Please contact the modpack maker to resolve this problem.
@@ -1785,6 +1783,7 @@ update.channel.nightly.hint=You are currently using a Nightly channel build of t
update.channel.nightly.title=Nightly Channel Notice
update.channel.stable=Stable
update.checking=Checking for updates
update.check_failed=Failed to check for update. %s
update.disable_auto_show_update_dialog=Do not show update dialog automatically
update.disable_auto_show_update_dialog.subtitle=Enable this option to prevent HMCL from automatically showing the update dialog.
update.failed=Failed to update
@@ -1798,6 +1797,7 @@ update.latest=This is the latest version
update.tooltip=Update
update.preview=Preview HMCL releases early
update.preview.subtitle=Enable this option to receive new versions of HMCL early for testing before their official release.
update.unverified=Update unavailable due to this launcher instance not verified
warning.java_interpreted_mode=HMCL is running in an interpreted Java environment, which will greatly affect performance.\n\
\n\
@@ -47,6 +47,8 @@ about.thanks_to.shulkersakura.statement=لتوفير الشعار الخاص ب
about.thanks_to.users=أعضاء مجموعة مستخدمي HMCL
about.thanks_to.users.statement=شكراً على التبرعات وتقارير الأخطاء وغير ذلك.
about.thanks_to.yushijinhun.statement=لتوفير الدعم المتعلق بـ authlib-injector.
# about.thanks_to.8mi-tech=
# about.thanks_to.8mi-tech.statement=
about.open_source=المصدر المفتوح
about.open_source.statement=GPL v3 (https://github.com/HMCL-dev/HMCL)
@@ -76,12 +78,14 @@ account.failed.server_response_malformed=استجابة الخادم غير صا
account.failed.ssl=حدث خطأ SSL أثناء الاتصال بالخادم. يُرجى محاولة تحديث Java.
account.failed.dns=حدث خطأ SSL أثناء الاتصال بالخادم. قد يكون تحليل DNS غير صحيح. يُرجى تغيير خادم DNS الخاص بك أو استخدام خدمة وكيل.
account.failed.wrong_account=لقد سجّلت الدخول إلى حساب خاطئ.
# account.storage.read_only=
account.injector.add=خادم مصادقة جديد
account.injector.empty=لا يوجد (يمكنك النقر على "+" لإضافة واحد)
account.injector.http=تحذير: يستخدم هذا الخادم بروتوكول HTTP غير الآمن. أي شخص يعترض اتصالك سيتمكن من رؤية بياناتك بنص واضح.
account.injector.link.homepage=الصفحة الرئيسية
account.injector.link.register=التسجيل
account.injector.server=خادم المصادقة
# account.injector.server.storage.read_only=
account.injector.server_url=رابط الخادم
account.injector.server_name=اسم الخادم
account.login=تسجيل الدخول
@@ -103,6 +107,7 @@ account.methods.microsoft.close_page=اكتمل تفويض حساب Microsoft.\n
account.methods.microsoft.error.add_family=يُرجى النقر <a href="https://support.microsoft.com/account-billing/837badbc-999e-54d2-2617-d19206b9540a">هنا</a> لتغيير تاريخ ميلاد حسابك ليكون فوق 18 عاماً، أو إضافة حسابك إلى عائلة.
account.methods.microsoft.error.country_unavailable=XBOX Live غير متاح في بلدك/منطقتك الحالية.
account.methods.microsoft.error.missing_xbox_account=لا يوجد حساب XBOX مرتبط بحساب Microsoft الخاص بك بعد. يُرجى النقر <a href="https://www.minecraft.net/msaprofile/mygames/editprofile">هنا</a> لربط واحد.
# account.methods.microsoft.error.no_license=
account.methods.microsoft.error.no_character=يُرجى التأكد من أنك اشتريت Minecraft: Java Edition.\n\
إذا اشتريته بالفعل، فقد لا يكون ملف اللعبة قد تم إنشاؤه. يُرجى النقر <a href="https://www.minecraft.net/msaprofile/mygames/editprofile">هنا</a> لإنشاء ملف اللعبة.
account.methods.microsoft.error.banned=قد يكون حسابك محظوراً من XBOX Live.\n\
@@ -112,6 +117,7 @@ account.methods.microsoft.error.wrong_verify_method=فشل تسجيل الدخو
account.methods.microsoft.hint=انقر على زر "تسجيل الدخول" لبدء إضافة حساب Microsoft الخاص بك.
account.methods.microsoft.methods.device=تسجيل الدخول برمز QR
account.methods.microsoft.methods.device.hint=امسح رمز QR أو زر <a href="%s">%s</a> لإتمام تسجيل الدخول، وأدخل <b>%s</b> في الصفحة المفتوحة.
# account.methods.microsoft.methods.device.hint.completed=
account.methods.microsoft.methods.browser=تسجيل الدخول عبر المتصفح
account.methods.microsoft.methods.browser.hint=انقر على زر "تسجيل الدخول" أو <a href="%s">انسخ الرابط</a> والصقه في المتصفح لتسجيل الدخول.
account.methods.microsoft.manual=<b>إذا كان اتصالك بالإنترنت ضعيفاً، قد يتسبب ذلك في بطء تحميل صفحات الويب أو فشلها كلياً.\nيمكنك المحاولة لاحقاً أو التبديل إلى اتصال إنترنت مختلف.</b>
@@ -157,9 +163,12 @@ account.skin.invalid_skin=ملف المظهر غير صالح.
account.username=اسم المستخدم
addon.category=الفئة
# addon.changelog=
# addon.changelog.empty=
addon.channel.alpha=ألفا
addon.channel.beta=بيتا
addon.channel.release=إصدار رسمي
# addon.check_update=
addon.check_update.button=تحديث
addon.check_update.confirm=تحديث
addon.check_update.current_version=الإصدار الحالي
@@ -170,7 +179,23 @@ addon.check_update.file=الملف
addon.check_update.source=المصدر
addon.check_update.target_version=الإصدار المستهدف
addon.curseforge=CurseForge
# addon.dependency.embedded=
# addon.dependency.optional=
# addon.dependency.required=
# addon.dependency.tool=
# addon.dependency.include=
# addon.dependency.incompatible=
# addon.dependency.broken=
# addon.dependencies.has_broken=
# addon.download.recommend=
# addon.download.title.release=
# addon.download.title.snapshot=
addon.modrinth=Modrinth
addon.sort.date_created=تاريخ الإنشاء
addon.sort.last_updated=آخر تحديث
addon.sort.popularity=الشعبية
# addon.sort.relevancy=
addon.sort.total_downloads=إجمالي التنزيلات
archive.author=المؤلف/المؤلفون
archive.date=تاريخ النشر
@@ -184,6 +209,7 @@ assets.index.malformed=ملفات فهرس الأصول المنزّلة تال
button.cancel=إلغاء
button.change_source=تغيير مصدر التنزيل
button.clear=مسح
# button.copy=
button.copy_and_exit=نسخ والخروج
button.delete=حذف
button.disable=تعطيل
@@ -242,6 +268,8 @@ curse.category.4472=تقنية
curse.category.4473=سحر
curse.category.5128=Vanilla+
curse.category.7418=رعب
# curse.category.9243=
# curse.category.10683=
# https://addons-ecs.forgesvc.net/api/v2/category/section/6
curse.category.5299=تعليم
@@ -267,6 +295,9 @@ curse.category.419=سحر
curse.category.412=تكنولوجيا
curse.category.4557=ريدستون
curse.category.428=Tinker's Construct
# curse.category.8937=
# curse.category.9026=
# curse.category.10775=
# '
curse.category.414=نقل اللاعب
curse.category.4486=Lucky Blocks
@@ -299,6 +330,8 @@ curse.category.4558=ريدستون
curse.category.4843=أتمتة
curse.category.4906=MCreator
curse.category.7669=Twilight Forest
# curse.category.9049=
# curse.category.10754=
# https://addons-ecs.forgesvc.net/api/v2/category/section/12
curse.category.5244=حزم خطوط
@@ -317,6 +350,7 @@ curse.category.404=متحرك
curse.category.4465=دعم المودات
curse.category.402=قرون وسطى
curse.category.401=عصري
# curse.category.8939=
# https://addons-ecs.forgesvc.net/api/v2/category/section/17
curse.category.4464=عالم المودات
@@ -340,12 +374,9 @@ curse.category.4550=مهام
curse.category.4555=توليد العالم
curse.category.4552=سكريبتات
curse.sort.author=المؤلف
curse.sort.date_created=تاريخ الإنشاء
curse.sort.last_updated=آخر تحديث
curse.sort.name=الاسم
curse.sort.popularity=الشعبية
curse.sort.total_downloads=إجمالي التنزيلات
# curse.category.6553=
# curse.category.6554=
# curse.category.6555=
datetime.format=MMM d, yyyy, h\:mm\:ss a
@@ -358,9 +389,16 @@ download.failed.empty=لا توجد إصدارات متاحة. انقر هنا
download.failed.no_code=فشل التنزيل
download.failed.refresh=فشل في جلب قائمة الإصدارات. يرجى النقر هنا لإعادة المحاولة.
download.game=New Game
# download.provider.bmclapi=
# download.provider.bmclapi.desc=
# download.provider.mojang=
# download.provider.mojang.desc=
download.provider.official=من المصادر الرسمية
# download.provider.official.desc=
download.provider.balanced=من أسرع المصادر المتاحة
# download.provider.balanced.desc=
download.provider.mirror=من مرآة
# download.provider.mirror.desc=
download.java=جارٍ تنزيل Java
download.java.process=عملية تنزيل Java
download.javafx=جارٍ تنزيل مكتبات المشغّل...
@@ -395,32 +433,32 @@ extension.resourcepack=أرشيف حزمة الموارد
extension.schematic=ملف مخطط
extension.world=أرشيف العالم
fatal.create_hmcl_current_directory_failure=لا يستطيع Hello Minecraft! Launcher إنشاء مجلد HMCL (%s). يُرجى نقل HMCL إلى موقع آخر وإعادة تشغيله.
fatal.create_hmcl_current_directory_failure=لا يستطيع HMCL إنشاء مجلد HMCL (%s). يُرجى نقل HMCL إلى موقع آخر وإعادة تشغيله.
fatal.javafx.incomplete=بيئة JavaFX غير مكتملة.\n\
يُرجى محاولة استبدال Java أو إعادة تثبيت OpenJFX.
fatal.javafx.missing=بيئة JavaFX مفقودة. يُرجى فتح Hello Minecraft! Launcher باستخدام Java الذي يتضمن OpenJFX.
fatal.config_change_owner_root=أنت تستخدم حساب الجذر لفتح Hello Minecraft! Launcher. قد يمنعك ذلك من فتح HMCL بحساب آخر في المستقبل.\n\
fatal.javafx.missing=بيئة JavaFX مفقودة. يُرجى فتح HMCL باستخدام Java الذي يتضمن OpenJFX.
fatal.config_change_owner_root=أنت تستخدم حساب الجذر لفتح HMCL. قد يمنعك ذلك من فتح HMCL بحساب آخر في المستقبل.\n\
هل تريد المتابعة؟
fatal.config_in_temp_dir=أنت تفتح Hello Minecraft! Launcher في مجلد مؤقت. قد تُفقد إعداداتك وبيانات اللعبة.\n\
fatal.config_in_temp_dir=أنت تفتح HMCL في مجلد مؤقت. قد تُفقد إعداداتك وبيانات اللعبة.\n\
يُنصح بنقل HMCL إلى موقع آخر وإعادة تشغيله.\n\
هل تريد المتابعة؟
fatal.config_loading_failure=لا يمكن تحميل ملفات الإعدادات.\n\
يُرجى التأكد من أن Hello Minecraft! Launcher يملك صلاحيات القراءة والكتابة على "%s" والملفات الموجودة فيه.\n\
يُرجى التأكد من أن HMCL يملك صلاحيات القراءة والكتابة على "%s" والملفات الموجودة فيه.\n\
لمستخدمي macOS، جرّب وضع HMCL في موقع بصلاحيات غير "سطح المكتب" و"التنزيلات" و"المستندات" وأعد المحاولة.
fatal.config_loading_failure.unix=لا يستطيع Hello Minecraft! Launcher تحميل ملف الإعدادات لأنه أُنشئ بواسطة المستخدم "%1$s".\n\
fatal.config_loading_failure.unix=لا يستطيع HMCL تحميل ملف الإعدادات لأنه أُنشئ بواسطة المستخدم "%1$s".\n\
يُرجى فتح HMCL كمستخدم جذر (غير موصى به)، أو تنفيذ الأمر التالي في الطرفية لتغيير ملكية ملف الإعدادات إلى المستخدم الحالي:\n%2$s
fatal.config_unsupported_version=ملف الإعدادات الحالي أُنشئ بواسطة إصدار أحدث من Hello Minecraft! Launcher، ولا يستطيع هذا الإصدار من HMCL تحميله بشكل صحيح.\n\
fatal.config_unsupported_version=ملف الإعدادات الحالي أُنشئ بواسطة إصدار أحدث من HMCL، ولا يستطيع هذا الإصدار من HMCL تحميله بشكل صحيح.\n\
يُرجى تحديث HMCL وإعادة تشغيله.\n\
قبل تحديث المشغّل، لن يتم حفظ أي إعدادات تقوم بتعديلها.
fatal.mac_app_translocation=تم عزل Hello Minecraft! Launcher في مجلد مؤقت بواسطة نظام التشغيل بسبب آليات أمان macOS.\n\
fatal.mac_app_translocation=تم عزل HMCL في مجلد مؤقت بواسطة نظام التشغيل بسبب آليات أمان macOS.\n\
يُرجى نقل HMCL إلى مجلد آخر قبل محاولة الفتح. وإلا، قد تُفقد إعداداتك وبيانات اللعبة بعد إعادة التشغيل.\n\
هل تريد المتابعة؟
fatal.migration_requires_manual_reboot=تم ترقية Hello Minecraft! Launcher. يُرجى إعادة تشغيل المشغّل.
fatal.apply_update_failure=نأسف، لكن Hello Minecraft! Launcher غير قادر على التحديث التلقائي.\n\
fatal.migration_requires_manual_reboot=تم ترقية HMCL. يُرجى إعادة تشغيل المشغّل.
fatal.apply_update_failure=نأسف، لكن HMCL غير قادر على التحديث التلقائي.\n\
\n\
يمكنك التحديث يدوياً بتنزيل إصدار أحدث من المشغّل من %s.\n\
إذا استمرت المشكلة، يُرجى إرسال تقرير عنها إلينا.
fatal.apply_update_need_win7=لا يستطيع Hello Minecraft! Launcher التحديث التلقائي على Windows XP/Vista.\n\
fatal.apply_update_need_win7=لا يستطيع HMCL التحديث التلقائي على Windows XP/Vista.\n\
\n\
يمكنك التحديث يدوياً بتنزيل إصدار أحدث من المشغّل من %s.
fatal.deprecated_java_version=سيتطلب HMCL Java 17 أو أحدث للتشغيل في المستقبل، لكنه سيستمر في دعم تشغيل الألعاب باستخدام Java 6~16.\n\
@@ -429,23 +467,25 @@ fatal.deprecated_java_version=سيتطلب HMCL Java 17 أو أحدث للتشغ
\n\
يمكنك الاحتفاظ بإصدار Java القديم. يستطيع HMCL التعرف على إصدارات Java المتعددة وإدارتها وسيختار تلقائياً Java المناسب بناءً على إصدار اللعبة.
fatal.deprecated_java_version.download_link=تنزيل Java %d
fatal.samba=إذا فتحت Hello Minecraft! Launcher من محرك أقراص شبكة Samba، قد لا تعمل بعض الميزات. يُرجى محاولة تحديث Java أو نقل المشغّل إلى مجلد آخر.
fatal.samba=إذا فتحت HMCL من محرك أقراص شبكة Samba، قد لا تعمل بعض الميزات. يُرجى محاولة تحديث Java أو نقل المشغّل إلى مجلد آخر.
fatal.illegal_char=مسار المستخدم الخاص بك يحتوي على حرف غير مسموح به "=". لن تتمكن من استخدام authlib-injector أو تغيير مظهر حسابك غير المتصل.
fatal.unsupported_platform=لا يدعم Minecraft منصتك الحالية بشكل كامل بعد، لذا قد تواجه ميزات مفقودة أو عدم القدرة على تشغيل اللعبة.\n\
\n\
إذا لم تتمكن من تشغيل Minecraft 1.17 أو أحدث، يمكنك محاولة تغيير "المُصيِّر" إلى "Mesa LLVMpipe" في "الإعدادات العامة/الخاصة بالنسخة ← الإعدادات المتقدمة" لاستخدام معالجة المعالج المركزي لتوافق أفضل.
fatal.unsupported_platform.loongarch=وفّر Hello Minecraft! Launcher دعماً لمنصة Loongson.\n\
fatal.unsupported_platform.loongarch=وفّر HMCL دعماً لمنصة Loongson.\n\
إذا واجهت مشاكل أثناء اللعب، يمكنك زيارة https://docs.hmcl.net/groups.html للحصول على مساعدة.
fatal.unsupported_platform.windows_arm64=وفّر Hello Minecraft! Launcher دعماً أصلياً لمنصة Windows on Arm. إذا واجهت مشاكل أثناء اللعب، يُرجى محاولة تشغيل اللعبة بـ Java المبني على معمارية x86.\n\
fatal.unsupported_platform.windows_arm64=وفّر HMCL دعماً أصلياً لمنصة Windows on Arm. إذا واجهت مشاكل أثناء اللعب، يُرجى محاولة تشغيل اللعبة بـ Java المبني على معمارية x86.\n\
\n\
إذا كنت تستخدم منصة <b>Qualcomm</b>، قد تحتاج إلى تثبيت <a href="ms-windows-store://pdp/?productid=9NQPSL29BFFF">حزمة توافق OpenGL</a> قبل اللعب.\n\
انقر على الرابط للانتقال إلى Microsoft Store وتثبيت حزمة التوافق.
# fatal.wine_warning=
file=ملف
folder.config=الإعدادات
folder.game=مجلد العمل
folder.logs=السجلات
# folder.crash-reports=
folder.mod=المودات
folder.resourcepacks=حزم الموارد
folder.shaderpacks=حزم الظلال
@@ -691,9 +731,10 @@ game_directory.instance_directory.choose=اختر مجلد اللعبة
game_directory.name=الاسم
game_directory.new=مجلد جديد
game_directory.use_relative_path=استخدام مسار نسبي لمجلد اللعبة إن أمكن
# game_directory.root=
help=مساعدة
help.doc=توثيق Hello Minecraft! Launcher
help.doc=توثيق HMCL
help.detail=لصانعي حزم البيانات وحزم المودات.
input.email=يجب أن يكون اسم المستخدم بريداً إلكترونياً.
@@ -703,6 +744,7 @@ input.url=يجب أن يكون الإدخال رابطاً صالحاً.
install=نسخة جديدة
install.change_version=تغيير الإصدار
# install.change_version.title=
install.change_version.confirm=هل أنت متأكد من تغيير %1$s من الإصدار %2$s إلى %3$s؟
install.change_version.process=عملية تغيير الإصدار
install.failed=فشل التثبيت
@@ -711,6 +753,7 @@ install.failed.downloading.detail=فشل تنزيل الملف: %s
install.failed.downloading.timeout=انتهت مهلة التنزيل عند جلب: %s
install.failed.install_online=فشل التعرف على الملف المقدم. إذا كنت تثبّت مود، انتقل إلى صفحة "المودات".
install.failed.malformed=الملفات المنزّلة تالفة. يمكنك محاولة حل هذه المشكلة بالتبديل إلى مصدر تنزيل آخر في "الإعدادات ← التنزيل ← مصدر التنزيل".
# install.failed.cleanroom_not_compatible_with_forge=
install.failed.optifine_conflict=لا يمكن تثبيت كل من OptiFine وFabric معاً على Minecraft 1.13 أو أحدث.
install.failed.optifine_forge_1.17=في Minecraft 1.17.1، يتوافق Forge فقط مع OptiFine H1 pre2 أو أحدث. يمكنك تثبيتها بتفعيل "الإصدارات التجريبية" عند اختيار إصدار OptiFine في HMCL.
install.failed.version_mismatch=يتطلب هذا المحمّل إصدار اللعبة %1$s، لكن الإصدار المثبت هو %2$s.
@@ -744,6 +787,7 @@ install.new_game=تثبيت نسخة
install.new_game.already_exists=اسم هذه النسخة موجود مسبقاً. يُرجى اختيار اسم آخر.
install.new_game.installation=تثبيت النسخة
install.new_game.malformed=اسم غير صالح.
# install.new_game.malformed_json=
install.success=تم التثبيت بنجاح.
instance=الألعاب
@@ -844,6 +888,8 @@ launch.advice.forge28_2_2_optifine=إصدار Forge 28.2.2 أو أحدث غير
launch.advice.forge37_0_60=إصدارات Forge قبل 37.0.60 غير متوافقة مع Java 17. يُرجى تحديث Forge إلى 37.0.60 أو أحدث، أو تشغيل اللعبة بـ Java 16.
launch.advice.java8_51_1_13=قد يتعطل Minecraft 1.13 على إصدارات Java 8 قبل 1.8.0_51. يُرجى تثبيت أحدث إصدار من Java 8.
launch.advice.java9=لا يمكن تشغيل Minecraft 1.12 أو أقدم على Java 9 أو أحدث. يُرجى استخدام Java 8.
# launch.advice.lwjgl_3_4_1=
# launch.advice.lwjgl_3_4_1.title=
launch.advice.modded_java=قد لا تكون بعض المودات متوافقة مع إصدارات Java الأحدث. يُنصح باستخدام Java %1$s لتشغيل Minecraft %2$s.
launch.advice.modlauncher8=إصدار Forge الذي تستخدمه غير متوافق مع إصدار Java الحالي. يُرجى محاولة تحديث Forge.
launch.advice.newer_java=أنت تستخدم إصداراً قديماً من Java لتشغيل اللعبة. يُنصح بالتحديث إلى Java 8، وإلا قد تتسبب بعض المودات في تعطل اللعبة.
@@ -880,13 +926,26 @@ launcher.agreement=الشروط واتفاقية الترخيص
launcher.agreement.accept=قبول
launcher.agreement.decline=رفض
launcher.agreement.hint=يجب الموافقة على اتفاقية الترخيص لاستخدام هذا البرنامج.
# launcher.april_fools.switch_lzh=
# launcher.april_fools.switch_lzh.confirm=
launcher.background=صورة الخلفية
launcher.background.choose=اختر صورة الخلفية
# launcher.background.builtin=
launcher.background.default=افتراضي
launcher.background.default.tooltip=أو "background.png/.jpg/.gif/.webp" والصور في مجلد "bg"
# launcher.background.fallback=
# launcher.background.fallback.builtin=
# launcher.background.fallback.paint=
# launcher.background.fallback.theme_color=
# launcher.background.load_policy=
# launcher.background.load_policy.show_fallback_while_loading=
# launcher.background.load_policy.wait_for_background=
# launcher.background.loading=
launcher.background.network=من رابط
# launcher.background.network.cache=
launcher.background.paint=لون خالص
launcher.background.theme=اتبع السمة
# launcher.background.theme_color=
launcher.cache_directory=مجلد الذاكرة المؤقتة
launcher.cache_directory.clean=مسح الذاكرة المؤقتة
launcher.cache_directory.choose=اختر مجلد الذاكرة المؤقتة
@@ -894,20 +953,22 @@ launcher.cache_directory.default=افتراضي ("%APPDATA%/.minecraft" أو "~/
launcher.cache_directory.disabled=معطّل
launcher.cache_directory.invalid=فشل إنشاء مجلد الذاكرة المؤقتة، جارٍ الرجوع إلى الافتراضي.
launcher.contact=تواصل معنا
launcher.crash=واجه Hello Minecraft! Launcher خطأً فادحاً! يُرجى نسخ السجل التالي وطلب المساعدة على Discord أو مجموعة QQ أو GitHub أو أي منتدى Minecraft آخر.
launcher.crash.java_internal_error=واجه Hello Minecraft! Launcher خطأً فادحاً بسبب تلف Java. يُرجى إلغاء تثبيت Java وتنزيل إصدار مناسب من <a href="https://bell-sw.com/pages/downloads/#downloads">هنا</a>.
launcher.crash.hmcl_out_dated=واجه Hello Minecraft! Launcher خطأً فادحاً! المشغّل قديم. يُرجى تحديثه!
launcher.crash=واجه HMCL خطأً فادحاً! يُرجى نسخ السجل التالي وطلب المساعدة على Discord أو مجموعة QQ أو GitHub أو أي منتدى Minecraft آخر.
launcher.crash.java_internal_error=واجه HMCL خطأً فادحاً بسبب تلف Java. يُرجى إلغاء تثبيت Java وتنزيل إصدار مناسب من <a href="https://bell-sw.com/pages/downloads/#downloads">هنا</a>.
launcher.crash.hmcl_out_dated=واجه HMCL خطأً فادحاً! المشغّل قديم. يُرجى تحديثه!
launcher.update_java=يُرجى تحديث إصدار Java الخاص بك.
libraries.download=جارٍ تنزيل المكتبات
login.enter_password=يُرجى إدخال كلمة المرور.
# logwindow.always_on_top=
logwindow.show_lines=إظهار أرقام الأسطر
logwindow.terminate_game=إنهاء عملية اللعبة
logwindow.title=السجل
logwindow.help=يمكنك الانتقال إلى مجتمع HMCL وإيجاد مساعدة من الآخرين.
logwindow.autoscroll=التمرير التلقائي
# logwindow.wrap_text=
logwindow.export_game_crash_logs=تصدير سجلات التعطل
logwindow.export_dump=تصدير تفريغ مكدس اللعبة
logwindow.export_dump.no_dependency=لا يحتوي Java الخاص بك على المكتبات اللازمة لإنشاء تفريغ المكدس. يُرجى الانضمام إلى Discord أو مجموعة QQ للحصول على مساعدة.
@@ -947,8 +1008,10 @@ modpack.file_api=بادئة رابط حزمة المودات
modpack.files.blueprints=مخططات BuildCraft
modpack.files.config=ملفات إعداد المودات
modpack.files.dumps=ملفات تصحيح NEI
# modpack.files.empty=
modpack.files.hmclversion_cfg=ملف إعداد المشغّل
modpack.files.liteconfig=ملفات LiteLoader
# modpack.files.load_failed=
modpack.files.mods=المودات
modpack.files.mods.voxelmods=خيارات VoxelMods
modpack.files.options_txt=ملف خيارات Minecraft
@@ -974,11 +1037,11 @@ modpack.type.curse.error=فشل تنزيل التبعيات. يُرجى المح
modpack.type.curse.not_found=بعض التبعيات لم تعد متاحة. يُرجى محاولة تثبيت إصدار أحدث من الحزمة.
modpack.type.manual.warning=هذه الحزمة معبّأة يدوياً من قِبل الناشر، وقد تحتوي بالفعل على مشغّل. يُنصح بمحاولة فك ضغط الحزمة وتشغيل اللعبة بمشغّلها الخاص. يستطيع HMCL استيرادها مع عدم ضمان قابليتها للاستخدام. هل تريد المتابعة؟
modpack.type.mcbbs=MCBBS
modpack.type.mcbbs.export=يمكن استيرادها بواسطة Hello Minecraft! Launcher
modpack.type.mcbbs.export=يمكن استيرادها بواسطة HMCL
modpack.type.modrinth=Modrinth
modpack.type.modrinth.export=يمكن استيرادها بواسطة مشغّلات شائعة من أطراف ثالثة
modpack.type.multimc=MultiMC
modpack.type.multimc.export=يمكن استيرادها بواسطة Hello Minecraft! Launcher وMultiMC
modpack.type.multimc.export=يمكن استيرادها بواسطة HMCL وMultiMC
modpack.type.server=تحديث تلقائي لحزمة المودات من الخادم
modpack.type.server.export=يتيح لمالك الخادم تحديث نسخة اللعبة عن بُعد
modpack.type.server.malformed=ملف بيانات الحزمة غير صالح. يُرجى التواصل مع صانع الحزمة لحل هذه المشكلة.
@@ -1105,6 +1168,7 @@ mods.add.title=اختر ملف المود الذي تريد إضافته
mods.disable=تعطيل
mods.download=تنزيل مود
mods.download.title=تنزيل مود - %1s
# mods.empty=
mods.enable=تفعيل
mods.game.version=إصدار اللعبة
mods.manage=المودات
@@ -1137,6 +1201,7 @@ nbt.title=عرض الملف - %s
datapack=حزم البيانات
datapack.add=إضافة
datapack.add.title=اختر أرشيف حزمة البيانات التي تريد إضافتها
# datapack.empty=
datapack.reload.toast=اللعبة تعمل حالياً، يُرجى استخدام الأمر /reload لإعادة تحميل حزمة البيانات
datapack.title=العالم [%s] - حزم البيانات
@@ -1155,6 +1220,7 @@ world.backup.create.new_one=نسخة احتياطية جديدة
world.backup.create.failed=فشل إنشاء النسخة الاحتياطية.\n%s
world.backup.create.success=تم إنشاء نسخة احتياطية جديدة بنجاح: %s
world.backup.delete=حذف هذه النسخة الاحتياطية
# world.backup.empty=
world.backup.processing=جارٍ النسخ الاحتياطي...
world.chunkbase=Chunk Base
world.chunkbase.end_city=مدينة النهاية
@@ -1173,6 +1239,7 @@ world.delete=حذف العالم
world.delete.failed=فشل حذف العالم.\n%s
world.download=تنزيل
world.download.title=تنزيل العالم - %1s
# world.empty=
world.export=تصدير العالم
world.export.title=اختر المجلد لهذا العالم المُصدَّر
world.export.location=حفظ باسم
@@ -1224,6 +1291,7 @@ world.load.fail=فشل تحميل العالم
world.locked=قيد الاستخدام
world.locked.failed=العالم قيد الاستخدام حالياً. يُرجى إغلاق اللعبة والمحاولة مجدداً.
world.manage=العوالم
# world.manage.button=
world.manage.title=العالم - %s
world.name=اسم العالم
world.name.enter=أدخل اسم العالم
@@ -1241,12 +1309,20 @@ repositories.chooser.title=اختر مصدر تنزيل JavaFX
resourcepack=حزم الموارد
resourcepack.add=إضافة
resourcepack.add.title=اختر أرشيف حزمة الموارد التي تريد إضافتها
resourcepack.manage=حزم الموارد
resourcepack.download=تنزيل
resourcepack.add.failed=فشل إضافة حزمة الموارد
resourcepack.add.title=اختر أرشيف حزمة الموارد التي تريد إضافتها
resourcepack.delete.failed=فشل حذف حزمة الموارد
resourcepack.download=تنزيل
resourcepack.download.title=تنزيل حزمة موارد - %1s
# resourcepack.empty=
resourcepack.manage=حزم الموارد
# resourcepack.update_in_modpack.warning=
# resourcepack.warning.invalid=
# resourcepack.warning.manipulate=
# resourcepack.warning.missing_game_meta=
# resourcepack.warning.missing_pack_meta=
# resourcepack.warning.too_new=
# resourcepack.warning.too_old=
reveal.in_file_manager=فتح في مدير الملفات
@@ -1260,6 +1336,7 @@ schematics.create_directory.prompt=يُرجى إدخال اسم المجلد ا
schematics.create_directory.failed=فشل إنشاء المجلد
schematics.create_directory.failed.already_exists=المجلد موجود مسبقاً
schematics.create_directory.failed.invalid_name=الاسم يحتوي على أحرف غير صالحة
# schematics.empty=
schematics.info.description=الوصف
schematics.info.enclosing_size=الحجم المحيط
schematics.info.name=الاسم
@@ -1281,11 +1358,13 @@ search.sort=ترتيب حسب
search.first_page=الأولى
search.previous_page=السابقة
search.next_page=التالية
# search.no_results_found=
search.last_page=الأخيرة
search.page_n=%1$d / %2$s
selector.choose=اختر
selector.choose_file=اختر ملفاً
# selector.choose_directory=
selector.custom=مخصص
settings=الإعدادات
@@ -1298,14 +1377,30 @@ settings.advanced.dont_check_game_completeness=عدم التحقق من سلام
settings.advanced.dont_check_jvm_validity=عدم التحقق من توافق JVM
settings.advanced.dont_patch_natives=عدم محاولة استبدال المكتبات الأصلية تلقائياً
settings.advanced.environment_variables=متغيرات البيئة
# settings.advanced.environment_variables.subtitle=
settings.advanced.game_dir.default=افتراضي (".minecraft/")
settings.advanced.game_dir.independent=معزول (".minecraft/versions/<اسم النسخة>/", باستثناء الأصول والمكتبات)
# settings.advanced.graphics=
# settings.advanced.graphics_backend=
# settings.advanced.graphics_backend.desc=
# settings.advanced.graphics_backend.default=
# settings.advanced.graphics_backend.default.desc=
# settings.advanced.graphics_backend.opengl=
# settings.advanced.graphics_backend.opengl.desc=
# settings.advanced.graphics_backend.vulkan=
# settings.advanced.graphics_backend.vulkan.desc=
# settings.advanced.graphics_backend.vulkan.desc.global=
# settings.advanced.graphics_backend.vulkan.desc.unsupported=
settings.advanced.java_permanent_generation_space=مساحة PermGen
settings.advanced.jvm=خيارات JVM
settings.advanced.jvm_args=وسيطات JVM
settings.advanced.jvm_args.prompt=\ · إذا كانت الوسيطات المُدخلة في "وسيطات JVM" مطابقة للوسيطات الافتراضية، فلن تُضاف.\n\
\ · أدخل أي وسيطات GC في "وسيطات JVM"، وسيتم تعطيل وسيطة G1 الافتراضية.\n\
\ · فعّل "عدم إضافة وسيطات JVM الافتراضية" لتشغيل اللعبة بدون إضافة الوسيطات الافتراضية.
# settings.advanced.jvm_memory.deprecated=
# settings.advanced.jvm_memory.deprecated.subtitle=
# settings.advanced.launch_options=
# settings.advanced.launch_options.subtitle=
settings.advanced.launcher_visibility.close=إغلاق المشغّل بعد تشغيل اللعبة
settings.advanced.launcher_visibility.hide=إخفاء المشغّل بعد تشغيل اللعبة
settings.advanced.launcher_visibility.hide_and_reopen=إخفاء المشغّل وإظهاره عند إغلاق اللعبة
@@ -1313,7 +1408,9 @@ settings.advanced.launcher_visibility.keep=إبقاء المشغّل ظاهرا
settings.advanced.launcher_visible=ظهور المشغّل
settings.advanced.minecraft_arguments=وسيطات التشغيل
settings.advanced.minecraft_arguments.prompt=افتراضي
# settings.advanced.natives_settings=
settings.advanced.natives_directory=مسار المكتبات الأصلية
# settings.advanced.natives_directory.custom.enabled=
settings.advanced.no_jvm_args=عدم إضافة وسيطات JVM الافتراضية
settings.advanced.no_optimizing_jvm_args=عدم إضافة وسيطات تحسين JVM الافتراضية
settings.advanced.precall_command=أمر ما قبل التشغيل
@@ -1333,15 +1430,56 @@ settings.advanced.post_exit_command=أمر ما بعد الإغلاق
settings.advanced.post_exit_command.prompt=أوامر تُنفَّذ بعد إغلاق اللعبة
settings.advanced.renderer=المُصيِّر
settings.advanced.renderer.default=افتراضي
settings.advanced.renderer.d3d12=Mesa D3D12
# settings.advanced.renderer.default.desc=
# settings.advanced.renderer.opengl=
# settings.advanced.renderer.vulkan=
# settings.advanced.renderer.gpu_preferences=
# settings.advanced.renderer.lavapipe=
# settings.advanced.renderer.lavapipe.desc=
# settings.advanced.renderer.dozen=
# settings.advanced.renderer.dozen.desc=
# settings.advanced.renderer.nvidia_vulkan=
# settings.advanced.renderer.nvidia_vulkan.desc=
# settings.advanced.renderer.nvidia_nvk=
# settings.advanced.renderer.nvidia_nvk.desc=
# settings.advanced.renderer.amdvlk=
# settings.advanced.renderer.amdvlk.desc=
# settings.advanced.renderer.amd_radv=
# settings.advanced.renderer.amd_radv.desc=
# settings.advanced.renderer.intel_vulkan=
# settings.advanced.renderer.intel_vulkan.desc=
# settings.advanced.renderer.intel_anv=
# settings.advanced.renderer.intel_anv.desc=
# settings.advanced.renderer.intel_hasvk=
# settings.advanced.renderer.intel_hasvk.desc=
# settings.advanced.renderer.qualcomm=
# settings.advanced.renderer.qualcomm.desc=
# settings.advanced.renderer.turnip=
# settings.advanced.renderer.turnip.desc=
# settings.advanced.renderer.moltenvk=
# settings.advanced.renderer.moltenvk.desc=
# settings.advanced.renderer.kosmickrisp=
# settings.advanced.renderer.kosmickrisp.desc=
# settings.advanced.renderer.powervr=
# settings.advanced.renderer.powervr.desc=
# settings.advanced.renderer.panvk=
# settings.advanced.renderer.panvk.desc=
# settings.advanced.renderer.v3dv=
# settings.advanced.renderer.v3dv.desc=
settings.advanced.renderer.llvmpipe=Mesa LLVMpipe
# settings.advanced.renderer.llvmpipe.desc=
settings.advanced.renderer.d3d12=Mesa D3D12
# settings.advanced.renderer.d3d12.desc=
settings.advanced.renderer.zink=Mesa Zink
# settings.advanced.renderer.zink.desc=
settings.advanced.server_ip=عنوان الخادم
settings.advanced.server_ip.prompt=الانضمام تلقائياً بعد تشغيل اللعبة
settings.advanced.unsupported_system_options=إعدادات غير مطبّقة على النظام الحالي
settings.advanced.use_native_glfw_or_sdl=استخدام GLFW / SDL النظام
settings.advanced.use_native_openal=استخدام OpenAL النظام
# settings.advanced.use_native_sdl=
settings.advanced.linux_freebsd_only=Linux/FreeBSD فقط
# settings.advanced.windows_only=
settings.advanced.wrapper_launcher=أمر التغليف
settings.advanced.wrapper_launcher.prompt=يتيح التشغيل باستخدام برنامج تغليف إضافي مثل "optirun" على Linux
@@ -1349,9 +1487,22 @@ settings.custom=مخصص
settings.game=الإعدادات
settings.game.current=اللعبة
# settings.game.default_isolation=
# settings.game.default_isolation.subtitle=
# settings.game.default_isolation.always=
# settings.game.default_isolation.always.desc=
# settings.game.default_isolation.modded=
# settings.game.default_isolation.modded.desc=
# settings.game.default_isolation.never=
# settings.game.default_isolation.never.desc=
settings.game.dimension=الدقة
settings.game.exploration=استكشاف
settings.game.fullscreen=ملء الشاشة
# settings.game.inherit_global=
# settings.game.instance_settings.unsupported=
# settings.game.presets.unsupported=
# settings.game.isolation=
# settings.game.isolation.subtitle=
settings.game.java_directory=Java
settings.game.java_directory.auto=اختيار تلقائي
settings.game.java_directory.auto.not_found=لم يتم تثبيت أي إصدار Java مناسب.
@@ -1361,28 +1512,51 @@ settings.game.java_directory.invalid=مسار Java غير صحيح
settings.game.java_directory.version=تحديد إصدار Java
settings.game.java_directory.template=%1$s (%2$s)
settings.game.management=إدارة
# settings.game.override_global=
# settings.game.quick_play=
# settings.game.quick_play.multiplayer=
# settings.game.quick_play.none=
# settings.game.quick_play.realms=
# settings.game.quick_play.singleplayer=
# settings.game.quick_play.subtitle=
# settings.game.running_directory=
# settings.game.section.basic=
# settings.game.section.game=
# settings.game.window_type=
# settings.game.window_type.fullscreen=
# settings.game.window_type.maximized=
# settings.game.window_type.windowed=
settings.game.working_directory.choose=اختر مجلد العمل
settings.icon=الأيقونة
# settings.game_directories.read_only=
settings.launcher=إعدادات المشغّل
# settings.launcher.allow_auto_agent=
# settings.launcher.allow_auto_agent.subtitle=
# settings.launcher.animation=
settings.launcher.appearance=المظهر
settings.launcher.brightness=وضع السمة
settings.launcher.brightness.auto=متابعة إعدادات النظام
settings.launcher.brightness.dark=الوضع الداكن
settings.launcher.brightness.light=الوضع الفاتح
settings.launcher.debug=تصحيح
# settings.launcher.disable_april_fools=
settings.launcher.disable_auto_game_options=عدم تغيير لغة اللعبة تلقائياً
settings.launcher.download=التنزيل
settings.launcher.download.threads=الخيوط
settings.launcher.download.threads.auto=تحديد تلقائي
# settings.launcher.download.threads.custom=
settings.launcher.download_source=مصدر التنزيل
settings.launcher.download_source.auto=اختيار مصادر التنزيل تلقائياً
# settings.launcher.default_addon_source=
# settings.launcher.misc=
settings.launcher.font=الخط
settings.launcher.font.anti_aliasing=مضاد التعرج
settings.launcher.font.anti_aliasing.auto=تلقائي
settings.launcher.font.anti_aliasing.gray=تدرج رمادي
settings.launcher.font.anti_aliasing.lcd=بكسل فرعي
# settings.launcher.fonts=
settings.launcher.general=عام
settings.launcher.language=اللغة
settings.launcher.launcher_log.export=تصدير سجلات المشغّل
@@ -1402,9 +1576,35 @@ settings.launcher.proxy.port=المنفذ
settings.launcher.proxy.socks=SOCKS
settings.launcher.proxy.username=اسم المستخدم
settings.launcher.theme=لون السمة
# settings.launcher.theme_color=
# settings.launcher.theme_color_style=
# settings.launcher.theme_color_style.content=
# settings.launcher.theme_color_style.content.desc=
# settings.launcher.theme_color_style.expressive=
# settings.launcher.theme_color_style.expressive.desc=
# settings.launcher.theme_color_style.fidelity=
# settings.launcher.theme_color_style.fidelity.desc=
# settings.launcher.theme_color_style.fruit_salad=
# settings.launcher.theme_color_style.fruit_salad.desc=
# settings.launcher.theme_color_style.monochrome=
# settings.launcher.theme_color_style.monochrome.desc=
# settings.launcher.theme_color_style.neutral=
# settings.launcher.theme_color_style.neutral.desc=
# settings.launcher.theme_color_style.rainbow=
# settings.launcher.theme_color_style.rainbow.desc=
# settings.launcher.theme_color_style.tonal_spot=
# settings.launcher.theme_color_style.tonal_spot.desc=
# settings.launcher.theme_color_style.vibrant=
# settings.launcher.theme_color_style.vibrant.desc=
# settings.launcher.theme_color_type.background=
# settings.launcher.theme_color_type.custom=
# settings.launcher.theme_color_type.custom.description=
# settings.launcher.theme_color_type.default=
# settings.launcher.theme_color_type.system=
settings.launcher.title_transparent=شريط عنوان شفاف
settings.launcher.turn_off_animations=تعطيل الحركات
settings.launcher.version_list_source=قائمة الإصدارات
# settings.launcher.window_transparent=
settings.launcher.background.settings.opacity=الشفافية
settings.memory=الذاكرة
@@ -1412,15 +1612,30 @@ settings.memory.allocate=%1$.1f جيجابايت مخصص
settings.memory.allocate.exceeded=%1$.1f جيجابايت مخصص (%2$.1f جيجابايت متاح)
settings.memory.auto_allocate=تخصيص تلقائي
settings.memory.lower_bound=الحد الأدنى للذاكرة
# settings.memory.manual_allocate=
settings.memory.unit.mib=ميجابايت
settings.memory.used_per_total=%1$.1f جيجابايت مستخدم / %2$.1f جيجابايت إجمالي
settings.physical_memory=حجم الذاكرة الفعلية
settings.show_log=عرض السجلات
settings.enable_debug_log_output=إخراج سجل التصحيح
# settings.file.force_write=
# settings.file.force_write.confirm=
settings.tabs.installers=محمّلات المودات
settings.take_effect_after_restart=يُطبَّق بعد إعادة التشغيل
settings.type=نوع إعدادات النسخة
settings.type.global.manage=الإعدادات العامة
# settings.type.global.preset=
# settings.type.global.preset.create=
# settings.type.global.preset.default=
# settings.type.global.preset.duplicate_name=
# settings.type.global.preset.help=
# settings.type.global.preset.manage_all=
# settings.type.global.preset.name=
# settings.type.global.preset.rename=
# settings.type.global.preset.remove=
# settings.type.global.preset.remove.confirm=
# settings.type.global.preset.subtitle=
# settings.type.global.preset.auto_name=
shaderpack.download.title=تنزيل ظلال - %1s
@@ -1433,6 +1648,7 @@ terracotta.terracotta=Terracotta | متعدد اللاعبين
terracotta.status=الردهة
terracotta.back=خروج
terracotta.feedback.title=ملء استمارة التقييم
# terracotta.feedback.desc=
terracotta.feedback.desc.update=مع تحديث HMCL لنواة متعدد اللاعبين، نأمل أن تخصص 10 ثوانٍ لملء استمارة التقييم.
terracotta.sudo_installing=يجب على HMCL التحقق من كلمة مرورك قبل تثبيت نواة متعدد اللاعبين
terracotta.difficulty.easiest=شبكة ممتازة: الاتصال شبه مضمون!
@@ -1509,6 +1725,40 @@ terracotta.unsupported.arch.32bit=متعدد اللاعبين غير مدعوم
terracotta.unsupported.arch.loongarch64_ow=متعدد اللاعبين غير مدعوم على توزيعات Linux LoongArch64 القديمة. يُرجى التحديث إلى توزيعة العالم الجديد (مثل AOSC OS).
terracotta.unsupported.region=ميزة متعدد اللاعبين متاحة حالياً فقط لمستخدمي البر الرئيسي الصيني وقد لا تكون متاحة في منطقتك.
# theme_pack.appearance.follow_theme.tooltip=
# theme_pack.appearance.custom.tooltip=
# theme_pack.apply=
# theme_pack.apply.confirm=
# theme_pack.apply.failed=
# theme_pack.builtin=
# theme_pack.current.missing=
# theme_pack.delete=
# theme_pack.delete.confirm=
# theme_pack.delete.failed=
# theme_pack.delete.success=
# theme_pack.directory=
# theme_pack.empty=
# theme_pack.export=
# theme_pack.export.author=
# theme_pack.export.failed=
# theme_pack.export.id=
# theme_pack.export.name=
# theme_pack.export.subtitle=
# theme_pack.export.success=
# theme_pack.export.version=
# theme_pack.export.title=
# theme_pack.file=
# theme_pack.import=
# theme_pack.import.failed=
# theme_pack.import.success=
# theme_pack.import.title=
# theme_pack.load.failed=
# theme_pack.manage=
# theme_pack.theme=
# theme_pack.theme.id=
# theme_pack.themes=
# theme_pack.version=
unofficial.hint=أنت تستخدم إصداراً غير رسمي من HMCL. لا نستطيع ضمان أمانه.
update=تحديث
@@ -1530,15 +1780,21 @@ update.channel.nightly.hint=أنت تستخدم حالياً إصدار القن
update.channel.nightly.title=إشعار القناة الليلية
update.channel.stable=رسمي
update.checking=جارٍ التحقق من التحديثات
# update.check_failed=
# update.disable_auto_show_update_dialog=
# update.disable_auto_show_update_dialog.subtitle=
update.failed=فشل التحديث
update.found=تحديث متاح!
update.newest_version=أحدث إصدار: %s
update.bubble.title=تحديث متاح: %s
update.bubble.subtitle=انقر هنا للتحديث
# update.note.stable=
# update.note.dev=
update.latest=هذا هو أحدث إصدار
update.tooltip=تحديث
update.preview=الاطلاع المبكر على إصدارات HMCL
update.preview.subtitle=فعّل هذا الخيار لاستقبال إصدارات HMCL الجديدة مبكراً للاختبار قبل إصدارها الرسمي.
# update.unverified=
warning.java_interpreted_mode=يعمل HMCL في بيئة Java مُترجمة تفسيرياً، مما سيؤثر بشكل كبير على الأداء.\n\
\n\
@@ -160,8 +160,6 @@ account.skin.upload.failed=Fehler beim Hochladen des Skins.
account.skin.invalid_skin=Ungültige Skin-Datei.
account.username=Benutzername
addon.broken_dependency.title=Fehlerhafte Abhängigkeit
addon.broken_dependency.desc=Diese Abhängigkeit existierte vorher, ist aber nicht mehr vorhanden. Versuchen Sie, eine andere Download-Quelle zu verwenden.
addon.category=Kategorie
addon.changelog=Änderungsprotokoll
addon.changelog.empty=Derzeit kein Änderungsprotokoll
@@ -186,10 +184,16 @@ addon.dependency.tool=Erforderliche Abhängigkeiten (Müssen separat heruntergel
addon.dependency.include=Integrierte Abhängigkeiten (Bereits in der Addon-Datei vom Autor gepackt. Muss nicht separat heruntergeladen werden)
addon.dependency.incompatible=Inkompatible Addons (Wenn diese Addons gleichzeitig installiert werden, kann das Spiel nicht gestartet werden)
addon.dependency.broken=Fehlerhafte Abhängigkeiten (Dieses Addon existierte vorher, ist aber nicht mehr vorhanden. Versuchen Sie, eine andere Download-Quelle zu verwenden.)
# addon.dependencies.has_broken=
addon.download.recommend=Empfohlene Version für Minecraft %1s
addon.download.title.release=Minecraft %s
addon.download.title.snapshot=Minecraft %s (Snapshots)
addon.modrinth=Modrinth
addon.sort.date_created=Erstellungsdatum
addon.sort.last_updated=Zuletzt aktualisiert
addon.sort.popularity=Beliebtheit
# addon.sort.relevancy=
addon.sort.total_downloads=Downloads insgesamt
archive.author=Autor(en)
archive.date=Veröffentlichungsdatum
@@ -371,13 +375,6 @@ curse.category.6553=Realistisch
curse.category.6554=Fantasie
curse.category.6555=Vanilla
curse.sort.author=Autor
curse.sort.date_created=Erstellungsdatum
curse.sort.last_updated=Zuletzt aktualisiert
curse.sort.name=Name
curse.sort.popularity=Beliebtheit
curse.sort.total_downloads=Downloads insgesamt
datetime.format=dd.MM.yyyy, HH\:mm\:ss
download=Herunterladen
@@ -433,32 +430,32 @@ extension.resourcepack=Ressourcenpaket-Archiv
extension.schematic=Schematik-Datei
extension.world=Welt-Archiv
fatal.create_hmcl_current_directory_failure=Hello Minecraft! Launcher kann das HMCL-Verzeichnis (%s) nicht erstellen. Bitte verschieben Sie HMCL an einen anderen Speicherort und öffnen Sie es erneut.
fatal.create_hmcl_current_directory_failure=HMCL kann das HMCL-Verzeichnis (%s) nicht erstellen. Bitte verschieben Sie HMCL an einen anderen Speicherort und öffnen Sie es erneut.
fatal.javafx.incomplete=Die JavaFX-Umgebung ist unvollständig.\n\
Bitte versuchen Sie, Ihr Java zu ersetzen oder OpenJFX neu zu installieren.
fatal.javafx.missing=Fehlende JavaFX-Umgebung. Bitte öffnen Sie den Hello Minecraft! Launcher mit Java, welches OpenJFX enthält.
fatal.config_change_owner_root=Sie verwenden das Root-Konto, um den Hello Minecraft! Launcher zu öffnen. Dies könnte Sie daran hindern, HMCL in Zukunft mit einem anderen Konto zu öffnen.\n\
fatal.javafx.missing=Fehlende JavaFX-Umgebung. Bitte öffnen Sie den HMCL mit Java, welches OpenJFX enthält.
fatal.config_change_owner_root=Sie verwenden das Root-Konto, um den HMCL zu öffnen. Dies könnte Sie daran hindern, HMCL in Zukunft mit einem anderen Konto zu öffnen.\n\
Möchten Sie trotzdem fortfahren?
fatal.config_in_temp_dir=Sie öffnen den Hello Minecraft! Launcher in einem temporären Verzeichnis. Ihre Einstellungen und Spieldaten könnten verloren gehen.\n\
fatal.config_in_temp_dir=Sie öffnen den HMCL in einem temporären Verzeichnis. Ihre Einstellungen und Spieldaten könnten verloren gehen.\n\
Es wird empfohlen, HMCL an einen anderen Ort zu verschieben und erneut zu öffnen.\n\
Möchten Sie trotzdem fortfahren?
fatal.config_loading_failure=Konfigurationsdateien können nicht geladen werden.\n\
Bitte stellen Sie sicher, dass der Hello Minecraft! Launcher Lese- und Schreibzugriff auf "%s" und die darin enthaltenen Dateien hat.\n\
Bitte stellen Sie sicher, dass der HMCL Lese- und Schreibzugriff auf "%s" und die darin enthaltenen Dateien hat.\n\
Versuchen Sie unter macOS, HMCL an einen Ort mit anderen Berechtigungen als "Schreibtisch", "Downloads" und "Dokumente" zu legen und versuchen Sie es erneut.
fatal.config_loading_failure.unix=Hello Minecraft! Launcher konnte die Konfigurationsdatei nicht laden, da sie vom Benutzer "%1$s" erstellt wurde.\n\
fatal.config_loading_failure.unix=HMCL konnte die Konfigurationsdatei nicht laden, da sie vom Benutzer "%1$s" erstellt wurde.\n\
Bitte öffnen Sie HMCL als Root-Benutzer (nicht empfohlen) oder führen Sie den folgenden Befehl im Terminal aus, um den Besitz der Konfigurationsdatei auf den aktuellen Benutzer zu übertragen:\n%2$s
fatal.config_unsupported_version=Die aktuelle Konfigurationsdatei wurde von einer neueren Version des Hello Minecraft! Launchers erstellt, und diese Version von HMCL kann sie nicht richtig laden.\n\
fatal.config_unsupported_version=Die aktuelle Konfigurationsdatei wurde von einer neueren Version des HMCLs erstellt, und diese Version von HMCL kann sie nicht richtig laden.\n\
Bitte aktualisieren Sie HMCL und starten Sie es neu.\n\
Vor dem Aktualisieren des Launchers werden keine von Ihnen geänderten Einstellungen gespeichert.
fatal.mac_app_translocation=Hello Minecraft! Launcher wurde aufgrund von macOS-Sicherheitsmechanismen vom Betriebssystem in ein temporäres Verzeichnis isoliert.\n\
fatal.mac_app_translocation=HMCL wurde aufgrund von macOS-Sicherheitsmechanismen vom Betriebssystem in ein temporäres Verzeichnis isoliert.\n\
Bitte verschieben Sie HMCL in ein anderes Verzeichnis, bevor Sie versuchen, es zu öffnen. Andernfalls könnten Ihre Einstellungen und Spieldaten nach einem Neustart verloren gehen.\n\
Möchten Sie trotzdem fortfahren?
fatal.migration_requires_manual_reboot=Hello Minecraft! Launcher wurde aktualisiert. Bitte starten Sie den Launcher neu.
fatal.apply_update_failure=Es tut uns leid, aber der Hello Minecraft! Launcher kann nicht automatisch aktualisiert werden.\n\
fatal.migration_requires_manual_reboot=HMCL wurde aktualisiert. Bitte starten Sie den Launcher neu.
fatal.apply_update_failure=Es tut uns leid, aber der HMCL kann nicht automatisch aktualisiert werden.\n\
\n\
Sie können manuell aktualisieren, indem Sie eine neuere Launcher-Version von %s herunterladen.\n\
Wenn das Problem weiterhin besteht, melden Sie es uns bitte.
fatal.apply_update_need_win7=Der Hello Minecraft! Launcher kann unter Windows XP/Vista nicht automatisch aktualisiert werden.\n\
fatal.apply_update_need_win7=Der HMCL kann unter Windows XP/Vista nicht automatisch aktualisiert werden.\n\
\n\
Sie können manuell aktualisieren, indem Sie eine neuere Launcher-Version von %s herunterladen.
fatal.deprecated_java_version=HMCL wird in Zukunft Java 17 oder neuer benötigen, um zu laufen, wird aber weiterhin das Starten von Spielen mit Java 6~16 unterstützen.\n\
@@ -467,14 +464,14 @@ Es wird empfohlen, die neueste Java-Version zu installieren, um sicherzustellen,
\n\
Sie können die alte Java-Version weiterhin behalten. HMCL kann mehrere Java-Versionen erkennen und verwalten und wählt basierend auf der Spielversion automatisch das entsprechende Java für Sie aus.
fatal.deprecated_java_version.download_link=Java %d herunterladen
fatal.samba=Wenn Sie den Hello Minecraft! Launcher von einem Samba-Netzlaufwerk geöffnet haben, funktionieren einige Funktionen möglicherweise nicht. Bitte versuchen Sie, Ihr Java zu aktualisieren oder den Launcher in ein anderes Verzeichnis zu verschieben.
fatal.samba=Wenn Sie den HMCL von einem Samba-Netzlaufwerk geöffnet haben, funktionieren einige Funktionen möglicherweise nicht. Bitte versuchen Sie, Ihr Java zu aktualisieren oder den Launcher in ein anderes Verzeichnis zu verschieben.
fatal.illegal_char=Ihr Arbeitsverzeichnis enthält ein ungültiges Zeichen "=". Sie können authlib-injector nicht verwenden oder den Skin Ihres Offline-Kontos nicht ändern.
fatal.unsupported_platform=Minecraft wird auf Ihrer Plattform noch nicht vollständig unterstützt, daher fehlen möglicherweise Funktionen oder Sie können das Spiel überhaupt nicht starten.\n\
\n\
Wenn Sie Minecraft 1.17 und neuer nicht starten können, können Sie versuchen, den "Renderer" unter "Allgemeine/Instanzspezifische Einstellungen → Grafikeinstellungen" auf "Mesa LLVMpipe" oder "Mesa Lavapipe" umzustellen, um CPU-Rendering für bessere Kompatibilität zu verwenden.
fatal.unsupported_platform.loongarch=Der Hello Minecraft! Launcher bietet nun Unterstützung für die Loongson-Plattform.\n\
fatal.unsupported_platform.loongarch=Der HMCL bietet nun Unterstützung für die Loongson-Plattform.\n\
Wenn beim Spielen Probleme auftreten, können Sie https://docs.hmcl.net/groups.html für Hilfe besuchen.
fatal.unsupported_platform.windows_arm64=Der Hello Minecraft! Launcher bietet native Unterstützung für die Windows-on-Arm-Plattform. Wenn beim Spielen Probleme auftreten, versuchen Sie bitte, das Spiel mit Java basierend auf der x86-Architektur zu starten.\n\
fatal.unsupported_platform.windows_arm64=Der HMCL bietet native Unterstützung für die Windows-on-Arm-Plattform. Wenn beim Spielen Probleme auftreten, versuchen Sie bitte, das Spiel mit Java basierend auf der x86-Architektur zu starten.\n\
\n\
Wenn Sie die <b>Qualcomm</b>-Plattform verwenden, müssen Sie möglicherweise das <a href="ms-windows-store://pdp/?productid=9NQPSL29BFFF">OpenGL-Kompatibilitätspaket</a> installieren, bevor Sie Spiele spielen.\n\
Klicken Sie auf den Link, um zum Microsoft Store zu navigieren und das Kompatibilitätspaket zu installieren.
@@ -732,9 +729,10 @@ game_directory.instance_directory.choose=Spielverzeichnis auswählen
game_directory.name=Name
game_directory.new=Neues Verzeichnis
game_directory.use_relative_path=Verwenden Sie, wenn möglich, einen relativen Pfad für das Spielverzeichnis
# game_directory.root=
help=Hilfe
help.doc=Hello Minecraft! Launcher Dokumentation
help.doc=HMCL Dokumentation
help.detail=Für Hersteller von Datenpaketen und Modpacks.
input.email=Der Benutzername muss eine E-Mail-Adresse sein.
@@ -744,6 +742,7 @@ input.url=Die Eingabe muss eine gültige URL sein.
install=Neue Instanz
install.change_version=Version ändern
# install.change_version.title=
install.change_version.confirm=Sind Sie sicher, dass Sie %1$s von Version %2$s zu %3$s wechseln möchten?
install.change_version.process=Versionsänderungsprozess
install.failed=Installation fehlgeschlagen
@@ -752,6 +751,7 @@ install.failed.downloading.detail=Datei konnte nicht heruntergeladen werden: %s
install.failed.downloading.timeout=Download-Timeout beim Abrufen von: %s
install.failed.install_online=Die bereitgestellte Datei konnte nicht identifiziert werden. Wenn Sie einen Mod installieren, navigieren Sie zur Seite "Mods".
install.failed.malformed=Die heruntergeladenen Dateien sind beschädigt. Sie können versuchen, dieses Problem zu beheben, indem Sie unter "Einstellungen → Herunterladen → Downloadquelle" zu einer anderen Downloadquelle wechseln.
# install.failed.cleanroom_not_compatible_with_forge=
install.failed.optifine_conflict=OptiFine und Fabric können auf Minecraft 1.13 oder neuer nicht gleichzeitig installiert werden.
install.failed.optifine_forge_1.17=Für Minecraft 1.17.1 ist Forge nur mit OptiFine H1 pre2 oder neuer kompatibel. Sie können sie installieren, indem Sie "Snapshots" aktivieren, wenn Sie eine OptiFine-Version in HMCL auswählen.
install.failed.version_mismatch=Dieser Loader benötigt die Spielversion %1$s, aber die installierte ist %2$s.
@@ -886,6 +886,7 @@ launch.advice.forge28_2_2_optifine=Forge Version 28.2.2 oder neuer ist nicht mit
launch.advice.forge37_0_60=Forge-Versionen vor 37.0.60 sind nicht mit Java 17 kompatibel. Bitte aktualisieren Sie Forge auf 37.0.60 oder neuer, oder starten Sie das Spiel mit Java 16.
launch.advice.java8_51_1_13=Minecraft 1.13 kann auf Java 8-Versionen vor 1.8.0_51 abstürzen. Bitte installieren Sie die neueste Java 8-Version.
launch.advice.java9=Sie können Minecraft 1.12 oder früher nicht mit Java 9 oder neuer starten. Bitte verwenden Sie stattdessen Java 8.
# launch.advice.lwjgl_3_4_1=
# launch.advice.lwjgl_3_4_1=Die aktuelle Spielversion hat ein bekanntes Problem, das zu Ruckeln im Spiel führen kann.\nHMCL kann die Spielleistung automatisch optimieren (mittels eines Java-Agenten).\nErlauben Sie HMCL, das Spiel automatisch zu optimieren?\nWenn Probleme auftreten, können Sie die Option "HMCL erlauben, das Spiel zu modifizieren" unter "Einstellungen → Allgemein" deaktivieren.
launch.advice.lwjgl_3_4_1.title=HMCL erlauben, das Spiel automatisch zu optimieren?
launch.advice.modded_java=Einige Mods sind möglicherweise nicht mit neueren Java-Versionen kompatibel. Es wird empfohlen, Java %1$s zu verwenden, um Minecraft %2$s zu starten.
@@ -951,9 +952,9 @@ launcher.cache_directory.default=Standard ("%APPDATA%/.minecraft" oder "~/.minec
launcher.cache_directory.disabled=Deaktiviert
launcher.cache_directory.invalid=Fehler beim Erstellen des Cache-Verzeichnisses, Rückgriff auf Standard.
launcher.contact=Kontaktiere uns
launcher.crash=Hello Minecraft! Launcher ist auf einen fatalen Fehler gestoßen! Bitte kopieren Sie das folgende Protokoll und bitten Sie in unserem Discord, der QQ-Gruppe, auf GitHub oder in einem anderen Minecraft-Forum um Hilfe.
launcher.crash.java_internal_error=Hello Minecraft! Launcher ist auf einen fatalen Fehler gestoßen, da Ihre Java-Installation beschädigt ist. Bitte deinstallieren Sie Java und laden Sie eine geeignete Java-Version <a href="https://bell-sw.com/pages/downloads/#downloads">hier</a> herunter.
launcher.crash.hmcl_out_dated=Hello Minecraft! Launcher ist auf einen fatalen Fehler gestoßen! Ihr Launcher ist veraltet. Bitte aktualisieren Sie Ihren Launcher!
launcher.crash=HMCL ist auf einen fatalen Fehler gestoßen! Bitte kopieren Sie das folgende Protokoll und bitten Sie in unserem Discord, der QQ-Gruppe, auf GitHub oder in einem anderen Minecraft-Forum um Hilfe.
launcher.crash.java_internal_error=HMCL ist auf einen fatalen Fehler gestoßen, da Ihre Java-Installation beschädigt ist. Bitte deinstallieren Sie Java und laden Sie eine geeignete Java-Version <a href="https://bell-sw.com/pages/downloads/#downloads">hier</a> herunter.
launcher.crash.hmcl_out_dated=HMCL ist auf einen fatalen Fehler gestoßen! Ihr Launcher ist veraltet. Bitte aktualisieren Sie Ihren Launcher!
launcher.update_java=Bitte aktualisieren Sie Ihre Java-Version.
libraries.download=Bibliotheken werden heruntergeladen
@@ -1035,11 +1036,11 @@ modpack.type.curse.error=Fehler beim Herunterladen von Abhängigkeiten. Bitte ve
modpack.type.curse.not_found=Einige Abhängigkeiten sind nicht mehr verfügbar. Bitte versuchen Sie, eine neuere Modpack-Version zu installieren.
modpack.type.manual.warning=Das Modpack wurde vom Herausgeber manuell verpackt, was möglicherweise bereits einen Launcher enthält. Es wird empfohlen, das Modpack zu entpacken und das Spiel mit dem eigenen Launcher zu starten. HMCL kann es dennoch importieren, jedoch ohne Garantie auf Nutzbarkeit. Trotzdem fortfahren?
modpack.type.mcbbs=MCBBS
modpack.type.mcbbs.export=Kann durch Hello Minecraft! Launcher importiert werden
modpack.type.mcbbs.export=Kann durch HMCL importiert werden
modpack.type.modrinth=Modrinth
modpack.type.modrinth.export=Kann von gängigen Drittanbieter-Launchern importiert werden
modpack.type.multimc=MultiMC
modpack.type.multimc.export=Kann durch Hello Minecraft! Launcher und MultiMC importiert werden
modpack.type.multimc.export=Kann durch HMCL und MultiMC importiert werden
modpack.type.server=Modpack vom Server automatisch aktualisieren
modpack.type.server.export=Ermöglicht dem Serverbesitzer, die Spielinstanz remote zu aktualisieren
modpack.type.server.malformed=Ungültiges Modpack-Manifest. Bitte kontaktieren Sie den Modpack-Ersteller, um dieses Problem zu beheben.
@@ -1477,6 +1478,7 @@ settings.advanced.server_ip.prompt=Nach Spielstart automatisch beitreten
settings.advanced.unsupported_system_options=Für das aktuelle System nicht zutreffende Einstellungen
settings.advanced.use_native_glfw_or_sdl=System-GLFW / SDL verwenden
settings.advanced.use_native_openal=System-OpenAL verwenden
# settings.advanced.use_native_sdl=
settings.advanced.linux_freebsd_only=Nur Linux/FreeBSD
settings.advanced.windows_only=Nur Windows
settings.advanced.wrapper_launcher=Wrapper-Befehl
@@ -1780,6 +1782,7 @@ update.channel.nightly.hint=Sie verwenden derzeit einen Nightly-Kanal-Build des
update.channel.nightly.title=Hinweis zum Nightly-Kanal
update.channel.stable=Stabil
update.checking=Suche nach Updates
# update.check_failed=
update.disable_auto_show_update_dialog=Update-Dialog nicht automatisch anzeigen
update.disable_auto_show_update_dialog.subtitle=Aktivieren Sie diese Option, um zu verhindern, dass HMCL den Update-Dialog automatisch anzeigt.
update.failed=Fehler beim Aktualisieren
@@ -1793,6 +1796,7 @@ update.latest=Dies ist die neueste Version
update.tooltip=Aktualisieren
update.preview=Vorschau auf HMCL-Veröffentlichungen frühzeitig erhalten
update.preview.subtitle=Aktivieren Sie diese Option, um neue Versionen von HMCL frühzeitig zum Testen vor ihrer offiziellen Veröffentlichung zu erhalten.
# update.unverified=
warning.java_interpreted_mode=HMCL wird in einer interpretierten Java-Umgebung ausgeführt, was die Leistung erheblich beeinträchtigt.\n\
\n\
File diff suppressed because it is too large. Load diff
File diff suppressed because it is too large. Load diff
File diff suppressed because it is too large. Load diff
File diff suppressed because it is too large. Load diff
@@ -100,12 +100,10 @@ account.copy_uuid=Копіювати UUID облікового запису
account.methods=Тип входу
account.methods.authlib_injector=authlib-injector
account.methods.microsoft=Microsoft
account.methods.microsoft.birth=Як змінити дату народження облікового запису
account.methods.microsoft.code=Код (Скопійовано в буфер обміну)
account.methods.microsoft.close_page=Авторизація облікового запису Microsoft тепер завершена.\n\
\n\
Нам залишилося виконати ще трохи роботи, але ви можете безпечно закрити цю вкладку зараз.
account.methods.microsoft.deauthorize=Скасувати авторизацію
account.methods.microsoft.error.add_family=Будь ласка, натисніть <a href="https://support.microsoft.com/account-billing/837badbc-999e-54d2-2617-d19206b9540a">тут</a>, щоб змінити дату народження вашого акаунта на старше 18 років, або додайте свій акаунт до сім'ї.
account.methods.microsoft.error.country_unavailable=XBOX Live недоступний у вашій поточній країні/регіоні.
account.methods.microsoft.error.missing_xbox_account=Будь ласка, підтвердіть, що ви придбали Minecraft: Java Edition. Якщо так, натисніть <a href="https://www.minecraft.net/msaprofile/mygames/editprofile">тут</a>, щоб створити свій ігровий профіль.
@@ -115,8 +113,6 @@ account.methods.microsoft.error.banned=Ваш акаунт міг бути за
Ви можете натиснути <a href="https://enforcement.xbox.com/enforcement/showenforcementhistory">тут</a>, щоб перевірити статус блокування вашого акаунта.
account.methods.microsoft.error.unknown=Не вдалося увійти, код помилки: %d.
account.methods.microsoft.error.wrong_verify_method=Не вдалося увійти. Будь ласка, спробуйте увійти у свій акаунт, використовуючи ПАРОЛЬ, замість інших методів входу.
account.methods.microsoft.logging_in=Вхід...
account.methods.microsoft.makegameidsettings=Створити профіль / Редагувати ім'я профілю
account.methods.microsoft.hint=Натисніть кнопку "Увійти", щоб почати додавання вашого акаунта Microsoft.
account.methods.microsoft.methods.device=Увійти за допомогою QR-коду
account.methods.microsoft.methods.device.hint=Відскануйте QR-код або перейдіть за посиланням <a href="%s">%s</a>, щоб завершити вхід, введіть <b>%s</b> на відкритій сторінці.
@@ -128,7 +124,6 @@ account.methods.microsoft.profile=Профіль облікового запис
account.methods.microsoft.purchase=Купити Minecraft
account.methods.microsoft.snapshot=Ви використовуєте неофіційну збірку HMCL. Будь ласка, завантажте <a href="https://hmcl.huangyuhui.net/download">офіційну збірку</a> для входу.
account.methods.microsoft.snapshot.tooltip=Ви використовуєте неофіційну збірку HMCL. Будь ласка, завантажте офіційну збірку для оновлення акаунта.
account.methods.microsoft.snapshot.website=Офіційний сайт
account.methods.offline=Автономно
account.methods.offline.name.special_characters=Використовуйте лише літери, цифри та підкреслення (макс. 16 символів)
account.methods.offline.name.invalid=Рекомендується використовувати лише англійські літери, цифри та підкреслення для імені користувача, довжина не повинна перевищувати 16 символів.\n\
@@ -191,10 +186,16 @@ addon.dependency.tool=Обов'язкові залежності (Необхід
addon.dependency.include=Вбудовані залежності (Вже упаковані у файл доповнення автором. Не потрібно завантажувати окремо)
addon.dependency.incompatible=Несумісні доповнення (Одночасне встановлення цих доповнень перешкодить запуску гри)
addon.dependency.broken=Зламані залежності (Це доповнення існувало раніше, але його більше немає. Спробуйте використати інше джерело завантаження.)
# addon.dependencies.has_broken=
addon.download.recommend=Рекомендована версія для Minecraft %1s
addon.download.title.release=Minecraft %s
addon.download.title.snapshot=Minecraft %s (Снапшоти)
addon.modrinth=Modrinth
addon.sort.date_created=Дата створення
addon.sort.last_updated=Останнє оновлення
addon.sort.popularity=Популярність
# addon.sort.relevancy=
addon.sort.total_downloads=Всього завантажень
archive.author=Автор(и)
archive.date=Дата публікації
@@ -371,13 +372,6 @@ curse.category.6553=Реалістично
curse.category.6554=Фентезі
curse.category.6555=Ваніла
curse.sort.author=Автор
curse.sort.date_created=Дата створення
curse.sort.last_updated=Останнє оновлення
curse.sort.name=Назва
curse.sort.popularity=Популярність
curse.sort.total_downloads=Всього завантажень
datetime.format=dd.MM.yyyy, HH:mm:ss
download=Завантажити
@@ -446,7 +440,7 @@ fatal.config_loading_failure=Не вдається завантажити фай
Для macOS спробуйте помістити HMCL кудись із дозволами, відмінними від "Робочий стіл", "Завантаження" та "Документи", і спробуйте знову.
fatal.config_loading_failure.unix=Hello Minecraft! Лаунчер не зміг завантажити файл конфігурації, оскільки він був створений користувачем "%1$s".\n\
Відкрийте HMCL як користувач root (не рекомендується) або виконайте наступну команду в терміналі, щоб змінити власника файлу конфігурації на поточного користувача:\n%2$s
fatal.config_unsupported_version=Поточний файл конфігурації був створений новішою версією Hello Minecraft! Launcher, і ця версія HMCL не може завантажити його належним чином.\n\
fatal.config_unsupported_version=Поточний файл конфігурації був створений новішою версією HMCL, і ця версія HMCL не може завантажити його належним чином.\n\
Будь ласка, оновіть та перезапустіть HMCL.\n\
До оновлення лаунчера будь-які змінені вами налаштування не будуть збережені.
fatal.mac_app_translocation=Hello Minecraft! Лаунчер ізольовано до тимчасового каталогу ОС через механізми безпеки macOS.\n\
@@ -459,7 +453,6 @@ fatal.apply_update_failure=Вибачте, але Hello Minecraft! Лаунче
fatal.apply_update_need_win7=Hello Minecraft! Лаунчер не може автоматично оновитися на Windows XP/Vista. \n\
Ви можете оновити вручну, завантаживши новішу версію лаунчера з %s.
fatal.deprecated_java_version=У майбутньому HMCL потребуватиме Java 17 або новішої версії для роботи, але все ще підтримуватиме запуск ігор на Java 6~16.\n\nРекомендується встановити останню версію Java, щоб гарантувати належну роботу HMCL.\n\nВи можете продовжувати зберігати стару версію Java. HMCL може розпізнавати та керувати декількома версіями Java і автоматично вибере відповідну Java для вас на основі версії гри.
fatal.deprecated_java_version.update=У майбутньому HMCL потребуватиме Java 17 або новішої версії для роботи. Будь ласка, встановіть останню версію Java, щоб HMCL міг завершити оновлення.\n\nВи можете продовжувати зберігати стару версію Java. HMCL може розпізнавати та керувати декількома версіями Java і автоматично вибере відповідну Java для вас на основі версії гри.
fatal.deprecated_java_version.download_link=Завантажити Java %d
fatal.samba=Якщо ви відкрили Hello Minecraft! Лаунчер з мережевого диска Samba, деякі функції можуть не працювати. Спробуйте оновити вашу Java або перемістити лаунчер в інший каталог.
fatal.illegal_char=Ваш шлях користувача містить недопустимий символ "=". Ви не зможете використовувати authlib-injector або змінювати скін вашого автономного облікового запису.
@@ -691,6 +684,7 @@ game_directory.instance_directory.choose=Вибрати каталог гри
game_directory.name=Назва
game_directory.new=Новий каталог
game_directory.use_relative_path=Використовувати відносний шлях для каталогу гри, якщо можливо
# game_directory.root=
help=Допомога
help.doc=Документація Hello Minecraft! Лаунчера
@@ -703,6 +697,7 @@ input.url=Введення має бути дійсною URL-адресою.
install=Новий екземпляр
install.change_version=Змінити версію
# install.change_version.title=
install.change_version.confirm=Ви впевнені, що хочете переключити %s з версії %s на %s?
install.change_version.process=Процес зміни версії
install.failed=Не вдалося встановити
@@ -711,18 +706,19 @@ install.failed.downloading.detail=Не вдалося завантажити ф
install.failed.downloading.timeout=Час очікування завантаження при отриманні: %s
install.failed.install_online=Не вдалося ідентифікувати наданий файл. Якщо ви встановлюєте мод, перейдіть на сторінку "Моди".
install.failed.malformed=Завантажені файли пошкоджені. Ви можете спробувати вирішити цю проблему, переключившись на інше джерело завантаження у "Налаштування → Завантаження → Джерело завантаження".
# install.failed.cleanroom_not_compatible_with_forge=
install.failed.optifine_conflict=Не можна встановити OptiFine та Fabric одночасно на Minecraft 1.13 або новішому.
install.failed.optifine_forge_1.17=Для Minecraft 1.17.1 Forge сумісний лише з OptiFine H1 pre2 або новішою. Ви можете встановити їх, позначивши "Снапшоти" при виборі версії OptiFine в HMCL.
install.failed.version_mismatch=Цей завантажувач вимагає версію гри %s, але встановлена %s.
install.installer.change_version=%s Несумісний
install.installer.choose=Виберіть вашу версію %s
install.installer.do_not_install=Не встановлювати
install.installer.cleanroom=Cleanroom
install.installer.do_not_install=Не встановлювати
install.installer.fabric=Fabric
install.installer.fabric-api=Fabric API
install.installer.fabric-quilt-api.warning=%1$s - це мод, і він буде встановлений у каталог модів екземпляра гри. Не змінюйте робочий каталог гри, інакше %1$s не працюватиме. Якщо ви все ж хочете змінити каталог, вам слід перевстановити його.
install.installer.legacyfabric=Legacy Fabric
install.installer.legacyfabric-api=Legacy Fabric API
install.installer.fabric-quilt-api.warning=%1$s - це мод, і він буде встановлений у каталог модів екземпляра гри. Не змінюйте робочий каталог гри, інакше %1$s не працюватиме. Якщо ви все ж хочете змінити каталог, вам слід перевстановити його.
install.installer.forge=Forge
install.installer.neoforge=NeoForge
install.installer.game=Minecraft
@@ -779,8 +775,8 @@ instance.manage=Усі екземпляри
instance.manage.clean=Видалити файли журналів
instance.manage.clean.tooltip=Видалити файли в каталогах "logs" та "crash-reports".
instance.manage.duplicate=Дублювати екземпляр
instance.manage.duplicate.prompt=Введіть нову назву екземпляра
instance.manage.duplicate.duplicate_save=Дублювати світи
instance.manage.duplicate.prompt=Введіть нову назву екземпляра
instance.manage.duplicate.confirm=Дубльований екземпляр матиме копію всіх файлів у каталозі екземпляра (".minecraft/versions/<назва екземпляра>"), з ізольованим робочим каталогом та налаштуваннями.
instance.manage.manage=Редагувати екземпляр
instance.manage.manage.title=Редагувати екземпляр - %1s
@@ -845,6 +841,9 @@ launch.advice.forge28_2_2_optifine=Forge версії 28.2.2 або новішо
launch.advice.forge37_0_60=Forge версій до 37.0.60 несумісний з Java 17. Оновіть Forge до 37.0.60 або новішої, або запустіть гру з Java 16.
launch.advice.java8_51_1_13=Minecraft 1.13 може зазнати збою на версіях Java 8 до 1.8.0_51. Встановіть останню версію Java 8.
launch.advice.java9=Ви не можете запустити Minecraft 1.12 або раніші з Java 9 або новішою. Використовуйте Java 8.
# launch.advice.lwjgl_3_4_1=
# launch.advice.lwjgl_3_4_1=Поточна версія гри має відому проблему, яка може спричинити підвисання у грі.\nHMCL може автоматично оптимізувати продуктивність гри (використовуючи Java Agent).\nЧи дозволяєте ви HMCL автоматично оптимізувати гру?\nЯкщо у вас виникнуть проблеми, ви можете вимкнути опцію "Дозволити HMCL змінювати гру" у "Налаштування → Загальні".
launch.advice.lwjgl_3_4_1.title=Дозволити HMCL автоматично оптимізувати гру?
launch.advice.modded_java=Деякі моди можуть бути несумісні з новішими версіями Java. Рекомендується використовувати Java %s для запуску Minecraft %s.
launch.advice.modlauncher8=Версія Forge, яку ви використовуєте, несумісна з поточною версією Java. Спробуйте оновити Forge.
launch.advice.newer_java=Ви використовуєте старішу версію Java для запуску гри. Рекомендується оновити до Java 8, інакше деякі моди можуть призвести до збою гри.
@@ -853,8 +852,6 @@ launch.advice.require_newer_java_version=Поточна версія гри ви
launch.advice.too_large_memory_for_32bit=Ви виділили розмір пам'яті, більший за обмеження пам'яті 32-бітної інсталяції Java. Ви можете не змогти запустити гру.
launch.advice.vanilla_linux_java_8=Minecraft 1.12.2 або раніші підтримують лише Java 8 для платформи Linux x86-64, оскільки новіші версії не можуть завантажити 32-бітні нативні бібліотеки, такі як liblwjgl.so. Завантажте її з java.com або встановіть OpenJDK 8.
launch.advice.vanilla_x86.translation=Minecraft не повністю підтримується на вашій платформі, тому ви можете зіткнутися з відсутністю функцій або навіть не зможете запустити гру. Ви можете завантажити Java для архітектури <b>x86-64</b> <a href="https://learn.microsoft.com/java/openjdk/download">тут</a> для повного ігрового досвіду.
# launch.advice.lwjgl_3_4_1=Поточна версія гри має відому проблему, яка може спричинити підвисання у грі.\nHMCL може автоматично оптимізувати продуктивність гри (використовуючи Java Agent).\nЧи дозволяєте ви HMCL автоматично оптимізувати гру?\nЯкщо у вас виникнуть проблеми, ви можете вимкнути опцію "Дозволити HMCL змінювати гру" у "Налаштування → Загальні".
launch.advice.lwjgl_3_4_1.title=Дозволити HMCL автоматично оптимізувати гру?
launch.advice.unknown=Гра не може бути запущена з наступних причин:
launch.failed=Не вдалося запустити
launch.failed.cannot_create_jvm=Ми не можемо створити JVM. Це може бути через неправильні аргументи JVM. Ви можете спробувати вирішити це, видаливши всі аргументи, які ви додали у "Глобальні/Специфічні налаштування екземпляра → Розширені налаштування → Параметри JVM".
@@ -900,8 +897,6 @@ launcher.background.load_policy.wait_for_background=Очікувати на тл
launcher.background.loading=Завантаження тла
launcher.background.network=З URL
launcher.background.network.cache=Кешувати зображення з URL-адрес
launcher.background.network.cache.disabled=Вимкнено
launcher.background.network.cache.enabled=Увімкнено
launcher.background.paint=Суцільний колір
launcher.background.theme=Слідувати темі
launcher.background.theme_color=За кольором теми
@@ -1113,7 +1108,6 @@ modrinth.category.velocity=Velocity
modrinth.category.waterfall=Waterfall
modrinth.category.worldgen=Генерація світу
modrinth.category.8x-=×8 і менше
modrinth.category.16x=×16
modrinth.category.32x=×32
modrinth.category.48x=×48
modrinth.category.64x=×64
@@ -1369,14 +1363,9 @@ settings.advanced.launcher_visibility.keep=Залишити лаунчер ви
settings.advanced.launcher_visible=Видимість лаунчера
settings.advanced.minecraft_arguments=Аргументи запуску
settings.advanced.minecraft_arguments.prompt=Типово
settings.advanced.natives=Нативні бібліотеки
settings.advanced.natives_settings=Налаштування нативних бібліотек
settings.advanced.natives_directory=Шлях до нативних бібліотек
settings.advanced.natives_directory.choose=Виберіть місце розташування бажаних нативних бібліотек
settings.advanced.natives_directory.custom=Власний
settings.advanced.natives_directory.custom.enabled=Використовувати власні нативні бібліотеки
settings.advanced.natives_directory.default=Типово
settings.advanced.natives_directory.default.version_id=<Назва екземпляра>
settings.advanced.no_jvm_args=Не додавати типові аргументи JVM
settings.advanced.no_optimizing_jvm_args=Не додавати типові аргументи оптимізації JVM
settings.advanced.precall_command=Команда перед запуском
@@ -1443,6 +1432,7 @@ settings.advanced.server_ip.prompt=Автоматично приєднатися
settings.advanced.unsupported_system_options=Налаштування, що не застосовуються до поточної системи
settings.advanced.use_native_glfw_or_sdl=Використовувати системний GLFW / SDL
settings.advanced.use_native_openal=Використовувати системний OpenAL
# settings.advanced.use_native_sdl=
settings.advanced.linux_freebsd_only=Лише Linux/FreeBSD
settings.advanced.windows_only=Тільки для Windows
settings.advanced.wrapper_launcher=Команда обгортки
@@ -1491,9 +1481,7 @@ settings.game.window_type=Тип вікна гри
settings.game.window_type.fullscreen=На весь екран
settings.game.window_type.maximized=Розгорнуте
settings.game.window_type.windowed=Віконне
settings.game.working_directory=Робочий каталог
settings.game.working_directory.choose=Вибрати робочий каталог
settings.game.working_directory.hint=Увімкніть опцію "Ізольовано" в "Робоча директорія", щоб дозволити поточному екземпляру зберігати свої налаштування, світи та моди в окремій директорії.\n\ \n\ Рекомендується увімкнути цю опцію, щоб уникнути конфліктів модів, але вам доведеться перенести ваші світи вручну.
settings.icon=Іконка
settings.game_directories.read_only=Файл директорії гри був збережений новішою версією HMCL. Поточна версія HMCL не може змінювати директорії гри.
@@ -1507,7 +1495,6 @@ settings.launcher.brightness=Режим теми
settings.launcher.brightness.auto=Слідувати системним налаштуванням
settings.launcher.brightness.dark=Темний режим
settings.launcher.brightness.light=Світлий режим
settings.launcher.common_path.tooltip=HMCL розмістить усі ігрові ресурси та залежності тут. Якщо в каталозі гри вже є існуючі бібліотеки, тоді HMCL спочатку надасть перевагу їх використанню.
settings.launcher.debug=Налагодження
settings.launcher.disable_april_fools=Не вмикати першоквітневі функції
settings.launcher.disable_auto_game_options=Не змінювати мову гри
@@ -1746,6 +1733,7 @@ update.channel.nightly.hint=Ви зараз використовуєте збі
update.channel.nightly.title=Повідомлення каналу Нічний
update.channel.stable=Реліз
update.checking=Перевірка оновлень
# update.check_failed=
update.disable_auto_show_update_dialog=Не показувати діалогове вікно оновлення автоматично
update.disable_auto_show_update_dialog.subtitle=Увімкніть цю опцію, щоб HMCL автоматично не показував діалогове вікно оновлення.
update.failed=Не вдалося оновити
@@ -1759,6 +1747,7 @@ update.latest=Це остання версія
update.tooltip=Оновити
update.preview=Ранній попередній перегляд випусків HMCL
update.preview.subtitle=Увімкніть цю опцію, щоб отримувати нові версії HMCL раніше для тестування перед їх офіційним випуском.
# update.unverified=
warning.java_interpreted_mode=HMCL працює в інтерпретованому середовищі Java, що значно вплине на продуктивність.\n\ \n\ Для найкращого досвіду ми рекомендуємо використовувати Java з підтримкою JIT для запуску HMCL.
warning.software_rendering=Наразі HMCL використовує програмний рендеринг, що значно вплине на продуктивність.
@@ -190,6 +190,11 @@ addon.download.recommend=推荐版本 - Minecraft %1s
addon.download.title.release=Minecraft %s
addon.download.title.snapshot=Minecraft %s (快照)
addon.modrinth=Modrinth
addon.sort.date_created=创建日期
addon.sort.last_updated=最近更新
addon.sort.popularity=热度
addon.sort.relevancy=相关度
addon.sort.total_downloads=下载量
archive.author=作者
archive.date=发布日期
@@ -209,8 +214,8 @@ button.delete=删除
button.disable=禁用
button.do_not_show_again=不再显示
button.edit=修改
button.install=安装
button.enable=启用
button.install=安装
button.export=导出
button.no=否
button.ok=确定
@@ -226,20 +231,20 @@ button.select_all=全选
button.view=查看
button.yes=是
color.recent=推荐
color.custom=自定义颜色
contact=反馈
contact.chat=官方群组
contact.chat.discord=Discord
contact.chat.discord.statement=欢迎加入 Discord 服务器,加入后请遵守讨论区规定
contact.chat.qq_group=用户 QQ 群
contact.chat.qq_group.statement=欢迎加入 HMCL 官方 QQ 群,加入后请遵守群规
contact.feedback=提交反馈
contact.feedback.github=GitHub Issue
contact.feedback.github.statement=提交一个 GitHub Issue
contact.chat=官方群组
contact.chat.qq_group=用户 QQ 群
contact.chat.qq_group.statement=欢迎加入 HMCL 官方 QQ 群,加入后请遵守群规
contact.chat.discord=Discord
contact.chat.discord.statement=欢迎加入 Discord 服务器,加入后请遵守讨论区规定
crash.NoClassDefFound=请确认 Hello Minecraft! Launcher 本体是否完整,或更新你的 Java。\n你可以访问 https://docs.hmcl.net/help.html 页面寻求帮助。
color.recent=推荐
color.custom=自定义颜色
crash.NoClassDefFound=请确认 HMCL 本体是否完整,或更新你的 Java。\n你可以访问 https://docs.hmcl.net/help.html 页面寻求帮助。
crash.user_fault=你的系统或 Java 环境可能安装不当导致本软件崩溃,请检查你的 Java 环境或你的电脑。\n你可以访问 https://docs.hmcl.net/help.html 页面寻求帮助。
curse.category.0=全部
@@ -270,14 +275,14 @@ curse.category.5299=教育
curse.category.5232=额外行星
curse.category.5129=原版增强
curse.category.5189=实用与 QOL
curse.category.5190=QOL
curse.category.5191=实用与 QOL
curse.category.5192=梦幻菜单
curse.category.6145=空岛
curse.category.6814=性能
curse.category.6954=动态联合/集成动力 (Integrated Dynamics)
curse.category.6484=机械动力 (Create)
curse.category.6821=错误修复
curse.category.6145=空岛
curse.category.5190=QOL
curse.category.5191=实用与 QOL
curse.category.5192=梦幻菜单
curse.category.423=信息展示
curse.category.426=模组扩展
curse.category.434=装备武器
@@ -288,10 +293,10 @@ curse.category.429=工业 (Industrialcraft)
curse.category.419=魔法
curse.category.412=科技
curse.category.4557=红石
curse.category.428=匠魂
curse.category.8937=ModJam 2025
curse.category.9026=创造模式
curse.category.10775=恐怖
curse.category.428=匠魂
curse.category.414=交通运输
curse.category.4486=幸运方块 (Lucky Blocks)
curse.category.432=建筑 (Buildcraft)
@@ -371,13 +376,6 @@ curse.category.6553=写实
curse.category.6554=幻想
curse.category.6555=原生
curse.sort.author=作者
curse.sort.date_created=创建日期
curse.sort.last_updated=最近更新
curse.sort.name=名称
curse.sort.popularity=热度
curse.sort.total_downloads=下载量
datetime.format=yyyy 年 MM 月 dd 日 HH:mm:ss
download=下载
@@ -430,27 +428,27 @@ extension.resourcepack=资源包压缩包
extension.schematic=原理图文件
extension.world=世界压缩包
fatal.create_hmcl_current_directory_failure=Hello Minecraft! Launcher 无法创建 HMCL 文件夹 (%s),请将 HMCL 移动至其他位置再启动。\n如遇到问题,你可以访问 https://docs.hmcl.net/help.html 页面寻求帮助。
fatal.create_hmcl_current_directory_failure=HMCL 无法创建 HMCL 文件夹 (%s),请将 HMCL 移动至其他位置再启动。\n如遇到问题,你可以访问 https://docs.hmcl.net/help.html 页面寻求帮助。
fatal.javafx.incomplete=JavaFX 运行环境不完整。请尝试更换你的 Java 或者重新安装 OpenJFX。
fatal.javafx.missing=缺少 JavaFX 运行环境。请使用包含 OpenJFX 的 Java 运行环境启动 Hello Minecraft! Launcher。\n你可以访问 https://docs.hmcl.net/help.html 页面寻求帮助。
fatal.config_change_owner_root=你正在使用 root 账户启动 Hello Minecraft! Launcher,这可能导致你未来无法正常使用其他账户正常启动 HMCL。\n你可以访问 https://docs.hmcl.net/help.html 页面寻求帮助。\n是否继续启动?
fatal.config_in_temp_dir=你正在临时文件夹中启动 Hello Minecraft! Launcher,你的设置和游戏数据可能会丢失。建议将 HMCL 移动至其他位置再启动。\n你可以访问 https://docs.hmcl.net/help.html 页面寻求帮助。\n是否继续启动?
fatal.config_loading_failure=Hello Minecraft! Launcher 无法加载配置文件。\n请确保 HMCL 对“%s”文件夹及该文件夹下的文件拥有读写权限。\n对于 macOS,尝试将 HMCL 放在除“桌面”“下载”“文稿”之外的有权限的地方再试。\n你可以访问 https://docs.hmcl.net/help.html 页面寻求帮助。
fatal.config_loading_failure.unix=Hello Minecraft! Launcher 无法加载配置文件,因为配置文件是由用户“%1$s”创建的。\n请使用 root 账户启动 HMCL (不推荐),或在终端中执行以下命令将配置文件的所有权变更为当前用户:\n%2$s\n你可以访问 https://docs.hmcl.net/help.html 页面寻求帮助。
fatal.config_unsupported_version=当前配置文件是由更高版本的 Hello Minecraft! Launcher 创建的,当前版本的 HMCL 无法正常加载。请更新并重启 HMCL。\n在更新启动器之前,你修改的所有设置都不会被保存。\n如果遇到问题,你可以点击右上角帮助按钮进行求助。
fatal.mac_app_translocation=由于 macOS 的安全机制,Hello Minecraft! Launcher 被系统隔离至临时文件夹中。\n请将 HMCL 移动到其他文件夹后再尝试启动,否则你的设置和游戏数据可能会在重启后丢失。\n你可以访问 https://docs.hmcl.net/help.html 页面寻求帮助。\n是否继续启动?
fatal.migration_requires_manual_reboot=Hello Minecraft! Launcher 即将完成升级,请重新打开 HMCL。\n如遇到问题,你可以访问 https://docs.hmcl.net/help.html 页面寻求帮助。
fatal.apply_update_failure=我们很抱歉 Hello Minecraft! Launcher 无法自动完成升级,因为出现了一些问题。\n但你依可以从 %s 手动下载 HMCL 来完成升级。\n你可以访问 https://docs.hmcl.net/help.html 页面寻求帮助。
fatal.apply_update_need_win7=Hello Minecraft! Launcher 无法在 Windows XP/Vista 上进行自动更新。请从 %s 手动下载 HMCL 来完成升级。
fatal.javafx.missing=缺少 JavaFX 运行环境。请使用包含 OpenJFX 的 Java 运行环境启动 HMCL。\n你可以访问 https://docs.hmcl.net/help.html 页面寻求帮助。
fatal.config_change_owner_root=你正在使用 root 账户启动 HMCL,这可能导致你未来无法正常使用其他账户正常启动 HMCL。\n你可以访问 https://docs.hmcl.net/help.html 页面寻求帮助。\n是否继续启动?
fatal.config_in_temp_dir=你正在临时文件夹中启动 HMCL,你的设置和游戏数据可能会丢失。建议将 HMCL 移动至其他位置再启动。\n你可以访问 https://docs.hmcl.net/help.html 页面寻求帮助。\n是否继续启动?
fatal.config_loading_failure=HMCL 无法加载配置文件。\n请确保 HMCL 对“%s”文件夹及该文件夹下的文件拥有读写权限。\n对于 macOS,尝试将 HMCL 放在除“桌面”“下载”“文稿”之外的有权限的地方再试。\n你可以访问 https://docs.hmcl.net/help.html 页面寻求帮助。
fatal.config_loading_failure.unix=HMCL 无法加载配置文件,因为配置文件是由用户“%1$s”创建的。\n请使用 root 账户启动 HMCL (不推荐),或在终端中执行以下命令将配置文件的所有权变更为当前用户:\n%2$s\n你可以访问 https://docs.hmcl.net/help.html 页面寻求帮助。
fatal.config_unsupported_version=当前配置文件是由更高版本的 HMCL 创建的,当前版本的 HMCL 无法正常加载。请更新并重启 HMCL。\n在更新启动器之前,你修改的所有设置都不会被保存。\n如果遇到问题,你可以点击右上角帮助按钮进行求助。
fatal.mac_app_translocation=由于 macOS 的安全机制,HMCL 被系统隔离至临时文件夹中。\n请将 HMCL 移动到其他文件夹后再尝试启动,否则你的设置和游戏数据可能会在重启后丢失。\n你可以访问 https://docs.hmcl.net/help.html 页面寻求帮助。\n是否继续启动?
fatal.migration_requires_manual_reboot=HMCL 即将完成升级,请重新打开 HMCL。\n如遇到问题,你可以访问 https://docs.hmcl.net/help.html 页面寻求帮助。
fatal.apply_update_failure=我们很抱歉 HMCL 无法自动完成升级,因为出现了一些问题。\n但你依可以从 %s 手动下载 HMCL 来完成升级。\n你可以访问 https://docs.hmcl.net/help.html 页面寻求帮助。
fatal.apply_update_need_win7=HMCL 无法在 Windows XP/Vista 上进行自动更新。请从 %s 手动下载 HMCL 来完成升级。
fatal.deprecated_java_version=HMCL 未来需要 Java 17 或更高版本才能运行,但依然支持使用 Java 6~16 启动游戏。建议安装最新版本的 Java 以确保 HMCL 能正常工作。\n你可以继续保留旧版本 Java。HMCL 能够识别与管理多个 Java,并会自动根据游戏版本为你选择合适的 Java。\n你可以访问 https://docs.hmcl.net/help.html 页面寻求帮助。
fatal.deprecated_java_version.download_link=下载 Java %d
fatal.samba=如果你正在通过 Samba 共享的文件夹中运行 Hello Minecraft! Launcher,启动器可能无法正常工作。请尝试更新你的 Java 或在本地文件夹内运行 HMCL。\n你可以访问 https://docs.hmcl.net/help.html 页面寻求帮助。
fatal.samba=如果你正在通过 Samba 共享的文件夹中运行 HMCL,启动器可能无法正常工作。请尝试更新你的 Java 或在本地文件夹内运行 HMCL。\n你可以访问 https://docs.hmcl.net/help.html 页面寻求帮助。
fatal.illegal_char=由于你的运行路径中存在非法字符“=”,你将无法使用外置登录账户以及离线登录更换皮肤功能。\n你可以访问 https://docs.hmcl.net/help.html 页面寻求帮助。
fatal.unsupported_platform=Minecraft 尚未对你的平台提供完善支持,所以可能影响游戏体验或无法启动游戏。\n\
若无法启动 Minecraft 1.17 及更高版本,可以尝试在“(全局/实例特定) 游戏设置 → 图形设置”中将“渲染器”切换为“Mesa LLVMpipe” / “Mesa Lavapipe”,以获得更好的兼容性。\n\
如遇到问题,你可以点击右上角帮助按钮进行求助。
fatal.unsupported_platform.loongarch=Hello Minecraft! Launcher 已为龙芯提供支持。\n如果遇到问题,你可以点击右上角帮助按钮进行求助。
fatal.unsupported_platform.windows_arm64=Hello Minecraft! Launcher 已为 Windows on Arm 平台提供原生支持。如果你在游戏中遇到问题,请尝试使用 x86 架构的 Java 启动游戏。\n如果你正在使用 <b>高通</b> 平台,你可能需要安装 <a href="ms-windows-store://pdp/?productid=9NQPSL29BFFF">OpenGL 兼容包</a> 后才能进行游戏。点击链接前往 Microsoft Store 安装兼容包。\n如遇到问题,你可以点击右上角帮助按钮进行求助。
fatal.unsupported_platform.loongarch=HMCL 已为龙芯提供支持。\n如果遇到问题,你可以点击右上角帮助按钮进行求助。
fatal.unsupported_platform.windows_arm64=HMCL 已为 Windows on Arm 平台提供原生支持。如果你在游戏中遇到问题,请尝试使用 x86 架构的 Java 启动游戏。\n如果你正在使用 <b>高通</b> 平台,你可能需要安装 <a href="ms-windows-store://pdp/?productid=9NQPSL29BFFF">OpenGL 兼容包</a> 后才能进行游戏。点击链接前往 Microsoft Store 安装兼容包。\n如遇到问题,你可以点击右上角帮助按钮进行求助。
# When translating the following string into non-Latin languages, please retain the English translation
fatal.wine_warning=HMCL is running under Wine or one of its distributions.\nAs a cross-platform application, HMCL is best experienced natively on your host OS.\nPress "OK" to continue, but please note that some issues may arise.\n\n您目前正在使用 Wine 或其发行版运行 HMCL。\nHMCL 是跨平台的,我们建议您直接在宿主系统上运行。\n按下“确定”以继续,但请注意,此操作可能会引发一些问题。
@@ -473,14 +471,21 @@ game.crash.feedback=<b>请不要将本界面截图或拍照给他人!</b>如
game.crash.info=游戏信息
game.crash.reason=崩溃原因
game.crash.reason.analyzing=分析中……
game.crash.reason.multiple=检测到多个原因:\n\n
game.crash.reason.block=当前游戏由于某个方块不能正常工作,无法继续运行。\n你可以尝试使用地图编辑工具编辑世界删除该方块,或者直接删除对应的模组。\n方块类型:%1$s\n方块坐标:%2$s\n\n相关工具:<a href="https://minecraft.wiki/w/Tutorial:Programs_and_editors/Mapping#Map_editors">英文 Wiki</a> | <a href="https://zh.minecraft.wiki/w/辅助程序与编辑器/地图工具?variant=zh-cn#地图编辑工具">中文 Wiki</a>
game.crash.reason.bootstrap_failed=当前游戏由于模组“%1$s”出现问题,无法继续运行。\n你可以尝试删除或更新该模组以解决问题。
game.crash.reason.mixin_apply_mod_failed=当前游戏由于 Mixin 无法应用于“%1$s”模组,无法继续运行。\n你可以尝试删除或更新该模组以解决问题。
game.crash.reason.config=当前游戏由于无法解析模组配置文件,无法继续运行。\n无法解析模组“%1$s”的配置文件“%2$s”。
game.crash.reason.multiple=检测到多个原因:\n\n
game.crash.reason.debug_crash=当前游戏由于手动触发崩溃,无法继续运行。\n事实上游戏并没有问题,问题都是你造成的!
game.crash.reason.duplicated_mod=当前游戏由于模组“%1$s”重复安装,无法继续运行。\n%2$s\n每种模组只能安装一个,请你删除多余的模组再试。
game.crash.reason.entity=当前游戏由于某个实体不能正常工作,无法继续运行。\n你可以尝试使用地图编辑工具编辑世界删除该实体,或者直接删除对应的模组。\n实体类型:%1$s\n实体坐标:%2$s\n\n相关工具:<a href="https://minecraft.wiki/w/Tutorial:Programs_and_editors/Mapping#Map_editors">英文 Wiki</a> | <a href="https://zh.minecraft.wiki/w/辅助程序与编辑器/地图工具?variant=zh-cn#地图编辑工具">中文 Wiki</a>
game.crash.reason.modmixin_failure=当前游戏由于某些模组注入失败,无法继续运行。\n这一般代表着该模组存在问题,或与当前环境不兼容。\n你可以查看日志寻找出错模组。
game.crash.reason.forge_error=Forge/NeoForge 可能已经提供了错误信息。\n你可以查看日志,并根据错误报告中的日志信息进行对应处理。\n如果没有看到报错信息,可以查看错误报告了解错误具体是如何发生的。\n%1$s
game.crash.reason.mod_resolution0=当前游戏由于一些模组出现问题,无法继续运行。\n你可以查看日志寻找出错模组。
game.crash.reason.mixin_apply_mod_failed=当前游戏由于 Mixin 无法应用于“%1$s”模组,无法继续运行。\n你可以尝试删除或更新该模组以解决问题。
game.crash.reason.java_version_is_too_high=当前游戏由于 Java 版本过高,无法继续运行。\n请在“(全局/实例特定) 游戏设置 → 游戏 Java”中改用较低版本的 Java,然后再启动游戏。\n如果没有,可以从 <a href="https://www.java.com/download/">java.com (Java 8)</a> 或 <a href="https://bell-sw.com/pages/downloads/#downloads">BellSoft Liberica Full JRE (Java 17)</a> 等平台下载、安装一个 (安装完后需重启启动器)。
game.crash.reason.need_jdk11=当前游戏由于 Java 版本不合适,无法继续运行。\n你需要下载安装 <a href="https://bell-sw.com/pages/downloads/#downloads">Java 11</a>,并在“(全局/实例特定) 游戏设置 → 游戏 Java”中将 Java 设置为 11.x 的版本。
game.crash.reason.mod_name=当前游戏由于模组文件名称问题,无法继续运行。\n模组文件名称应只使用半角的大小写字母 (Aa~Zz)、数字 (0~9)、横线 (-)、下划线 (_)和点 (.)。\n请到模组文件夹中将所有不合规的模组文件名修改为上述合规字符。
game.crash.reason.incomplete_forge_installation=当前游戏由于 Forge/NeoForge 安装不完整,无法继续运行。\n请在“实例管理 → 自动安装”中卸载 Forge 并重新安装。
game.crash.reason.fabric_version_0_12=Fabric Loader 0.12 及更高版本与当前已经安装的模组可能不兼容,你需要将 Fabric Loader 降级至 0.11.7。
game.crash.reason.fabric_warnings=Fabric 提供了一些警告信息:\n%1$s
game.crash.reason.file_already_exists=当前游戏由于文件“%1$s”已经存在,无法继续运行。\n如果你认为这个文件可以删除,你可以在备份这个文件后尝试删除它,并重新启动游戏。
@@ -494,38 +499,31 @@ game.crash.reason.graphics_driver=当前游戏由于显卡驱动问题而崩溃
game.crash.reason.macos_failed_to_find_service_port_for_display=当前游戏由于 Apple Silicon 平台下初始化 OpenGL 窗口失败,无法继续运行。\n对于该问题,HMCL 暂无直接性的解决方案。请你尝试任意打开一个浏览器并全屏,然后再回到 HMCL 启动游戏。在弹出游戏窗口前<b>迅速切回浏览器页面</b>,等待游戏窗口出现后再切回游戏窗口。
game.crash.reason.illegal_access_error=当前游戏由于某些模组的问题,无法继续运行。\n如果你认识“%1$s”,你可以更新或删除对应模组再试。
game.crash.reason.install_mixinbootstrap=当前游戏由于缺失 MixinBootstrap,无法继续运行。\n你可以尝试安装 <a href="https://www.curseforge.com/minecraft/mc-mods/mixinbootstrap">MixinBootstrap</a> 解决该问题。若安装后崩溃,可以尝试在该模组的文件名开头添加半角感叹号 (!) 解决。
game.crash.reason.need_jdk11=当前游戏由于 Java 版本不合适,无法继续运行。\n你需要下载安装 <a href="https://bell-sw.com/pages/downloads/#downloads">Java 11</a>,并在“(全局/实例特定) 游戏设置 → 游戏 Java”中将 Java 设置为 11.x 的版本。
game.crash.reason.optifine_is_not_compatible_with_forge=当前游戏由于 OptiFine 与当前版本的 Forge 不兼容,导致游戏崩溃。\n点击 <a href="https://zkitefly.github.io/optifine-forge-support-list">此处</a> 查看 OptiFine 所兼容的 Forge 版本,并严格按照对应版本重新安装游戏或在“实例管理 → 自动安装”中更换版本。\n经测试,Forge 版本过高或过低都可能导致崩溃。
game.crash.reason.mod_files_are_decompressed=当前游戏由于模组文件被解压了,无法继续运行。\n请直接把整个模组文件放进模组文件夹中即可。\n解压模组文件会导致游戏出错。请删除模组文件夹中已被解压的模组,然后再启动游戏。
game.crash.reason.shaders_mod=当前游戏由于同时安装了 OptiFine 和 Shaders 模组,无法继续运行。\n由于 OptiFine 已集成 Shaders 模组的功能,所以只需删除 Shaders 模组即可。
game.crash.reason.rtss_forest_sodium=当前游戏由于 RivaTuner Statistics Server (RTSS) 与 Sodium 不兼容,导致游戏崩溃。\n点击 <a href="https://github.com/CaffeineMC/sodium-fabric/wiki/Known-Issues#rtss-incompatible">此处</a> 查看详情。
game.crash.reason.too_many_mods_lead_to_exceeding_the_id_limit=当前游戏由于你所安装的模组过多,超出了游戏的 ID 限制,无法继续运行。\n请尝试安装 <a href="https://www.curseforge.com/minecraft/mc-mods/jeid">JEID</a> 等修复模组,或删除部分大型模组。
game.crash.reason.night_config_fixes=当前游戏由于 Night Config 库的一些问题,无法继续运行。\n你可以尝试安装 <a href="https://www.curseforge.com/minecraft/mc-mods/night-config-fixes">Night Config Fixes</a> 模组,这或许能帮助你解决这个问题。\n更多详情,可访问该模组的 <a href="https://github.com/Fuzss/nightconfigfixes">GitHub 仓库</a>。
game.crash.reason.optifine_causes_the_world_to_fail_to_load=当前游戏可能由于 OptiFine 而无法继续运行。\n该问题只在特定 OptiFine 版本中出现,你可以尝试在“实例管理 → 自动安装”中更换 OptiFine 的版本。
game.crash.reason.jdk_9=当前游戏由于 Java 版本过高,无法继续运行。\n你需要下载安装 <a href="https://bell-sw.com/pages/downloads/#downloads">Java 8</a>,并在“(全局/实例特定) 游戏设置 → 游戏 Java”中将 Java 设置为 1.8.x 的版本。
game.crash.reason.jvm_32bit=当前游戏由于内存分配过大,超过了 32 位 Java 虚拟机内存限制,无法继续运行。\n如果你的电脑是 64 位系统,请下载安装并更换 64 位 Java。<a href="https://bell-sw.com/pages/downloads/#downloads">下载 Java</a>\n如果你的电脑是 32 位系统,你或许可以重新安装 64 位系统,或换一台新电脑。\n或者,你可以在“(全局/实例特定) 游戏设置 → 游戏内存”中关闭“自动分配内存”,并把内存分配值调整为 1024 MiB 或以下。
game.crash.reason.loading_crashed_forge=当前游戏由于模组“%1$s (%2$s)”错误,无法继续运行。\n你可以尝试删除或更新该模组以解决问题。
game.crash.reason.loading_crashed_fabric=当前游戏由于模组“%1$s”错误,无法继续运行。\n你可以尝试删除或更新该模组以解决问题。
game.crash.reason.memory_exceeded=当前游戏由于内存分配过大,无法继续运行。\n该问题是由于系统页面文件太小导致的。\n你需要在“(全局/实例特定) 游戏设置”中关闭“自动分配内存”,并将内存分配值调低至游戏能正常启动为止。\n你还可以尝试将虚拟内存设置调整为“自动管理所有驱动器分页文件大小”,<a href="https://docs.hmcl.net/assets/img/hmcl/自动管理所有驱动器分页文件大小.webp">详情</a>。
game.crash.reason.mac_jdk_8u261=当前游戏由于你所使用的 Forge/OptiFine 与 Java 冲突而崩溃。\n请尝试更新 Forge/OptiFine,或使用 Java 8u251 及更早版本启动。
game.crash.reason.forge_repeat_installation=当前游戏由于 Forge 重复安装,无法继续运行。<a href="https://github.com/HMCL-dev/HMCL/issues/1880">此为已知问题</a>\n建议将日志上传并反馈至 GitHub,以便我们找到更多线索并修复此问题。\n目前你可以在“实例管理 → 自动安装”中卸载 Forge 并重新安装。
game.crash.reason.optifine_repeat_installation=当前游戏由于 OptiFine 重复安装,无法继续运行。\n请删除模组文件夹下的 OptiFine 或前往“实例管理 → 自动安装”卸载安装的 OptiFine。
game.crash.reason.memory_exceeded=当前游戏由于内存分配过大,无法继续运行。\n该问题是由于系统页面文件太小导致的。\n你需要在“(全局/实例特定) 游戏设置”中关闭“自动分配内存”,并将内存分配值调低至游戏能正常启动为止。\n你还可以尝试将虚拟内存设置调整为“自动管理所有驱动器分页文件大小”,<a href="https://docs.hmcl.net/assets/img/hmcl/自动管理所有驱动器分页文件大小.webp">详情</a>。
game.crash.reason.mod=当前游戏由于“%1$s”的问题,无法继续运行。\n你可以更新或删除已经安装的“%1$s”再试。
game.crash.reason.mod_resolution=当前游戏由于模组依赖问题,无法继续运行。Fabric 提供了如下信息:\n%1$s
game.crash.reason.forgemod_resolution=当前游戏由于模组依赖问题,无法继续运行。Forge/NeoForge 提供了如下信息:\n%1$s
game.crash.reason.forge_found_duplicate_mods=当前游戏由于模组重复安装,无法继续运行。Forge/NeoForge 提供了如下信息:\n%1$s
game.crash.reason.mod_resolution_collection=当前游戏由于前置模组版本不匹配,无法继续运行。\n“%1$s”需要前置模组“%2$s”才能继续运行。\n这表示你需要更新或降级前置模组。你可以前往“下载 → 模组”页面或网上下载“%3$s”。
game.crash.reason.mod_resolution_conflict=当前游戏由于模组冲突,无法继续运行。\n“%1$s”与“%2$s”不兼容。
game.crash.reason.mod_resolution_missing=当前游戏由于缺少前置模组,无法继续运行。\n“%1$s”需要前置模组“%2$s”才能继续运行。\n这表示有一些必需的模组没有安装,或该模组版本不匹配。你可以前往“下载 → 模组”页面或网上下载“%3$s”。
game.crash.reason.mod_resolution_missing_minecraft=当前游戏由于模组和 Minecraft 游戏版本不匹配,无法继续运行。\n“%1$s”需要 Minecraft %2$s 才能运行。\n如果你要继续使用你已经安装的模组,你可以选择安装对应的 Minecraft 版本。如果你要继续使用当前 Minecraft 版本,你需要安装对应版本的模组。
game.crash.reason.mod_resolution_mod_version=%1$s (版本号 %2$s)
game.crash.reason.mod_resolution_mod_version.any=%1$s (任意版本)
game.crash.reason.forge_repeat_installation=当前游戏由于 Forge 重复安装,无法继续运行。<a href="https://github.com/HMCL-dev/HMCL/issues/1880">此为已知问题</a>\n建议将日志上传并反馈至 GitHub,以便我们找到更多线索并修复此问题。\n目前你可以在“实例管理 → 自动安装”中卸载 Forge 并重新安装。
game.crash.reason.optifine_repeat_installation=当前游戏由于 OptiFine 重复安装,无法继续运行。\n请删除模组文件夹下的 OptiFine 或前往“实例管理 → 自动安装”卸载安装的 OptiFine。
game.crash.reason.forgemod_resolution=当前游戏由于模组依赖问题,无法继续运行。Forge/NeoForge 提供了如下信息:\n%1$s
game.crash.reason.forge_found_duplicate_mods=当前游戏由于模组重复安装,无法继续运行。Forge/NeoForge 提供了如下信息:\n%1$s
game.crash.reason.modmixin_failure=当前游戏由于某些模组注入失败,无法继续运行。\n这一般代表着该模组存在问题,或与当前环境不兼容。\n你可以查看日志寻找出错模组。
game.crash.reason.night_config_fixes=当前游戏由于 Night Config 库的一些问题,无法继续运行。\n你可以尝试安装 <a href="https://www.curseforge.com/minecraft/mc-mods/night-config-fixes">Night Config Fixes</a> 模组,这或许能帮助你解决这个问题。\n更多详情,可访问该模组的 <a href="https://github.com/Fuzss/nightconfigfixes">GitHub 仓库</a>。
game.crash.reason.forge_error=Forge/NeoForge 可能已经提供了错误信息。\n你可以查看日志,并根据错误报告中的日志信息进行对应处理。\n如果没有看到报错信息,可以查看错误报告了解错误具体是如何发生的。\n%1$s
game.crash.reason.mod_resolution0=当前游戏由于一些模组出现问题,无法继续运行。\n你可以查看日志寻找出错模组。
game.crash.reason.java_version_is_too_high=当前游戏由于 Java 版本过高,无法继续运行。\n请在“(全局/实例特定) 游戏设置 → 游戏 Java”中改用较低版本的 Java,然后再启动游戏。\n如果没有,可以从 <a href="https://www.java.com/download/">java.com (Java 8)</a> 或 <a href="https://bell-sw.com/pages/downloads/#downloads">BellSoft Liberica Full JRE (Java 17)</a> 等平台下载、安装一个 (安装完后需重启启动器)。
game.crash.reason.mod_name=当前游戏由于模组文件名称问题,无法继续运行。\n模组文件名称应只使用半角的大小写字母 (Aa~Zz)、数字 (0~9)、横线 (-)、下划线 (_)和点 (.)。\n请到模组文件夹中将所有不合规的模组文件名修改为上述合规字符。
game.crash.reason.incomplete_forge_installation=当前游戏由于 Forge/NeoForge 安装不完整,无法继续运行。\n请在“实例管理 → 自动安装”中卸载 Forge 并重新安装。
game.crash.reason.optifine_is_not_compatible_with_forge=当前游戏由于 OptiFine 与当前版本的 Forge 不兼容,导致游戏崩溃。\n点击 <a href="https://zkitefly.github.io/optifine-forge-support-list">此处</a> 查看 OptiFine 所兼容的 Forge 版本,并严格按照对应版本重新安装游戏或在“实例管理 → 自动安装”中更换版本。\n经测试,Forge 版本过高或过低都可能导致崩溃。
game.crash.reason.mod_files_are_decompressed=当前游戏由于模组文件被解压了,无法继续运行。\n请直接把整个模组文件放进模组文件夹中即可。\n解压模组文件会导致游戏出错。请删除模组文件夹中已被解压的模组,然后再启动游戏。
game.crash.reason.shaders_mod=当前游戏由于同时安装了 OptiFine 和 Shaders 模组,无法继续运行。\n由于 OptiFine 已集成 Shaders 模组的功能,所以只需删除 Shaders 模组即可。
game.crash.reason.rtss_forest_sodium=当前游戏由于 RivaTuner Statistics Server (RTSS) 与 Sodium 不兼容,导致游戏崩溃。\n点击 <a href="https://github.com/CaffeineMC/sodium-fabric/wiki/Known-Issues#rtss-incompatible">此处</a> 查看详情。
game.crash.reason.too_many_mods_lead_to_exceeding_the_id_limit=当前游戏由于你所安装的模组过多,超出了游戏的 ID 限制,无法继续运行。\n请尝试安装 <a href="https://www.curseforge.com/minecraft/mc-mods/jeid">JEID</a> 等修复模组,或删除部分大型模组。
game.crash.reason.optifine_causes_the_world_to_fail_to_load=当前游戏可能由于 OptiFine 而无法继续运行。\n该问题只在特定 OptiFine 版本中出现,你可以尝试在“实例管理 → 自动安装”中更换 OptiFine 的版本。
game.crash.reason.modlauncher_8=当前游戏由于你所使用的 Forge 版本与当前使用的 Java 冲突而崩溃。请尝试更新 Forge 到 36.2.26 或更高版本或换用版本低于 1.8.0.320 的 Java。<a href="https://bell-sw.com/pages/downloads/?version=java-8&package=jre-full">Liberica JDK 8u312+7</a>
game.crash.reason.no_class_def_found_error=当前游戏由于代码不完整,无法继续运行。\n你的游戏可能缺失了某个模组,或者某些模组文件不完整,或者模组与游戏的版本不匹配。\n你可能需要重新安装游戏和模组,或寻求他人帮助。\n缺失:\n%1$s
game.crash.reason.no_such_method_error=当前游戏由于代码不完整,无法继续运行。\n你的游戏可能缺失了某个模组,或者某些模组文件不完整,或者模组与游戏的版本不匹配。\n你可能需要重新安装游戏和模组,或寻求他人帮助。
@@ -553,7 +551,7 @@ game_directory.use_relative_path=若可能,游戏文件夹使用相对路径
game_directory.root=使用磁盘根目录作为游戏文件夹可能会导致无法启动游戏,并会在磁盘根目录下创建多个文件(夹)。\n\n确定要继续吗?
help=帮助
help.doc=Hello Minecraft! Launcher 帮助文档
help.doc=HMCL 帮助文档
help.detail=可查阅数据包、整合包制作指南等内容
input.email=用户名必须是邮箱
@@ -581,9 +579,9 @@ install.installer.choose=选择 %s 版本
install.installer.cleanroom=Cleanroom
install.installer.do_not_install=不安装
install.installer.fabric=Fabric
install.installer.fabric-api=Fabric API
install.installer.legacyfabric=Legacy Fabric
install.installer.legacyfabric-api=Legacy Fabric API
install.installer.fabric-api=Fabric API
install.installer.fabric-quilt-api.warning=%1$s 是一个模组,将会被安装到新游戏的模组文件夹。请你在安装游戏后不要修改当前游戏的“版本隔离”设置。如果你在之后修改了相关设置,则需要重新安装 %1$s。
install.installer.forge=Forge
install.installer.neoforge=NeoForge
@@ -772,9 +770,9 @@ launcher.cache_directory.default=默认 ("%APPDATA%/.minecraft" 或 "~/.minecraf
launcher.cache_directory.disabled=禁用 (总是使用游戏文件夹路径)
launcher.cache_directory.invalid=无法创建自定义的缓存文件夹。已经恢复到默认设置。
launcher.contact=联系我们
launcher.crash=Hello Minecraft! Launcher 遇到了无法处理的错误。请复制下列内容并点击右下角的按钮反馈问题。
launcher.crash.java_internal_error=Hello Minecraft! Launcher 由于当前 Java 损坏而无法继续运行。请卸载当前 Java,点击 <a href="https://bell-sw.com/pages/downloads/#downloads">此处</a> 安装合适的 Java 版本。
launcher.crash.hmcl_out_dated=Hello Minecraft! Launcher 遇到了无法处理的错误。已检测到你的启动器不是最新版本,请更新后再试。
launcher.crash=HMCL 遇到了无法处理的错误。请复制下列内容并点击右下角的按钮反馈问题。
launcher.crash.java_internal_error=HMCL 由于当前 Java 损坏而无法继续运行。请卸载当前 Java,点击 <a href="https://bell-sw.com/pages/downloads/#downloads">此处</a> 安装合适的 Java 版本。
launcher.crash.hmcl_out_dated=HMCL 遇到了无法处理的错误。已检测到你的启动器不是最新版本,请更新后再试。
launcher.update_java=请更新你的 Java。\n你可以访问 https://docs.hmcl.net/help.html 页面寻求帮助。
libraries.download=下载依赖库
@@ -792,6 +790,7 @@ logwindow.export_game_crash_logs=导出游戏崩溃信息
logwindow.export_dump=导出游戏运行栈
logwindow.export_dump.no_dependency=你的 Java 不包含用于创建游戏运行栈的依赖。请前往 HMCL QQ 群或 Discord 寻求帮助。
message.cancelled=操作被取消
message.confirm=提示
message.copied=已复制到剪贴板
@@ -855,15 +854,15 @@ modpack.type.curse.error=未能完成该整合包所需的依赖下载,请再
modpack.type.curse.not_found=部分必需文件已经在网络中被删除并且再也无法下载。请尝试该整合包的最新版本或者安装其他整合包。\n如遇到问题,你可以点击右上角帮助按钮进行求助。
modpack.type.manual.warning=该整合包由发布者手动打包,其中可能已经包含启动器。建议尝试解压后使用其自带的启动器运行游戏。\n如遇到问题,你可以点击右上角帮助按钮进行求助。\nHMCL 可以尝试导入该整合包,但不保证可用性。是否继续?
modpack.type.mcbbs=MCBBS 整合包 (推荐)
modpack.type.mcbbs.export=可以被 Hello Minecraft! Launcher 导入
modpack.type.mcbbs.export=可以被 HMCL 导入
modpack.type.modrinth=Modrinth
modpack.type.modrinth.export=可以被主流第三方启动器导入
modpack.type.multimc=MultiMC
modpack.type.multimc.export=可以被 Hello Minecraft! Launcher 和 MultiMC 导入
modpack.type.multimc.export=可以被 HMCL 和 MultiMC 导入
modpack.type.server=服务器自动更新整合包
modpack.type.server.export=允许服务器管理员远程更新游戏客户端
modpack.type.server.malformed=服务器整合包配置格式错误,请联系服务器管理员解决此问题。\n如遇到问题,你可以点击右上角帮助按钮进行求助。
modpack.unsupported=Hello Minecraft! Launcher 不支持该整合包格式
modpack.unsupported=HMCL 不支持该整合包格式
modpack.update=正在升级整合包
modpack.wizard=导出整合包向导
modpack.wizard.step.1=基本设置
@@ -1455,6 +1454,7 @@ settings.type.global.preset.auto_name=预设 %d
shaderpack.download.title=光影下载 - %1s
system.architecture=架构
system.operating_system=操作系统
@@ -1591,6 +1591,7 @@ update.channel.nightly.hint=你正在使用 HMCL 预览版。预览版更新较
update.channel.nightly.title=预览版提示
update.channel.stable=稳定版
update.checking=正在检查更新
update.check_failed=检查更新失败 %s
update.disable_auto_show_update_dialog=不自动显示更新弹窗
update.disable_auto_show_update_dialog.subtitle=启用此选项,HMCL 将不会自动弹出更新弹窗。
update.failed=更新失败
@@ -1604,6 +1605,7 @@ update.latest=当前版本为最新版本
update.tooltip=更新
update.preview=提前预览 HMCL 版本
update.preview.subtitle=启用此选项,你将可以提前获取 HMCL 的新版本,以便在正式发布前进行测试。
update.unverified=更新不可用,因为无法验证此启动器实例完整性
warning.java_interpreted_mode=HMCL 正在运行在解释器模式的 Java 环境中,性能将会受到很大影响。\n我们建议你使用支持 JIT 的 Java 启动 HMCL 以获取最佳体验。
warning.software_rendering=HMCL 正在使用软件渲染,性能将会受到很大影响。\n你可以访问 https://docs.hmcl.net/help.html 页面寻求帮助。
@@ -188,6 +188,11 @@ addon.download.recommend=推薦版本 - Minecraft %1s
addon.download.title.release=Minecraft %s
addon.download.title.snapshot=Minecraft %s (快照)
addon.modrinth=Modrinth
addon.sort.date_created=建立日期
addon.sort.last_updated=最近更新
addon.sort.popularity=熱度
addon.sort.relevancy=相關度
addon.sort.total_downloads=下載量
archive.author=作者
archive.date=發布日期
@@ -207,8 +212,8 @@ button.delete=刪除
button.disable=停用
button.do_not_show_again=不再顯示
button.edit=編輯
button.install=安裝
button.enable=啟用
button.install=安裝
button.export=匯出
button.no=否
button.ok=確定
@@ -237,7 +242,7 @@ contact.feedback.github.statement=提交一個 GitHub Issue
color.recent=建議
color.custom=自訂顏色
crash.NoClassDefFound=請確認 Hello Minecraft! Launcher 本體是否完整,或更新你的 Java。
crash.NoClassDefFound=請確認 HMCL 本體是否完整,或更新你的 Java。
crash.user_fault=你的系統或 Java 環境可能安裝不當導致本軟體當機,請檢查你的 Java 環境或你的電腦!可以嘗試重新安裝 Java。
curse.category.0=全部
@@ -286,10 +291,10 @@ curse.category.429=工業 (Industrialcraft)
curse.category.419=魔法
curse.category.412=科技
curse.category.4557=紅石
curse.category.428=匠魂
curse.category.8937=ModJam 2025
curse.category.9026=創造模式
curse.category.10775=恐怖
curse.category.428=匠魂
curse.category.414=交通運輸
curse.category.4486=幸運方塊 (Lucky Blocks)
curse.category.432=建築 (Buildcraft)
@@ -369,13 +374,6 @@ curse.category.6553=寫實
curse.category.6554=幻想
curse.category.6555=原生
curse.sort.author=作者
curse.sort.date_created=建立日期
curse.sort.last_updated=最近更新
curse.sort.name=名稱
curse.sort.popularity=熱度
curse.sort.total_downloads=下載量
datetime.format=yyyy 年 MM 月 dd 日 HH:mm:ss
download=下載
@@ -427,26 +425,26 @@ extension.resourcepack=資源包壓縮檔
extension.schematic=原理圖檔案
extension.world=世界壓縮檔
fatal.create_hmcl_current_directory_failure=Hello Minecraft! Launcher 無法建立 HMCL 資料夾 (%s),請將 HMCL 移動至其他位置再開啟。
fatal.create_hmcl_current_directory_failure=HMCL 無法建立 HMCL 資料夾 (%s),請將 HMCL 移動至其他位置再開啟。
fatal.javafx.incomplete=JavaFX 執行環境不完整。請嘗試更換你的 Java 或者重新安裝 OpenJFX。
fatal.javafx.missing=缺少 JavaFX 執行環境。請使用包含 OpenJFX 的 Java 執行環境開啟 Hello Minecraft! Launcher。
fatal.config_change_owner_root=你正在使用 root 帳戶開啟 Hello Minecraft! Launcher,這可能導致你未來無法使用其他帳戶正常開啟 HMCL。\n是否繼續開啟?
fatal.config_in_temp_dir=你正在暫存目錄中開啟 Hello Minecraft! Launcher,你的設定和遊戲資料可能會遺失。建議將 HMCL 移動至其他位置再開啟。\n是否繼續開啟?
fatal.config_loading_failure=Hello Minecraft! Launcher 無法載入設定檔案。\n請確保 HMCL 對「%s」目錄及該目錄下的檔案擁有讀寫權限。
fatal.config_loading_failure.unix=Hello Minecraft! Launcher 無法載入設定檔案,因為設定檔案是由使用者「%1$s」建立的。\n請使用 root 帳戶開啟 HMCL (不推薦),或在終端中執行以下指令將設定檔案的所有權變更為目前使用者:\n%2$s
fatal.config_unsupported_version=目前設定檔案是由更高版本的 Hello Minecraft! Launcher 建立的,目前版本的 HMCL 無法正常載入。請更新並重新啟動 HMCL。\n在更新啟動器之前,你所做的所有設定更改都不會被儲存。
fatal.mac_app_translocation=由於 macOS 的安全機制,Hello Minecraft! Launcher 被系統隔離至暫存目錄中。\n請將 HMCL 移動到其他目錄後再嘗試開啟,否則你的設定和遊戲資料可能會在重啟後遺失。\n是否繼續開啟?
fatal.migration_requires_manual_reboot=Hello Minecraft! Launcher 即將升級完成,請重新開啟 HMCL。
fatal.apply_update_failure=我們很抱歉 Hello Minecraft! Launcher 無法自動完成升級程式,因為出現了一些問題。\n但你依然可以從 %s 處手動下載 HMCL 來完成升級。
fatal.apply_update_need_win7=Hello Minecraft! Launcher 無法在 Windows XP/Vista 上進行自動更新。請從 %s 處手動下載 HMCL 來完成升級。
fatal.javafx.missing=缺少 JavaFX 執行環境。請使用包含 OpenJFX 的 Java 執行環境開啟 HMCL。
fatal.config_change_owner_root=你正在使用 root 帳戶開啟 HMCL,這可能導致你未來無法使用其他帳戶正常開啟 HMCL。\n是否繼續開啟?
fatal.config_in_temp_dir=你正在暫存目錄中開啟 HMCL,你的設定和遊戲資料可能會遺失。建議將 HMCL 移動至其他位置再開啟。\n是否繼續開啟?
fatal.config_loading_failure=HMCL 無法載入設定檔案。\n請確保 HMCL 對「%s」目錄及該目錄下的檔案擁有讀寫權限。
fatal.config_loading_failure.unix=HMCL 無法載入設定檔案,因為設定檔案是由使用者「%1$s」建立的。\n請使用 root 帳戶開啟 HMCL (不推薦),或在終端中執行以下指令將設定檔案的所有權變更為目前使用者:\n%2$s
fatal.config_unsupported_version=目前設定檔案是由更高版本的 HMCL 建立的,目前版本的 HMCL 無法正常載入。請更新並重新啟動 HMCL。\n在更新啟動器之前,你所做的所有設定更改都不會被儲存。
fatal.mac_app_translocation=由於 macOS 的安全機制,HMCL 被系統隔離至暫存目錄中。\n請將 HMCL 移動到其他目錄後再嘗試開啟,否則你的設定和遊戲資料可能會在重啟後遺失。\n是否繼續開啟?
fatal.migration_requires_manual_reboot=HMCL 即將升級完成,請重新開啟 HMCL。
fatal.apply_update_failure=我們很抱歉 HMCL 無法自動完成升級程式,因為出現了一些問題。\n但你依然可以從 %s 處手動下載 HMCL 來完成升級。
fatal.apply_update_need_win7=HMCL 無法在 Windows XP/Vista 上進行自動更新。請從 %s 處手動下載 HMCL 來完成升級。
fatal.deprecated_java_version=HMCL 未來需要 Java 17 或更高版本才能執行,但依然支援使用 Java 6~16 啟動遊戲。建議安裝最新版本的 Java 以確保 HMCL 正常執行。\n你可以繼續保留舊版本 Java。HMCL 能夠識別與管理多個 Java,並會自動根據遊戲版本為你選取合適的 Java。
fatal.deprecated_java_version.download_link=下載 Java %d
fatal.samba=如果您正在透過 Samba 共亯的目錄中開啟 Hello Minecraft! Launcher,啟動器可能無法正常工作,請嘗試更新您的 Java 或在本機目錄內開啟 HMCL。
fatal.samba=如果您正在透過 Samba 共亯的目錄中開啟 HMCL,啟動器可能無法正常工作,請嘗試更新您的 Java 或在本機目錄內開啟 HMCL。
fatal.illegal_char=由於您的執行路徑中存在無效字元『=』,您將無法使用外部登入帳戶以及離線登入更換外觀功能。
fatal.unsupported_platform=Minecraft 尚未對您的平臺提供完善支援,所以可能影響遊戲體驗或無法啟動遊戲。\n\
若無法啟動 Minecraft 1.17 及更高版本,可以嘗試在「(全域/實例特定) 遊戲設定 → 圖形設定」中將「繪製器」切換為「Mesa LLVMpipe」/「Mesa Lavapipe」,以獲得更好的相容性。
fatal.unsupported_platform.loongarch=Hello Minecraft! Launcher 已為龍芯提供支援。\n如果遇到問題,你可以點擊右上角幫助按鈕進行求助。
fatal.unsupported_platform.windows_arm64=Hello Minecraft! Launcher 已為 Windows on Arm 平臺提供原生支援。如果你在遊戲中遭遇問題,請嘗試使用 x86 架構的 Java 啟動遊戲。\n\n如果你正在使用<b>高通</b>平臺,你可能需要安裝 <a href="ms-windows-store://pdp/?productid=9NQPSL29BFFF">OpenGL 相容包</a>後才能進行遊戲。點擊連結前往 Microsoft Store 安裝相容包。
fatal.unsupported_platform.loongarch=HMCL 已為龍芯提供支援。\n如果遇到問題,你可以點擊右上角幫助按鈕進行求助。
fatal.unsupported_platform.windows_arm64=HMCL 已為 Windows on Arm 平臺提供原生支援。如果你在遊戲中遭遇問題,請嘗試使用 x86 架構的 Java 啟動遊戲。\n\n如果你正在使用<b>高通</b>平臺,你可能需要安裝 <a href="ms-windows-store://pdp/?productid=9NQPSL29BFFF">OpenGL 相容包</a>後才能進行遊戲。點擊連結前往 Microsoft Store 安裝相容包。
# When translating the following string into non-Latin languages, please retain the English translation
fatal.wine_warning=HMCL is running under Wine or one of its distributions.\nAs a cross-platform application, HMCL is best experienced natively on your host OS.\nPress "OK" to continue, but please note that some issues may arise.\n\n您目前正在使用 Wine 或其衍生版本執行 HMCL。\nHMCL 是跨平臺的,我們建議您直接在主機系統上執行。\n按下「確定」以繼續,但請注意,此操作可能會引發一些問題。
@@ -472,20 +470,20 @@ game.crash.reason.analyzing=分析中……
game.crash.reason.multiple=檢測到多個原因:\n\n
game.crash.reason.block=目前遊戲由於某個方塊不能正常工作,無法繼續執行。\n你可以嘗試使用地圖編輯工具編輯世界刪除該方塊,或者直接刪除對應的模組。\n方塊類型:%1$s\n方塊坐標:%2$s\n\n相關工具:<a href="https://minecraft.wiki/w/Tutorial:Programs_and_editors/Mapping#Map_editors">英文 Wiki</a> | <a href="https://zh.minecraft.wiki/w/辅助程序与编辑器/地图工具?variant=zh-tw#地图编辑工具">中文 Wiki</a>
game.crash.reason.bootstrap_failed=目前遊戲由於模組「%1$s」出現問題,無法繼續執行。\n你可以嘗試刪除或更新該模組以解決問題。
game.crash.reason.mixin_apply_mod_failed=目前遊戲由於 Mixin 無法應用於「%1$s」模組,無法繼續執行。\n你可以嘗試刪除或更新該模組以解決問題。
game.crash.reason.config=目前遊戲由於無法解析模組配置檔案,無法繼續執行\n模組「%1$s」的配置檔案「%2$s」無法被解析。
game.crash.reason.debug_crash=目前遊戲由於手動觸發崩潰,無法繼續執行。\n事實上遊戲並沒有問題,問題都是你造成的!
game.crash.reason.duplicated_mod=目前遊戲由於模組重複安裝,無法繼續執行。\n%s\n每種模組只能安裝一個,請你刪除多餘的模組再試。
game.crash.reason.entity=目前遊戲由於某個實體不能正常工作,無法繼續執行。\n你可以嘗試使用地圖編輯工具編輯世界刪除該實體,或者直接刪除對應的模組。\n實體類型:%1$s\n實體坐標:%2$s\n\n相關工具:<a href="https://minecraft.wiki/w/Tutorial:Programs_and_editors/Mapping#Map_editors">英文 Wiki</a> | <a href="https://zh.minecraft.wiki/w/辅助程序与编辑器/地图工具?variant=zh-tw#地图编辑工具">中文 Wiki</a>
game.crash.reason.fabric_version_0_12=Fabric Loader 0.12 及更高版本與目前已經安裝的模組可能不相容,你需要將 Fabric Loader 降級至 0.11.7。
game.crash.reason.fabric_warnings=Fabric 提供了一些警告訊息:\n%1$s
game.crash.reason.modmixin_failure=目前遊戲由於某些模組注入失敗,無法繼續執行。\n這一般代表著該模組存在問題,或與目前環境不相容。\n你可以查看日誌尋找出錯模組。
game.crash.reason.forge_error=Forge/NeoForge 可能已經提供了錯誤資訊。\n你可以查看日誌,並根據錯誤報告中的日誌資訊進行對應處。\n如果沒有看到報錯資訊,可以查看錯誤報告了解錯誤具體是如何發生的。\n%1$s
game.crash.reason.mod_resolution0=目前遊戲由於一些模組出現問題,無法繼續執行。\n你可以查看日誌尋找出錯模組。
game.crash.reason.need_jdk11=目前遊戲由於 Java 版本不合適,無法繼續執行。\n你需要下載安裝 Java 11,並在「(全域/實例特定) 遊戲設定 → 遊戲 Java」中將 Java 設定為 11.x 的版本。
game.crash.reason.mixin_apply_mod_failed=目前遊戲由於 Mixin 無法應用於「%1$s」模組,無法繼續執行。\n你可以嘗試刪除或更新該模組以解決問題。
game.crash.reason.java_version_is_too_high=目前遊戲由於使用的 Java 版本過高而崩潰了,無法繼續執行。\n請在「(全域/實例特定) 遊戲設定 → 遊戲 Java」中改用較低版本的 Java,然後再啟動遊戲。\n如果沒有,可以從 <a href="https://www.java.com/download/">java.com (Java 8)</a> 或 <a href="https://bell-sw.com/pages/downloads/#downloads">BellSoft Liberica Full JRE (Java 17)</a> 等平台下載、安裝一個 (安裝完後需重啟啟動器)。
game.crash.reason.need_jdk11=目前遊戲由於 Java 版本不合適,無法繼續執行。\n你需要下載安裝 Java 11,並在「(全域/實例特定) 遊戲設定 → 遊戲 Java」中將 Java 設定為 11.x 的版本。
game.crash.reason.mod_name=目前遊戲由於模組檔案名稱問題,無法繼續執行。\n模組檔案名稱應只使用半型的大小寫字母 (Aa~Zz)、數位 (0~9)、橫線 (-)、底線 (_)和點 (.)。\n請到模組目錄中將所有不合規的模組檔案名稱修正為上述合規字元。
game.crash.reason.incomplete_forge_installation=目前遊戲由於 Forge 安裝不完整,無法繼續執行。\n請在「實例管理 - 自動安裝」中移除 Forge 並重新安裝。
game.crash.reason.fabric_version_0_12=Fabric Loader 0.12 及更高版本與目前已經安裝的模組可能不相容,你需要將 Fabric Loader 降級至 0.11.7。
game.crash.reason.fabric_warnings=Fabric 提供了一些警告訊息:\n%1$s
game.crash.reason.file_already_exists=目前遊戲由於檔案「%1$s」已經存在,無法繼續執行。\n如果你認為這個檔案可以刪除,你可以在備份這個檔案後嘗試刪除它,並重新啟動遊戲。
game.crash.reason.file_changed=目前遊戲由於檔案校驗失敗,無法繼續執行。\n如果你手動修改了 Minecraft.jar 檔案,你需要回退修改,或者重新下載遊戲。
game.crash.reason.gl_operation_failure=目前遊戲由於你使用的某些模組/光影包/資源包/紋理包出現問題,無法繼續執行。\n請先嘗試停用你所使用的模組/光影包/資源包/紋理包再試。
@@ -495,11 +493,20 @@ game.crash.reason.graphics_driver=目前遊戲由於你的顯示卡驅動存在
game.crash.reason.macos_failed_to_find_service_port_for_display=目前遊戲由於 Apple Silicon 平台下初始化 OpenGL 視窗失敗,無法繼續執行。\n對於該問題,HMCL 暫無直接性的解決方案。請你嘗試任意開啟一個瀏覽器並切換為全螢幕,然後再回到 HMCL 啟動遊戲。在彈出遊戲視窗前<b>迅速切回瀏覽器頁面</b>,等待遊戲視窗出現後再切回遊戲視窗。
game.crash.reason.illegal_access_error=目前遊戲由於某些模組的問題,無法繼續執行。\n如果你認識「%1$s」,你可以更新或刪除對應模組再試。
game.crash.reason.install_mixinbootstrap=目前遊戲由於缺失 MixinBootstrap,無法繼續執行。\n你可以嘗試安裝 <a href="https://www.curseforge.com/minecraft/mc-mods/mixinbootstrap">MixinBootstrap</a> 解決該問題。若安裝後崩潰,可以嘗試在該模組的檔案名前新增半形驚嘆號 (!) 解決。
game.crash.reason.optifine_is_not_compatible_with_forge=目前遊戲由於 OptiFine 與目前版本的 Forge 不相容,導致了遊戲崩潰。\n請前往 <a href="https://optifine.net/downloads">OptiFine 官網</a>查看 OptiFine 所相容的 Forge 版本,並嚴格按照對應版本重新安裝遊戲,或在「實例管理 → 自動安裝」中更換版本。\n經測試,Forge 版本過高或過低都可能導致崩潰。
game.crash.reason.mod_files_are_decompressed=目前遊戲由於模組檔案被解壓了,無法繼續執行。\n請直接把整個模組檔案放進模組目錄中即可。\n解壓模組檔案會導致遊戲出錯。請刪除模組目錄中已被解壓的模組,然後再啟動遊戲。
game.crash.reason.shaders_mod=目前遊戲由於同時安裝了 OptiFine 和 Shaders 模組,無法繼續執行。 \n由於 OptiFine 已整合 Shaders 模組的功能,只需刪除 Shaders 模組即可。
game.crash.reason.rtss_forest_sodium=目前遊戲由於 RivaTuner Statistics Server (RTSS) 與 Sodium 不相容,導致遊戲崩潰。\n點擊 <a href="https://github.com/CaffeineMC/sodium-fabric/wiki/Known-Issues#rtss-incompatible">此處</a> 查看詳情。
game.crash.reason.too_many_mods_lead_to_exceeding_the_id_limit=目前遊戲由於你所安裝的模組過多,超出了遊戲的 ID 限制,無法繼續執行。\n請嘗試安裝<a href="https://www.curseforge.com/minecraft/mc-mods/jeid">JEID</a>等修正模組,或刪除部分大型模組。
game.crash.reason.night_config_fixes=目前遊戲由於 Night Config 庫的一些問題,無法繼續執行。\n你可以嘗試安裝 <a href="https://www.curseforge.com/minecraft/mc-mods/night-config-fixes">Night Config Fixes</a> 模組,這或許能幫助你解決這個問題。\n了解更多,可訪問該模組的 <a href="https://github.com/Fuzss/nightconfigfixes">GitHub 儲存庫</a>。
game.crash.reason.optifine_causes_the_world_to_fail_to_load=目前遊戲可能由於 OptiFine 而無法繼續執行。\n該問題只在特定 OptiFine 版本中出現,你可以嘗試在「實例管理 → 自動安裝」中更換 OptiFine 的版本。
game.crash.reason.jdk_9=目前遊戲由於 Java 版本過高,無法繼續執行。\n你需要下載安裝 Java 8,並在「(全域/實例特定) 遊戲設定 → 遊戲 Java」中將 Java 設定為 1.8.x 的版本。
game.crash.reason.jvm_32bit=目前遊戲由於記憶體分配過大,超過了 32 位 Java 虛擬機記憶體限制,無法繼續執行。\n如果你的電腦是 64 位系統,請下載安裝並更換 64 位 Java。\n如果你的電腦是 32 位系統,你或許可以重新安裝 64 位系統,或換一台新電腦。\n或者,你可以關閉「(全域/實例特定) 遊戲設定 → 遊戲記憶體」中的「自動分配」,並且把記憶體分配值調節為 1024 MiB 或以下。
game.crash.reason.loading_crashed_forge=目前遊戲由於模組「%1$s (%2$s)」錯誤,無法繼續執行。\n你可以嘗試刪除或更新該模組以解決問題。
game.crash.reason.loading_crashed_fabric=目前遊戲由於模組「%1$s」錯誤,無法繼續執行。\n你可以嘗試刪除或更新該模組以解決問題。
game.crash.reason.mac_jdk_8u261=目前遊戲由於你所使用的 Forge 或 OptiFine 與 Java 衝突而崩潰。\n請嘗試更新 Forge 和 OptiFine,或使用 Java 8u251 及更早版本啟動。
game.crash.reason.forge_repeat_installation=目前遊戲由於 Forge 重複安裝,無法繼續執行。<a href="https://github.com/HMCL-dev/HMCL/issues/1880">此為已知問題</a>\n建議將日誌上傳並回報至 GitHub,以便我們找到更多線索並修復此問題。\n目前你可以在「實例管理 → 自動安裝」中移除 Forge 並重新安裝。
game.crash.reason.optifine_repeat_installation=目前遊戲由於重複安裝 OptiFine,無法繼續執行。\n請刪除模組目錄下的 OptiFine 或前往「實例管理 → 自動安裝」移除安裝的 OptiFine。
game.crash.reason.memory_exceeded=目前遊戲由於記憶體分配過大,無法繼續執行。\n該問題是由於系統分頁檔太小導致的。\n你需要在「(全域/實例特定) 遊戲設定 → 遊戲記憶體」中關閉「自動分配」,並將記憶體分配值調低至遊戲能正常啟動為止。\n你還可以嘗試調大系統的分頁檔大小。
game.crash.reason.mod=目前遊戲由於 %1$s 的問題,無法繼續執行。\n你可以更新或刪除已經安裝的「%1$s」再試。
game.crash.reason.mod_resolution=目前遊戲由於相依模組問題,無法繼續執行。Fabric 提供了如下訊息:\n%1$s
@@ -511,16 +518,7 @@ game.crash.reason.mod_resolution_missing=目前遊戲由於缺少相依模組,
game.crash.reason.mod_resolution_missing_minecraft=目前遊戲由於模組和 Minecraft 遊戲版本不匹配,無法繼續執行。\n「%1$s」需要 Minecraft %2$s 才能執行。\n如果你要繼續使用你已經安裝的模組,你可以選取安裝對應的 Minecraft 版本。如果你要繼續使用目前的 Minecraft 版本,你需要安裝對應版本的模組。
game.crash.reason.mod_resolution_mod_version=%1$s (版本號 %2$s)
game.crash.reason.mod_resolution_mod_version.any=%1$s (任意版本)
game.crash.reason.forge_repeat_installation=目前遊戲由於 Forge 重複安裝,無法繼續執行。<a href="https://github.com/HMCL-dev/HMCL/issues/1880">此為已知問題</a>\n建議將日誌上傳並回報至 GitHub,以便我們找到更多線索並修復此問題。\n目前你可以在「實例管理 → 自動安裝」中移除 Forge 並重新安裝。
game.crash.reason.optifine_repeat_installation=目前遊戲由於重複安裝 OptiFine,無法繼續執行。\n請刪除模組目錄下的 OptiFine 或前往「實例管理 → 自動安裝」移除安裝的 OptiFine。
game.crash.reason.optifine_is_not_compatible_with_forge=目前遊戲由於 OptiFine 與目前版本的 Forge 不相容,導致了遊戲崩潰。\n請前往 <a href="https://optifine.net/downloads">OptiFine 官網</a>查看 OptiFine 所相容的 Forge 版本,並嚴格按照對應版本重新安裝遊戲,或在「實例管理 → 自動安裝」中更換版本。\n經測試,Forge 版本過高或過低都可能導致崩潰。
game.crash.reason.night_config_fixes=目前遊戲由於 Night Config 庫的一些問題,無法繼續執行。\n你可以嘗試安裝 <a href="https://www.curseforge.com/minecraft/mc-mods/night-config-fixes">Night Config Fixes</a> 模組,這或許能幫助你解決這個問題。\n了解更多,可訪問該模組的 <a href="https://github.com/Fuzss/nightconfigfixes">GitHub 儲存庫</a>。
game.crash.reason.mod_files_are_decompressed=目前遊戲由於模組檔案被解壓了,無法繼續執行。\n請直接把整個模組檔案放進模組目錄中即可。\n解壓模組檔案會導致遊戲出錯。請刪除模組目錄中已被解壓的模組,然後再啟動遊戲。
game.crash.reason.too_many_mods_lead_to_exceeding_the_id_limit=目前遊戲由於你所安裝的模組過多,超出了遊戲的 ID 限制,無法繼續執行。\n請嘗試安裝<a href="https://www.curseforge.com/minecraft/mc-mods/jeid">JEID</a>等修正模組,或刪除部分大型模組。
game.crash.reason.optifine_causes_the_world_to_fail_to_load=目前遊戲可能由於 OptiFine 而無法繼續執行。\n該問題只在特定 OptiFine 版本中出現,你可以嘗試在「實例管理 → 自動安裝」中更換 OptiFine 的版本。
game.crash.reason.modlauncher_8=目前遊戲由於你所使用的 Forge 版本與目前使用的 Java 衝突崩潰。請嘗試更新 Forge。
game.crash.reason.shaders_mod=目前遊戲由於同時安裝了 OptiFine 和 Shaders 模組,無法繼續執行。 \n由於 OptiFine 已整合 Shaders 模組的功能,只需刪除 Shaders 模組即可。
game.crash.reason.rtss_forest_sodium=目前遊戲由於 RivaTuner Statistics Server (RTSS) 與 Sodium 不相容,導致遊戲崩潰。\n點擊 <a href="https://github.com/CaffeineMC/sodium-fabric/wiki/Known-Issues#rtss-incompatible">此處</a> 查看詳情。
game.crash.reason.no_class_def_found_error=目前遊戲由於程式碼不完整,無法繼續執行。\n你的遊戲可能缺失了某個模組,或者某些模組檔案不完整,或者模組與遊戲的版本不匹配。\n你可能需要重新安裝遊戲和模組,或請求他人幫助。\n缺失:%1$s
game.crash.reason.no_such_method_error=目前遊戲由於程式碼不完整,無法繼續執行。\n你的遊戲可能缺失了某個模組,或者某些模組檔案不完整,或者模組與遊戲的版本不匹配。\n你可能需要重新安裝遊戲和模組,或請求他人幫助。
game.crash.reason.opengl_not_supported=目前遊戲由於你的顯示卡驅動存在問題,無法繼續執行。\n原因是 OpenGL 不受支援,你現在是否在遠端桌面或者串流模式下?如果是,請直接使用原電腦啟動遊戲。\n或者嘗試升級你的顯示卡驅動到最新版本後再嘗試啟動遊戲。如果你的電腦同時存在獨立顯示卡與整合式顯示卡,你需要檢查遊戲是否使用整合式顯示卡啟動。如果是,請嘗試使用獨立顯示卡開啟 HMCL 與遊戲。如果仍有問題,你可能需要考慮換一個新顯示卡或新電腦。
@@ -547,7 +545,7 @@ game_directory.use_relative_path=如可行,則對於遊戲目錄使用相對
game_directory.root=使用磁碟根目錄作為遊戲資料夾可能會導致無法啟動遊戲,並會在磁碟根目錄下建立多個檔案和資料夾。\n\n確定要繼續嗎?
help=說明
help.doc=Hello Minecraft! Launcher 說明文件
help.doc=HMCL 說明文件
help.detail=可查閱資料包、模組包製作教學等內容
input.email=[使用者名稱] 必須是電子信箱格式
@@ -766,9 +764,9 @@ launcher.cache_directory.default=預設 ("%APPDATA%/.minecraft" 或 "~/.minecraf
launcher.cache_directory.disabled=停用
launcher.cache_directory.invalid=無法建立自訂的快取目錄。已還原至預設設定。
launcher.contact=聯絡我們
launcher.crash=Hello Minecraft! Launcher 遇到了無法處理的錯誤。請複製下列內容並透過 GitHub、Discord 或 HMCL QQ 群回報問題。
launcher.crash.java_internal_error=Hello Minecraft! Launcher 由於目前 Java 損壞而無法繼續執行。請移除目前 Java,點擊 <a href="https://bell-sw.com/pages/downloads/#downloads">此處</a> 安裝合適的 Java 版本。
launcher.crash.hmcl_out_dated=Hello Minecraft! Launcher 遇到了無法處理的錯誤。已偵測到你的啟動器不是最新版本,請更新後重試!
launcher.crash=HMCL 遇到了無法處理的錯誤。請複製下列內容並透過 GitHub、Discord 或 HMCL QQ 群回報問題。
launcher.crash.java_internal_error=HMCL 由於目前 Java 損壞而無法繼續執行。請移除目前 Java,點擊 <a href="https://bell-sw.com/pages/downloads/#downloads">此處</a> 安裝合適的 Java 版本。
launcher.crash.hmcl_out_dated=HMCL 遇到了無法處理的錯誤。已偵測到你的啟動器不是最新版本,請更新後重試!
launcher.update_java=請更新你的 Java
libraries.download=下載依賴庫
@@ -850,15 +848,15 @@ modpack.type.curse.error=無法完成該模組包所需的相依元件下載,
modpack.type.curse.not_found=部分必需檔案已經從網路中被刪除並且再也無法下載。請嘗試該模組包的最新版本或者安裝其他模組包。
modpack.type.manual.warning=該模組包由發佈者手動打包,其中可能已經包含啟動器。建議嘗試解壓後使用其內建的啟動器執行遊戲。\nHMCL 可以嘗試匯入該模組包,但不保證可用性。是否繼續?
modpack.type.mcbbs=MCBBS 模組包
modpack.type.mcbbs.export=可以被 Hello Minecraft! Launcher 匯入
modpack.type.mcbbs.export=可以被 HMCL 匯入
modpack.type.modrinth=Modrinth
modpack.type.modrinth.export=可以被主流第三方啟動器匯入
modpack.type.multimc=MultiMC
modpack.type.multimc.export=可以被 Hello Minecraft! Launcher 和 MultiMC 匯入
modpack.type.multimc.export=可以被 HMCL 和 MultiMC 匯入
modpack.type.server=伺服器自動更新模組包
modpack.type.server.export=允許伺服器管理員遠端更新遊戲用戶端
modpack.type.server.malformed=伺服器模組包配置格式錯誤,請聯絡伺服器管理員解決此問題
modpack.unsupported=Hello Minecraft! Launcher 不支援該模組包格式
modpack.unsupported=HMCL 不支援該模組包格式
modpack.update=正在升級模組包
modpack.wizard=匯出模組包引導
modpack.wizard.step.1=基本設定
@@ -1056,6 +1054,7 @@ world.export=匯出此世界
world.export.title=選取該世界的儲存位置
world.export.location=儲存到
world.export.wizard=匯出世界「%s」
world.game_version=遊戲版本
world.icon=世界圖示
world.icon.change=修改世界圖示
world.icon.change.fail.load.title=圖片解析失敗
@@ -1101,7 +1100,6 @@ world.info.time.format=%d 天 %d 小時 %d 分鐘
world.load.fail=世界載入失敗
world.locked=使用中
world.locked.failed=該世界正在使用中,請關閉遊戲後重試。
world.game_version=遊戲版本
world.manage=世界管理
world.manage.button=管理此世界
world.manage.title=世界 - %s
@@ -1536,8 +1534,8 @@ terracotta.unsupported.arch.32bit=多人聯機功能不支援 32 位元系統。
terracotta.unsupported.arch.loongarch64_ow=多人聯機功能不支援 Linux LoongArch64 舊世界發行版,請更新至新世界發行版 (如 AOSC OC)。
terracotta.unsupported.region=多人聯機功能目前僅為中國內地使用者提供服務,在您所在地區可能不可用。
theme_pack.appearance.custom.tooltip=目前使用自訂啟動器設定。點擊後跟隨所選主題。
theme_pack.appearance.follow_theme.tooltip=目前跟隨所選主題。點擊後使用自訂啟動器設定。
theme_pack.appearance.custom.tooltip=目前使用自訂啟動器設定。點擊後跟隨所選主題。
theme_pack.apply=套用主題
theme_pack.apply.confirm=確定要套用主題「%s」嗎?
theme_pack.apply.failed=套用主題失敗
@@ -1587,6 +1585,7 @@ update.channel.nightly.hint=你正在使用 HMCL 預覽版。預覽版更新較
update.channel.nightly.title=預覽版提示
update.channel.stable=穩定版
update.checking=正在檢查更新
update.check_failed=檢查更新失敗 %s
update.disable_auto_show_update_dialog=不自動顯示更新彈窗
update.disable_auto_show_update_dialog.subtitle=啟用此選項,HMCL 將不會自動彈出更新彈窗。
update.failed=更新失敗
@@ -1600,6 +1599,7 @@ update.latest=目前版本為最新版本
update.tooltip=更新
update.preview=提前測試 HMCL 預覽版本
update.preview.subtitle=啟用此選項,你將可以提前取得 HMCL 的新版本,以便在正式發布前進行測試。
update.unverified=更新不可用,因為無法驗證此啟動器例項完整性
warning.java_interpreted_mode=HMCL 正在執行於直譯器模式的 Java 環境中,效能將會受到很大影響。\n我們建議你使用支援 JIT 的 Java 開啟 HMCL 以獲得最佳體驗。
warning.software_rendering=HMCL 正在使用軟體繪製,效能將會受到很大影響。
@@ -0,0 +1,147 @@
/*
* 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.ui.construct;
import javafx.application.Platform;
import javafx.scene.Scene;
import javafx.scene.control.Label;
import javafx.scene.layout.HBox;
import javafx.scene.layout.Region;
import org.jetbrains.annotations.NotNullByDefault;
import org.junit.jupiter.api.condition.EnabledIf;
import org.junit.jupiter.params.ParameterizedTest;
import org.junit.jupiter.params.provider.ValueSource;
import java.util.concurrent.ExecutionException;
import java.util.concurrent.FutureTask;
import java.util.concurrent.TimeUnit;
import java.util.concurrent.TimeoutException;
import static org.junit.jupiter.api.Assertions.assertEquals;
import static org.junit.jupiter.api.Assertions.assertTrue;
/// Verifies tag sizing in parents that allocate only the item's preferred width.
@NotNullByDefault
@EnabledIf("org.jackhuang.hmcl.JavaFXLauncher#isStarted")
public final class TwoLineListItemTest {
/// Verifies tags remain visible as they are added, resized, removed, and added again.
@ParameterizedTest
@ValueSource(booleans = {false, true})
public void testPreferredWidthIncludesTags(boolean wrapText) {
onFxThread(() -> {
TwoLineListItem item = new TwoLineListItem("Example Mod", "a.jar");
item.getTitleLabel().setWrapText(wrapText);
HBox parent = createParent(item);
layout(parent, 800);
double originalWidth = item.getWidth();
item.addTag("Fabric");
layout(parent, 800);
assertTagsVisible(item);
assertTrue(item.getWidth() > originalWidth);
item.addTag("NeoForge");
item.addTag("Quilt");
layout(parent, 800);
assertTagsVisible(item);
double taggedWidth = item.getWidth();
item.getTags().get(0).setText("A longer loader tag");
layout(parent, 800);
assertTagsVisible(item);
assertTrue(item.getWidth() > taggedWidth);
item.getTags().clear();
layout(parent, 800);
assertEquals(originalWidth, item.getWidth(), 0.001);
item.addTag("Fabric");
item.setSubtitle("A subtitle that is wider than the title and its loader tag");
layout(parent, 800);
assertTagsVisible(item);
assertTrue(item.getSubtitleLabel().getWidth() >= item.getSubtitleLabel().prefWidth(-1));
});
}
/// Verifies constrained rows give the title priority while allowing truncation or wrapping.
@ParameterizedTest
@ValueSource(booleans = {false, true})
public void testTitleRetainsPriority(boolean wrapText) {
onFxThread(() -> {
TwoLineListItem item = new TwoLineListItem("A very long mod title ".repeat(20), "a.jar");
item.getTitleLabel().setWrapText(wrapText);
item.addTag("Fabric");
item.addTag("NeoForge");
HBox parent = createParent(item);
layout(parent, 300);
assertEquals(252, item.getWidth(), 0.001);
assertEquals(item.getWidth(), item.getTitleLabel().getWidth(), 0.001);
assertTrue(item.getBoundsInParent().getMaxX() <= parent.getWidth());
if (wrapText) {
assertTrue(item.getTitleLabel().getHeight() > item.getTitleLabel().prefHeight(-1));
}
item.setTitle("Mod");
layout(parent, 300);
assertTagsVisible(item);
});
}
/// Creates a scene with an icon and an item without a horizontal growth constraint.
private static HBox createParent(TwoLineListItem item) {
Region icon = new Region();
icon.setMinSize(40, 40);
icon.setPrefSize(40, 40);
icon.setMaxSize(40, 40);
HBox parent = new HBox(8, icon, item);
new Scene(parent);
return parent;
}
/// Applies CSS and lays out the parent at the given width and its preferred height.
private static void layout(HBox parent, double width) {
parent.applyCss();
parent.resize(width, parent.prefHeight(width));
parent.layout();
}
/// Verifies every tag fits within the region that clips its contents.
private static void assertTagsVisible(TwoLineListItem item) {
for (Label tag : item.getTags()) {
Region container = (Region) tag.getParent();
assertTrue(tag.getBoundsInParent().getMaxX() <= container.getWidth(), "Tag is clipped");
assertTrue(tag.getWidth() >= tag.prefWidth(-1), "Tag text is truncated");
}
}
/// Runs assertions on the JavaFX thread and waits up to 30 seconds for completion.
private static void onFxThread(Runnable action) {
FutureTask<Boolean> task = new FutureTask<>(action, true);
Platform.runLater(task);
try {
task.get(30, TimeUnit.SECONDS);
} catch (InterruptedException e) {
Thread.currentThread().interrupt();
throw new AssertionError(e);
} catch (ExecutionException | TimeoutException e) {
throw new AssertionError(e);
}
}
}
@@ -0,0 +1,52 @@
/*
* 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.addon;
import org.jackhuang.hmcl.addon.mod.ModLoaderType;
import org.jackhuang.hmcl.util.StringUtils;
import org.jetbrains.annotations.NotNullByDefault;
import org.jetbrains.annotations.Nullable;
@NotNullByDefault
public record AddonLoader(String name, @Nullable AddonLoaderType type) {
public static boolean mightBeLoader(String str) {
if (StringUtils.isBlank(str)
|| !StringUtils.isASCII(str)
|| "client".equalsIgnoreCase(str) || "server".equalsIgnoreCase(str))
return false;
int l = str.length();
for (int i = 0; i < l; i++) {
char c = str.charAt(i);
if (c != '-' && c != ' ' && c != '_' && !StringUtils.isAlphabetic(c)) return false;
}
return true;
}
public static AddonLoader of(String name) {
for (var type : ModLoaderType.values()) {
for (String loaderName : type.names()) {
if (name.equalsIgnoreCase(loaderName)) {
return new AddonLoader(name, type);
}
}
}
return new AddonLoader(name, null);
}
}
@@ -0,0 +1,33 @@
/*
* 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.addon;
import org.jetbrains.annotations.NotNullByDefault;
import org.jetbrains.annotations.Unmodifiable;
import java.util.Set;
/// For mods and shaders
@NotNullByDefault
public interface AddonLoaderType {
String displayName();
@Unmodifiable Set<String> names();
}
@@ -17,7 +17,6 @@
*/
package org.jackhuang.hmcl.addon;
import org.jackhuang.hmcl.addon.mod.ModLoaderType;
import org.jackhuang.hmcl.addon.repository.CurseForgeRemoteAddonRepository;
import org.jackhuang.hmcl.addon.repository.ModrinthRemoteAddonRepository;
import org.jackhuang.hmcl.download.DownloadProvider;
@@ -224,7 +223,7 @@ public record RemoteAddon(String slug, String author, String title, String descr
public record Version(IVersion self, String versionId, String projectId, String name, String version,
Instant datePublished, VersionType versionType, File file, List<Dependency> dependencies,
List<String> gameVersions, List<ModLoaderType> loaders) {
List<String> gameVersions, List<AddonLoader> loaders) {
}
public record File(Map<String, String> hashes, String url, String filename) {
@@ -35,52 +35,6 @@ public interface RemoteAddonRepository {
String getBaseUrl();
enum SortType {
POPULARITY,
NAME,
DATE_CREATED,
LAST_UPDATED,
AUTHOR,
TOTAL_DOWNLOADS
}
enum SortOrder {
ASC,
DESC
}
class SearchResult {
private final Stream<RemoteAddon> sortedResults;
private final Stream<RemoteAddon> unsortedResults;
private final int totalPages;
public SearchResult(Stream<RemoteAddon> sortedResults, Stream<RemoteAddon> unsortedResults, int totalPages) {
this.sortedResults = sortedResults;
this.unsortedResults = unsortedResults;
this.totalPages = totalPages;
}
public SearchResult(Stream<RemoteAddon> sortedResults, int pages) {
this.sortedResults = sortedResults;
this.unsortedResults = sortedResults;
this.totalPages = pages;
}
public Stream<RemoteAddon> getResults() {
return this.sortedResults;
}
public Stream<RemoteAddon> getUnsortedResults() {
return this.unsortedResults;
}
public int getTotalPages() {
return this.totalPages;
}
}
SearchResult search(DownloadProvider downloadProvider, String gameVersion, @Nullable Category category, int pageOffset, int pageSize, String searchFilter, SortType sortType, SortOrder sortOrder)
throws IOException;
@@ -106,4 +60,20 @@ public interface RemoteAddonRepository {
record Category(Object self, String id, List<Category> subcategories) {
}
enum SortType {
RELEVANCY,
POPULARITY,
DATE_CREATED,
LAST_UPDATED,
TOTAL_DOWNLOADS
}
enum SortOrder {
ASC,
DESC
}
record SearchResult(Stream<RemoteAddon> results, int totalPages) {
}
}
@@ -202,7 +202,7 @@ public final class LocalModFile extends LocalAddonFile implements Comparable<Loc
if (currentVersion.isEmpty()) return null;
List<RemoteAddon.Version> remoteVersions = repository.getRemoteVersionsById(downloadProvider, currentVersion.get().projectId())
.filter(version -> version.gameVersions().contains(gameVersion))
.filter(version -> version.loaders().contains(getModLoaderType()))
.filter(version -> version.loaders().stream().anyMatch(it -> it.type() == getModLoaderType()))
.filter(version -> version.datePublished().compareTo(currentVersion.get().datePublished()) > 0)
.sorted(Comparator.comparing(RemoteAddon.Version::datePublished).reversed())
.toList();
@@ -17,27 +17,45 @@
*/
package org.jackhuang.hmcl.addon.mod;
import org.jackhuang.hmcl.addon.AddonLoaderType;
import org.jetbrains.annotations.NotNullByDefault;
import org.jetbrains.annotations.Nullable;
import org.jetbrains.annotations.Unmodifiable;
import java.util.Set;
@NotNullByDefault
public enum ModLoaderType {
UNKNOWN(null),
FORGE("INST_FORGE"),
CLEANROOM("INST_CLEANROOM"),
NEO_FORGE("INST_NEOFORGE"),
FABRIC("INST_FABRIC"),
QUILT("INST_QUILT"),
LITE_LOADER("INST_LITELOADER"),
LEGACY_FABRIC("INST_LEGACYFABRIC");
public enum ModLoaderType implements AddonLoaderType {
UNKNOWN("Unknown", null),
FORGE("Forge", "INST_FORGE", "forge"),
CLEANROOM("Cleanroom", "INST_CLEANROOM", "cleanroom"),
NEO_FORGE("NeoForge", "INST_NEOFORGE", "neoforge"),
FABRIC("Fabric", "INST_FABRIC", "fabric"),
QUILT("Quilt", "INST_QUILT", "quilt"),
LITE_LOADER("LiteLoader", "INST_LITELOADER", "liteloader"),
LEGACY_FABRIC("Legacy Fabric", "INST_LEGACYFABRIC", "legacy-fabric");
private final String displayName;
private final @Nullable String envVarName;
private final Set<String> names;
ModLoaderType(@Nullable String envVarName) {
ModLoaderType(String displayName, @Nullable String envVarName, String... names) {
this.displayName = displayName;
this.envVarName = envVarName;
this.names = Set.of(names);
}
public @Nullable String getEnvVarName() {
return envVarName;
}
@Override
public String displayName() {
return displayName;
}
@Override
public @Unmodifiable Set<String> names() {
return names;
}
}
@@ -18,13 +18,12 @@
package org.jackhuang.hmcl.addon.repository;
import com.google.gson.reflect.TypeToken;
import org.jackhuang.hmcl.addon.AddonLoader;
import org.jackhuang.hmcl.addon.RemoteAddon;
import org.jackhuang.hmcl.addon.RemoteAddonRepository;
import org.jackhuang.hmcl.addon.mod.ModLoaderType;
import org.jackhuang.hmcl.download.DownloadProvider;
import org.jackhuang.hmcl.util.Immutable;
import org.jackhuang.hmcl.util.MurmurHash2;
import org.jackhuang.hmcl.util.Pair;
import org.jackhuang.hmcl.util.StringUtils;
import org.jackhuang.hmcl.util.io.*;
import org.jackhuang.hmcl.util.versioning.GameVersionNumber;
@@ -57,11 +56,10 @@ public final class CurseForgeRemoteAddonRepository implements RemoteAddonReposit
private static final String PREFIX = "https://api.curseforge.com";
private static final String BASE = "https://www.curseforge.com";
private static final Semaphore SEMAPHORE = new Semaphore(16);
private static final int DEFAULT_RETRY_COUNT = 3;
public static final String API_KEY = System.getProperty("hmcl.curseforge.apikey", JarUtils.getAttribute("hmcl.curseforge.apikey", ""));
private static final int WORD_PERFECT_MATCH_WEIGHT = 5;
private static <R extends HttpRequest> R withApiKey(R request) {
if (request.getUrl().startsWith(PREFIX) && !API_KEY.isEmpty()) {
request.header("X-API-KEY", API_KEY);
@@ -106,13 +104,11 @@ public final class CurseForgeRemoteAddonRepository implements RemoteAddonReposit
private static int toModsSearchSortField(SortType sort) {
// https://docs.curseforge.com/rest-api/#tocS_ModsSearchSortField
return switch (sort) {
case DATE_CREATED -> 1;
case RELEVANCY -> 1; // This represents Featured, however test shows that they are quite similar
case POPULARITY -> 2;
case DATE_CREATED -> 11;
case LAST_UPDATED -> 3;
case NAME -> 4;
case AUTHOR -> 5;
case TOTAL_DOWNLOADS -> 6;
default -> 8;
};
}
@@ -128,6 +124,11 @@ public final class CurseForgeRemoteAddonRepository implements RemoteAddonReposit
return (int) Math.ceil((double) Math.min(response.pagination.totalCount, 10000) / pageSize);
}
/// Searches the configured section, preserving the order returned by the server.
///
/// @throws UnsupportedOperationException if this repository has no configured section
/// @throws NoCandidatesException if no response is obtained and no I/O failure was recorded
/// @throws IOException if all candidate requests fail with I/O errors
@Override
public SearchResult search(DownloadProvider downloadProvider, String gameVersion, @Nullable RemoteAddonRepository.Category category, int pageOffset, int pageSize, String searchFilter, SortType sortType, SortOrder sortOrder) throws IOException {
if (type == null) throw new UnsupportedOperationException();
@@ -150,18 +151,16 @@ public final class CurseForgeRemoteAddonRepository implements RemoteAddonReposit
query.put("index", Integer.toString(pageOffset * pageSize));
query.put("pageSize", Integer.toString(pageSize));
Response<List<CurseAddon>> response = null;
@Nullable Response<List<CurseAddon>> response = null;
IOException exception = null;
@Nullable IOException exception = null;
List<URI> candidates = downloadProvider.injectURLWithCandidates(NetworkUtils.withQuery(PREFIX + "/v1/mods/search", query));
for (URI candidate : candidates) {
LOG.info("Fetching " + candidate);
try {
response = withApiKey(HttpRequest.GET(candidate.toString()))
.retry(DEFAULT_RETRY_COUNT)
.getJson(Response.typeOf(listTypeOf(CurseAddon.class)));
if (searchFilter.isEmpty()) {
return new SearchResult(response.data().stream().map(CurseAddon::toAddon), calculateTotalPages(response, pageSize));
}
break;
} catch (IOException e) {
LOG.warning("Failed to search addons: " + candidate, e);
@@ -176,31 +175,10 @@ public final class CurseForgeRemoteAddonRepository implements RemoteAddonReposit
}
}
if (response == null) {
throw exception != null ? exception : new NoCandidatesException();
}
if (response != null)
return new SearchResult(response.data().stream().map(CurseAddon::toAddon), calculateTotalPages(response, pageSize));
// https://github.com/HMCL-dev/HMCL/issues/1549
String lowerCaseSearchFilter = searchFilter.toLowerCase(Locale.ROOT);
Map<String, Integer> searchFilterWords = new HashMap<>();
for (String s : StringUtils.tokenize(lowerCaseSearchFilter)) {
searchFilterWords.put(s, searchFilterWords.getOrDefault(s, 0) + 1);
}
StringUtils.LevCalculator levCalculator = new StringUtils.LevCalculator();
return new SearchResult(response.data().stream().map(CurseAddon::toAddon).map(remoteAddon -> {
String lowerCaseResult = remoteAddon.title().toLowerCase(Locale.ROOT);
int diff = levCalculator.calc(lowerCaseSearchFilter, lowerCaseResult);
for (String s : StringUtils.tokenize(lowerCaseResult)) {
if (searchFilterWords.containsKey(s)) {
diff -= WORD_PERFECT_MATCH_WEIGHT * searchFilterWords.get(s) * s.length();
}
}
return pair(remoteAddon, diff);
}).sorted(Comparator.comparingInt(Pair::getValue)).map(Pair::getKey), response.data().stream().map(CurseAddon::toAddon), calculateTotalPages(response, pageSize));
throw exception != null ? exception : new NoCandidatesException();
} finally {
SEMAPHORE.release();
}
@@ -273,6 +251,7 @@ public final class CurseForgeRemoteAddonRepository implements RemoteAddonReposit
try {
Response<FingerprintMatchesResult> response = withApiKey(HttpRequest.POST(PREFIX + "/v1/fingerprints/432"))
.json(mapOf(pair("fingerprints", Collections.singletonList(hash))))
.retry(DEFAULT_RETRY_COUNT)
.getJson(Response.typeOf(FingerprintMatchesResult.class));
if (response.data().exactMatches() == null || response.data().exactMatches().isEmpty()) {
@@ -290,6 +269,7 @@ public final class CurseForgeRemoteAddonRepository implements RemoteAddonReposit
SEMAPHORE.acquireUninterruptibly();
try {
Response<CurseAddon> response = withApiKey(HttpRequest.GET(PREFIX + "/v1/mods/" + id))
.retry(DEFAULT_RETRY_COUNT)
.getJson(Response.typeOf(CurseAddon.class));
return response.data.toAddon();
} finally {
@@ -315,6 +295,7 @@ public final class CurseForgeRemoteAddonRepository implements RemoteAddonReposit
SEMAPHORE.acquireUninterruptibly();
try {
Response<CurseAddon.LatestFile> response = withApiKey(HttpRequest.GET(String.format("%s/v1/mods/%s/files/%s", PREFIX, projectId, fileId)))
.retry(DEFAULT_RETRY_COUNT)
.getJson(Response.typeOf(CurseAddon.LatestFile.class));
return response.data().toVersion().file();
} finally {
@@ -328,6 +309,7 @@ public final class CurseForgeRemoteAddonRepository implements RemoteAddonReposit
try {
Response<List<CurseAddon.LatestFile>> response = withApiKey(HttpRequest.GET(PREFIX + "/v1/mods/" + id + "/files",
pair("pageSize", "10000")))
.retry(DEFAULT_RETRY_COUNT)
.getJson(Response.typeOf(listTypeOf(CurseAddon.LatestFile.class)));
return response.data().stream().map(CurseAddon.LatestFile::toVersion);
} finally {
@@ -340,6 +322,7 @@ public final class CurseForgeRemoteAddonRepository implements RemoteAddonReposit
SEMAPHORE.acquireUninterruptibly();
try {
Response<String> response = withApiKey(HttpRequest.GET(String.format("%s/v1/mods/%s/files/%s/changelog", PREFIX, addonId, versionId)))
.retry(DEFAULT_RETRY_COUNT)
.getJson(Response.typeOf(String.class));
return response.data();
} finally {
@@ -352,6 +335,7 @@ public final class CurseForgeRemoteAddonRepository implements RemoteAddonReposit
SEMAPHORE.acquireUninterruptibly();
try {
Response<CurseAddon> response = withApiKey(HttpRequest.GET(PREFIX + "/v1/mods/" + version.projectId()))
.retry(DEFAULT_RETRY_COUNT)
.getJson(Response.typeOf(CurseAddon.class));
var addon = response.data();
var classId = addon.classId();
@@ -380,6 +364,7 @@ public final class CurseForgeRemoteAddonRepository implements RemoteAddonReposit
SEMAPHORE.acquireUninterruptibly();
try {
Response<List<Category>> categories = withApiKey(HttpRequest.GET(PREFIX + "/v1/categories", pair("gameId", "432")))
.retry(DEFAULT_RETRY_COUNT)
.getJson(Response.typeOf(listTypeOf(Category.class)));
return reorganizeCategories(categories.data(), section).stream().map(Category::toCategory);
} finally {
@@ -598,6 +583,22 @@ public final class CurseForgeRemoteAddonRepository implements RemoteAddonReposit
default -> RemoteAddon.VersionType.Release;
};
Map<String, String> knownHashes;
if (hashes != null) {
knownHashes = new HashMap<>();
for (LatestFileHash hash : hashes) {
if (hash.value != null) {
switch (hash.algo) {
case 1 -> knownHashes.put("sha1", hash.value);
case 2 -> knownHashes.put("md5", hash.value);
}
}
}
knownHashes = Map.copyOf(knownHashes);
} else {
knownHashes = Map.of();
}
return new RemoteAddon.Version(
this,
Integer.toString(id()),
@@ -606,7 +607,7 @@ public final class CurseForgeRemoteAddonRepository implements RemoteAddonReposit
fileName(),
fileDate(),
versionType,
new RemoteAddon.File(Collections.emptyMap(), downloadUrl(), fileName()),
new RemoteAddon.File(knownHashes, downloadUrl(), fileName()),
dependencies.stream().map(dependency -> {
if (!RELATION_TYPE.containsKey(dependency.relationType())) {
throw new IllegalStateException("Broken datas.");
@@ -614,13 +615,10 @@ public final class CurseForgeRemoteAddonRepository implements RemoteAddonReposit
return RemoteAddon.Dependency.ofGeneral(RELATION_TYPE.get(dependency.relationType()), RemoteAddon.Source.CURSEFORGE, Integer.toString(dependency.modId()));
}).distinct().filter(Objects::nonNull).collect(Collectors.toList()),
gameVersions.stream().filter(GameVersionNumber::isKnown).toList(),
gameVersions.stream().flatMap(version -> {
if ("fabric".equalsIgnoreCase(version)) return Stream.of(ModLoaderType.FABRIC);
else if ("forge".equalsIgnoreCase(version)) return Stream.of(ModLoaderType.FORGE);
else if ("quilt".equalsIgnoreCase(version)) return Stream.of(ModLoaderType.QUILT);
else if ("neoforge".equalsIgnoreCase(version)) return Stream.of(ModLoaderType.NEO_FORGE);
else return Stream.empty();
}).collect(Collectors.toList())
gameVersions.stream()
.filter(AddonLoader::mightBeLoader)
.map(AddonLoader::of)
.toList()
);
}
}
@@ -19,9 +19,9 @@ package org.jackhuang.hmcl.addon.repository;
import com.google.gson.annotations.SerializedName;
import com.google.gson.reflect.TypeToken;
import org.jackhuang.hmcl.addon.AddonLoader;
import org.jackhuang.hmcl.addon.RemoteAddon;
import org.jackhuang.hmcl.addon.RemoteAddonRepository;
import org.jackhuang.hmcl.addon.mod.ModLoaderType;
import org.jackhuang.hmcl.download.DownloadProvider;
import org.jackhuang.hmcl.util.DigestUtils;
import org.jackhuang.hmcl.util.Immutable;
@@ -146,11 +146,11 @@ public final class ModrinthRemoteAddonRepository implements RemoteAddonRepositor
private static String convertSortType(SortType sortType) {
return switch (sortType) {
case RELEVANCY -> "relevance";
case POPULARITY -> "follows";
case DATE_CREATED -> "newest";
case POPULARITY, NAME, AUTHOR -> "relevance";
case LAST_UPDATED -> "updated";
case TOTAL_DOWNLOADS -> "downloads";
default -> throw new IllegalArgumentException("Unsupported sort type " + sortType);
};
}
@@ -490,15 +490,7 @@ public final class ModrinthRemoteAddonRepository implements RemoteAddonRepositor
return RemoteAddon.Dependency.ofGeneral(DEPENDENCY_TYPE.get(dependency.dependencyType), RemoteAddon.Source.MODRINTH, dependency.projectId);
}).filter(Objects::nonNull).collect(Collectors.toList()),
gameVersions,
loaders.stream().flatMap(loader -> {
if ("fabric".equalsIgnoreCase(loader)) return Stream.of(ModLoaderType.FABRIC);
else if ("forge".equalsIgnoreCase(loader)) return Stream.of(ModLoaderType.FORGE);
else if ("legacy-fabric".equalsIgnoreCase(loader)) return Stream.of(ModLoaderType.LEGACY_FABRIC);
else if ("neoforge".equalsIgnoreCase(loader)) return Stream.of(ModLoaderType.NEO_FORGE);
else if ("quilt".equalsIgnoreCase(loader)) return Stream.of(ModLoaderType.QUILT);
else if ("liteloader".equalsIgnoreCase(loader)) return Stream.of(ModLoaderType.LITE_LOADER);
else return Stream.empty();
}).collect(Collectors.toList())
loaders.stream().map(AddonLoader::of).toList()
));
}
}
@@ -114,16 +114,16 @@ public sealed abstract class ResourcePackFile extends LocalAddonFile implements
@Nullable
@Contract(pure = true)
public abstract PackMcMeta getMeta();
public abstract PackMcMeta.PackInfo getPackInfo();
@Nullable
public LocalAddonFile.Description getDescription() {
if (getMeta() == null || getMeta().pack() == null) return null;
return getMeta().pack().description();
if (getPackInfo() == null) return null;
return getPackInfo().description();
}
// 64*64
public abstract @Nullable Image getIcon();
public abstract @Nullable Image loadIcon();
@Override
public int compareTo(@NotNull ResourcePackFile other) {
@@ -30,8 +30,7 @@ import java.nio.file.Path;
import static org.jackhuang.hmcl.util.logging.Logger.LOG;
final class ResourcePackFolder extends ResourcePackFile {
private final PackMcMeta meta;
private final @Nullable Image icon;
private final PackMcMeta.PackInfo info;
public ResourcePackFolder(ResourcePackManager manager, Path path) {
super(manager, path);
@@ -42,33 +41,31 @@ final class ResourcePackFolder extends ResourcePackFile {
} catch (Exception e) {
LOG.warning("Failed to parse resource pack meta", e);
}
this.meta = meta;
this.info = meta != null ? meta.pack() : null;
}
@Override
public PackMcMeta.PackInfo getPackInfo() {
return info;
}
@Override
public @Nullable Image loadIcon() {
byte[] iconData = null;
Image iconTemp = null;
try {
iconData = Files.readAllBytes(path.resolve("pack.png"));
} catch (IOException e) {
LOG.warning("Failed to read resource pack icon", e);
iconData = Files.readAllBytes(getFile().resolve("pack.png"));
} catch (Exception e) {
LOG.warning("Failed to load resource pack icon", e);
}
if (iconData != null) {
try (ByteArrayInputStream inputStream = new ByteArrayInputStream(iconData)) {
iconTemp = new Image(inputStream, 64, 64, true, true);
return new Image(inputStream, 64, 64, true, true);
} catch (Exception e) {
LOG.warning("Failed to load resource pack icon", e);
}
}
this.icon = iconTemp;
}
@Override
public PackMcMeta getMeta() {
return meta;
}
@Override
public @Nullable Image getIcon() {
return icon;
return null;
}
@Override
@@ -522,18 +522,18 @@ public final class ResourcePackManager extends LocalAddonManager<ResourcePackFil
}
public ResourcePackFile.Compatibility getCompatibility(@NotNull ResourcePackFile resourcePack) {
if (resourcePack.getMeta() == null || resourcePack.getMeta().pack() == null)
if (resourcePack.getPackInfo() == null)
return ResourcePackFile.Compatibility.MISSING_PACK_META;
if (this.getRequiredVersion().isUnspecified())
return ResourcePackFile.Compatibility.MISSING_GAME_META;
int requiredMajor = getRequiredVersion().majorVersion();
VersionRange<PackMcMeta.PackVersion> versionRange;
if (requiredMajor > 64)
versionRange = getResourcePackVersionRangeNew(resourcePack.getMeta().pack());
versionRange = getResourcePackVersionRangeNew(resourcePack.getPackInfo());
else if (requiredMajor > 15)
versionRange = getResourcePackVersionRangeOld(resourcePack.getMeta().pack());
versionRange = getResourcePackVersionRangeOld(resourcePack.getPackInfo());
else
versionRange = getResourcePackVersionRangeOldest(resourcePack.getMeta().pack());
versionRange = getResourcePackVersionRangeOldest(resourcePack.getPackInfo());
if (versionRange.isEmpty())
return ResourcePackFile.Compatibility.INVALID;
if (versionRange.getMaximum().compareTo(this.getRequiredVersion()) < 0)
@@ -36,52 +36,47 @@ import java.util.Optional;
import static org.jackhuang.hmcl.util.logging.Logger.LOG;
final class ResourcePackZipFile extends ResourcePackFile {
private final PackMcMeta meta;
private final @Nullable Image icon;
private final PackMcMeta.PackInfo info;
public ResourcePackZipFile(ResourcePackManager manager, Path path) throws IOException {
super(manager, path);
PackMcMeta metaTemp = null;
byte[] iconData = null;
PackMcMeta meta = null;
try (var zipFileTree = CompressingUtils.openZipTree(path)) {
try {
metaTemp = PackMcMeta.fromNonNullJson(zipFileTree.readTextEntry("/pack.mcmeta"));
meta = PackMcMeta.fromNonNullJson(zipFileTree.readTextEntry("/pack.mcmeta"));
} catch (Exception e) {
LOG.warning("Failed to parse resource pack meta", e);
}
}
this.info = meta != null ? meta.pack() : null;
}
@Override
public PackMcMeta.PackInfo getPackInfo() {
return info;
}
@Override
public @Nullable Image loadIcon() {
byte[] iconData = null;
try (var zipFileTree = CompressingUtils.openZipTree(getFile())) {
var iconEntry = zipFileTree.getEntry("/pack.png");
if (iconEntry != null) {
try {
iconData = zipFileTree.readBinaryEntry(iconEntry);
} catch (Exception e) {
LOG.warning("Failed to load resource pack icon", e);
}
iconData = zipFileTree.readBinaryEntry(iconEntry);
}
} catch (Exception e) {
LOG.warning("Failed to load resource pack icon", e);
}
this.meta = metaTemp;
Image iconTemp = null;
if (iconData != null) {
try (ByteArrayInputStream inputStream = new ByteArrayInputStream(iconData)) {
iconTemp = new Image(inputStream, 64, 64, true, true);
return new Image(inputStream, 64, 64, true, true);
} catch (Exception e) {
LOG.warning("Failed to load resource pack icon", e);
}
}
this.icon = iconTemp;
}
@Override
public PackMcMeta getMeta() {
return meta;
}
@Override
public @Nullable Image getIcon() {
return icon;
return null;
}
@Override
@@ -36,7 +36,6 @@ public abstract class YggdrasilAccount extends ClassicAccount {
protected final UUID profileID;
protected final String loginName;
private boolean authenticated = false;
private YggdrasilSession session;
protected YggdrasilAccount(AccountID accountID, YggdrasilService service, String loginName, YggdrasilSession session) {
@@ -72,7 +71,6 @@ public abstract class YggdrasilAccount extends ClassicAccount {
}
profileID = session.getSelectedProfile().getId();
authenticated = true;
addProfilePropertiesListener();
}
@@ -101,37 +99,33 @@ public abstract class YggdrasilAccount extends ClassicAccount {
return session.getSelectedProfile().getId();
}
/// Returns authentication information after validating the current token.
/// Refreshes the session if the profile name is missing or the token is invalid.
@Override
public synchronized AuthInfo logIn() throws AuthenticationException {
if (!authenticated || !session.hasProfileName()) {
if (session.hasProfileName() && service.validate(session.getAccessToken(), session.getClientToken())) {
authenticated = true;
} else {
YggdrasilSession acquiredSession;
try {
acquiredSession = service.refresh(session.getAccessToken(), session.getClientToken(), null);
} catch (RemoteAuthenticationException e) {
if ("ForbiddenOperationException".equals(e.getRemoteName())) {
throw new CredentialExpiredException(e);
} else {
throw e;
}
if (!session.hasProfileName() || !service.validate(session.getAccessToken(), session.getClientToken())) {
YggdrasilSession acquiredSession;
try {
acquiredSession = service.refresh(session.getAccessToken(), session.getClientToken(), null);
} catch (RemoteAuthenticationException e) {
if ("ForbiddenOperationException".equals(e.getRemoteName())) {
throw new CredentialExpiredException(e);
} else {
throw e;
}
if (acquiredSession.getSelectedProfile() == null ||
!acquiredSession.getSelectedProfile().getId().equals(profileID)) {
throw new ServerResponseMalformedException("Selected profile changed");
}
if (!acquiredSession.hasProfileName()) {
throw new ServerResponseMalformedException("Profile name is missing");
}
session = acquiredSession;
authenticated = true;
invalidate();
}
}
if (acquiredSession.getSelectedProfile() == null ||
!acquiredSession.getSelectedProfile().getId().equals(profileID)) {
throw new ServerResponseMalformedException("Selected profile changed");
}
if (!acquiredSession.hasProfileName()) {
throw new ServerResponseMalformedException("Profile name is missing");
}
session = acquiredSession;
invalidate();
}
return session.toAuthInfo();
}
@@ -161,7 +155,6 @@ public abstract class YggdrasilAccount extends ClassicAccount {
session = acquiredSession;
}
authenticated = true;
invalidate();
return session.toAuthInfo();
}
@@ -196,7 +189,6 @@ public abstract class YggdrasilAccount extends ClassicAccount {
@Override
public void clearCache() {
authenticated = false;
service.getProfileRepository().invalidate(profileID);
}
@@ -26,6 +26,7 @@ import org.jackhuang.hmcl.download.neoforge.NeoForgeInstallTask;
import org.jackhuang.hmcl.download.optifine.OptiFineInstallTask;
import org.jackhuang.hmcl.game.*;
import org.jackhuang.hmcl.task.Task;
import org.jackhuang.hmcl.util.function.ExceptionalFunction;
import org.jackhuang.hmcl.util.io.FileUtils;
import org.jackhuang.hmcl.util.versioning.GameVersionNumber;
import org.jetbrains.annotations.NotNullByDefault;
@@ -36,6 +37,7 @@ import java.nio.file.Files;
import java.nio.file.Path;
import java.util.ArrayList;
import java.util.List;
import java.util.Objects;
import java.util.regex.Matcher;
/// Provides downloads and game-component installation for one game repository.
@@ -163,6 +165,69 @@ public class DefaultDependencyManager extends AbstractDependencyManager {
}
}
/// Creates a task that updates an instance's manifest and its own client JAR in one draft.
///
/// The updater receives the published instance and must return a manifest with the same id.
/// If the updated manifest uses this instance's own JAR, that JAR is replaced when the resolved
/// client download changes or the previous manifest used another instance's JAR. Downloads are
/// compared by SHA-1 when either declares a checksum, otherwise by URL and size. Matching
/// checksums identify the same client even when the URLs differ. Referenced JARs are not modified.
///
/// A replacement is obtained through this manager's download provider and cache before the
/// manifest and JAR are committed together. A task failure aborts the draft and retains the
/// previously published instance files. Shared cache files written by the tasks are retained.
///
/// @param <E> the checked exception type thrown while creating the update task
/// @param instanceId the instance to update
/// @param updater the asynchronous manifest update
/// @return the task that commits the updated instance
public <E extends Exception> Task<Void> updateInstanceAsync(
GameInstanceID instanceId,
ExceptionalFunction<GameInstance, Task<GameInstanceManifest>, E> updater) {
return Task.composeAsync(() -> {
DefaultGameRepositoryDraft draft = repository.openDraft();
try {
GameInstance instance = draft.getBaseSnapshot().getInstance(instanceId);
return Objects.requireNonNull(updater.apply(instance), "Instance updater returned null")
.thenComposeAsync(manifest -> {
if (!instanceId.equals(manifest.id())) {
throw new IllegalArgumentException(
"Instance updater changed id from " + instanceId + " to " + manifest.id());
}
GameInstanceManifest previous = instance.getResolvedManifest();
GameInstanceManifest resolved = draft.getBaseSnapshot().resolve(manifest);
draft.put(manifest);
if (instanceId.equals(resolved.jar())
&& (!instanceId.equals(previous.jar())
|| !isSameClientDownload(previous.getDownloadInfo(), resolved.getDownloadInfo()))) {
return new GameDownloadTask(this, resolved).thenAcceptAsync(
jar -> draft.putPrimaryJar(instanceId, jar));
}
return null;
}).thenRunAsync(() -> {
draft.commit();
}).whenComplete(exception -> {
if (draft.isOpen()) {
draft.abort();
}
});
} catch (Throwable exception) {
abortDraftAfterFailure(draft, exception);
throw exception;
}
});
}
/// Compares client identity by checksum, falling back to URL and size when neither has one.
private static boolean isSameClientDownload(DownloadInfo previous, DownloadInfo updated) {
@Nullable String previousSha1 = previous.getSha1();
@Nullable String updatedSha1 = updated.getSha1();
if (previousSha1 != null || updatedSha1 != null) {
return previousSha1 != null && previousSha1.equalsIgnoreCase(updatedSha1);
}
return previous.getUrl().equals(updated.getUrl()) && previous.getSize() == updated.getSize();
}
@Override
public Task<?> checkGameCompletionAsync(
GameInstance instance,
@@ -207,6 +207,22 @@ public class DefaultGameBuilder extends GameBuilder {
}
}
/// Aborts this builder's open draft, including after ownership has passed to its build task.
///
/// If [#buildAsync()] has returned a task, the caller must ensure its executor has stopped
/// before invoking this method. This operation does not cancel or wait for task execution.
/// It has no effect if the draft has already committed or aborted, and does not undo a
/// committed installation. Subsequent calls have no effect after cleanup has completed or
/// failed. Shared download caches are retained.
///
/// @throws IOException if reserved instance files cannot be removed; draft exclusivity is
/// released even in this case
public void abort() throws IOException {
if (draft.isOpen()) {
draft.abort();
}
}
/// Performs repository-specific initialization after an instance is committed.
///
/// This method is invoked after the repository has published the committed snapshot and before
@@ -22,6 +22,7 @@ import org.jackhuang.hmcl.download.ComponentVersionList;
import org.jackhuang.hmcl.task.GetTask;
import org.jackhuang.hmcl.task.Task;
import org.jackhuang.hmcl.util.StringUtils;
import org.jackhuang.hmcl.util.gson.JsonSerializable;
import org.jackhuang.hmcl.util.versioning.VersionNumber;
import java.util.Collections;
@@ -79,17 +80,17 @@ public final class OptiFineBMCLVersionList extends ComponentVersionList<OptiFine
versions.clear();
Set<String> duplicates = new HashSet<>();
for (OptiFineVersion element : root) {
String version = element.getType() + "_" + element.getPatch();
String mirror = apiRoot + "/optifine/" + toLookupVersion(element.getGameVersion()) + "/" + element.getType() + "/" + element.getPatch();
String version = element.type() + "_" + element.patch();
String mirror = apiRoot + "/optifine/" + toLookupVersion(element.gameVersion()) + "/" + element.type() + "/" + element.patch();
if (!duplicates.add(mirror))
continue;
boolean isPre = element.getPatch() != null && (element.getPatch().startsWith("pre") || element.getPatch().startsWith("alpha"));
boolean isPre = element.patch() != null && (element.patch().startsWith("pre") || element.patch().startsWith("alpha"));
if (StringUtils.isBlank(element.getGameVersion()))
if (StringUtils.isBlank(element.gameVersion()))
continue;
String gameVersion = VersionNumber.normalize(fromLookupVersion(element.getGameVersion()));
String gameVersion = VersionNumber.normalize(fromLookupVersion(element.gameVersion()));
versions.put(gameVersion, new OptiFineRemoteVersion(gameVersion, version, Collections.singletonList(mirror), isPre));
}
} finally {
@@ -97,73 +98,14 @@ public final class OptiFineBMCLVersionList extends ComponentVersionList<OptiFine
}
});
}
/**
* @author huangyuhui
*/
private static final class OptiFineVersion {
@SerializedName("dl")
private final String downloadLink;
@SerializedName("ver")
private final String version;
@SerializedName("date")
private final String date;
@SerializedName("type")
private final String type;
@SerializedName("patch")
private final String patch;
@SerializedName("mirror")
private final String mirror;
@SerializedName("mcversion")
private final String gameVersion;
public OptiFineVersion() {
this(null, null, null, null, null, null, null);
}
public OptiFineVersion(String downloadLink, String version, String date, String type, String patch, String mirror, String gameVersion) {
this.downloadLink = downloadLink;
this.version = version;
this.date = date;
this.type = type;
this.patch = patch;
this.mirror = mirror;
this.gameVersion = gameVersion;
}
public String getDownloadLink() {
return downloadLink;
}
public String getVersion() {
return version;
}
public String getDate() {
return date;
}
public String getType() {
return type;
}
public String getPatch() {
return patch;
}
public String getMirror() {
return mirror;
}
public String getGameVersion() {
return gameVersion;
}
@JsonSerializable
private record OptiFineVersion(@SerializedName("dl") String downloadLink, @SerializedName("ver") String version,
@SerializedName("date") String date, @SerializedName("type") String type,
@SerializedName("patch") String patch, @SerializedName("mirror") String mirror,
@SerializedName("mcversion") String gameVersion) {
}
}
@@ -24,7 +24,6 @@ import javafx.beans.property.ReadOnlyObjectProperty;
import javafx.beans.property.SimpleObjectProperty;
import org.jackhuang.hmcl.task.Task;
import org.jackhuang.hmcl.util.Lang;
import org.jackhuang.hmcl.util.function.ExceptionalFunction;
import org.jackhuang.hmcl.util.gson.JsonUtils;
import org.jackhuang.hmcl.util.io.FileUtils;
import org.jetbrains.annotations.NotNullByDefault;
@@ -293,6 +292,8 @@ public abstract class DefaultGameRepository implements GameRepository {
LOG.warning("Failed to load instance", e);
}
}
newSnapshot.removeInvalidInstances();
} catch (IOException e) {
LOG.warning("Failed to load instance from " + instancesDir, e);
}
@@ -523,57 +524,6 @@ public abstract class DefaultGameRepository implements GameRepository {
return Task.supplyAsync(() -> save(instanceManifest));
}
/// Creates a task that updates one registered instance inside an exclusive draft.
///
/// The updater receives the instance from the immutable published snapshot and must return a
/// working manifest with the same id. Its result is staged and committed exactly once. Failure
/// or cancellation aborts the draft; shared cache files written by the updater are retained.
///
/// @param <E> the checked exception type thrown while creating the update task
/// @param instanceId the instance to update
/// @param updater the asynchronous manifest update
/// @return the task that commits the updated manifest
public <E extends Exception> Task<Void> updateInstanceAsync(
GameInstanceID instanceId,
ExceptionalFunction<GameInstance, Task<GameInstanceManifest>, E> updater) {
return Task.composeAsync(() -> {
DefaultGameRepositoryDraft draft = openDraft();
try {
return Objects.requireNonNull(
updater.apply(draft.getBaseSnapshot().getInstance(instanceId)),
"Instance updater returned null")
.thenApplyAsync(manifest -> {
if (!instanceId.equals(manifest.id())) {
throw new IllegalArgumentException(
"Instance updater changed id from " + instanceId + " to " + manifest.id());
}
draft.put(manifest);
draft.commit();
return manifest;
}).whenComplete(exception -> {
if (draft.isOpen()) {
draft.abort();
}
});
} catch (Throwable exception) {
abortDraftAfterFailure(draft, exception);
throw exception;
}
});
}
/// Aborts a draft after task construction fails and preserves any cleanup failure.
///
/// @param draft the draft to abort
/// @param failure the failure that prevented task construction
private static void abortDraftAfterFailure(DefaultGameRepositoryDraft draft, Throwable failure) {
try {
draft.abort();
} catch (Exception cleanupFailure) {
failure.addSuppressed(cleanupFailure);
}
}
/// Creates an empty unsealed snapshot for the given layout.
///
/// @param layout the layout for the new snapshot
@@ -361,6 +361,7 @@ public final class DefaultGameRepositoryDraft implements GameRepositoryDraft {
: repository.createInstance(committedSnapshot, manifest.id(), manifest);
committedSnapshot.put(updated);
}
committedSnapshot.removeInvalidInstances();
committedSnapshot.seal();
return committedSnapshot;
}
@@ -160,6 +160,51 @@ public class DefaultGameRepositorySnapshot implements GameRepositorySnapshot {
instances.remove(id);
}
/// Remove invalid instances.
/// TODO: In the future we could retain these instances and show their status in the UI.
void removeInvalidInstances() {
checkMutable();
HashSet<GameInstanceID> visited = null;
loop:
for (DefaultGameInstance instance : List.copyOf(instances.values())) {
if (instance.getManifest().inheritsFrom() == null) {
continue;
}
if (visited != null)
visited.clear();
else
visited = new HashSet<>();
DefaultGameInstance current = instance;
visited.add(current.getId());
while (current.getManifest().inheritsFrom() != null) {
GameInstanceID parentId = current.getManifest().inheritsFrom();
if (!visited.add(parentId)) {
// DefaultGameRepositorySnapshot.resolve can handle circular references
continue loop;
}
DefaultGameInstance parent = instances.get(parentId);
if (parent == null) {
LOG.warning("Instance " + current.getId() + " inherits from missing instance " + parentId);
for (DefaultGameInstance toRemoved = instance; toRemoved != null; ) {
instances.remove(toRemoved.getId());
toRemoved = toRemoved.getManifest().inheritsFrom() != null
? instances.get(toRemoved.getManifest().inheritsFrom())
: null;
}
break;
}
current = parent;
}
}
}
/// Creates an unpublished mutable copy with instances rebound to the copy.
///
/// The caller must call [#seal()] before retaining or publishing the result as a snapshot.
@@ -83,6 +83,7 @@ public enum GameComponentType {
},
FORGE("forge", ModLoaderType.FORGE) {
private final Pattern FORGE_VERSION_MATCHER = Pattern.compile("^([0-9.]+)-(?<forge>[0-9.]+)(-([0-9.]+))?$");
private final Set<String> ARTIFACTS = Set.of("forge", "fmlloader", "minecraftforge");
@Override
protected @Nullable String getComponentVersion(GameInstanceManifest manifest, String libraryVersion) {
@@ -95,13 +96,17 @@ public enum GameComponentType {
@Override
protected boolean matchLibrary(Library library, List<Library> libraries) {
for (Library l : libraries) {
if (NEO_FORGE.matchLibrary(l, libraries)) {
return false;
if ("net.minecraftforge".equals(library.groupId()) && ARTIFACTS.contains(library.artifactId())) {
for (Library l : libraries) {
if (NEO_FORGE.matchLibrary(l, libraries)) {
return false;
}
}
return true;
}
return "net.minecraftforge".equals(library.groupId()) && ("forge".equals(library.artifactId()) || "fmlloader".equals(library.artifactId()));
return false;
}
},
CLEANROOM("cleanroom", ModLoaderType.CLEANROOM) {
@@ -203,12 +203,9 @@ public record Library(
return true;
}
if (downloads != null && downloads.classifiers() != null
&& downloads.classifiers().keySet().stream().anyMatch(s -> s.startsWith("native"))) {
return true;
}
return this.artifact().getClassifier() != null && this.artifact().getClassifier().startsWith("natives-");
return downloads != null
&& downloads.classifiers() != null
&& downloads.classifiers().keySet().stream().anyMatch(s -> s.startsWith("native"));
}
public @Nullable LibraryDownloadInfo getRawDownloadInfo() {
@@ -279,6 +279,7 @@ public class DefaultLauncher extends Launcher {
if (instance.hasComponent(GameComponentType.CLEANROOM)) {
libraryClasspath.removeIf(c -> c.contains("2.9.4-nightly-20150209"));
libraryClasspath.removeIf(c -> c.contains("platform-3.4.0"));
}
Path jar = instance.getInstanceJarFile();
@@ -134,7 +134,10 @@ public final class CurseCompletionTask extends Task<Void> {
if (StringUtils.isBlank(file.fileName()) || file.url() == null) {
try {
RemoteAddon.File remoteFile = CurseForgeRemoteAddonRepository.MODS.getAddonFile(Integer.toString(file.projectID()), Integer.toString(file.fileID()));
return file.withFileName(remoteFile.filename()).withURL(remoteFile.url());
return file
.withFileName(remoteFile.filename())
.withURL(remoteFile.url())
.withHashes(remoteFile.hashes());
} catch (FileNotFoundException fof) {
LOG.warning("Could not query api.curseforge.com for deleted mods: " + file.projectID() + ", " + file.fileID(), fof);
notFound.set(true);
@@ -165,7 +168,7 @@ public final class CurseCompletionTask extends Task<Void> {
return Stream.empty();
}
var task = new FileDownloadTask(f.url(), path);
var task = new FileDownloadTask(f.url(), path, f.getIntegrityCheck());
task.setCacheRepository(dependency.getCacheRepository());
task.setCaching(true);
return Stream.of(task.withCounter("hmcl.modpack.download"));
@@ -19,19 +19,33 @@ package org.jackhuang.hmcl.modpack.curse;
import com.google.gson.JsonParseException;
import com.google.gson.annotations.SerializedName;
import org.jackhuang.hmcl.task.FileDownloadTask;
import org.jackhuang.hmcl.util.Pair;
import org.jackhuang.hmcl.util.gson.JsonSerializable;
import org.jackhuang.hmcl.util.gson.Validation;
import org.jetbrains.annotations.Nullable;
import java.util.List;
import java.util.Map;
import java.util.Objects;
import static org.jackhuang.hmcl.util.Pair.pair;
/// @author huangyuhui
@JsonSerializable
public record CurseManifestFile(@SerializedName("projectID") int projectID,
@SerializedName("fileID") int fileID,
@SerializedName("fileName") String fileName,
@SerializedName("url") String url,
@SerializedName("required") boolean required) implements Validation {
@SerializedName("required") boolean required,
@SerializedName("hashes") Map<String, String> hashes) implements Validation {
private static final List<Pair<String, String>> HASH_ALGORITHMS = List.of(
pair("sha1", "SHA-1"),
pair("sha256", "SHA-256"),
pair("sha512", "SHA-512"),
pair("md5", "MD5")
);
@Override
public void validate() throws JsonParseException {
@@ -51,12 +65,29 @@ public record CurseManifestFile(@SerializedName("projectID") int projectID,
}
}
@Nullable
public FileDownloadTask.IntegrityCheck getIntegrityCheck() {
if (hashes == null || hashes.isEmpty()) return null;
for (Pair<String, String> algorithm : HASH_ALGORITHMS) {
String hash = hashes.get(algorithm.key());
if (hash != null) {
return new FileDownloadTask.IntegrityCheck(algorithm.value(), hash);
}
}
return null;
}
public CurseManifestFile withFileName(String fileName) {
return new CurseManifestFile(projectID, fileID, fileName, url, required);
return new CurseManifestFile(projectID, fileID, fileName, url, required, hashes);
}
public CurseManifestFile withURL(String url) {
return new CurseManifestFile(projectID, fileID, fileName, url, required);
return new CurseManifestFile(projectID, fileID, fileName, url, required, hashes);
}
public CurseManifestFile withHashes(Map<String, String> hashes) {
return new CurseManifestFile(projectID, fileID, fileName, url, required, hashes);
}
@Override
@@ -26,43 +26,28 @@ import org.jackhuang.hmcl.util.Immutable;
* https://addons-ecs.forgesvc.net/api/v2/addon/&lt;projectID&gt;/file/&lt;fileID&gt;
*/
@Immutable
public final class CurseMetaMod {
@SerializedName(value = "Id", alternate = "id")
private final int id;
public record CurseMetaMod(@SerializedName(value = "Id", alternate = "id") int id,
@SerializedName(value = "FileName", alternate = "fileName") String fileName,
@SerializedName(value = "FileNameOnDisk") String fileNameOnDisk,
@SerializedName(value = "DownloadURL", alternate = "downloadUrl") String downloadURL) {
@SerializedName(value = "FileName", alternate = "fileName")
private final String fileName;
@SerializedName(value = "FileNameOnDisk")
private final String fileNameOnDisk;
@SerializedName(value = "DownloadURL", alternate = "downloadUrl")
private final String downloadURL;
public CurseMetaMod() {
this(0, "", "", "");
}
public CurseMetaMod(int id, String fileName, String fileNameOnDisk, String downloadURL) {
this.id = id;
this.fileName = fileName;
this.fileNameOnDisk = fileNameOnDisk;
this.downloadURL = downloadURL;
}
public int getId() {
@Override
public int id() {
return id;
}
public String getFileName() {
@Override
public String fileName() {
return fileName;
}
public String getFileNameOnDisk() {
@Override
public String fileNameOnDisk() {
return fileNameOnDisk;
}
public String getDownloadURL() {
@Override
public String downloadURL() {
return downloadURL;
}
}
@@ -223,7 +223,7 @@ public class McbbsModpackCompletionTask extends CompletableFutureTask<Void> {
try {
String result = NetworkUtils.doGet(String.format("https://cursemeta.dries007.net/%d/%d.json", file.getProjectID(), file.getFileID()));
CurseMetaMod mod = JsonUtils.fromNonNullJson(result, CurseMetaMod.class);
return file.withFileName(mod.getFileNameOnDisk()).withURL(mod.getDownloadURL());
return file.withFileName(mod.fileNameOnDisk()).withURL(mod.downloadURL());
} catch (FileNotFoundException fof) {
LOG.warning("Could not query cursemeta for deleted mods: " + file.getUrl(), fof);
notFound.set(true);
@@ -232,7 +232,7 @@ public class McbbsModpackCompletionTask extends CompletableFutureTask<Void> {
try {
String result = NetworkUtils.doGet(String.format("https://addons-ecs.forgesvc.net/api/v2/addon/%d/file/%d", file.getProjectID(), file.getFileID()));
CurseMetaMod mod = JsonUtils.fromNonNullJson(result, CurseMetaMod.class);
return file.withFileName(mod.getFileName()).withURL(mod.getDownloadURL());
return file.withFileName(mod.fileName()).withURL(mod.downloadURL());
} catch (FileNotFoundException fof) {
LOG.warning("Could not query forgesvc for deleted mods: " + file.getUrl(), fof);
notFound.set(true);
@@ -21,9 +21,9 @@ import java.io.File;
import java.io.IOException;
import java.nio.file.Files;
import java.nio.file.Path;
import java.nio.file.Paths;
import java.util.*;
import org.jackhuang.hmcl.addon.LocalAddonManager;
import org.jackhuang.hmcl.addon.mod.ModManager;
import org.jackhuang.hmcl.addon.repository.ModrinthRemoteAddonRepository;
import org.jackhuang.hmcl.game.DefaultGameInstance;
@@ -34,6 +34,7 @@ import org.jackhuang.hmcl.modpack.Modpack;
import org.jackhuang.hmcl.modpack.ModpackExportInfo;
import org.jackhuang.hmcl.task.Task;
import org.jackhuang.hmcl.util.DigestUtils;
import org.jackhuang.hmcl.util.StringUtils;
import org.jackhuang.hmcl.util.gson.JsonUtils;
import org.jackhuang.hmcl.util.io.Zipper;
import org.jackhuang.hmcl.util.versioning.GameVersionNumber;
@@ -93,7 +94,7 @@ public class ModrinthModpackExportTask extends Task<Void> {
boolean isDisabled = modManager.isDisabled(file);
if (isDisabled) {
relativePath = modManager.enableMod(Paths.get(relativePath)).toString();
relativePath = StringUtils.removeSuffix(relativePath, LocalAddonManager.DISABLED_EXTENSION);
}
Optional<RemoteAddon.Version> modrinthVersion = Optional.empty();
@@ -1,124 +0,0 @@
/*
* 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.modpack.multimc;
import org.jackhuang.hmcl.game.DefaultGameInstance;
import org.jackhuang.hmcl.game.GameComponentAnalyzer;
import org.jackhuang.hmcl.game.GameComponentType;
import org.jackhuang.hmcl.modpack.ModAdviser;
import org.jackhuang.hmcl.modpack.Modpack;
import org.jackhuang.hmcl.modpack.ModpackExportInfo;
import org.jackhuang.hmcl.task.Task;
import org.jackhuang.hmcl.util.gson.JsonUtils;
import org.jackhuang.hmcl.util.io.Zipper;
import org.jackhuang.hmcl.util.versioning.GameVersionNumber;
import org.jetbrains.annotations.NotNullByDefault;
import java.io.IOException;
import java.io.StringWriter;
import java.nio.file.Files;
import java.nio.file.Path;
import java.util.ArrayList;
import java.util.List;
import java.util.Map;
import static org.jackhuang.hmcl.util.logging.Logger.LOG;
/// Exports one registered game instance as a MultiMC modpack archive.
@NotNullByDefault
public class MultiMCModpackExportTask extends Task<Void> {
/// The fixed instance snapshot exported by this task.
private final DefaultGameInstance instance;
/// The paths selected for inclusion in the archive.
private final List<String> whitelist;
/// The MultiMC instance configuration written to the archive.
private final MultiMCInstanceConfiguration configuration;
/// The archive written by this task.
private final Path output;
/// Creates a MultiMC modpack export task.
///
/// @param instance the registered instance snapshot to export
/// @param whitelist the paths selected for inclusion
/// @param configuration the MultiMC instance configuration
/// @param output the archive to write
public MultiMCModpackExportTask(DefaultGameInstance instance, List<String> whitelist, MultiMCInstanceConfiguration configuration, Path output) {
this.instance = instance;
this.whitelist = whitelist;
this.configuration = configuration;
this.output = output;
onDone().register(event -> {
if (event.isFailed()) {
try {
Files.deleteIfExists(output);
} catch (IOException e) {
LOG.warning("Failed to delete modpack file: " + output, e);
}
}
});
}
/// {@inheritDoc}
@Override
public void execute() throws Exception {
var instanceId = instance.getId();
ArrayList<String> blackList = new ArrayList<>(ModAdviser.MODPACK_BLACK_LIST);
blackList.add(instanceId + ".jar");
blackList.add(instanceId + ".json");
LOG.info("Compressing game files without some files in blacklist, including files or directories: usernamecache.json, asm, logs, backups, versions, assets, usercache.json, libraries, crash-reports, launcher_profiles.json, NVIDIA, TCNodeTracker");
try (Zipper zip = new Zipper(output)) {
zip.putDirectory(instance.getRunDirectory(), ".minecraft", path -> Modpack.acceptFile(path, blackList, whitelist));
GameVersionNumber version = instance.getVersion();
if (version == GameVersionNumber.unknown()) {
throw new IOException("Cannot parse the version of " + instanceId);
}
String gameVersion = version.toString();
GameComponentAnalyzer analyzer = instance.getAnalyzer();
List<MultiMCManifest.MultiMCManifestComponent> components = new ArrayList<>();
components.add(new MultiMCManifest.MultiMCManifestComponent(true, false, MultiMCComponents.getComponent(GameComponentType.GAME), gameVersion));
for (Map.Entry<String, GameComponentType> pair : MultiMCComponents.getPairs()) {
if (pair.getValue().isModLoader()) {
String componentVersion = analyzer.getVersion(pair.getValue());
if (componentVersion != null) {
components.add(new MultiMCManifest.MultiMCManifestComponent(false, false, pair.getKey(), componentVersion));
}
}
}
MultiMCManifest mmcPack = new MultiMCManifest(1, components);
zip.putTextFile(JsonUtils.GSON.toJson(mmcPack), "mmc-pack.json");
StringWriter writer = new StringWriter();
configuration.toProperties().store(writer, "Auto generated by Hello Minecraft! Launcher");
zip.putTextFile(writer.toString(), "instance.cfg");
zip.putTextFile("", ".packignore");
}
}
/// Export options supported by the MultiMC format.
public static final ModpackExportInfo.Options OPTION = new ModpackExportInfo.Options()
.requireAuthor()
.requireMinMemory();
}
@@ -128,6 +128,25 @@ public final class StringUtils {
return Character.toUpperCase(str.charAt(0)) + str.substring(1);
}
public static @Nullable String capitalizeWords(@Nullable String str) {
if (str == null || str.isEmpty())
return str;
String[] words = str.replace('-', ' ').replace('_', ' ').split(" ");
for (int i = 0; i < words.length; i++) {
words[i] = capitalizeFirst(words[i]);
}
return String.join(" ", words);
}
public static boolean containsDigit(String str) {
int l = str.length();
for (int i = 0; i < l; i++) {
char c = str.charAt(i);
if ('0' <= c && c <= '9') return true;
}
return false;
}
public static String substringBeforeLast(String str, char delimiter) {
return substringBeforeLast(str, delimiter, str);
}
@@ -618,11 +637,23 @@ public final class StringUtils {
return true;
}
public static boolean isAlphabetic(char ch) {
return ch >= 'a' && ch <= 'z' || ch >= 'A' && ch <= 'Z';
}
public static boolean isAlphabetic(String str) {
int length = str.length();
for (int i = 0; i < length; i++) {
if (!isAlphabetic(str.charAt(i))) return false;
}
return true;
}
public static boolean isAlphabeticOrNumber(String str) {
int length = str.length();
for (int i = 0; i < length; i++) {
char ch = str.charAt(i);
if (!(ch >= '0' && ch <= '9') && !(ch >= 'a' && ch <= 'z') && !(ch >= 'A' && ch <= 'Z'))
if (!(ch >= '0' && ch <= '9') && !isAlphabetic(ch))
return false;
}
return true;
@@ -19,16 +19,13 @@ package org.jackhuang.hmcl.util.io;
import kala.compress.archivers.zip.ZipArchiveEntry;
import kala.compress.archivers.zip.ZipArchiveReader;
import kala.compress.utils.BufferedDataInputSeekableChannel;
import org.jackhuang.hmcl.util.Lang;
import org.jackhuang.hmcl.util.platform.OperatingSystem;
import org.jackhuang.hmcl.util.tree.ZipFileTree;
import java.io.IOException;
import java.nio.ByteBuffer;
import java.nio.ByteOrder;
import java.nio.CharBuffer;
import java.nio.channels.SeekableByteChannel;
import java.nio.charset.*;
import java.nio.file.*;
import java.nio.file.spi.FileSystemProvider;
@@ -131,18 +128,6 @@ public final class CompressingUtils {
throw new IOException("Cannot find suitable encoding for the zip.");
}
private static BufferedDataInputSeekableChannel openBufferedChannel(Path zipFile) throws IOException {
SeekableByteChannel channel = Files.newByteChannel(zipFile);
try {
return new BufferedDataInputSeekableChannel(channel, 8192, ByteOrder.LITTLE_ENDIAN);
} catch (Throwable e) {
IOUtils.closeQuietly(channel, e);
throw e;
}
}
public static ZipFileTree openZipTree(Path zipFile) throws IOException {
return new ZipFileTree(openZipFile(zipFile));
}
@@ -152,14 +137,14 @@ public final class CompressingUtils {
}
public static ZipArchiveReader openZipFile(Path zipFile, Charset charset) throws IOException {
return new ZipArchiveReader(openBufferedChannel(zipFile), charset);
return new ZipArchiveReader(zipFile, charset, true, true);
}
public static ZipArchiveReader openZipFileWithPossibleEncoding(Path zipFile, Charset possibleEncoding) throws IOException {
if (possibleEncoding == null)
possibleEncoding = StandardCharsets.UTF_8;
ZipArchiveReader zipReader = new ZipArchiveReader(openBufferedChannel(zipFile));
ZipArchiveReader zipReader = new ZipArchiveReader(zipFile, possibleEncoding, true, true);
Charset suitableEncoding;
try {
@@ -176,7 +161,7 @@ public final class CompressingUtils {
}
zipReader.close();
return new ZipArchiveReader(openBufferedChannel(zipFile), suitableEncoding);
return new ZipArchiveReader(zipFile, suitableEncoding, true, true);
}
public static final class Builder {
@@ -0,0 +1,133 @@
/*
* 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.util.javafx;
import javafx.beans.property.ObjectProperty;
import org.jackhuang.hmcl.task.Schedulers;
import org.jetbrains.annotations.NotNull;
import org.jetbrains.annotations.Nullable;
import java.lang.ref.SoftReference;
import java.lang.ref.WeakReference;
import java.util.Objects;
import java.util.concurrent.CompletableFuture;
import java.util.function.Supplier;
/// Cache for a property of an item of [javafx.scene.control.ListCell].
///
/// @param <T> type of the property value
/// @param <B> type of the bean, aka. the item
public abstract class ItemPropertyAsyncCache<T, B> {
private final B bean;
public ItemPropertyAsyncCache(B bean) {
this.bean = Objects.requireNonNull(bean);
}
protected abstract @Nullable T getValue();
protected abstract @Nullable T getDefault();
/// @return the completable future that loads the value, or null if not set or already garbage-collected
@Nullable
protected abstract CompletableFuture<T> getFuture();
protected abstract void setFuture(@NotNull CompletableFuture<T> imageFuture);
public final void attachValue(ObjectProperty<T> property, @Nullable WeakReference<ObjectProperty<B>> current) {
CompletableFuture<T> future = getFuture();
if (future != null) {
T value = future.getNow(null);
if (value != null) {
property.set(value);
return;
}
} else {
future = CompletableFuture.supplyAsync(this::getValue, Schedulers.io());
setFuture(future);
}
property.set(getDefault());
future.thenAcceptAsync(image -> {
if (current != null) {
ObjectProperty<B> thisProperty = current.get();
if (thisProperty == null || thisProperty.get() != bean) {
// The current ListCell has already switched to another object
return;
}
}
property.set(image);
}, Schedulers.javafx());
}
///
/// @param <T> {@inheritDoc}
/// @param <B> {@inheritDoc}
private static abstract class Base<T, B> extends ItemPropertyAsyncCache<T, B> {
private final Supplier<T> valueSupplier, defaultSupplier;
///
/// @param bean the item of list cell
/// @param valueSupplier supplier of the value
/// @param defaultSupplier supplier of the placeholder value
public Base(B bean, Supplier<T> valueSupplier, @Nullable Supplier<T> defaultSupplier) {
super(bean);
this.valueSupplier = Objects.requireNonNull(valueSupplier);
this.defaultSupplier = Objects.requireNonNullElse(defaultSupplier, () -> null);
}
@Override
protected @Nullable T getValue() {
return valueSupplier.get();
}
@Override
protected @Nullable T getDefault() {
return defaultSupplier.get();
}
}
/// Implementation of [ItemPropertyAsyncCache], using a [SoftReference] to balance the cost of time and memory.
///
/// @param <T> {@inheritDoc}
/// @param <B> {@inheritDoc}
public static final class Soft<T, B> extends Base<T, B> {
private SoftReference<@Nullable CompletableFuture<T>> cache = null;
///
/// @param bean the item of list cell
/// @param valueSupplier supplier of the value
/// @param defaultSupplier supplier of the placeholder value
public Soft(B bean, Supplier<T> valueSupplier, @Nullable Supplier<T> defaultSupplier) {
super(bean, valueSupplier, defaultSupplier);
}
@Override
protected @Nullable CompletableFuture<T> getFuture() {
return cache != null ? cache.get() : null;
}
@Override
protected void setFuture(@NotNull CompletableFuture<T> future) {
this.cache = new SoftReference<>(future);
}
}
}
@@ -18,7 +18,7 @@
package org.jackhuang.hmcl.util.tree;
import kala.compress.archivers.ArchiveEntry;
import kala.compress.archivers.zip.ZipArchiveReader;
import org.jackhuang.hmcl.util.io.CompressingUtils;
import org.jetbrains.annotations.NotNull;
import org.jetbrains.annotations.Nullable;
import org.jetbrains.annotations.UnmodifiableView;
@@ -44,7 +44,7 @@ public abstract class ArchiveFileTree<R, E extends ArchiveEntry> implements Clos
String name = namePath.toString();
if (name.endsWith(".jar") || name.endsWith(".zip")) {
return new ZipFileTree(new ZipArchiveReader(file));
return CompressingUtils.openZipTree(file);
} else if (name.endsWith(".tar") || name.endsWith(".tar.gz") || name.endsWith(".tgz")) {
return TarFileTree.open(file);
} else {
@@ -53,7 +53,6 @@ public abstract class ArchiveFileTree<R, E extends ArchiveEntry> implements Clos
}
protected final R reader;
protected final Dir<E> root = new Dir<>("", "");
public ArchiveFileTree(R reader) {
this.reader = reader;
@@ -63,11 +62,10 @@ public abstract class ArchiveFileTree<R, E extends ArchiveEntry> implements Clos
return reader;
}
public Dir<E> getRoot() {
return root;
}
public abstract Dir<E> getRoot();
public @Nullable E getEntry(@NotNull String entryPath) {
Dir<E> root = getRoot();
Dir<E> dir = root;
if (entryPath.indexOf('/') < 0) {
return dir.getFiles().get(entryPath);
@@ -91,7 +89,7 @@ public abstract class ArchiveFileTree<R, E extends ArchiveEntry> implements Clos
}
public @Nullable Dir<E> getDirectory(@NotNull String dirPath) {
Dir<E> dir = root;
Dir<E> dir = getRoot();
if (dirPath.isEmpty()) {
return dir;
}
@@ -106,45 +104,66 @@ public abstract class ArchiveFileTree<R, E extends ArchiveEntry> implements Clos
return dir;
}
protected void addEntry(E entry) throws IOException {
String[] path = entry.getName().split("/");
List<String> pathList = Arrays.asList(path);
/// Adds an entry, creating missing parent directories.
/// Empty and `.` directory components are skipped. Entries with `..` directory
/// components, duplicate files, and file/directory conflicts are skipped with a warning.
/// Parent directories created before a skipped entry is detected remain in the tree.
///
/// @param entry the archive entry to add
protected static <E extends ArchiveEntry> void addEntry(Dir<E> root, @NotNull E entry) {
String name = entry.getName();
Dir<E> dir = root;
for (int i = 0, end = entry.isDirectory() ? path.length : path.length - 1; i < end; i++) {
String item = path[i];
if (item.equals("."))
int start = 0;
while (start < name.length()) {
int end = name.indexOf('/', start);
boolean isLastPart = end < 0 || end == name.length() - 1;
String item = end >= 0 ? name.substring(start, end) : name.substring(start);
// A final component may be skipped, so the cursor must still reach the end.
start = end < 0 ? name.length() : end + 1;
if (isLastPart && !entry.isDirectory()) {
if (dir.getSubDirs().containsKey(item)) {
LOG.warning("A file and a directory have the same name: " + name);
return;
}
if (dir.getFiles().containsKey(item)) {
LOG.warning("Duplicate entry: " + entry.getName());
return;
}
if (dir.files.isEmpty())
dir.files = new HashMap<>();
dir.files.put(item, entry);
break;
}
if (item.equals(".") || item.isEmpty())
continue;
if (item.equals("..") || item.isEmpty())
throw new IOException("Invalid entry: " + entry.getName());
if (dir.files.containsKey(item)) {
throw new IOException("A file and a directory have the same name: " + entry.getName());
if (item.equals("..")) {
LOG.warning("Invalid entry name: " + name);
return;
}
final int nameEnd = i + 1;
dir = dir.subDirs.computeIfAbsent(item, name ->
new Dir<>(name, String.join("/", pathList.subList(0, nameEnd))));
}
if (entry.isDirectory()) {
if (dir.entry == null)
dir.entry = entry;
else if (!dir.entry.isDirectory())
throw new IOException("A file and a directory have the same name: " + entry.getName());
} else {
String fileName = path[path.length - 1];
if (dir.subDirs.containsKey(fileName)) {
throw new IOException("A file and a directory have the same name: " + entry.getName());
if (dir.getFiles().containsKey(item)) {
LOG.warning("A file and a directory have the same name: " + name);
return;
}
if (dir.files.containsKey(fileName)) {
throw new IOException("Duplicate entry: " + entry.getName());
}
if (dir.subDirs.isEmpty())
dir.subDirs = new HashMap<>();
dir.files.put(fileName, entry);
dir = dir.subDirs.computeIfAbsent(item, Dir::new);
if (isLastPart) {
if (dir.entry == null)
dir.entry = entry;
else if (!dir.entry.isDirectory())
LOG.warning("A file and a directory have the same name: " + entry.getName());
break;
}
}
}
@@ -221,15 +240,13 @@ public abstract class ArchiveFileTree<R, E extends ArchiveEntry> implements Clos
public static final class Dir<E extends ArchiveEntry> {
private final String name;
private final String fullName;
private E entry;
final Map<String, Dir<E>> subDirs = new HashMap<>();
final Map<String, E> files = new HashMap<>();
Map<String, Dir<E>> subDirs = Map.of();
Map<String, E> files = Map.of();
public Dir(String name, String fullName) {
public Dir(String name) {
this.name = name;
this.fullName = fullName;
}
public boolean isRoot() {
@@ -240,11 +257,6 @@ public abstract class ArchiveFileTree<R, E extends ArchiveEntry> implements Clos
return name;
}
/// Get the normalized full path. Leading `/` and all `.` in the path will be removed.
public @NotNull String getFullName() {
return fullName;
}
public @Nullable E getEntry() {
return entry;
}
@@ -20,6 +20,7 @@ package org.jackhuang.hmcl.util.tree;
import kala.compress.archivers.tar.TarArchiveEntry;
import kala.compress.archivers.tar.TarArchiveReader;
import org.jetbrains.annotations.NotNull;
import org.jetbrains.annotations.Nullable;
import java.io.*;
import java.nio.file.Files;
@@ -61,31 +62,11 @@ public final class TarFileTree extends ArchiveFileTree<TarArchiveReader, TarArch
private final Path tempFile;
private final Thread shutdownHook;
private @Nullable Dir<TarArchiveEntry> root;
public TarFileTree(TarArchiveReader file, Path tempFile) throws IOException {
public TarFileTree(TarArchiveReader file, Path tempFile) {
super(file);
this.tempFile = tempFile;
try {
for (TarArchiveEntry entry : file.getEntries()) {
addEntry(entry);
}
} catch (Throwable e) {
try {
file.close();
} catch (Throwable e2) {
e.addSuppressed(e2);
}
if (tempFile != null) {
try {
Files.deleteIfExists(tempFile);
} catch (Throwable e2) {
e.addSuppressed(e2);
}
}
throw e;
}
if (tempFile != null) {
this.shutdownHook = new Thread(() -> {
@@ -99,6 +80,18 @@ public final class TarFileTree extends ArchiveFileTree<TarArchiveReader, TarArch
this.shutdownHook = null;
}
@Override
public Dir<TarArchiveEntry> getRoot() {
if (root == null) {
root = new Dir<>("");
for (TarArchiveEntry entry : reader.getEntries()) {
addEntry(root, entry);
}
}
return root;
}
@Override
protected void copyAttributes(@NotNull TarArchiveEntry source, @NotNull Path targetFile) throws IOException {
var fileAttributeView = Files.getFileAttributeView(targetFile, BasicFileAttributeView.class);
@@ -19,8 +19,8 @@ package org.jackhuang.hmcl.util.tree;
import kala.compress.archivers.zip.ZipArchiveEntry;
import kala.compress.archivers.zip.ZipArchiveReader;
import org.jackhuang.hmcl.util.io.IOUtils;
import org.jetbrains.annotations.NotNull;
import org.jetbrains.annotations.Nullable;
import java.io.IOException;
import java.io.InputStream;
@@ -37,23 +37,26 @@ import java.util.Set;
*/
public final class ZipFileTree extends ArchiveFileTree<ZipArchiveReader, ZipArchiveEntry> {
private final boolean closeReader;
private @Nullable Dir<ZipArchiveEntry> root;
public ZipFileTree(ZipArchiveReader file) throws IOException {
public ZipFileTree(ZipArchiveReader file) {
this(file, true);
}
public ZipFileTree(ZipArchiveReader file, boolean closeReader) throws IOException {
public ZipFileTree(ZipArchiveReader file, boolean closeReader) {
super(file);
this.closeReader = closeReader;
try {
for (ZipArchiveEntry zipArchiveEntry : file.getEntries()) {
addEntry(zipArchiveEntry);
}
@Override
public Dir<ZipArchiveEntry> getRoot() {
if (root == null) {
root = new Dir<>("");
for (ZipArchiveEntry zipArchiveEntry : reader.getEntries()) {
addEntry(root, zipArchiveEntry);
}
} catch (Throwable e) {
if (closeReader)
IOUtils.closeQuietly(file, e);
throw e;
}
return root;
}
@Override
@@ -103,6 +106,15 @@ public final class ZipFileTree extends ArchiveFileTree<ZipArchiveReader, ZipArch
}
}
@Override
public @Nullable ZipArchiveEntry getEntry(@NotNull String entryPath) {
ZipArchiveEntry entry = reader.getEntry(entryPath);
if (entry != null)
return entry;
return super.getEntry(entryPath);
}
@Override
public InputStream getInputStream(ZipArchiveEntry entry) throws IOException {
return getReader().getInputStream(entry);
@@ -933,4 +933,20 @@
26.2-pre-6
26.2-rc-1
26.2-rc-2
26.2
26.2
26.3-snapshot-1
26.3-snapshot-2
26.3-snapshot-3
26.3-snapshot-4
26.3-snapshot-5
26.3-snapshot-6
26.3-snapshot-7
26.3-snapshot-8
26.3-snapshot-9
26.3-snapshot-10
26.3-pre-1
26.3-pre-2
26.3-pre-3
26.3-rc-1
26.3-rc-2
26.3
@@ -0,0 +1,176 @@
/*
* 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.download;
import org.jackhuang.hmcl.game.*;
import org.jackhuang.hmcl.task.Task;
import org.jackhuang.hmcl.task.TaskExecutor;
import org.jackhuang.hmcl.task.TaskListener;
import org.jetbrains.annotations.NotNullByDefault;
import org.jetbrains.annotations.Nullable;
import org.junit.jupiter.api.Test;
import org.junit.jupiter.api.io.TempDir;
import java.io.IOException;
import java.nio.file.Path;
import java.util.concurrent.CountDownLatch;
import java.util.concurrent.TimeUnit;
import java.util.concurrent.atomic.AtomicBoolean;
import java.util.concurrent.atomic.AtomicReference;
import static org.junit.jupiter.api.Assertions.*;
/// Verifies that cancelled builds retain exclusivity only until their cleanup completes.
@NotNullByDefault
public final class DefaultGameBuilderCancellationTest {
/// Explicit cleanup after an early cancellation releases a draft skipped by the task chain.
@Test
public void testAbortAfterCancelBeforeBuildStarts(@TempDir Path directory) throws Exception {
verifyCancellation(directory, false);
}
/// Cancellation waits for active component work before releasing the draft.
@Test
public void testAbortAfterCancelDuringComponentInstallation(@TempDir Path directory) throws Exception {
verifyCancellation(directory, true);
}
/// Runs an installation with a gate at the chosen cancellation point.
private static void verifyCancellation(Path directory, boolean duringInstallation) throws Exception {
TestRepository repository = new TestRepository(directory);
CountDownLatch ready = new CountDownLatch(1);
CountDownLatch release = new CountDownLatch(1);
CountDownLatch stopped = new CountDownLatch(1);
AtomicBoolean componentStarted = new AtomicBoolean();
TestDependencyManager manager = new TestDependencyManager(
repository, ready, release, componentStarted);
AtomicReference<@Nullable IOException> cleanupFailure = new AtomicReference<>();
DefaultGameBuilder builder = manager.newGameBuilder(new GameInstanceID("first"));
Task<?> task;
try (builder) {
builder.component(GameComponentType.GAME, "1.21.1");
task = builder.buildAsync();
}
TaskExecutor executor = task.executor(new TaskListener() {
/// Holds the outer stage wrapper before its cleanup task can be scheduled.
@Override
public void onReady(Task<?> readyTask) {
if (!duringInstallation && readyTask == task) {
ready.countDown();
await(release);
}
}
/// Releases the draft only after the executor stops, as the installation dialog does.
@Override
public void onStop(boolean success, TaskExecutor completedExecutor) {
try {
builder.abort();
builder.abort();
} catch (IOException exception) {
cleanupFailure.set(exception);
} finally {
stopped.countDown();
}
}
});
executor.start();
try {
await(ready);
executor.cancel();
assertThrows(IllegalStateException.class, repository::openDraft);
assertEquals(1L, stopped.getCount());
} finally {
release.countDown();
}
await(stopped);
assertNull(cleanupFailure.get());
assertEquals(duringInstallation, componentStarted.get());
assertFalse(repository.hasInstance(new GameInstanceID("first")));
try (DefaultGameBuilder ignored = manager.newGameBuilder(new GameInstanceID("second"))) {
assertThrows(IllegalStateException.class, repository::openDraft);
}
}
/// Waits for a deterministic test gate and fails instead of hanging indefinitely.
private static void await(CountDownLatch latch) {
try {
assertTrue(latch.await(10, TimeUnit.SECONDS), "Task lifecycle timed out");
} catch (InterruptedException exception) {
Thread.currentThread().interrupt();
throw new AssertionError(exception);
}
}
/// Provides an empty repository for builds that never publish an instance.
@NotNullByDefault
private static final class TestRepository extends DefaultGameRepository {
/// Creates a repository rooted at the test directory.
private TestRepository(Path directory) {
super(directory);
}
/// {@inheritDoc}
@Override
protected DefaultGameRepositoryLayout createLayout(Path directory) {
return new DefaultGameRepositoryLayout(directory);
}
/// Rejects publication because every test cancels before an instance is installed.
@Override
protected DefaultGameInstance createInstance(DefaultGameRepositorySnapshot snapshot,
GameInstanceID id, GameInstanceManifest manifest, @Nullable Path manifestFile) {
throw new AssertionError("Cancelled installation must not publish an instance");
}
}
/// Replaces network installation with a controlled local task.
@NotNullByDefault
private static final class TestDependencyManager extends DefaultDependencyManager {
/// Signals when component installation begins.
private final CountDownLatch ready;
/// Allows component installation to return after cancellation.
private final CountDownLatch release;
/// Records whether component installation ran.
private final AtomicBoolean componentStarted;
/// Creates a manager with an isolated cache and no remote requests.
private TestDependencyManager(TestRepository repository, CountDownLatch ready,
CountDownLatch release, AtomicBoolean componentStarted) {
super(repository, new MojangDownloadProvider(),
new DefaultCacheRepository(repository.getBaseDirectory().resolve("cache")));
this.ready = ready;
this.release = release;
this.componentStarted = componentStarted;
}
/// Returns a task that waits for cancellation before reporting a local installation failure.
@Override
Task<GameInstanceManifest> installUnpublishedComponentAsync(GameInstanceManifest manifest,
Path modsDirectory, String gameVersion, GameComponentType componentType, String version) {
return Task.supplyAsync(() -> {
componentStarted.set(true);
ready.countDown();
await(release);
throw new IOException("Simulated component installation failure");
});
}
}
}
@@ -17,17 +17,29 @@
*/
package org.jackhuang.hmcl.game;
import org.jackhuang.hmcl.download.DefaultCacheRepository;
import org.jackhuang.hmcl.download.DefaultDependencyManager;
import org.jackhuang.hmcl.download.MojangDownloadProvider;
import org.jackhuang.hmcl.download.game.GameDownloadTask;
import org.jackhuang.hmcl.task.Task;
import org.jackhuang.hmcl.util.DigestUtils;
import org.jackhuang.hmcl.util.gson.JsonUtils;
import org.jackhuang.hmcl.util.io.UrlResponseInfo;
import org.jetbrains.annotations.NotNullByDefault;
import org.jetbrains.annotations.Nullable;
import org.junit.jupiter.api.Test;
import org.junit.jupiter.api.io.TempDir;
import org.junit.jupiter.params.ParameterizedTest;
import org.junit.jupiter.params.provider.ValueSource;
import java.io.IOException;
import java.net.URI;
import java.net.http.HttpHeaders;
import java.nio.file.FileAlreadyExistsException;
import java.nio.file.Files;
import java.nio.file.Path;
import java.util.List;
import java.util.Map;
import static org.junit.jupiter.api.Assertions.assertEquals;
import static org.junit.jupiter.api.Assertions.assertFalse;
@@ -277,18 +289,211 @@ public final class DefaultGameRepositoryDraftTest {
assertEquals(GameRepositoryDraft.State.FAILED, draft.getState());
}
/// Runs an asynchronous update using the published instance as immutable context.
/// A manifest-only update preserves an existing client JAR.
@Test
public void testUpdateInstanceAsyncCommitsWorkingManifest(@TempDir Path tempDirectory) throws Exception {
TestRepository repository = new TestRepository(tempDirectory);
GameInstanceID id = new GameInstanceID("instance");
repository.save(new GameInstanceManifest(id).withMainClass("original.Main"));
Path target = repository.getLayout().getInstanceJarFile(id);
Files.writeString(target, "custom client");
Task<?> update = repository.updateInstanceAsync(id, workingInstance -> Task.supplyAsync(() ->
Task<?> update = createDependencyManager(repository).updateInstanceAsync(id, workingInstance -> Task.supplyAsync(() ->
workingInstance.getManifest().withMainClass("updated.Main")));
assertTrue(update.executor().test());
assertEquals("updated.Main", repository.getInstance(id).getManifest().mainClass());
assertEquals("custom client", Files.readString(target));
}
/// A version change replaces an existing client JAR with the file selected by the new manifest.
@Test
public void testUpdateInstanceAsyncReplacesClientJar(@TempDir Path tempDirectory) throws Exception {
TestRepository repository = new TestRepository(tempDirectory.resolve("game"));
GameInstanceID id = new GameInstanceID("instance");
GameInstanceManifest original = new GameInstanceManifest(id).withMainClass("original.Main");
repository.save(original);
Path target = repository.getLayout().getInstanceJarFile(id);
Files.writeString(target, "old client");
Path source = tempDirectory.resolve("new-client.jar");
Files.writeString(source, "new client");
String sha1 = DigestUtils.digestToString("SHA-1", source);
DefaultCacheRepository cache = new DefaultCacheRepository(tempDirectory.resolve("cache"));
Path cached = cache.cacheFile(source, "SHA-1", sha1);
DefaultDependencyManager manager = new DefaultDependencyManager(
repository, new MojangDownloadProvider(), cache);
GameInstanceManifest replacement = original.withDownloads(Map.of(DownloadType.CLIENT,
new DownloadInfo("https://example.invalid/client.jar", sha1)));
Task<?> update = manager.updateInstanceAsync(id, instance ->
new GameDownloadTask(manager, replacement).thenApplyAsync(jar -> {
assertEquals("old client", Files.readString(target));
assertEquals(original, repository.getInstance(id).getManifest());
return replacement;
}));
assertTrue(update.executor().test());
assertEquals(replacement, repository.getInstance(id).getManifest());
assertTrue(replacement.getDownloadInfo().validateChecksum(target, false));
assertEquals("new client", Files.readString(cached));
}
/// Equivalent checksums preserve a customized client even when the download URL changes.
@Test
public void testUpdateInstanceAsyncPreservesClientWithSameChecksum(@TempDir Path tempDirectory) throws Exception {
TestRepository repository = new TestRepository(tempDirectory);
GameInstanceID id = new GameInstanceID("instance");
GameInstanceManifest original = new GameInstanceManifest(id).withDownloads(Map.of(DownloadType.CLIENT,
new DownloadInfo("https://example.invalid/old.jar", "a".repeat(40))));
repository.save(original);
Path target = repository.getLayout().getInstanceJarFile(id);
Files.writeString(target, "custom client");
GameInstanceManifest replacement = original.withDownloads(Map.of(DownloadType.CLIENT,
new DownloadInfo("https://example.invalid/new.jar", "A".repeat(40))));
assertTrue(createDependencyManager(repository).updateInstanceAsync(id,
instance -> Task.completed(replacement)).executor().test());
assertEquals(replacement, repository.getInstance(id).getManifest());
assertEquals("custom client", Files.readString(target));
}
/// A changed URL selects a replacement when neither client download declares a checksum.
@Test
public void testUpdateInstanceAsyncReplacesClientWithoutChecksum(@TempDir Path tempDirectory) throws Exception {
TestRepository repository = new TestRepository(tempDirectory);
GameInstanceID id = new GameInstanceID("instance");
GameInstanceManifest original = new GameInstanceManifest(id).withDownloads(Map.of(DownloadType.CLIENT,
new DownloadInfo("https://example.invalid/old.jar")));
repository.save(original);
Path target = repository.getLayout().getInstanceJarFile(id);
Files.writeString(target, "old client");
String newUrl = "https://example.invalid/new.jar";
DefaultDependencyManager manager = createDependencyManager(repository);
manager.getCacheRepository().cacheText(new UrlResponseInfo(200, URI.create(newUrl),
HttpHeaders.of(Map.of("etag", List.of("new-client"),
"cache-control", List.of("max-age=3600")), (name, value) -> true)), "new client");
GameInstanceManifest replacement = original.withDownloads(Map.of(DownloadType.CLIENT, new DownloadInfo(newUrl)));
assertTrue(manager.updateInstanceAsync(id, instance -> Task.completed(replacement)).executor().test());
assertEquals(replacement, repository.getInstance(id).getManifest());
assertEquals("new client", Files.readString(target));
}
/// Client changes supplied only by patches are resolved before choosing the replacement JAR.
@Test
public void testUpdateInstanceAsyncResolvesClientPatch(@TempDir Path tempDirectory) throws Exception {
TestRepository repository = new TestRepository(tempDirectory);
GameInstanceID id = new GameInstanceID("instance");
GameInstanceManifest original = new GameInstanceManifest(id);
repository.save(original);
Path target = repository.getLayout().getInstanceJarFile(id);
Files.writeString(target, "old client");
Path source = tempDirectory.resolve("new-client.jar");
Files.writeString(source, "new client");
String sha1 = DigestUtils.digestToString("SHA-1", source);
DefaultDependencyManager manager = createDependencyManager(repository);
manager.getCacheRepository().cacheFile(source, "SHA-1", sha1);
GameInstanceManifest replacement = original.withPatches(List.of(GameInstancePatch.fromManifest(
original.withDownloads(Map.of(DownloadType.CLIENT,
new DownloadInfo("https://example.invalid/client.jar", sha1))),
GameComponentType.GAME.getPatchId(), "new-version", GameInstancePatch.PRIORITY_MC)));
assertTrue(manager.updateInstanceAsync(id, instance -> Task.completed(replacement)).executor().test());
assertEquals(replacement, repository.getInstance(id).getManifest());
assertEquals("new client", Files.readString(target));
}
/// Switching JAR ownership materializes an owned client but never replaces a referenced client.
@ParameterizedTest
@ValueSource(booleans = {false, true})
public void testUpdateInstanceAsyncSwitchesJarOwnership(boolean useOwnJar, @TempDir Path tempDirectory) throws Exception {
TestRepository repository = new TestRepository(tempDirectory);
GameInstanceID id = new GameInstanceID("instance");
GameInstanceID sharedId = new GameInstanceID("shared");
repository.save(new GameInstanceManifest(sharedId));
Path sharedJar = repository.getLayout().getInstanceJarFile(sharedId);
Files.writeString(sharedJar, "shared client");
String sha1 = DigestUtils.digestToString("SHA-1", sharedJar);
DownloadInfo download = new DownloadInfo("https://example.invalid/client.jar", sha1);
GameInstanceManifest original = new GameInstanceManifest(id)
.withJar(useOwnJar ? sharedId : id)
.withDownloads(useOwnJar ? Map.of(DownloadType.CLIENT, download) : null);
repository.save(original);
Path target = repository.getLayout().getInstanceJarFile(id);
Files.writeString(target, "custom client");
DefaultDependencyManager manager = createDependencyManager(repository);
manager.getCacheRepository().cacheFile(sharedJar, "SHA-1", sha1);
GameInstanceManifest replacement = original.withJar(useOwnJar ? id : sharedId)
.withDownloads(Map.of(DownloadType.CLIENT, download));
assertTrue(manager.updateInstanceAsync(id, instance -> Task.completed(replacement)).executor().test());
assertEquals(useOwnJar ? "shared client" : "custom client", Files.readString(target));
assertEquals("shared client", Files.readString(sharedJar));
assertEquals(useOwnJar ? target : sharedJar, repository.getInstance(id).getInstanceJarFile());
}
/// A failed JAR lookup leaves both the old manifest and its client JAR intact.
@Test
public void testUpdateInstanceAsyncPreservesFilesWhenJarTaskFails(@TempDir Path tempDirectory) throws Exception {
TestRepository repository = new TestRepository(tempDirectory);
GameInstanceID id = new GameInstanceID("instance");
GameInstanceManifest original = new GameInstanceManifest(id).withMainClass("original.Main");
repository.save(original);
Path manifestFile = repository.getLayout().getInstanceJson(id);
String originalJson = Files.readString(manifestFile);
Path target = repository.getLayout().getInstanceJarFile(id);
Files.writeString(target, "original");
GameInstanceManifest replacement = original.withDownloads(Map.of(DownloadType.CLIENT,
new DownloadInfo("file:///missing-client.jar", "0".repeat(40))));
Task<?> update = createDependencyManager(repository).updateInstanceAsync(id,
instance -> Task.completed(replacement));
assertFalse(update.executor().test());
assertEquals(original, repository.getInstance(id).getManifest());
assertEquals(originalJson, Files.readString(manifestFile));
assertEquals("original", Files.readString(target));
try (DefaultGameRepositoryDraft draft = repository.openDraft()) {
assertTrue(draft.isOpen());
}
}
/// Publication failure rolls back both files after an asynchronous update stages a new JAR.
@Test
public void testUpdateInstanceAsyncRollsBackManifestAndJar(@TempDir Path tempDirectory) throws Exception {
FailingRepository repository = new FailingRepository(tempDirectory.resolve("game"));
GameInstanceID id = new GameInstanceID("instance");
GameInstanceManifest original = new GameInstanceManifest(id).withMainClass("original.Main");
repository.save(original);
Path manifestFile = repository.getLayout().getInstanceJson(id);
String originalJson = Files.readString(manifestFile);
Path target = repository.getLayout().getInstanceJarFile(id);
Files.writeString(target, "original");
Path source = tempDirectory.resolve("replacement.jar");
Files.writeString(source, "replacement");
repository.failDraftPublish = true;
DefaultDependencyManager manager = createDependencyManager(repository);
String sha1 = DigestUtils.digestToString("SHA-1", source);
Path cached = manager.getCacheRepository().cacheFile(source, "SHA-1", sha1);
GameInstanceManifest replacement = original.withMainClass("updated.Main")
.withDownloads(Map.of(DownloadType.CLIENT,
new DownloadInfo("https://example.invalid/client.jar", sha1)));
Task<?> update = manager.updateInstanceAsync(id, instance -> Task.completed(replacement));
assertFalse(update.executor().test());
assertEquals(original, repository.getInstance(id).getManifest());
assertEquals(originalJson, Files.readString(manifestFile));
assertEquals("original", Files.readString(target));
assertEquals("replacement", Files.readString(source));
assertEquals("replacement", Files.readString(cached));
try (DefaultGameRepositoryDraft draft = repository.openDraft()) {
assertTrue(draft.isOpen());
}
}
/// Rejects an asynchronous update that attempts to create a different instance id.
@@ -299,7 +504,7 @@ public final class DefaultGameRepositoryDraftTest {
GameInstanceID otherId = new GameInstanceID("other");
repository.save(new GameInstanceManifest(id).withMainClass("original.Main"));
Task<?> update = repository.updateInstanceAsync(id, workingInstance ->
Task<?> update = createDependencyManager(repository).updateInstanceAsync(id, workingInstance ->
Task.supplyAsync(() -> workingInstance.getManifest().withId(otherId)));
assertFalse(update.executor().test());
@@ -316,7 +521,7 @@ public final class DefaultGameRepositoryDraftTest {
TestRepository repository = new TestRepository(tempDirectory);
GameInstanceID id = new GameInstanceID("missing");
Task<?> update = repository.updateInstanceAsync(id, workingInstance ->
Task<?> update = createDependencyManager(repository).updateInstanceAsync(id, workingInstance ->
Task.completed(workingInstance.getManifest()));
assertFalse(update.executor().test());
@@ -332,7 +537,7 @@ public final class DefaultGameRepositoryDraftTest {
GameInstanceID id = new GameInstanceID("instance");
repository.save(new GameInstanceManifest(id));
Task<?> update = repository.updateInstanceAsync(id, workingInstance -> {
Task<?> update = createDependencyManager(repository).updateInstanceAsync(id, workingInstance -> {
throw new IOException("Simulated updater failure");
});
assertFalse(update.executor().test());
@@ -342,6 +547,12 @@ public final class DefaultGameRepositoryDraftTest {
}
}
/// Creates a dependency manager with a cache isolated inside the test repository.
private static DefaultDependencyManager createDependencyManager(TestRepository repository) {
return new DefaultDependencyManager(repository, new MojangDownloadProvider(),
new DefaultCacheRepository(repository.getBaseDirectory().resolve("cache")));
}
/// Minimal repository implementation for draft tests.
@NotNullByDefault
private static class TestRepository extends DefaultGameRepository {
@@ -0,0 +1,132 @@
/*
* 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.util.tree;
import kala.compress.archivers.tar.TarArchiveEntry;
import kala.compress.archivers.tar.TarArchiveOutputStream;
import kala.compress.archivers.tar.TarArchiveReader;
import kala.compress.archivers.tar.TarConstants;
import org.jetbrains.annotations.NotNullByDefault;
import org.junit.jupiter.api.Test;
import org.junit.jupiter.api.io.TempDir;
import org.junit.jupiter.params.ParameterizedTest;
import org.junit.jupiter.params.provider.ValueSource;
import java.io.IOException;
import java.nio.file.Files;
import java.nio.file.Path;
import java.time.Duration;
import static org.junit.jupiter.api.Assertions.*;
/// Verifies archive path traversal and handling of skipped entries.
@NotNullByDefault
public final class ArchiveFileTreeTest {
/// Creates an empty TAR tree whose entries can be added directly by each test.
private static TarFileTree openTree(Path directory) throws IOException {
Path archive = directory.resolve("test.tar");
try (var output = new TarArchiveOutputStream(Files.newOutputStream(archive))) {
output.finish();
}
return new TarFileTree(new TarArchiveReader(archive), null);
}
/// Completes traversal when the final directory component is a dot, with or without a slash.
@ParameterizedTest
@ValueSource(strings = {".", "./", "a/.", "a/./"})
public void testDotDirectoryTerminates(String name, @TempDir Path directory) throws IOException {
try (var tree = openTree(directory)) {
// A TAR directory flag does not require its name to end in a slash.
var entry = new TarArchiveEntry(name, TarConstants.LF_DIR);
assertTimeoutPreemptively(Duration.ofSeconds(2), () -> ArchiveFileTree.addEntry(tree.getRoot(), entry));
assertTrue(tree.getRoot().getFiles().isEmpty());
if (name.startsWith("a/")) {
assertEquals(1, tree.getRoot().getSubDirs().size());
assertNotNull(tree.getDirectory("a"));
} else {
assertTrue(tree.getRoot().getSubDirs().isEmpty());
}
}
}
/// Preserves lookup of files beneath dot and empty directory components.
@Test
public void testNormalizedFilePath(@TempDir Path directory) throws IOException {
try (var tree = openTree(directory)) {
var entry = new TarArchiveEntry("./a//./file.txt");
ArchiveFileTree.addEntry(tree.getRoot(), entry);
assertSame(entry, tree.getEntry("a/file.txt"));
assertTrue(tree.getRoot().getFiles().isEmpty());
}
}
/// Skips the whole entry when a parent component is a file, retaining the existing file.
@ParameterizedTest
@ValueSource(strings = {"a/", "a/file.txt"})
public void testFileConflictSkipsEntry(String name, @TempDir Path directory) throws IOException {
try (var tree = openTree(directory)) {
var existing = new TarArchiveEntry("a");
ArchiveFileTree.addEntry(tree.getRoot(), existing);
ArchiveFileTree.addEntry(tree.getRoot(), new TarArchiveEntry(name));
assertSame(existing, tree.getEntry("a"));
assertEquals(1, tree.getRoot().getFiles().size());
assertTrue(tree.getRoot().getSubDirs().isEmpty());
}
}
/// Preserves explicit and implicit directories when a file has the same name.
@ParameterizedTest
@ValueSource(strings = {"a/", "a/file.txt"})
public void testDirectoryConflictSkipsFile(String name, @TempDir Path directory) throws IOException {
try (var tree = openTree(directory)) {
ArchiveFileTree.addEntry(tree.getRoot(), new TarArchiveEntry(name));
ArchiveFileTree.addEntry(tree.getRoot(), new TarArchiveEntry("a"));
assertNotNull(tree.getDirectory("a"));
assertTrue(tree.getRoot().getFiles().isEmpty());
if (name.endsWith("file.txt"))
assertNotNull(tree.getEntry("a/file.txt"));
}
}
/// Keeps the first file entry when another file has the same path.
@Test
public void testDuplicateFileIsSkipped(@TempDir Path directory) throws IOException {
try (var tree = openTree(directory)) {
var existing = new TarArchiveEntry("file.txt");
ArchiveFileTree.addEntry(tree.getRoot(), existing);
ArchiveFileTree.addEntry(tree.getRoot(), new TarArchiveEntry("file.txt"));
assertSame(existing, tree.getEntry("file.txt"));
assertEquals(1, tree.getRoot().getFiles().size());
}
}
/// Skips entries containing parent directory components without remapping their files.
@ParameterizedTest
@ValueSource(strings = {"../file.txt", "a/../file.txt"})
public void testParentDirectorySkipsEntry(String name, @TempDir Path directory) throws IOException {
try (var tree = openTree(directory)) {
ArchiveFileTree.addEntry(tree.getRoot(), new TarArchiveEntry(name));
assertNull(tree.getEntry("file.txt"));
assertNull(tree.getEntry("a/file.txt"));
var valid = new TarArchiveEntry("valid.txt");
ArchiveFileTree.addEntry(tree.getRoot(), valid);
assertSame(valid, tree.getEntry("valid.txt"));
}
}
}
+8
View File
@@ -8,11 +8,15 @@ repositories {
}
dependencies {
implementation(libs.jetbrains.annotations)
implementation(libs.gson)
implementation(libs.jna)
implementation(libs.kala.compress.tar)
implementation(libs.kala.compress.ar)
implementation(libs.weburl)
testImplementation(libs.junit.jupiter)
testRuntimeOnly("org.junit.platform:junit-platform-launcher")
}
java {
@@ -24,6 +28,10 @@ tasks.withType<JavaCompile> {
options.encoding = "UTF-8"
}
tasks.test {
useJUnitPlatform()
}
tasks.processResources {
into("org/jackhuang/hmcl/gradle/l10n") {
from(projectDir.resolve("../HMCLCore/src/main/resources/assets/lang/"))
@@ -39,7 +39,7 @@ public enum DocumentLocale {
return "uʍoᗡ ǝpᴉsd∩";
}
},
SIMPLIFIED_CHINESE(Locale.forLanguageTag("zh-Hans"), "zh"),
SIMPLIFIED_CHINESE("zh-Hans"),
TRADITIONAL_CHINESE("zh-Hant") {
@Override
public List<DocumentLocale> getCandidates() {
@@ -38,7 +38,7 @@ import java.util.regex.Pattern;
///
/// ```
/// <!-- #BEGIN LANGUAGE_SWITCHER -->
/// **English** | 中文 ([简体](FOO_zh.md), [繁體](FOO_zh_Hant.md)) | [日本語](FOO_ja.md)
/// **English** | 中文 ([简体](FOO_zh_Hans.md), [繁體](FOO_zh_Hant.md)) | [日本語](FOO_ja.md)
/// <!-- #END LANGUAGE_SWITCHER -->
/// ```
///
@@ -74,21 +74,7 @@ public abstract class CreateLanguageList extends DefaultTask {
locales.add(Locale.ENGLISH);
else if (fileName.charAt(baseName.length()) == '_') {
String localeName = fileName.substring(baseName.length() + 1, fileName.length() - suffix.length());
// TODO: Delete this if the I18N file naming is changed
if (baseName.equals("I18N")) {
if (localeName.equals("zh"))
locales.add(Locale.forLanguageTag("zh-Hant"));
else if (localeName.equals("zh_CN"))
locales.add(Locale.forLanguageTag("zh-Hans"));
else
locales.add(Locale.forLanguageTag(localeName.replace('_', '-')));
} else {
if (localeName.equals("zh"))
locales.add(Locale.forLanguageTag("zh-Hans"));
else
locales.add(Locale.forLanguageTag(localeName.replace('_', '-')));
}
locales.add(Locale.forLanguageTag(localeName.replace('_', '-')));
}
}
}
@@ -48,8 +48,6 @@ public abstract class CreateLocaleNamesResourceBundle extends DefaultTask {
private static String mapToFileName(String base, String ext, Locale locale) {
if (locale.equals(Locale.ENGLISH))
return base + "." + ext;
else if (locale.toLanguageTag().equals("zh-Hans"))
return base + "_zh." + ext;
else
return base + "_" + locale.toLanguageTag().replace('-', '_') + "." + ext;
}
@@ -0,0 +1,246 @@
/*
* 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.gradle.l10n;
import org.gradle.api.DefaultTask;
import org.gradle.api.GradleException;
import org.gradle.api.file.ConfigurableFileCollection;
import org.gradle.api.file.RegularFileProperty;
import org.gradle.api.tasks.InputFile;
import org.gradle.api.tasks.InputFiles;
import org.gradle.api.tasks.TaskAction;
import org.gradle.api.tasks.UntrackedTask;
import org.jetbrains.annotations.NotNullByDefault;
import org.jetbrains.annotations.Nullable;
import org.jetbrains.annotations.Unmodifiable;
import java.io.IOException;
import java.io.StringReader;
import java.nio.file.Files;
import java.nio.file.Path;
import java.util.ArrayList;
import java.util.HashMap;
import java.util.HashSet;
import java.util.LinkedHashMap;
import java.util.List;
import java.util.Properties;
/// Synchronizes translation files in place with the keys and blank lines of a reference file.
///
/// Existing values, escapes, and continuation lines are retained. Missing keys become
/// `# key=` comments, and obsolete entries are removed. Each translation retains its
/// header; subsequent comments move with the following key, and trailing comments remain
/// at the end. Comments from the reference file are not copied. Output uses UTF-8 and LF.
@NotNullByDefault
@UntrackedTask(because = "Updates translation source files in place")
public abstract class SyncTranslations extends DefaultTask {
/// Returns the UTF-8 reference file that defines the keys and spacing between entries.
@InputFile
public abstract RegularFileProperty getSourceFile();
/// Returns the UTF-8 translation files to rewrite; the reference file must not be included.
@InputFiles
public abstract ConfigurableFileCollection getTranslationFiles();
/// Reads and validates all inputs, then writes only files whose contents have changed.
///
/// @throws IOException if an input cannot be read or an output cannot be written;
/// previously written files are not rolled back
/// @throws GradleException if the reference has duplicate keys or is also a translation
/// @throws IllegalArgumentException if an input contains a malformed Unicode escape
@TaskAction
public void run() throws IOException {
Path source = getSourceFile().get().getAsFile().toPath();
Document reference = parse(Files.readString(source));
var updates = new LinkedHashMap<Path, String>();
for (var file : getTranslationFiles().getFiles()) {
Path target = file.toPath();
if (Files.isSameFile(source, target)) {
throw new GradleException("The reference file must not be included in translationFiles: " + target);
}
String original = Files.readString(target);
String updated = synchronize(reference, parse(original));
if (!updated.equals(original)) {
updates.put(target, updated);
}
}
for (var update : updates.entrySet()) {
Files.writeString(update.getKey(), update.getValue());
getLogger().lifecycle("Synchronized {}", update.getKey().getFileName());
}
}
/// Returns a translation arranged by the reference, preserving the last active value
/// for duplicate translation keys, as [Properties] does.
///
/// @throws GradleException if the reference contains duplicate keys
static String synchronize(Document reference, Document translation) {
var values = new HashMap<String, String>();
var comments = new HashMap<String, String>();
var pendingComments = new StringBuilder();
for (Entry entry : translation.entries()) {
if (entry.key() != null) {
if (!isComment(entry.text())) {
values.put(entry.key(), entry.text());
}
comments.merge(entry.key(), pendingComments.toString(), String::concat);
pendingComments.setLength(0);
} else if (isComment(entry.text())) {
pendingComments.append(entry.text());
}
}
var result = new StringBuilder(translation.header());
var keys = new HashSet<String>();
for (Entry entry : reference.entries()) {
@Nullable String key = entry.key();
if (key == null) {
if (!isComment(entry.text())) {
result.append(entry.text());
}
continue;
}
if (!keys.add(key)) {
throw new GradleException("Duplicate reference key: " + key);
}
result.append(comments.getOrDefault(key, ""));
result.append(values.getOrDefault(key, "# " + escapeKey(key) + "=\n"));
}
return result.append(pendingComments).toString();
}
/// Parses physical lines into entries without re-encoding property values. Canonical
/// `# key=` placeholders delimit the header just like active entries.
///
/// @throws IOException if the properties reader fails
/// @throws IllegalArgumentException if a property contains a malformed Unicode escape
static Document parse(String content) throws IOException {
@Unmodifiable List<String> lines = content.lines().toList();
var header = new StringBuilder();
var entries = new ArrayList<Entry>();
boolean inHeader = true;
for (int i = 0; i < lines.size(); i++) {
String line = lines.get(i);
var text = new StringBuilder(line).append('\n');
@Nullable String key = null;
if (isComment(line)) {
String stripped = stripPropertyWhitespace(line).stripTrailing();
if (stripped.startsWith("# ") && stripped.endsWith("=")) {
Properties placeholder = new Properties();
try {
placeholder.load(new StringReader(stripped.substring(2)));
if (placeholder.size() == 1) {
String candidate = placeholder.stringPropertyNames().iterator().next();
if (stripped.equals("# " + escapeKey(candidate) + "=")) {
key = candidate;
}
}
} catch (IllegalArgumentException ignored) {
// Ordinary comments do not have to contain valid property escapes.
}
}
} else if (!stripPropertyWhitespace(line).isEmpty()) {
// Only an odd number of trailing backslashes continues a property.
while (continuesLine(line)) {
if (++i == lines.size()) {
// Terminate an EOF continuation before moving this entry elsewhere.
text.append('\n');
break;
}
line = lines.get(i);
text.append(line).append('\n');
}
Properties property = new Properties();
property.load(new StringReader(text.toString()));
key = property.stringPropertyNames().iterator().next();
}
if (key != null) {
inHeader = false;
}
if (inHeader) {
header.append(text);
} else {
entries.add(new Entry(key, text.toString()));
}
}
return new Document(header.toString(), List.copyOf(entries));
}
/// Returns whether the first non-whitespace character starts a properties comment.
private static boolean isComment(String text) {
String stripped = stripPropertyWhitespace(text);
return stripped.startsWith("#") || stripped.startsWith("!");
}
/// Removes only the leading whitespace recognized by [Properties#load(java.io.Reader)].
private static String stripPropertyWhitespace(String text) {
int offset = 0;
while (offset < text.length()) {
char ch = text.charAt(offset);
if (ch != ' ' && ch != '\t' && ch != '\f') {
break;
}
offset++;
}
return text.substring(offset);
}
/// Returns whether a physical line ends with an unescaped backslash.
private static boolean continuesLine(String line) {
int backslashes = 0;
for (int i = line.length() - 1; i >= 0 && line.charAt(i) == '\\'; i--) {
backslashes++;
}
return backslashes % 2 != 0;
}
/// Escapes a decoded key so that removing the placeholder's `# ` prefix yields
/// a valid property with the original key and an empty value.
private static String escapeKey(String key) {
var result = new StringBuilder();
for (int i = 0; i < key.length(); i++) {
char ch = key.charAt(i);
switch (ch) {
case '\t' -> result.append("\\t");
case '\n' -> result.append("\\n");
case '\r' -> result.append("\\r");
case '\f' -> result.append("\\f");
case '\\', ' ', '=', ':', '#', '!' -> result.append('\\').append(ch);
default -> result.append(ch);
}
}
return result.toString();
}
/// Stores an entry's decoded key and its original text with LF line endings.
///
/// @param key the decoded key, or `null` for an ordinary comment or blank line
/// @param text the complete entry, including continuation lines and its final newline
@NotNullByDefault
record Entry(@Nullable String key, String text) {
}
/// Stores the leading header and an immutable sequence of entries.
///
/// @param header all lines before the first active entry or canonical placeholder
/// @param entries the remaining entries in file order
@NotNullByDefault
record Document(String header, @Unmodifiable List<Entry> entries) {
}
}
@@ -1,6 +1,6 @@
#
# Hello Minecraft! Launcher
# Copyright (C) 2025 huangyuhui <[email protected]> and contributors
# Copyright (C) 2026 huangyuhui <[email protected]> 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
@@ -18,3 +18,6 @@
# Languages
lzh=文言
# Scripts
Qabs=顛倒
@@ -0,0 +1,118 @@
/*
* 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.gradle.l10n;
import org.jetbrains.annotations.NotNullByDefault;
import org.junit.jupiter.api.Test;
import java.io.IOException;
import java.io.StringReader;
import java.util.Properties;
import static org.junit.jupiter.api.Assertions.*;
/// Verifies layout synchronization and preservation of properties parsing semantics.
@NotNullByDefault
class SyncTranslationsTest {
/// Checks ordering, consecutive blank lines, obsolete keys, and untranslated entries.
@Test
void synchronizesKeysAndBlankLines() throws IOException {
String source = "first=First\n\n\nsecond=Second\nthird=Third\n\n";
String translation = "third=Three\nobsolete=Old\n\nfirst=One\n";
assertEquals("first=One\n\n\n# second=\nthird=Three\n\n", sync(source, translation));
}
/// Retains the translator's header and moves comments with the following key.
@Test
void preservesTranslationComments() throws IOException {
String source = "# Reference author\n\nfirst=First\n\n# Reference note\nsecond=Second\n";
String translation = "# Translation author\n\nsecond=Two\n# First note\nfirst=One\n! Final note\n";
assertEquals("# Translation author\n\n# First note\nfirst=One\n\nsecond=Two\n! Final note\n",
sync(source, translation));
}
/// Preserves continuation lines, escaped keys, separators, Unicode, and empty values.
@Test
void preservesPropertySyntaxAndValues() throws IOException {
String source = "escaped\\ key=Source\npath=Path\nempty=Empty\nunicode=Unicode\n";
String translation = "unicode=\\u00e9\nempty=\npath:C:\\\\temp\\\\\n"
+ "escaped\\ key : caf\u00e9\\n\\\n # continued text\\\n and more\n";
String result = sync(source, translation);
assertEquals(load(translation), load(result));
assertTrue(result.startsWith("escaped\\ key : caf\u00e9\\n\\\n # continued text\\\n and more\n"));
assertTrue(result.contains("path:C:\\\\temp\\\\\nempty=\nunicode=\\u00e9\n"));
}
/// Keeps leading placeholders out of the header and removes obsolete placeholders.
@Test
void synchronizesPlaceholdersIdempotently() throws IOException {
String source = "first=First\n\nsecond=Second\n";
String translation = "# Author\n\n# obsolete=\n# second= \t\n";
String result = sync(source, translation);
assertEquals("# Author\n\n# first=\n\n# second=\n", result);
assertEquals(result, sync(source, result));
assertTrue(load(result).isEmpty());
}
/// Generates placeholders whose uncommented keys decode to the reference keys.
@Test
void escapesPlaceholderKeys() throws IOException {
String source = "escaped\\ key\\:\\=\\\\\\#\\!\\t\\n=value\n=Empty key\n";
String result = sync(source, "");
assertEquals(load(source).stringPropertyNames(), load(result.replace("# ", "")).stringPropertyNames());
assertEquals(result, sync(source, result));
}
/// Uses the last active duplicate value even when a placeholder follows it.
@Test
void handlesDuplicateKeys() throws IOException {
assertEquals("key=Last\n", sync("key=Reference\n", "key=First\nkey=Last\n# key=\n"));
assertThrows(org.gradle.api.GradleException.class, () -> sync("key=A\nkey=B\n", "key=C\n"));
}
/// Terminates a continuation at EOF so that a reordered entry cannot consume the next key.
@Test
void terminatesContinuationAtEndOfFile() throws IOException {
String source = "first=First\nsecond=Second\n";
String translation = "second=Two\nfirst=One\\";
String result = sync(source, translation);
assertEquals(load(translation), load(result));
assertEquals(result, sync(source, result));
}
/// Normalizes CRLF and handles files with no terminating newline or no entries.
@Test
void handlesLineEndingsAndEmptyFiles() throws IOException {
assertEquals("first=One\n\n# second=\n", sync("first=A\r\n\r\nsecond=B", "first=One"));
assertEquals("", sync("", "obsolete=Old\n"));
assertEquals("# first=\n", sync("first=First\n", ""));
}
/// Synchronizes two in-memory files through the production parser.
private static String sync(String source, String translation) throws IOException {
return SyncTranslations.synchronize(SyncTranslations.parse(source), SyncTranslations.parse(translation));
}
/// Loads the effective properties for comparison independently of layout.
private static Properties load(String content) throws IOException {
Properties result = new Properties();
result.load(new StringReader(content));
return result;
}
}
+1 -1
View File
@@ -1,7 +1,7 @@
# Contributing Guide
<!-- #BEGIN LANGUAGE_SWITCHER -->
**English** | 中文 ([简体](Contributing_zh.md), [繁體](Contributing_zh_Hant.md))
**English** | 中文 ([简体](Contributing_zh_Hans.md), [繁體](Contributing_zh_Hant.md))
<!-- #END LANGUAGE_SWITCHER -->
## Build HMCL
Loaded 100 of 120 files, more files were not shown because too many files have changed in this diff. Show more