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

2.9 KiB

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

python3 GetUserPreviewApi.py \
  --userId 6964139 
{
    "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

python3 UserLogin.py \
  --userId 6964139 \
  --accessCode "01036000000000000000" \
  --serial "00000000" \
  --loginDateTime 1700000000
[
    '{"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

python3 UserLogoutApi.py \
  --userId 6964139 \
  --accessCode "01036000000000000000" \
  --logoutType 1 \
  --loginDateTime 1700000000 \
  --cookie '{"JSESSIONID":"TRGISALEAKER"}'
{"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

python3 GetUserDataApi.py \
  --userId 6964139 \
  --cookie '{"JSESSIONID": "TRGISALEAKER"}'