🎸 Tsugu BanG Dream（Koishi）
插件包名：
koishi-plugin-tsugu-bangdream-bot
当前版本：0.1.3
BanG Dream! 少女乐团派对多功能查询插件，数据主要来自 Bestdori，并通过 Tsugu 后端处理。
这是 Koishi 分支的说明书，与 AstrBot 版并非同一个前端插件。本站统一使用：
@bot + 命令
🚀 快速开始
| 功能 | 示例 |
|---|---|
| 查卡 | @bot 查卡 高松灯 |
| 查卡面 | @bot 查卡面 1399 |
| 查角色 | @bot 查角色 高松灯 |
| 查活动 | @bot 查活动 177 |
| 查歌曲 | @bot 查曲 春日影 |
| 随机歌曲 | @bot 随机曲 lv27 |
| 查玩家 | @bot 查玩家 10000000 cn |
| 查车牌 | @bot ycm |
| 查档线 | @bot ycx 1000 |
| 抽卡模拟 | @bot 抽卡模拟 10 |
🌍 服务器
| 代码 | 服务器 |
|---|---|
jp | 日服 |
en | 国际服 |
tw | 台服 |
cn | 国服 |
kr | 韩服 |
大多数命令都可以填写代码或中文服务器名。
🃏 卡牌、角色与活动
| 命令 | 说明 |
|---|---|
@bot 查卡 关键词 | 按关键词或卡牌 ID 查询卡牌 |
@bot 查卡面 卡牌ID | 查看指定卡牌插画 |
@bot 查角色 关键词 | 查询角色资料 |
@bot 查活动 关键词 | 查询活动资料 |
@bot 查卡池 卡池ID | 查询指定卡池 |
@bot 查试炼 | 查询当前活动试炼 |
@bot 查试炼 活动ID -m | 查询指定活动，并显示歌曲 Meta |
别名包括：
查卡牌查卡插画查插画查stage查舞台查festival查5v5
示例：
@bot 查卡 1399
@bot 查卡 绿 tsugu
@bot 查试炼 157 -m
关键词之间需要使用空格分隔。
🎵 歌曲与谱面
| 命令 | 说明 |
|---|---|
@bot 查曲 关键词 | 查询歌曲 |
@bot 查谱面 歌曲ID | 查询该歌曲全部谱面 |
@bot 查谱面 歌曲ID 难度 | 查询指定难度谱面 |
@bot 随机曲 | 随机选择歌曲 |
@bot 随机曲 条件 | 在符合条件的歌曲中随机 |
@bot 查询分数表 | 查询主服务器分数表 |
@bot 查询分数表 服务器 | 查询指定服务器分数表 |
随机 是 随机曲 的别名。
查询分数表 还支持：
查分数表查询分数榜查分数榜
示例：
@bot 查曲 ag lv27
@bot 查谱面 1 expert
@bot 随机曲 lv24 ag
@bot 查询分数表 cn
📈 档线查询
| 命令 | 说明 |
|---|---|
@bot ycx 档位 [活动ID] [服务器] | 查询指定档位的当前档线和预测线 |
@bot ycxall [活动ID] [服务器] | 查询全部档位 |
@bot lsycx 档位 [活动ID] [服务器] | 与最近数期同类型活动进行历史对比 |
示例：
@bot ycx 1000
@bot ycx 1000 177 jp
@bot ycxall 177 jp
@bot lsycx 1000 177 jp
myycx 是 ycxall 的别名。
🎲 抽卡模拟
@bot 抽卡模拟 次数 [卡池ID]
示例：
@bot 抽卡模拟 10
@bot 抽卡模拟 300 922
未填写卡池 ID 时，使用当前活动卡池。
当前 Koishi 插件源码要求明确填写抽卡次数，直接发送
@bot 抽卡模拟可能提示命令不完整。
👤 玩家查询与绑定
查询玩家
@bot 查玩家 玩家ID [服务器]
示例：
@bot 查玩家 40474621 jp
查询玩家 是别名。未填写服务器时使用当前主服务器。
绑定玩家
@bot 绑定玩家 [服务器]
绑定流程：
- bot 给出一个临时验证数字；
- 把游戏内的个人评论或当前卡组名称改成该数字；
- 在等待期间单独发送玩家 ID；
- 插件验证资料并完成绑定。
不要把玩家 ID 直接写在
绑定玩家命令后面。
管理绑定
| 命令 | 说明 |
|---|---|
@bot 玩家状态 | 查看当前绑定玩家 |
@bot 玩家状态 序号 | 查看指定绑定记录 |
@bot 玩家状态列表 | 查看全部绑定 |
@bot 玩家默认ID 序号 | 设置默认绑定记录 |
@bot 解除绑定 服务器 | 解除指定服务器绑定 |
常用别名：
玩家列表玩家信息列表默认玩家ID默认玩家玩家ID解绑玩家
⚙️ 服务器设置
| 命令 | 说明 |
|---|---|
@bot 主服务器 服务器 | 设置主要查询服务器 |
@bot 设置显示服务器 服务器1 服务器2 | 设置资料默认显示顺序 |
示例：
@bot 主服务器 国服
@bot 日服模式
@bot 设置默认服务器 国服 日服
相关别名包括：
服务器模式切换服务器默认服务器设置默认服务器
🚗 车牌功能
| 命令 | 说明 |
|---|---|
@bot ycm | 查看全部车牌 |
@bot ycm 关键词 | 按关键词筛选车牌 |
@bot 有车吗 | ycm 的别名 |
@bot 车来 | ycm 的别名 |
@bot 开启车牌转发 | 允许识别并提交自己发送的车牌 |
@bot 关闭车牌转发 | 停止车牌转发 |
示例：
@bot ycm 大分
开启转发后，发送含有房间号和车牌关键词的消息时，插件可能自动提交至 Tsugu 或 BandoriStation。
⚠️ 使用注意
- 查询依赖 Tsugu 后端与外部游戏数据服务。
- 命令和参数之间必须留空格。
- 绑定玩家时应等待 bot 提示，再单独发送玩家 ID。
- 档线和预测线仅供参考，不代表最终官方排名。
- 抽卡模拟仅供娱乐。
- 车牌转发能否工作取决于关键词、房间号格式和管理员配置。
- 插件需要 Koishi 数据库服务保存用户设置和绑定信息。
- 管理员可能设置只有
@bot后才触发，因此本站统一使用@bot + 命令。
❓ 常见问题
为什么命令没有反应？
确认已经正确艾特 bot、命令参数之间有空格、插件在线，并且 Tsugu 后端可访问。
为什么绑定失败？
可能是玩家 ID 错误、验证码没有正确写入签名或卡组名、等待超时，或游戏资料尚未同步。
为什么显示多个服务器的数据？
这是默认显示服务器设置造成的。可使用：
@bot 设置默认服务器 国服 日服
调整顺序和范围。
为什么车牌没有自动转发？
确认已发送 @bot 开启车牌转发，且消息包含可识别的房间号和车牌关键词。
📎 项目信息
- 插件名称：Tsugu BangDream Bot
- Koishi 包名：
koishi-plugin-tsugu-bangdream-bot - 当前版本：
0.1.3 - 作者：Yamamoto、DreamPrism、HarryShan
- Koishi 要求：
^4.17.12 - 开源协议：MIT
- 项目地址：https://github.com/Yamamoto-2/tsugu-bangdream-bot
