# Eaquira

A python 3 project which is used to post title server of 「舞萌 DX」&「maimai DX International」

---

## Info

__Eaquira__ is a fork of `sdgb-some-api` main branch. Thanks to leakers.

## SDGA Usage

特别说明：国际服（下称 SDGA）部分代码仅提供参考，并不具备实用价值。
- 世嘉对 SDGA 的维护尚可，对于发送请求的 IP 有较为严格的要求。对于滥发请求的 IP 等会快速封禁。
- 由于 AiMeDB 已禁用对 FeliCa 卡类型老旧接口的支持（主要是 FeliCa Lookup 的部分，将 IDm 查表转换为 accessCode 相关），大部分使用蓝白卡（判断方式：卡号 5 开头）的玩家无法通过命令行模拟的方式实现上号，必须要通过购买第三方读卡器才能实现刷卡上号。

still in progress...

## SDGB Usage

SDGB 目前仍然停留在老旧的 1.40 版本支持（即 DX 2024），仓库中现有代码并不支持最新版本。目前有计划在 Esquira 2.0 重构发送请求的架构（大饼）。

- _authlite.py_ Get latest opt file of SDGB.
- _login.py_ ```UserLoginApi```
- _logout.py_ ```UserLogoutApi```
- _mapstock.py_ 区域前进保存 99 千米
- _music.py_ 传分
- _preview.py_ ```GetUserPreviewApi```
- _sdgb.py_ 网络发包
- _ticket.py_ ```UpsertUserChargelogApi```
- *unlock_all.py* 解锁「舞萌DX」至「舞萌DX 2024」所有的乐曲，含有 Re:Master 难度的乐曲的 Re:Master 铺面暂无法解锁
- _unlock.py_ 解锁指定歌曲
- _userdata.py_ ```GetUserDataApi```

其中，_mapstock.py_ _music.py_ _ticket.py_ _unlock.py_ _userdata.py_ 均包含完整登录流程，其中 _music.py_ 会按照 _settings.py_ 中记录的歌曲信息覆盖原有成绩，_mapstock.py_ _unlock.py_ 会上传一条「PANDORA PANDOXXX」Re:Master 铺面的游玩记录，但是不会覆盖原有成绩。

- _settings.py_ 储存 UserId、机厅信息等重要的信息，**请不要向他人泄露自己的 UserId**。将 ```.settings.py``` 命名为 ```settings.py``` 并按照注释修改设置。

## Running

```bash
pip install -r requirements.txt
```

## Warning and Statements

WE ARE NOT RESIPONSIBLE FOR YOUR ACCOUNT.

>怂别用，用别怂。
>
>我也没说过这玩意一直能用，至少现在能用。

## Copyright

GNU License.

__Eaquira__ is a part of [__Project Fragrance__](https://fragrance.moe).