🎸 Tsugu BanG Dream Bot
插件名称： astrbot_plugin_tsugu_bangdream
当前版本： v0.2.0
为 AstrBot 接入 Tsugu 后端，提供 BanG Dream! 少女乐团派对的卡牌、角色、活动、歌曲、玩家、档线、车牌和抽卡模拟查询。
该插件目前支持 QQ OneBot / aiocqhttp。
🚀 快速开始
| 想做什么 | 示例 |
|---|---|
| 查询卡牌 | @bot 查卡 高松灯 |
| 查看卡面 | @bot 查卡面 卡牌ID |
| 查询角色 | @bot 查角色 高松灯 |
| 查询歌曲 | @bot 查曲 春日影 |
| 随机歌曲 | @bot 随机曲 |
| 查询玩家 | @bot 查玩家 玩家ID 国服 |
| 查看车牌 | @bot ycm |
| 绑定玩家 | @bot 绑定玩家 国服 |
🃏 卡牌、角色与活动
| 命令 | 说明 |
|---|---|
@bot 查卡 关键词 | 按关键词查询卡牌 |
@bot 查卡面 卡牌ID | 查看指定卡牌的卡面或插画 |
@bot 查角色 关键词 | 查询角色资料 |
@bot 查活动 关键词 | 查询活动信息 |
@bot 查卡池 卡池ID | 查询指定卡池信息 |
@bot 抽卡模拟 | 使用默认次数和卡池进行模拟 |
@bot 抽卡模拟 次数 卡池ID | 指定抽卡次数和卡池 |
卡牌 ID、活动 ID 和卡池 ID 通常可从其他查询结果中取得。
🎵 歌曲与谱面
| 命令 | 说明 |
|---|---|
@bot 查曲 关键词 | 查询歌曲 |
@bot 查谱面 歌曲ID | 查询指定歌曲谱面 |
@bot 查谱面 歌曲ID 难度 | 查询指定难度谱面 |
@bot 随机曲 | 随机选择一首歌曲 |
@bot 随机曲 关键词 | 在符合关键词的歌曲中随机选择 |
@bot 查询分数表 | 查询主服务器的歌曲分数表 |
@bot 查询分数表 国服 | 查询指定服务器分数表 |
@bot 查试炼 | 查询当前或默认活动试炼 |
@bot 查试炼 活动ID | 查询指定活动试炼 |
@bot 查试炼 活动ID -m | 使用 README 提供的 -m 模式查询 |
仓库 README 没有进一步解释 -m 的展示差异，具体效果以 bot 返回为准。
📈 档线查询
| 命令 | 说明 |
|---|---|
@bot ycx 档位 | 查询指定档位的当前活动档线 |
@bot ycx 档位 活动ID | 查询指定活动与档位 |
@bot ycx 档位 活动ID 国服 | 指定服务器查询 |
@bot ycxall | 查询当前活动的全部档位 |
@bot ycxall 活动ID | 查询指定活动的全部档位 |
@bot lsycx 档位 | 查询历史档线 |
@bot lsycx 档位 活动ID 国服 | 指定档位、活动和服务器查询历史档线 |
这里的“档线”结果由 Tsugu 后端返回。不同服务器和活动的数据完整度可能不同。
👤 玩家绑定与服务器
绑定玩家
@bot 绑定玩家 国服
插件会进入绑定流程，按 bot 后续提示完成操作。
解除绑定
@bot 解除绑定 国服
服务器设置
| 命令 | 说明 |
|---|---|
@bot 主服务器 国服 | 设置主要查询服务器 |
@bot 设置显示服务器 国服 日服 | 设置查询结果中显示的服务器与顺序 |
@bot 玩家状态 | 查看当前默认绑定玩家 |
@bot 玩家状态 2 | 查看第 2 个绑定记录 |
@bot 玩家状态 日服 | 查看指定服务器的绑定玩家 |
@bot 玩家状态列表 | 查看全部玩家绑定 |
@bot 玩家默认ID 2 | 将第 2 个绑定记录设置为默认 |
支持的服务器：
| 代码 | 中文 |
|---|---|
cn | 国服 |
jp | 日服 |
tw | 台服 |
en | 国际服 / 英服 |
kr | 韩服 |
可以直接使用代码或中文服务器名。
🚗 车牌功能
查询车牌
@bot ycm
也可以使用插件源码中的别名：
@bot 有车吗
@bot 车来
添加关键词可以筛选车牌：
@bot ycm 关键词
车牌转发
| 命令 | 说明 |
|---|---|
@bot 开启车牌转发 | 允许把聊天中识别到的车牌提交到 Tsugu 后端 |
@bot 关闭车牌转发 | 停止车牌转发 |
车牌功能依赖 Tsugu 数据后端和当前部署配置。
⚠️ 使用限制
- 插件依赖 Tsugu 后端，后端不可用时所有查询都可能失败。
- 使用自建后端时，玩家绑定和车牌功能要求后端启用
LOCAL_DB=true。 - 管理员可以设置群聊和私聊白名单。
- 未进入白名单的 QQ 会话会被静默忽略，不会返回无权限提示。
- 卡牌、活动、歌曲和玩家数据以 Tsugu 后端为准。
- 玩家 ID、活动 ID、歌曲 ID、卡池 ID 等参数必须使用正确格式。
- 绑定流程中应按 bot 的后续提示操作。
- 当前 metadata 只列出
aiocqhttp平台。
❓ 常见问题
Q：为什么命令完全没有反应？
当前群或私聊账号可能不在 QQ 白名单中。白名单外的消息会被静默忽略。
Q：为什么能查卡，却不能绑定玩家或使用车牌？
当前后端可能没有启用本地数据库能力，或者数据后端配置不完整。
Q：服务器应该写什么？
可以写：
cn、jp、tw、en、kr
也可以写：
国服、日服、台服、国际服、韩服
Q：为什么 @bot ycx 提示缺少参数？
ycx 通常需要提供档位，例如：
@bot ycx 1000
Q：为什么抽卡模拟结果与游戏不一致？
抽卡模拟依赖 Tsugu 后端配置和卡池数据，仅供娱乐和概率参考。
📎 项目信息
- 显示名称：Tsugu BanGDream Bot
- 当前版本：v0.2.0
- 作者：Ars1027
- 支持平台：QQ OneBot /
aiocqhttp - 项目地址：https://github.com/Ars1027/astrbot_plugin_tsugu_bangdream
