133 lines
2.9 KiB
Markdown
133 lines
2.9 KiB
Markdown
# Kou
|
|
|
|
A Python 3 based「maimai DX International」title server (1.65.00) interaction emulator. Inspired by Fragrance/eaquira.
|
|
|
|
`SteamingAssets` dumped from .app file is required. Place it in the root of the project.
|
|
|
|
## Usage
|
|
|
|
Currently, Mifare AiME is the only supported type.
|
|
|
|
### `GetUserPreviewApi`
|
|
|
|
#### Parameters & Returns
|
|
|
|
| Parameter | Type | Required |
|
|
| :--- | :--- | :--- |
|
|
| `--userId` | `int` | Yes |
|
|
|
|
Returns a string. Just the response from Title Server.
|
|
|
|
#### Example
|
|
|
|
```bash
|
|
python3 GetUserPreviewApi.py \
|
|
--userId 6964139
|
|
```
|
|
```json
|
|
{
|
|
"userId": 6964139,
|
|
"userName": "TRG",
|
|
"isLogin": false,
|
|
"lastGameId": null,
|
|
"lastRomVersion": "1.65.00",
|
|
"lastDataVersion": "1.65.04",
|
|
"lastLoginDate": "2026-11-20 23:36:22",
|
|
"lastPlayDate": "2026-11-20 23:53:12",
|
|
"playerRating": 16666,
|
|
"nameplateId": 0,
|
|
"iconId": 10,
|
|
"trophyId": 0,
|
|
"isNetMember": 1,
|
|
"isInherit": false,
|
|
"totalAwake": 1734,
|
|
"dispRate": 0,
|
|
"dailyBonusDate": "1970-01-01 09:00:00",
|
|
"headPhoneVolume": null,
|
|
"banState": 1
|
|
}
|
|
```
|
|
|
|
|
|
### `UserLoginApi`
|
|
|
|
#### Parameters & Returns
|
|
|
|
| Parameter | Type | Required |
|
|
| :--- | :--- | :--- |
|
|
| `--userId` | `int` | Yes |
|
|
| `--accessCode` | `str` | Yes |
|
|
| `--serial` | `str` | Yes |
|
|
| `--loginDateTime` | `int` | Yes |
|
|
|
|
Returns a two-element list containing ```[ResponseBodyFromTitleServer, CookiesFromTitleServer]```, both are string.
|
|
|
|
#### Example
|
|
|
|
```bash
|
|
python3 UserLogin.py \
|
|
--userId 6964139 \
|
|
--accessCode "01036000000000000000" \
|
|
--serial "00000000" \
|
|
--loginDateTime 1700000000
|
|
```
|
|
```python
|
|
[
|
|
'{"returnCode":1,"lastLoginDate":"2026-06-04 11:45:14","loginCount":8964,"consecutiveLoginCount":0,"loginId":198964}',
|
|
'{"JSESSIONID": "TRGISALEAKER"}'
|
|
]
|
|
```
|
|
---
|
|
|
|
### `UserLogoutApi`
|
|
|
|
#### Parameters & Returns
|
|
|
|
| Parameter | Type | Required |
|
|
| :--- | :--- | :--- |
|
|
| `--userId` | `int` | Yes |
|
|
| `--accessCode` | `str` | Yes |
|
|
| `--logoutType` | `int` | Version-dependent |
|
|
| `--loginDateTime` | `int` | Yes |
|
|
| `--cookie` | `str` | Yes |
|
|
|
|
Returns a string. Just the response from Title Server.
|
|
|
|
#### Example
|
|
|
|
```bash
|
|
python3 UserLogoutApi.py \
|
|
--userId 6964139 \
|
|
--accessCode "01036000000000000000" \
|
|
--logoutType 1 \
|
|
--loginDateTime 1700000000 \
|
|
--cookie '{"JSESSIONID":"TRGISALEAKER"}'
|
|
```
|
|
```json
|
|
{"returnCode": 1}
|
|
```
|
|
|
|
---
|
|
|
|
### `GetUserDataApi` / `GetUserChargeApi` / `GetUserExtendApi` / `GetUserMissionDataApi` / `GetUserOptionApi` / `GetUserRatingApi`
|
|
|
|
Requires running `UserLoginApi` first.
|
|
|
|
These scripts share the same parameter signature, requiring only `--userId` and `--cookie`.
|
|
|
|
#### Parameters & Returns
|
|
|
|
| Parameter | Type | Required | Notes |
|
|
| :--- | :--- | :--- | :--- |
|
|
| `--userId` | `int` | Yes | - |
|
|
| `--cookie` | `str` | Yes | JSON string |
|
|
|
|
Returns a string. Just the response from Title Server.
|
|
|
|
#### Examples
|
|
|
|
```bash
|
|
python3 GetUserDataApi.py \
|
|
--userId 6964139 \
|
|
--cookie '{"JSESSIONID": "TRGISALEAKER"}'
|
|
``` |