Skip to content

Attentions

Lost-MSth edited this page Dec 22, 2022 · 18 revisions

Game mechanics

PTT calculation

The calculation of PTT is mainly based on Arcaea Chinese wiki, but the calculation method of recent30 is not clear, which may lead to inconsistency with the official PTT. Sorry.

Recent 30 calculation rules

Maintain a queue from left to right. Here are some rules:

  1. If recent30 are not full, the new score will be put into the queue from the left and all of others will move to the right.
  2. If the total number of songs is less than 10 due to the new score, search for a score from the right to the left, to make the number of songs after refreshing recent30 is more than or equal to 10. If it cannot be found, exit the rightmost score; otherwise, exit the element found and move right to put the new score on the left.
  3. EX scores, Hard mode Track Lost scores and initial scores will get a protection. If the change of recent30 will reduce PTT, it will remain unchanged. In addition, if the score is higher than that of the same chart in recent30, it will refresh the old score from the earliest record.

Chart constant

Song database comes from BotArcAPI releases. If some songs are missing, the server will consider the song unranked, and the rating is set to 0 by default, which will not be added in recent30. Please add chart constant of some songs in the database by yourself. Of course, you can add some self-made charts.

Global rank

It is based on the sum of the user's highest scores of the FTR and BYD charts whose chart consts in the song database are bigger than 0.

Character

  • All characters are unlocked, and they are all in the full state.
  • Since v1.5, character skills have been added.
  • Since v2.5, the character system has been improved, including level up, uncapping and other mechanisms.

World

Since v1.3, world mode is available and allowed to custom maps.
Due to the lack of data, there are not many maps given, so you can capture the packages and add them by yourself. In the event chapter, several self-made circular maps are given, which can be used as a reference.

Tips

  • Map configuration must be correct. You can refer to the official maps to make your self maps.
  • There must be rewards at the last step of the map, otherwise it may lead to the collapse of Arcaea.
  • If it is a song unlock reward, please ensure that Arcaea has the song, otherwise it may lead to the collapse of Arcaea.
  • Beyond map is different from other maps. Please refer to the official beyond maps and be more careful.

Songs unlock

  • Since v1.3, some songs will be attempted to unlock, but all unlocking is not guaranteed.
  • Since v1.7, purchase system is available.
  • Other songs can be unlocked by using cloud save synchronization.

Songs download

You can download customized songs since v1.4.

  • Please make sure the file name is correct and the file is complete.
  • Please make sure you have all the required files, including all missing difficulty charts and song files.
  • For the case of downloading the whole package, you need to prepare the missing files of all songs in the package.
  • The chart file should check the number of notes, and the chart with too few notes cannot be downloaded.
  • After modifying files in the song folder while the server is running, please refresh the hash data of the songs in the background.
  • It is forbidden to log in to the official server to upload the chart results after downloading the unofficial charts. If you account is banned, we have no responsibility under any circumstances.

Login and register

The email address will not be considered when registering. Please fill it in freely.
Since v2.4, the email address will be recorded and shouldn't be the same, but the email availability will not be checked.

Multi device login

Since v2.2, multi device login has been added. However, please try not to use it if unnecessary, so as to avoid some strange problems.
Multi device login also includes multi application coexistence login of the same device.

Data synchronization

  • The server supports data synchronization and does not check the data. It is fully allowed to download data from the official server and upload it to the local server.
  • The background website allows cloud saves to be covered to best_score table. Note that the upload will directly cover the best score sheet and there is no recent30 data, so the updated PTT will be inaccurate.
  • Data download is also supported, but please do not synchronize the data to the official server. In case of banning your account, we are not responsible.

Purchase

It is no use. The default number of memories are 114514.

Since v1.7, purchase system is available. It also supports modifying some information, such as price and discount. The default number of memories is 0.

Present

Since v1.9, present system has been added, allowing some presents to be set up in the background, although it seems useless.

  • Please simplify the reward description. If it is too long, it will not be displayed completely on the client.
  • Under v2.6, the present items only support memories and fragments.
  • Adding pack items will cause the client to flash back.
  • Only the first item of the present items will be processed by the client.
  • Expired presents will not be distributed.
  • Presents can only be claimed once when logging in.

Redeem code

Since v2.0, redeem code system has been added, allowing some items to be set up in the background, although it seems useless.

  • The redeem code will not expire at present.
  • Under v2.6, the redeem code items only support memories and fragments.
  • All of redeem code items will be processed.

At present, the client seems to have no feedback, but the reward items can be handled correctly by the server.

Plot

When using full unlock cloud saves, if it is downloaded from the server during synchronization, it will be unlocked by default. (probably)

Friends

  • Use it normally. The default max number of friends is 50. (probably available)
  • There are no two default accounts, tairitsu and hikari, but there is a test account, admin. (Friend ID:123456789)

Ranking

It works normally, but it seems to be useless.

Link Play

Since v2.8, link play system is available. There may be various strange bugs. Please use it with caution.

Course Mode

Since v2.9, the course mode is available.

Operation and environment construction

Server

  • After running, please do not click the contents in the CMD window, so as not to enter the selected state and jam the server. (press enter to cancel the selected state)
  • The performance and security of the server are not guaranteed. There is no concurrent test and no security test. Please do not build a server on the Internet.

Of course, there is a very important reason that 616 may come and knock your door.

  • There may be a port conflict that make the server not work. Please check the port you are using.

Client

  • Ensure that the device and the server are in the same network. It means you can actually access the server.
  • Make sure the proxy is set up so Charles can guide the Arcaea to the local server.
  • Android 7 and above or IOS have more complex settings, please refer to the instructions.

Since Arcaea v3.6.0, the client needs to make some more complex operations.

Server construction and program design

Flask

HTTPS

Flash supports SSL. If necessary, please open it by yourself.

Front end

The front end is designed with Jinja2, of course, without any beautification. The CSS file comes from the official template.
In order to be compatible with a variety of situations, the web design is very primitive and did not use the front-end and back-end separation mode, without anything like JS.

Database

In order to be compatible with all kinds of situations, SQLite is used.
There may be something not good enough with the database, but it should basically meet the BC paradigm. There are almost no data constraints, no functions and triggers, and no views. The efficiency is worrying, and the security is equal to zero.

Log

Since v2.3, error logs will be recorded, and you can set up in the configuration file to record more detailed logs.