常见问题

排查顺序建议从上往下走：先确认启动器本身能起来，再确认能登录，最后才是游戏和联机。

双击没有反应 / 打不开

1. 先确认装了 Java。开一个命令行（PowerShell 或 cmd），执行 java -version。 如果提示「不是内部或外部命令」，说明没装 Java 或者没配 PATH。
2. 版本要对：本启动器需要 Java 21，最低 Java 17。 用 java -version 输出的第一行确认主版本号。 装新版本不会破坏旧版本，可以两个都留着。
3. 用命令行启动，这样能看到报错：把下面这条命令里的文件名换成你实际下载到的那个：

   java -jar HEU-Launcher-<版本>.jar

   版本号会随每次发布变化（写这份文档时是 1.0.3）。文件名和版本号在下载页上都有，照抄即可。 把窗口里的报错原样保留下来，提问时会用到。
4. 如果日志里出现 UnsupportedClassVersionError，那就是 Java 版本太低了，换 Java 21。

启动器提示更新，但更新总是失败

自动更新要下载约 22 MB 的文件。校园网、代理或杀毒软件都可能把它掐断。失败时启动器会给出一个链接， 指向下载页；在那里手动下载同一个文件，覆盖掉原来的 jar 即可 —— 下载页上的 SHA-1 和更新通道发布的是同一份文件，所以手动装的和你自动更新装的是同样的东西。

更新失败不会损坏现有的启动器：新文件要先通过 SHA-1 校验和来源标记检查， 通过了才会替换旧文件。

社区页面打不开 / 一片空白

社区页用的是内嵌的 Chromium（JCEF），第一次打开时需要下载约 150 MB 的原生库。

• 第一次打开会慢，进度会显示在页面上；下完之后就不再重复下载。
• 如果卡在下载不动，先确认能访问 h5.heumc.kuocai.cn（用浏览器打开看一下）。
• 下载失败时启动器会自动改用 Maven Central 的源重试。

登录不上 / 绑不上正版账号

• 社区统一登录（Logto）走的是 auth.spforum.cc，请确认这个域名能访问。
• 微软正版登录需要能访问微软的登录页面；这一步是微软自己在管，本站不经手你的微软密码。
• 如果提示「未配置客户端 ID」，说明这个构建没带微软应用 ID —— 正常发布的构建都带， 请到下载页重新下载一份。

联机连不上

• 联机大厅的房间由本站的服务端中转，需要能访问 heumc.api.kuocai.cn。
• 用校园网时，某些端口可能被防火墙拦掉。换个网络（比如手机热点）试一次，就能区分是网络问题还是服务问题。
• 房间列表为空不一定是故障 —— 可能只是现在没有人在开房。

提问时需要附上什么

没有这些信息，别人只能猜：

• 启动器的版本号（主界面或日志开头都有）。
• 操作系统版本、Java 版本（java -version 的完整输出）。
• 日志文件。不要截图或拍照 —— 日志在启动器目录下的 .heumc/logs/ 里，直接把文件发出来。
• 你做了什么、期望发生什么、实际发生了什么。

去哪问：见获取帮助与反馈。