常见问题

杂项

关于本项目

本项目 Arcaea-Server 是手机游戏 Arcaea 的简易服务端代码仓库，不涉及客户端破解或魔改相关内容。

TODO...

如有必要该如何提交问题

可以通过任何能让我看到的方式，但请提供完整而充足的信息：错误信息、网络数据包详情、设备信息、服务端与客户端版本、您到底干了什么操作才能这样……

顺便，在此之前您应该看一眼 Issues 和 Discussions 去确保您的问题没重复，也应该试试使用搜索引擎或者 GPT 能否解决您的问题。

客户端

如何魔改？

请在各类搜索引擎中进行资料检索，以及请到处看看 GitHub 上的别的仓库。目前互联网上的公开信息已经完全足够个人自行修改客户端来连接本地服务端了。小小的提示：客户端在 3.6.0 版本发生过重大安全更新，如果没有太多经验，可以先改改旧版试试。当然，高版本与低版本的修改方法天差地别。

闪退

提示

你可以很容易判断闪退问题的原因主要是客户端还是服务端。若闪退时服务端没有收到网络请求，则原因非常可能是客户端。当然，这并不是绝对的。

闪退是魔改出错、不到位的常见后果，也有可能是服务端数据问题。请先进行判断，一步一步锁定源头。

• 启动时闪退
  • 请检查游戏数据文件，特别是歌曲数据和三个特殊文件。注意客户端文件 Hash 检查。
  • 若使用热更新，请检查相关数据文件，注意不得缺少三个特殊文件。
• 登录时闪退
  • 很可能是服务端数据错误，过多、过少、两边不匹配都有可能导致闪退。
• 进入选曲界面闪退
  • 基本是客户端问题，请注意硬编码歌曲和曲包。
  • 可能是缺少默认播放曲目的问题，可以尝试使用主界面右下角进入选曲界面。
• 开始游玩时闪退
  • 可能是谱面文件问题，或者是歌曲文件格式问题。
• 结算界面闪退
  • 很大可能是硬编码歌曲和曲包导致的。
• 某些搭档闪退
  • 这是缺少相关硬编码曲包导致的。
• 全曲下载闪退
  • 一般是服务端提供的数据过多导致的。
• 课题模式、世界模式闪退
  • 服务端提供的数据客户端解析失败，通常是数据不匹配。

上述列举皆为常见情况，另外，魔改错误可能会导致各种奇怪闪退，请仔细检查。

网络连接问题

这个问题根据你所使用的连接方式而可能有不同的原因，但无论如何，第一步是查看 CMD 窗口的信息，检查是否有错误信息和外部连接日志。

• 如果有错误信息，请试图理解信息内容，再使用搜索引擎寻求解决办法，最后实在无法解决或者认为是服务端代码问题后再汇报给我。
• 如果有正常的连接日志，但是状态码为 404，原因一般是游戏 API 前缀错误。请在服务端配置文件中修改，或者对客户端连接地址进行修改。低版本客户端补充：可能在某些请求 URL 的结尾多出或少了一个 /，请自行修改代码以适配。
• 如果服务端无反应，则客户端无法连接到服务端，此时可能的原因较多，请检查各个环节一一排查。可能的原因有：常见网络问题、SSL 证书不被信任或错误、转发或代理设置问题、服务器端口未开放或防火墙限制、地址填写错误、服务端 CMD 鼠标点了下进入选择模式卡住了……

另外，如果仅仅是 Link Play 模式出现网络问题，首先确保 Link Play 服务端地址正确，如果使用中间件，请在设置中正确填写 LINKPLAY_DISPLAY_HOST 项目。其次，请检查 UDP 通信相关的设置：开放 UDP 端口、确保代理对 UDP 协议可用（有些并不支持 UDP 连接）、确保网络正常……

歌曲下载失败

• 在网络正常的情况下，首先最重要的是确保文件齐全，曲包要包含里面所有曲目的数据，歌曲要包含所有难度谱面的数据（除了 BYD 和 ETR 难度）。
• 客户端不接受小于一定大小的文件，故不要用空文件占位。
• 建议 base.ogg 等音频文件是 OGG 格式，请进行正确的格式转换而不是只改个后缀。
• 最好不要在服务端运行时修改文件，否则请刷新文件 hash 值。
• 请确保客户端 songlist 文件正确。若在服务端放置 songlist 文件，也请检查其合理性。
• 特殊视频文件是硬编码的，不对所有曲目通用。

服务端

服务端无法启动

首先，如果有错误信息，请先仔细阅读它，并试图自行通过搜索引擎来解决。如果你确定这是服务端代码错误，或者你无法解决这个问题，请将其汇报给我。下面列举一些常见的原因：

• 主机地址或端口填写错误，比如造成了端口冲突。
• 本项目所需的依赖未正确安装，或者版本不适配。
• 旧版本向新版本服务端更新时，数据库所需要的初始化数据未更新，导致数据库异常。