Skip to content

Latest commit

 

History

History
105 lines (95 loc) · 5.67 KB

usage.md

File metadata and controls

105 lines (95 loc) · 5.67 KB

What is this?

This is a Phigros Score Lookup Discord bot (aka PSLDiscordBot),
you can get your scores by using /get-scores or /get-photo etc.

How to use this?

If you are first time using this, please follow the guide.

  1. Use /link-token <token> or /login to link your account first. Having problem? See /link-token or /login usage.
  2. (Optional) Set your score precision using /set-precision.
  3. (Optional, this is almost optional in every case) Use /get-time-index to find the save you want to see (See /get-time-index usage)
  4. Now, you can get your scores by using /get-scores [index] or /get-photo [index].

Command usage

Options in <example> are required options, in [example] are optional options.

/help

Usage: /help
Prints this guide.

/login

Usage: /login
Example: /login
Login with TapTap. Once you do this you no longer need to do /link-token.

/link-token

Notice: You should use /login instead! This is obsolete.
Usage: /link-token <token>
Example: /link-token abcde12345fghij67890klmpq
Link your token. You must link your token before doing anything (except /help).
Token is a string which has length of 25, only contains numbers and lowercase alphabets.
Warning: people CAN use token to find your personal information, so do NOT leak your token! If you leaked it, logout in Phigros immediately. (Don't worry we don't use your token for personal information)
How to find token:
Chinese version

Android - way 1

  1. Find .userdata at Android/data/com.PigeonGames.Phigros/files/ (or more precisely, /storage/emulated/[userid]/Android/data/com.PigeonGames.Phigros/files/.userdata)

Some device may differ, then find folder named com.PigeonGames.Phigros and try to find .userdata underneath it.

  1. Open the .userdata file with any text editors, and find "sessionToken": "abcdefg", the abcdefg is your token, save it carefully.

For example, the file shows "sessionToken": "abcdefghij1234567890abcde", then your token is abcdefghij1234567890abcde.

Android - way 2

Download the file and follow the guide. (May be Chinese)

iOS - way 1

Use Ai-Si helper to export the backup, find the folder AppDomain-games.Pigeon.Phigros/Documents and .userdata is inside. You can also find file named f48523d73831bfbdc9faf74eca5bf2999ca5bf54, it is the .userdata file but with different name, then follow the Android way 1 step.

iOS - way 2

Summary: Grabbing the request sent from Phigros client to Phigros server (https://phigrosserver.pigeongames.cn/1.1/classes/_GameSave), this is faster but I only recommend it for advanced users.

  1. Download a proxy app on your device.
  2. Download HTTP Toolkit on your computer, and connect your device and your computer to same Wi-Fi.
  3. Get your computer IP and port which HTTP Toolkit is listening on (default 8000)，you can check it on main page (Proxy Port:8000), then install cert exported from HTTP Toolkit.
  4. Add new proxy, and enter IP and port gotten from above step, and start it.
  5. Start the service, then open Phigros and do sync, grab the request in HTTP Toolkit, then check the header of the request, the value of x-lc-session is your token.

iOS - way 3

Use an Android device temporally and follow the upper part.

/get-time-index

Usage: /get-time-index
It prints out all your save time and index that means it, 0 is always latest. You must do /link-token or /login first.

/export-scores

Usage: /get-all-scores [index]
Example: /get-all-scores 0
It gives you a CSV attachment that has all your scores. You must do /link-token or /login first.

/get-scores

Usage: /get-scores [index] [count]
Example: /get-scores 0 114514
It gives you a table of your scores, rks, status (with specified length) etc. You must do /link-token or /login first.

/set-precision

Usage: /set-precision <number, 16 >= number >= 1>
Example: /set-precision 5
It sets the precision of score show when doing /get-scores. Example: number = 1: acc: 99.1
number = 2: acc: 99.12
...
You also must do /link-token first.

/get-token

Usage: /get-token
Get your token. You must do /link-token or /login first.

/song-scores

Usage: /song-scores <search> [index]
Example: /song-scores volcanic 0
It searches all your scores, you can input song name, a song alias, or song id to find the song. You must do /link-token or /login first.

/get-photo

Usage: /get-photo [count] [index]
Example: /get-photo 69 0
Gives you a cool picture about your b19&1phi scores. You must do /link-token or /login first.

/about-me

Usage: /about-me [index]
Example: /about-me 0
Gives you a cool picture about your statistics. You must do /link-token or /login first.

/song-info

Usage: /song-info <search>
Example: /song-info 321
It searches songs in database, you can input song name, a song alias, or song id to find the song. You must do /link-token or /login first.

/song-scores

Usage: /song-scores <search> [index]
Example: /song-scores 2085 0
It searches songs in database, you can input song name, a song alias, or song id to find the song, and show your score in cool images. You must do /link-token or /login first.

/poke

Usage: /poke
Poke me