Files
Kou/README.md
T

90 lines
2.1 KiB
Markdown

# Kou
A Python 3 based「maimai DX International」title server 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.
### `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
```
```
[
'{"returnCode":1,"lastLoginDate":"2026-11-21 11:09:25","loginCount":125,"consecutiveLoginCount":3,"loginId":7710449444398826983}',
'{"JSESSIONID": "85F1E8EABB944B94CB581BA05EC6A312"}'
]
```
---
### `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"}'
```
```
{'returnCode': 1}
```
---
## 3. `GetUserDataApi` / `GetUserChargeApi` / `GetUserExtendApi` / `GetUserMissionDataApi` / `GetUserOptionApi` / `GetUserRatingApi`
These scripts share the same parameter signature, requiring only `--userId` and `--cookie`.
### Parameters
| Parameter | Type | Required | Notes |
| :--- | :--- | :--- | :--- |
| `--userId` | `int` | Yes | - |
| `--cookie` | `str` | Yes | JSON string |
Returns a string. Just the response from Title Server.
### Examples
```bash
python3 GetUserData.py \
--userId 6964139 \
--cookie '{"JSESSIONID": "TRGISALEAKER"}'
```