新增服务器管理界面以及适配 26.4 带参数的服务器地址 by CaaMoe · Pull Request #4962 · HMCL-dev/HMCL

CaaMoe · 2025-12-10T05:18:28Z

新增服务器管理界面，并适配 26.4 带参数的服务器地址

close #5246

概述

在实例页面新增「服务器管理」标签页，用于查看和编辑实例的 servers.dat：

实时显示服务器的状态和延迟。
一键启动游戏并直接连接服务器。
支持把服务器拖进启动器窗口来添加。

同时支持 26.4-snapshot-1 引入的带参数服务器地址（[id@]host[:port][?key=value...]）。这也修复了快速游玩「多人游戏」填写带参数的地址后不生效的问题。

burningtnt · 2025-12-10T14:12:05Z

不要使用 ImageIO 来加载图片。请参阅 FXUtils 以查看图片替代方案

3gf8jv4dv · 2025-12-11T07:55:39Z

图标可以考虑下这个：

3gf8jv4dv · 2025-12-11T12:02:26Z

假如有多个实例的「版本隔离」为「默认」，且 .minecraft 目录下有 servers.dat文件。

这时候切到另一个实例的「服务器管理」列表，勾选「显示全部」，会显示多个重复的条目。

这种情况是否需要解决？

CaaMoe · 2025-12-11T13:18:53Z

假如有多个实例的「版本隔离」为「默认」，且 .minecraft 目录下有 servers.dat文件。

这时候切到另一个实例的「服务器管理」列表，勾选「显示全部」，会显示多个重复的条目。

这种情况是否需要解决？

这看起来的确是个问题, 已经整改好了, 确保他们不会重复读取和显示。

3gf8jv4dv · 2025-12-11T16:35:26Z

我看了一下。建议：

对于当前实例会使用的条目，标签显示为「当前实例」或类似内容。
这样，对于有大量实例用户，可以快速区分。
说实话， server.tag.public 这个文本语义不明。
类似于第一条。如果能显示会使用它的实例，那么会更明了。

以下是我的设想：

当 .minecraft\servers.dat 存在时：
- A 实例「版本隔离」为「各版本独立」，附带 servers.dat
- B 实例「版本隔离」为「默认」
- C 实例「版本隔离」为「各版本独立」，附带 servers.dat
- D 实例「版本隔离」为「默认」
这时在 C 实例的「服务器管理」页，勾选「显示所有」：
- A 实例附带的 servers.dat 内条目，标签显示为「Name-A」
- B、D 实例会使用的 .minecraft\servers.dat 内条目，标签不是含糊的「默认」，而是清晰显示「Name-B」「Name-D」两个标签
- C 实例附带的 servers.dat 内条目，标签显示为「当前实例」
如果进入 B 实例的「服务器管理」页，勾选「显示所有」：
- A 实例附带的 servers.dat 内条目，标签显示为「Name-A」
- B、D 实例会使用的 .minecraft\servers.dat 内条目，标签显示为「当前实例」和「Name-D」
- C 实例附带的 servers.dat 内条目，标签显示为「Name-C」

CaaMoe · 2025-12-12T02:30:10Z

我看了一下。建议：

对于当前实例会使用的条目，标签显示为「当前实例」或类似内容。
这样，对于有大量实例用户，可以快速区分。

说实话， server.tag.public 这个文本语义不明。
类似于第一条。如果能显示会使用它的实例，那么会更明了。
以下是我的设想：
当 .minecraft\servers.dat 存在时：

A 实例「版本隔离」为「各版本独立」，附带 servers.dat

B 实例「版本隔离」为「默认」

C 实例「版本隔离」为「各版本独立」，附带 servers.dat

D 实例「版本隔离」为「默认」

这时在 C 实例的「服务器管理」页，勾选「显示所有」：

A 实例附带的 servers.dat 内条目，标签显示为「Name-A」

B、D 实例会使用的 .minecraft\servers.dat 内条目，标签不是含糊的「默认」，而是清晰显示「Name-B」「Name-D」两个标签

C 实例附带的 servers.dat 内条目，标签显示为「当前实例」

如果进入 B 实例的「服务器管理」页，勾选「显示所有」：

A 实例附带的 servers.dat 内条目，标签显示为「Name-A」

B、D 实例会使用的 .minecraft\servers.dat 内条目，标签显示为「当前实例」和「Name-D」

C 实例附带的 servers.dat 内条目，标签显示为「Name-C」

我根据你的描述重新设计了holder, 这是效果:

3gf8jv4dv

图标可以改一下。暂时没其他意见。

CaaMoe · 2026-01-31T13:09:52Z

图标可以改一下。暂时没其他意见。

图标还能改成啥样呢，没找到有更好康的

Calboot · 2026-02-01T08:46:00Z

图标还能改成啥样呢，没找到有更好康的

可以直接尝试获取对应服务器的图标？

3gf8jv4dv · 2026-02-01T08:53:24Z

图标还能改成啥样呢，没找到有更好康的

这个 #4962 (comment)

ToobLac · 2026-09-20T13:01:08Z

还有动静吗

CaaMoe · 2026-09-20T18:32:30Z

未同步的改动太多了，我重新调整了一份，相比较于之前的改动添加了方便快速启动并且连接到指定服务器的功能

# Conflicts: # HMCL/src/main/java/org/jackhuang/hmcl/ui/instances/GameInstancePage.java

Glavo

本审查建议由 GPT-6 Astra 生成

已将具体审查建议标注在对应代码行。

github-actions

🤖 Static analysis found the following issues (max count 10):

zkitefly reviewed Dec 10, 2025

View reviewed changes

Comment thread HMCL/src/main/java/org/jackhuang/hmcl/ui/versions/server/ServerListPage.java Outdated

