《CHUNITHM》是一款由SEGA开发的街机音乐游戏。其主要玩法为配合音乐节奏，通过触碰键盘或抬手以进行相应操作。CHUNITHM于2015年7月16日在日本开始运营。游戏内置多首乐曲并配有不同难度的谱面供玩家游玩。
引自萌娘百科，阅读更多：https://zh.moegirl.org.cn/CHUNITHM
本插件旨在降低游玩Chunithm的门槛，为玩家提供多项Chunithm相关的实用功能，以更好地提升自身游玩技术。
- ✅：已实现
- 🚧：开发中
| 功能 | 描述 | 实现 |
|---|---|---|
| 模糊搜索 | 根据别名匹配曲目 | ✅ |
| 精准搜索 | 根据cid匹配曲目 | ✅ |
| 添加别名 | 为曲目添加别名 | ✅ |
| 容错计算 | 计算曲目达成鸟/鸟加的容错 | ✅ |
| 谱面查询 | 获取曲目预览谱面 | ✅ |
| 随机歌曲 | 随机获取一首曲目 | ✅ |
| 定数列表 | 获取指定定数的所有曲目 | ✅ |
| 曲师查询 | 获取指定曲师的所有曲目 | ✅ |
| 猜歌游戏 | 根据截取曲绘猜测曲目 | ✅ |
| B30查询 | 查询B30曲目列表 | ✅ |
| 段位曲目 | 获取指定段位的曲目列表 | 🚧 |
配置完成 LangBot 主程序后使用管理员账号向机器人发送命令即可安装：
!plugin get https://github.com/AmethystTim/ChunithmUtil.git
或查看详细的插件安装说明
访问消息平台配置HTTP服务器
以NapCat为例，访问127.0.0.1:6099，配置信息如下：
插件安装完成后，需要获取歌曲元数据和谱面ID-歌曲的映射表
-
方式1（推荐）：在群聊中使用
chu update指令获取数据 -
方式2：运行以下脚本以获取数据
src/utils/songmeta.py # 获取歌曲元数据
src/utils/mapping.py # 获取谱面ID-歌曲的映射表
Chunithm版本更新后，可再次运行以更新数据
其中
[]表示必选参数，<>表示可选参数，<>中:右侧表示默认值
| 指令 | 描述 | 参数 | 示例 |
|---|---|---|---|
[别名]是什么歌 |
模糊搜索歌曲 | 别名 |
特大是什么歌； c1145是什么歌 |
chuset [cid] [别名1,别名2,…] |
为曲目添加别名 | cid, 别名1, 别名2, … |
chuset c165 16bit； chuset c165 16bit,16比特战争 chuset c165 16bit，16比特战争 |
别名[cid/别名] |
查询歌曲别名 | cid/别名 |
别名c165； 别名特大 |
chu lv [定数] |
获取指定定数的所有曲目 | 定数 |
chu lv 14.5 |
| 指令 | 描述 | 参数 | 示例 |
|---|---|---|---|
chuchart [cid/别名] <难度: mas> |
获取指定曲目谱面预览 | cid/别名,难度(可选exp/mas/ult) |
chuchart 特大； chuchart aleph-0 ult |
wechart [cid/别名] <类型> |
获取指定曲目谱面预览 | cid/别名, 类型(可选狂、招……，不指定则返回该曲目所有类型WE谱) |
wechart 特大 割； wechart 神威 招； wechart 这么可爱真是抱歉 |
| 指令 | 描述 | 参数 | 示例 |
|---|---|---|---|
chubind [服务器] [TOKEN] |
绑定服务器身份信息 | 服务器（可选lx，rin）TOKEN（lx为个人API，rin为20位卡号） |
chubind lx chunithm-114-CHUNITHMCHUNITHM_chunithm=； chubind rin 11451419198106166160 |
chucopy [服务器] |
从指定服务器迁移游玩记录 | 服务器（可选lx，rin） |
chucopy lx； chucopy rin |
b30 <分表类型: None> |
查询B30 | 分表类型（可选simple仅返回文本B30，不指定返回默认B30图表） |
b30 b30 simple |
| 指令 | 描述 | 参数 | 示例 |
|---|---|---|---|
| chuguess | 开始猜歌游戏 | - | - |
| chuhint | 查看提示 | - | - |
guess [cid/别名] |
提交答案 | - | guess c114； guess 特大 |
| chuguess end | 结束猜歌游戏 | - | chuguess end； chuguessend； cge |
| 指令 | 描述 | 参数 | 示例 |
|---|---|---|---|
chu容错 [cid/别名] <难度: mas> |
计算指定曲目达成鸟/鸟加的容错 | cid/别名, 难度(可选exp/mas/ult) |
churc 特大； chu容错 yurushite |
chu曲师 [曲师名] |
获取指定曲师的所有曲目 | 曲师名 |
chu曲师 void； chuqs void |
| chu update | 更新曲目、谱面信息 | - | chu update； chuupdate |
- 歌曲元数据：data.json
- Chunithm谱面保管室：https://sdvx.in/chunithm.html
- 感谢@Hitagisugoi提出的的谱师/曲师查询功能建议