Files
Kou/README.md
T
2026-11-21 11:47:35 +08:00

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"}'
```