Phira Documentation

English

简体中文

English

简体中文

Appearance

Phira FAQ ​

This is the Phira FAQ written by Phira support volunteers. Before playing Phira, please read and agree to the official Terms of Service and Privacy Policy.

Below are the updates in v0.7.1:

  • ! Added chart collaborators. For details, see https://teamflos.github.io/phira-docs/chart-management/collaborator.html
  • Added pull-to-refresh for favorites
  • Fixed an issue where some resource packs caused judge lines and effects to disappear
  • Fixed an issue where charts could not be exported in batches
  • Fixed an issue where notes could not be judged after dragging the progress bar in Practice Mode
  • Fixed an issue where online charts could not be added to local favorites
  • Fixed an issue where Hold notes were not supported in the RPE judgment area
  • Fixed an issue where the “score will not be recorded” prompt was missing when playing with a keyboard.

If you find any issues in this document, contact @Dmocken in the Phira QQ channel or use the Feedback page.

Before you start ​

  1. A device to play on (Android 7+ for online services, iOS 12+ for Apple devices).
  2. A personal email address.
  3. An AI assistant, so you can ask about any step you do not understand.

Download for Android ​

  1. Download sources for users in mainland China:
  2. International download source:
  3. If you see “device not supported”, “CPU incompatible”, or an installation failure message, try installing the 32-bit build.

Download for iOS ​

  1. Recommended: if you use an Apple ID outside mainland China, you can search for and download Phira from the App Store.
  2. You can also install it by sideloading an IPA. Download links:
  3. IPA sideloading usually requires a computer or tools such as TrollStore.See the tutorial.
  4. If you see an “Untrusted Enterprise Developer” prompt, go to Settings -> General -> VPN & Device Management and trust the developer. If you are prompted to enable Developer Mode, turn it on first in Settings.

Download for HarmonyOS ​

FAQ ​

Terms of Service and Privacy Policy ​

  • You must read and agree to the Terms of Service and Privacy Policy. If you do not agree, Phira may refuse to provide services to you.
  • After you read the Terms of Service and Privacy Policy, the pop-up window will close automatically, which will be taken as your confirmation that you have read and agreed to the terms.

Account and password ​

  • After registering, please check your email promptly. A verification email will be sent to you. If you do not receive it, please check your spam/junk folder or refresh the page.
  • If the invitation link displays "Invalid Activation Code" within 10 minutes of receiving it, it may be a system bug. In this case, please try logging in to Phira using your registered account and password.
  • To change your password, go to Reset password. After entering your email address, a password reset link will be sent to your inbox. You can reset your password through that link. If the page turns blank after you enter your email, that is a known bug. If you do not receive the reset link within 5 minutes, try submitting the password reset request again.

WARNING

If you cannot open the link in the email, replace api.phira.cn at the beginning of the URL with phira.5wyxi.com.

Online services ​

  • If chart loading or downloading fails, first check whether you are using the latest version of the app (0.7.1). If you are already on the latest version, the problem is likely on the server side, or your access may be temporarily restricted due to frequent requests. Try again later.
  • If score upload fails and you see a message saying the score is still being uploaded, that usually means the server connection is unstable. If you do not care about uploading the score, you can switch to offline mode.
  • If charts fail to download and show a long error message, or if downloads are unusually slow, try the following:
    • Wait an hour and then try again
    • Switch networks, for example from Wi-Fi to mobile data
    • Enable Insecure Mode in the game and restart it
    • Turn on airplane mode, or restart your device
    • Switch mobile carriers
    • Use a network proxy tool
    • Wait for the server to recover

Multiplayer service issues ​

Touch / input issues ​

  • iOS: Enable Guided Access.
  • Android: Add the app to your system's game space, or turn off multi-finger gestures and similar assistive features.
  • General: Disable aggressive optimization or enable low graphics mode. Overheating can cause CPU throttling and hurt performance. A dirty screen can also affect touch input. If the issue persists, check whether your screen supports multi-touch.

Resource packs ​

  • Resource packs are imported as zip files. Do not unzip them first.
  • Resource pack site: prprBlog (you may need special network access to open it)
  • QQ Channel: Phira Resource Pack Creation & Sharing
  • (Android) Files downloaded through QQ are usually saved under Android/data/com.tencent.mobileqq/Tencent/QQfile_recv.
  • Importing resource packs on iOS: TestFlight installs can import directly. On self-signed IPA installs, file importing often fails on many devices, including local charts, resource packs, and avatars.
  • To import a resource pack, go to Home > Resource Packs > the plus button on the left. To import a chart, go to Play > “Import” in the top-right corner. You can also choose "Phira (Resource Pack)" as the app used to open the zip file. If you see a purple title bar with a white screen, try opening the zip again from your file manager with "Phira (Resource Pack)".

WARNING

The Phigros Official Resource Pack is copyrighted by Pigeon Games. Phira does not have the right to distribute it and no longer provides it. Please respect the copyright and do not redistribute it freely.

Custom charts ​

  • To find custom charts for a specific song, the fastest way is to search on Bilibili and download them under the guidance of the chart creator.
  • Before uploading a chart, make sure you have fully read, understood, and agreed to the Phira Chart Upload Guidelines and the Phira Chart Content Policy (for charters). In addition, all Phigros-exclusive songs, original artwork, official charts, and enhanced versions of official charts are prohibited from being uploaded. Violations may result in account bans.
  • For non-exclusive songs, please do not use the original artwork. As long as your chart design differs from the official chart, it may be uploaded. For more details, refer to the upload guidelines.
  • To protect the copyright of in-game charts and artwork, story charts and character illustrations cannot be used on Windows or Linux.

Official contact channels ​