[Enhancement] 原理图管理优化 by Calboot · Pull Request #5366 · HMCL-dev/HMCL

Calboot · 2026-01-30T15:18:06Z

可能会做:

forgematica 识别

Resolves #4052 Resolves #4518 Resolves #3957

#3597 应在本 pr 和 #5095 均合并后再关闭

3gf8jv4dv · 2026-02-01T08:56:01Z

路径前面可以加个文本，例如 Location: schematics/directory/...

Calboot · 2026-02-01T09:01:10Z

路径前面可以加个文本，例如 Location: schematics/directory/...

其实我是想做成文件管理器那种形式，一般是没有提示语的

我给路径末尾加个/来提示这是路径

3gf8jv4dv · 2026-02-01T09:01:58Z

其实我是想做成文件管理器那种形式，一般是没有提示语的

我给路径末尾加个/来提示这是路径

👌

3gf8jv4dv · 2026-02-02T08:25:03Z

对于 1.16.5 及以上的 LexForge/NeoForge 实例，是否可以引导用户安装 Forgematica 而不是上游。

Calboot · 2026-02-02T08:26:21Z

对于 1.16.5 及以上的 LexForge/NeoForge 实例，是否可以引导用户安装 Forgematica 而不是上游。

在做

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

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

Copilot

Pull request overview

This pull request enhances the schematic management functionality in HMCL with comprehensive improvements including:

Purpose: Modernize and expand schematic file support, add custom directory configuration, improve UI/UX with better navigation and warnings, and integrate NBT viewing capabilities.

Changes:

Added support for multiple schematic formats (Litematic, NBT Structure, Schem/Schematic) beyond just Litematic files
Implemented custom Litematica directory detection from configuration files
Redesigned SchematicsPage UI with breadcrumb navigation, back button, warning messages for missing/disabled mods, and NBT viewer integration
Refactored code to use a common Schematic base class with format-specific implementations

Reviewed changes

Copilot reviewed 28 out of 31 changed files in this pull request and generated 20 comments.

Show a summary per file

File	Description
Vec3i.java	New record class for 3D integer vectors replacing JavaFX Point3D
SchematicType.java	Enum for schematic file type detection by extension
Schematic.java	Abstract base class for all schematic formats with common functionality
LitematicFile.java	Refactored to extend Schematic base class
SchemFile.java	New class supporting Schematica and Sponge Schem formats
NBTStructureFile.java	New class for vanilla NBT structure files
LitematicaConfig.java	Configuration model for reading Litematica custom directory settings
DefaultGameRepository.java	Added logic to read custom schematic directory from Litematica config
ModManager.java	Extracted supported loaders logic to be reusable
ModAdviser.java	Moved schematics from hidden to suggested list for modpack exports
SchematicsPage.java	Major UI refactoring with navigation improvements and warning system
NBTFileType.java	Added schematic file extensions to NBT file type support
I18N properties	Added localization strings for new UI elements across all languages
SchematicTest.java	Comprehensive tests for all schematic format loading

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

HMCLCore/src/main/java/org/jackhuang/hmcl/schematic/SchematicType.java

HMCLCore/src/main/java/org/jackhuang/hmcl/schematic/NBTStructureFile.java

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

HMCLCore/src/main/java/org/jackhuang/hmcl/util/Vec3i.java

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

HMCLCore/src/main/java/org/jackhuang/hmcl/schematic/NBTStructureFile.java

HMCLCore/src/main/java/org/jackhuang/hmcl/schematic/Schematic.java

# Conflicts: # HMCL/src/main/resources/assets/lang/I18N.properties # HMCL/src/main/resources/assets/lang/I18N_ar.properties # HMCL/src/main/resources/assets/lang/I18N_es.properties # HMCL/src/main/resources/assets/lang/I18N_ru.properties # HMCL/src/main/resources/assets/lang/I18N_uk.properties # HMCL/src/main/resources/assets/lang/I18N_zh.properties # HMCL/src/main/resources/assets/lang/I18N_zh_CN.properties

Calboot · 2026-02-06T07:30:28Z

@3gf8jv4dv 为啥要把非完全支持语言的schematics.create_directory schematics.add 都删了啊
schematics.add.title 也没完全添加上去

3gf8jv4dv · 2026-02-06T07:34:47Z

@3gf8jv4dv 为啥要把非完全支持语言的schematics.create_directory schematics.add 都删了啊
schematics.add.title 也没完全添加上去

因为当时考虑到英文的译文改了，删了的意思是希望重新翻译。

schematics.add.title 是新文本，当时只给简繁英加了。
「没完全添加」是说文言吗？没想好怎么翻合适。

Calboot · 2026-02-06T07:36:13Z

因为当时考虑到英文的译文改了，删了的意思是希望重新翻译。

schematics.add.title 是新文本，当时只给简繁英加了。「没完全添加」是说文言吗？没想好怎么翻合适。

哦哦哦，got it

Copilot

Pull request overview

Copilot reviewed 29 out of 32 changed files in this pull request and generated 4 comments.

Comments suppressed due to low confidence (1)

HMCLCore/src/main/java/org/jackhuang/hmcl/mod/ModManager.java:212

updateSupportedLoaders() is called before scanning the mods directory. The logic inside it depends on hasMod("kilt"...) / hasMod("connectormod"...), which won’t work until after addModInfo(...) populates localMods. This can make supportedLoaders incomplete/incorrect.

