ChunithmUtil

集成了多项Chunithm实用功能的LangBot插件🧩

介绍🤔

《CHUNITHM》是一款由SEGA开发的街机音乐游戏。其主要玩法为配合音乐节奏，通过触碰键盘或抬手以进行相应操作。CHUNITHM于2015年7月16日在日本开始运营。游戏内置多首乐曲并配有不同难度的谱面供玩家游玩。

引自萌娘百科，阅读更多：https://zh.moegirl.org.cn/CHUNITHM

本插件旨在降低游玩Chunithm的门槛，为玩家提供多项Chunithm相关的实用功能，以更好地提升自身游玩技术。

特性✨

• ✅：已实现
• 🚧：开发中

功能	描述	实现
模糊搜索	根据别名匹配曲目	✅
精准搜索	根据cid匹配曲目	✅
添加别名	为曲目添加别名	✅
容错计算	计算曲目达成鸟/鸟加的容错	✅
谱面查询	获取曲目预览谱面	✅
随机歌曲	随机获取一首曲目	✅
定数列表	获取指定定数的所有曲目	✅
曲师查询	获取指定曲师的所有曲目	✅
谱师查询	获取指定谱师的所有曲目	✅
自动更新	自动获取新版本曲目信息	✅
段位曲目	获取指定段位的曲目列表	🚧
谱面预览	获取曲目谱面预览视频链接	🚧

插件安装🛠️

配置完成 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版本更新后，可再次运行以更新数据

指令🤖

指令	描述	参数	示例
[别名]是什么歌	模糊搜索歌曲	别名	特大是什么歌
chu查歌[歌曲全名/cid]	精准搜索cid对应歌曲	歌曲全名/cid	chu查歌c114
chu随机一曲	随机获取一首曲目	-	-
alias [cid] [别名1,别名2,…]	为曲目添加别名	cid, 别名1, 别名2, …	alias c114 16bit,16比特战争
别名[cid]	查询歌曲别名	cid	别名c114
chuchart [cid/别名] <难度: mas>	获取指定曲目谱面预览	cid/别名, 难度(可选exp/mas/ult)	chuchart aleph-0 ult
chu lv [定数]	获取指定定数的所有曲目	定数	chu lv 14.5
chu容错 [cid/别名] <难度: mas>	计算指定曲目达成鸟/鸟加的容错	cid/别名, 难度(可选exp/mas/ult)	chu容错 yurushite
chu曲师 [曲师名]	获取指定曲师的所有曲目	曲师名	chu曲师 void
chu谱师 [谱师名]	获取指定谱师的所有曲目	谱师名	chu谱师 techno kitchen
chu update	更新曲目、谱面信息	-	-

注：[] 表示必选参数，<> 表示可选参数，<>中:右侧表示默认值

数据源

• 歌曲元数据：data.json
• Chunithm谱面保管室：https://sdvx.in/chunithm.html

致谢🙏

• 感谢@Hitagisugoi提出的的谱师/曲师查询功能建议