mil-plugin 为查询Milthm信息的插件，包括b20、score、song等Milthm相关功能，有相关的建议和问题可以在Issues中提出，欢迎PR。
具体功能可在安装插件后 通过 /mil help 查看详细指令
使用Github
#安装插件本体
git clone --depth=1 https://github.com/Temmie0125/mil-plugin.git ./plugins/mil-plugin/
#进入插件目录
cd ./plugins/mil-plugin/
#安装插件所需依赖
pnpm install
Warning
请使用主人权限执行该指令以下载曲绘，否则相关曲绘将无法正常展示！（可以是标准输入或者其他平台）
/mil downill
Tip
如果安装依赖时速度过慢，运行：
pnpm config set registry https://registry.npmmirror.com
-
优化界面设计
-
定数表
-
接入云存档系统
-
指令修改部分设置
-
谱面标签
-
猜曲绘、开字母等娱乐功能
以下#均可用/代替，命令头可自定义
| 功能名称 | 功能说明 |
|---|---|
#mil help |
查看帮助 |
直接发送存档文件 |
导入存档 |
#mil b20 |
查询b20 |
#mil song <曲名或别名> |
查询曲目图鉴 |
#mil alias <曲目> |
查看现有别名 |
#mil score <曲目> |
查看单曲成绩 |
#mil ill <曲目> |
查看曲绘 |
#mil recent |
查看最近一次游玩成绩（需要云存档） |
#mil delete |
删除bot端存档数据 |
#mil bind |
授权云存档（需要自行配置cilent_id和cilent_secret） |
#mil update |
更新存档数据 |
#mil unbind |
解除授权（不会删除本地存档） |
#mil guess |
猜曲绘，回答可以直接发送 |
#mil letter |
开字母，#open A翻开字母，#nx XXX猜测 |
| 功能名称 | 功能说明 |
|---|---|
#mil (强制|qz)?(更新|gx) |
更新插件 |
#mil downill |
下载或更新曲绘 |
直接上传你的saves.db给bot即可导入存档。
存档路径：
- Android(TapTap):
/storage/emulated/0/Android/data/game.taptap.morizero.milthm/files/data/- Android(Google Play):
/storage/emulated/0/Android/data/com.morizero.milthm/files/data/- IOS:
使用 文件 应用打开 Milthm 文件夹：
data/- Windows
%AppData%\..\LocalLow\Morizero\Milthm\data\- MacOS*
/Library/Application Support/Morizero/Milthm/data/- Linux
~/.config/unity3d/Morizero/Milthm/data/Warning
Milkoud 的在线成绩系统存在以下机制，可能导致云端与本地存档出现差异：
1. 仅在线成绩上传 — 离线游玩的成绩不会被上传到 Milkoud 的 Rank/Recent，但会保存在本地存档中并参与 Reality 计算。这是云端与存档 Reality 不一致的根本原因。
2. Touch / Keyboard 双端不互通 — Milkoud 为触摸端（手机/平板）和键盘端（PC）各自维护独立的排行榜。同一曲目在两个端的成绩不会互相覆盖，但本地存档是双端共用的（同一份 saves.db）。
3. 旧版成绩 — v4.0 以前的成绩不会被上传到云端。
本插件的处理策略：
- 从云端同时拉取 Touch 和 Keyboard 两端的 Rank/Recent 数据，合并后取同谱面最高分、最高 acc
- B20 差异检测会列出云端与存档不一致的曲目（含难度），方便你针对性消除差异
- 对于专注单一设备端的玩家（仅移动端 / 仅 PC 端），插件已能较好地保持云端与存档显示一致
- 如果你双端同时游玩，由于两端排名独立，可能会出现一定偏差。建议将不一致的曲目在常用端重新在线游玩一次即可同步
出现差异时的解决方式：使用 /mil b20 或 /mil update 后查看差异提示，将列出的曲目重新在线游玩一遍即可消除差异。
Warning
云存档功能需要自行配置以下任一内容：
- Re Nya Profiler API的API Key
- Milkloud OIDC的Cilent_id和Cilent_secret，可自行前往申请获取，此处不提供获取方式. 注意，如果你一定需要这一项配置，请务必申请Cilent Auth的认证类型，无需回调地址，Bot会自动轮询。
配置完上述内容之后，使用/mil bind，bot会发送一个授权链接，在有效期内完成授权即可。
之后可以使用/mil update更新你的云存档。
Warning
-
Milthm游戏内不会自动同步云存档，首次使用需要手动上传存档。
-
后续优先走Rank和Recent接口，Recent接口最多20条最近记录，只有极少数情况会走下载存档更新。下载存档每日最多5次，请合理使用。
-
如果你使用Re Nya Profiler API，请注意：
- API有并发限制和每日请求上限，每个用户每天最多请求存档5次。本插件已经做了缓存机制，可自行按需配置缓存有效期，并合理控制请求频率。
- API只能查询Best20以及Overflow2成绩，以及常规谱面完成的统计情况。如果你需要完整的数据，请使用本地导入或者自行申请Milkloud的OIDC client.
感谢phi-plugin提供的设计灵感
感谢以下贡献者对本项目做出的贡献
- 功能仅限内部交流与小范围使用，请勿将
Yunzai-Bot及mil-plugin用于任何以盈利为目的的场景. - 图片与其他素材均来自于网络，仅供交流学习使用，如有侵权请联系，会立即删除.
- 存档解析功能由mkzi-nya/milthm-calculator-web改写而来