Consider calling updateSupportedLoaders() after mods have been loaded (or call it twice: once for analyzer-only loader inference, then again after mod metadata is parsed).

    public void refreshMods() throws IOException {
        localModFiles.clear();
        localMods.clear();

        var resolved = getRepository().getResolvedPreservingPatchesVersion(id);
        gameVersion = repository.getGameVersion(resolved).orElse(null);
        analyzer = LibraryAnalyzer.analyze(resolved, gameVersion);

        updateSupportedLoaders();

        boolean supportSubfolders = analyzer.has(LibraryAnalyzer.LibraryType.FORGE)
                || analyzer.has(LibraryAnalyzer.LibraryType.QUILT);

        if (Files.isDirectory(getModsDirectory())) {
            try (DirectoryStream<Path> modsDirectoryStream = Files.newDirectoryStream(getModsDirectory())) {
                for (Path subitem : modsDirectoryStream) {
                    if (supportSubfolders && Files.isDirectory(subitem) && !".connector".equalsIgnoreCase(subitem.getFileName().toString())) {
                        try (DirectoryStream<Path> subitemDirectoryStream = Files.newDirectoryStream(subitem)) {
                            for (Path subsubitem : subitemDirectoryStream) {
                                addModInfo(subsubitem);
                            }
                        }
                    } else {
                        addModInfo(subitem);
                    }
                }
            }
        }
        loaded = true;
    }

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

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

Glavo · 2026-02-08T13:26:16Z

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

+                        && GameVersionNumber.asGameVersion(Optional.ofNullable(modManager.getGameVersion())).isAtLeast("1.16.4", "20w45a");
+                if (litematica == null && !shouldUseForgematica) {
+                    try {
+                        litematica = ModrinthRemoteModRepository.MODS.getModById("litematica");


不要在默认线程池中执行网络操作。

而且我觉得这样做可能不太必要，我觉得如果没有检测到用户安装相关模组的话直接隐藏掉这个标签页可能更合适。

而且我觉得这样做可能不太必要，我觉得如果没有检测到用户安装相关模组的话直接隐藏掉这个标签页可能更合适。

那万一识别错了或者人家只是暂时不想装不就炸了吗，直接用不了。现在如果出错起码还能用

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

HMCLCore/src/main/java/org/jackhuang/hmcl/util/Vec3i.java

Calboot added 7 commits January 30, 2026 23:15

延迟加载深层目录中的原理图

08ee37b

异步加载

b87a6d0

update

3c2e3ba

Fix rippler

27e1371

接入 NBTEditorPage

cc43366

添加返回按钮

e8af74f

update

95f20c3

Calboot marked this pull request as ready for review February 1, 2026 04:58

Calboot changed the title ~~[Feature] 原理图管理优化~~ [Enhancement] 原理图管理优化 Feb 1, 2026

Calboot added 6 commits February 1, 2026 17:27

update

d7d7f01

update

cdcb8ac

fix refresh

485d6ec

update

aecd81d

Resolves HMCL-dev#4052

512641a

update

145d439

Calboot marked this pull request as draft February 1, 2026 12:08

Calboot mentioned this pull request Feb 1, 2026

feat: 强化NBT编辑器功能，添加编辑功能 #5095

Draft

10 tasks

Calboot added 7 commits February 1, 2026 22:04

Resolves HMCL-dev#3957 (需要进一步测试)

959c94d

Fix text

5ae71b7

update

c9c902b

更新测试

8e589e5

支持 *.schem

abd6862

update

3a30647

添加投影提示

6733a58

3gf8jv4dv reviewed Feb 2, 2026

View reviewed changes

HMCL/src/main/resources/assets/lang/I18N_zh_CN.properties Outdated Show resolved Hide resolved

HMCL/src/main/resources/assets/lang/I18N_zh.properties Outdated Show resolved Hide resolved

Glavo requested a review from Copilot February 5, 2026 06:15

Copilot started reviewing on behalf of Glavo February 5, 2026 06:16 View session

Copilot AI reviewed Feb 5, 2026

View reviewed changes

Calboot added 10 commits February 6, 2026 11:17

License header

ef2911f

update

0df85d2

update

dcfb5d0

update

287b762

update

9a1a8bd

update

477e372

update

b1adbf2

update

de07a28

update

fadde6e

Calboot added 2 commits February 6, 2026 16:32

update

a942a20

Merge branch 'main' into litematica

7bc5168

Calboot mentioned this pull request Feb 7, 2026

[Feature] 原理图管理优化以及增加预览等功能 #4002

Open

Calboot added 2 commits February 8, 2026 12:32

Merge branch 'HMCL-dev:main' into litematica

b2149a5

update

f8a96ee

Glavo requested a review from Copilot February 8, 2026 13:18

Copilot started reviewing on behalf of Glavo February 8, 2026 13:18 View session

Copilot AI reviewed Feb 8, 2026

View reviewed changes

Glavo reviewed Feb 8, 2026

View reviewed changes

Calboot added 4 commits February 8, 2026 21:51

rename

212c912

update

6c59daf

update

39d54ea

Apply AI suggestions

a3b9a87

Minecraft269 mentioned this pull request Feb 12, 2026

[Bug] 当游戏因为方块错误而崩溃时，启动器会出现过期的域名 #5519

Closed

Conversation

Calboot commented Jan 30, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

3gf8jv4dv commented Feb 1, 2026

Uh oh!

Calboot commented Feb 1, 2026

Uh oh!

3gf8jv4dv commented Feb 1, 2026

Uh oh!

3gf8jv4dv commented Feb 2, 2026

Uh oh!

Calboot commented Feb 2, 2026

Uh oh!

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Reviewed changes

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Calboot commented Feb 6, 2026

Uh oh!

3gf8jv4dv commented Feb 6, 2026

Uh oh!

Calboot commented Feb 6, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Glavo Feb 8, 2026

Choose a reason for hiding this comment

Uh oh!

Calboot Feb 8, 2026

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

Calboot commented Jan 30, 2026 •

edited

Loading

Calboot commented Feb 6, 2026 •

edited

Loading