FAQ

Others

Abort

Arcaea-Server is a code repository of a simple server for mobile game Arcaea, and does not involve client cracking or modification related content.

TODO...

How to submit the questions if necessary?

You can do it in any way that I can see it, including emails, GitHub Issues, GitHub Discussions, other chatting softwares, and so on. Please give me complete and sufficient information, including the error messages, the network data packages, your devices' information, the server's and the client's version, the detailed operations you did...

By the way, you should have a look at Issues and Discussions to make sure your question is unique, and try to solve it via search engines or GPT.

Client

How to modify it?

Please search for information on various search engines and take a look at other repositories on GitHub. At present, the public information on the Internet is enough for individuals to make the client to connect to the local server.

A small reminder: The client has undergone significant security updates in version 3.6.0. If you don't have much experience, you can try modifying the old version first. Of course, the modification methods for newer and older versions are vastly different.

Crash

Tips

You can easily determine whether the main cause of the crash issue is the client or the server. If the server does not receive a network request during the client crash, it is highly likely that the cause is the client. Well, this is not absolute.

Crash is a common consequence of incorrect and inadequate modification, and it may also be due to server data issues. Please make a judgment first and lock in the source step by step.

• Crash at startup
  • Please check the game data files, especially the song data and three special files. Pay attention to the client file hash check.
  • If using hot updates, please check the relevant bundle files and be careful not to miss three special files.
• Crash during login
  • It is very likely that there is an error in the server's data, as too much, too little, or a mismatch between the two sides may cause a crash.
• Crash when entering the song selection interface
  • It's basically a client issue. Please pay attention to hard-coding songs and packs.
  • It may be due to the lack of default playing songs. You can try clicking the bottom right corner of the main interface to enter the song selection interface.
• Crash when starting to play
  • It may be a problem with the chart file or the format of the song file.
• Crash at score interface
  • It is highly likely caused by hard-coded songs and packs.
• Crash when selecting some partner
  • This is due to the lack of relevant hard-coded song packs.
• Crash when all songs downloading
  • It is generally caused by excessive data provided by the server.
• Crash in course mode or world mode
  • The client-side parsing of the data provided by the server failed, usually due to data mismatch.

The above examples are all common situations. In addition, magic modification errors may cause various strange crashes. Please carefully check them.

Network Connection Issues

This issue may have different reasons depending on the connection method you are using, but in any case, the first step is to check the information in the CMD window for error messages and network connection logs.

• If there is any error message, please try to understand the content of the message, then use search engines to try to find a solution. If it cannot be solved or if it is believed to be a problem with the server code, please report it to me.
• If there are normal network connection logs, but the status code is 404, the reason is usually an incorrect game API prefix. Please modify it in the server configuration file or modify the client connection address. Low version client supplement: There may be an extra or missing / at the end of some request URLs. Please modify the code to adapt.
• If there is no response from the server, it means the client cannot connect to the server. There may be multiple reasons for this, please check each step one by one. Possible reasons include: common network issues, untrusted or incorrect SSL certificates, forwarding or proxy settings issues, server ports not open or firewall restrictions, an incorrect address, server CMD mouse clicking to enter selection mode and getting stuck...

In addition, if there is only a network problem in Link Play mode, first ensure that the address of the Link Play server is correct. If using middleware, please correctly fill in the LINKPLAY_DISPLAY_HOST item in the setting. Secondly, please check the settings related to UDP communication: open the UDP port, ensure that the proxy is available to the UDP protocol (some do not support UDP connections), ensure that the network is functioning properly...

Song Downloading Issues

• Under normal network conditions, the first and most important thing is to ensure that the files are complete. The song packs should include data for all the songs inside, and the song should include data for all difficulty levels (except for BYD and ETR difficulty levels).
• The client does not accept files smaller than a certain size, so do not use empty file placeholders.
• Suggest that base.ogg should be OGG format. Please perform format conversion instead of changing the suffix.
• You had better not change song files when the server is running. If you did, please refresh the hash data.
• Please ensure that the client's songlist file is correct. If you place the songlist file on the server, please also check its validity.
• Special video files are hard-coded and not universally applicable to all songs.

Server

Startup Issues

Firstly, if there is any error message, please read it carefully and try to resolve it yourself through search engines. If you are certain that this is a server code error, or if you are unable to resolve the issue, please report it to me. Here are some common reasons:

• The host address or port is filled in incorrectly, maybe causing a port conflict.
• The requirements for this project is not installed correctly or the version is not compatible.
• When updating from an old version to a new version server, the initialization data required for the database was not updated, resulting in database issues.