CaaMoe requested a review from zkitefly December 10, 2025 05:30

Mine-diamond reviewed Dec 10, 2025

View reviewed changes

Comment thread HMCL/src/main/java/org/jackhuang/hmcl/ui/SVG.java Outdated

Comment thread HMCL/src/main/java/org/jackhuang/hmcl/ui/versions/server/ServerListItem.java Outdated

CaaMoe requested a review from Mine-diamond December 10, 2025 07:46

Mine-diamond reviewed Dec 10, 2025

View reviewed changes

Comment thread HMCL/src/main/java/org/jackhuang/hmcl/ui/SVG.java Outdated

Mine-diamond reviewed Dec 10, 2025

View reviewed changes

Comment thread HMCL/src/main/java/org/jackhuang/hmcl/ui/SVG.java Outdated

CiiLu reviewed Dec 10, 2025

View reviewed changes

Comment thread HMCL/src/main/java/org/jackhuang/hmcl/ui/versions/server/ServerData.java Outdated

CaaMoe requested a review from CiiLu December 11, 2025 02:46

3gf8jv4dv suggested changes Dec 11, 2025

View reviewed changes

3gf8jv4dv reviewed Dec 11, 2025

View reviewed changes

Comment thread HMCL/src/main/resources/assets/lang/I18N_zh.properties Outdated

CaaMoe requested a review from 3gf8jv4dv December 11, 2025 08:31

Mine-diamond mentioned this pull request Jan 16, 2026

[Feature] 添加服务器管理功能 #5246

Open

3gf8jv4dv reviewed Jan 23, 2026

View reviewed changes

Comment thread HMCL/src/main/resources/assets/lang/I18N_zh.properties Outdated

github-actions Bot added the 500+ label Jul 17, 2026

重写服务器管理界面

5eee4b4

CaaMoe force-pushed the main branch from ea0b889 to 5eee4b4 Compare September 20, 2026 18:27

CaaMoe added 3 commits September 21, 2026 20:50

还原distributionUrl, 更改服务器管理tab图标

008f783

添加服务器添加界面

3a3cbc0

add server status check

f347fe6

CaaMoe added 9 commits October 11, 2026 20:07

添加 MinecraftChatComponentUtilsTest

8ba89e4

提取ServerStorage

efe1c67

删除IconedServer

1d17f26

修复 supportQueryArgServerAddress 方法报错导致游戏无法启动的问题

878b127

修复文件读写上面存在的一些问题

d2fafe0

merge

b9fcbe0

# Conflicts: # HMCL/src/main/java/org/jackhuang/hmcl/ui/instances/GameInstancePage.java

修复文件读写上面存在的一些问题

9fcfaaa

将服务器管理入口移到底部管理弹出菜单内

42f20f8

Update ServerListPage

8fbe02e

ToobLac reviewed Oct 11, 2026

View reviewed changes

Comment thread HMCLCore/src/main/java/org/jackhuang/hmcl/game/World.java Outdated

CaaMoe added 3 commits October 11, 2026 23:25

版本判断抄错了

7ab9649

修复当打开的是实例管理页内的非服务器管理tab时, 拖拽添加服务器会失效的问题

3f8c700

修复如果在更新图标的过程中改变了服务器ip的话，此图标会被应用在编辑后的服务器里

a3040a4

Glavo reviewed Oct 12, 2026

View reviewed changes

CaaMoe added 5 commits October 12, 2026 21:45

修复EditPane在等待服务器查询时提前取消强制关闭Dialog后，查询成功后依然会保存用户已经取消的修改

178f95f

修复状态弹窗操作了错误的游戏实例

7d47013

修复原域名解析失败会跳过 SRV 查询

3a2658d

细节方面问题修复

c90d6ac

修复保存图标会覆盖游戏中的服务器列表更新

7e60540

github-actions Bot reviewed Oct 12, 2026

View reviewed changes

Comment thread HMCL/src/main/java/org/jackhuang/hmcl/ui/instances/server/ServerListPage.java Outdated

CaaMoe added 6 commits October 13, 2026 00:47

update ServerListPage

d064fc0

确保强制覆盖能还原用户的所有操作

6ce184b

不保留覆盖功能

209b405

消除可能存在的竞态问题

dc245cf

包名错了

a2c7726

加固editServerPane对cancel的判断

58fa76d

CaaMoe requested a review from Glavo October 12, 2026 18:19

CaaMoe added 3 commits October 15, 2026 16:18

Merge

e3e89bc

使用ToobLac的Subscription

53e9408

Merge

cded67c

Conversation

CaaMoe commented Dec 10, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

新增服务器管理界面，并适配 26.4 带参数的服务器地址

概述

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

burningtnt commented Dec 10, 2025

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

3gf8jv4dv commented Dec 11, 2025

Uh oh!

Uh oh!

3gf8jv4dv commented Dec 11, 2025

Uh oh!

CaaMoe commented Dec 11, 2025

Uh oh!

3gf8jv4dv commented Dec 11, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

CaaMoe commented Dec 12, 2025

Uh oh!

3gf8jv4dv left a comment • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

CaaMoe commented Jan 31, 2026

Uh oh!

Calboot commented Feb 1, 2026

Uh oh!

3gf8jv4dv commented Feb 1, 2026

Uh oh!

ToobLac commented Sep 20, 2026

Uh oh!

CaaMoe commented Sep 20, 2026

Uh oh!

Uh oh!

Glavo left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

github-actions Bot left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

This branch has not been deployed

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

9 participants

CaaMoe commented Dec 10, 2025 •

edited

Loading

3gf8jv4dv commented Dec 11, 2025 •

edited

Loading

3gf8jv4dv left a comment •

edited

Loading