nonebot-plugin-beatsaberscore 1.4.2

Nonebot2的节奏光剑查分插件,支持BeatLeader&ScoreSaber查分o((>ω< ))o

[!IMPORTANT] 此版本更新缓存管理机制,以及修复些已知问题

📖 介绍

Nonebot2的节奏光剑BeatLeader&ScoreSaber查分(ﾉ≧∀≦)ﾉ

💿 安装(以下选择其一安装即可)

使用 nb-cli 安装 (十分甚至九分的推荐)

在 nonebot2 项目的根目录下打开命令行, 输入以下指令即可安装

nb plugin install nonebot-plugin-beatsaberscore

使用 pip 安装

在 nonebot2 项目的根目录下打开命令行, 输入以下指令即可安装

pip install nonebot-plugin-beatsaberscore

如果安装完插件不载入的话,在nonebot文件夹中找到pyproject.toml,在plugins里面添加nonebot-plugin-beatsaberscore就完成了

如果你的Nonebot2项目下已经启用虚拟环境,可以使用Pipenv安装到项目中,但你需要安装pipenv包

使用 pipenv 安装

先安装pipenv

pip install pipenv

在 nonebot2 项目的根目录下打开命令行, 输入以下指令即可安装

pipenv install nonebot-plugin-beatsaberscore

🔄 更新

[!NOTE] 请不要用上面的安装方式更新!!!!!!!!!!!!

使用 nb-cli 更新

在 nonebot2 项目的根目录下打开命令行, 输入以下指令更新

nb plugin install nonebot-plugin-beatsaberscore --upgrade

使用 pip 更新

在 nonebot2 项目的根目录下打开命令行, 输入以下指令即可更新

pip install nonebot-plugin-beatsaberscore --upgrade

⚙️ 配置

配置项	必填	默认值	说明
BS_RETRIES	否	8	网络错误重试次数
BS_TIMEOUT	否	5	网络超时时间
COMMAND_START	否	[]	响应前缀设置
BS_LIMIT_CACHE	否	1500	缓存图片个数限制
BS_FAST_DOWNLOAD	否	True	并发下载开关

PS:最好是有科学上网,如果没有,BS_RETRIES向建议调至6以上

🎉 使用

如果设置了响应前缀,使用以下命令的时候不要忘记加上响应前缀

可以发送BS help或BS帮助获取帮助(其实也就导航到这里力)

BS绑定 + SteamID 绑定SteamID,绑定ID才可以查分,也可发送BS bind,等效BS绑定

[!NOTE] 先绑定SteamID再查分!!!

ScoreSaber查分

s40,ss40,SS查分,SS score都可用于触发查分指令

BeatLeader查分

b40,bl40,BL查分,BL score都可用于触发查分指令

BeatLeader&ScoreSaber查分
BS查分,bs查分,双倍快乐

Song_ID查歌

可用bsr进行查歌(在COMMAND_START选项中配置 ! 可使用!bsr查歌)
发送BS search + 歌曲的ID或者bs查歌 + 歌曲的id可以查询歌曲的信息

Song计算准度

[!NOTE] 此功能尚未完善,暂不放出来用了(我是菜逼)

SteamID是什么?

在登入beatleader.xyz后打开个人信息(也可打开Scoresaber,Steam账户网址,操作是一样的)

这个就是你的SteamID辣(即使ID不是纯数字也是可以用的)

✨ 未来规划

• 添加对ScoreSaber的查分支持
• 重做优化查分图
• 优化运行速度,使用线上+本地缓存来提高响应速度
• 定时推送beatsaver的新曲,渲染新曲图片
• 给自制谱投票功能
• 歌曲的推荐

📝 更新日志

1.4.2

• 修复 某些ID绘制歌曲缺失&无法绘制的Bug
  
• 优化 增加异步并发,大幅缩短第一次查分所需时间,增强插件性能(可在配置中选择是否需要开启)

📌往期更新内容

1.3.7

更新内容

- 更新 查歌提供ScoreSaber排位曲星评
- 更新 查歌命令
- 修复 查歌错误插入响应命令

1.3.5

更新内容

- 新增 缓存管理机制
- 更新 星评图标
- 修复 对Windows系统环境下的一些报错问题
- 修复 生成图片异常过大问题

1.3.2

更新内容

- 修复 ScoreSaber查分运行性能问题
- 修复 一处小问题

1.2.7 ----混沌

更新内容

- 新增 缓存机制(提升插件性能)
- 更新 SS+,SS,S,A准度评级图标
- 修复 A评级的准度区间
- 修复 ScoreSaber获取歌曲id缺失问题
- 修复 之前极少数用户查分报错问题(已找到原因)
- 修复 准度评级图标的偏移值
- 修复 ScoreSaber&BeatLeader并发查分的报错
- 优化 删除大量无意义循环,大幅精简代码
- 优化 查分图和消息响应的一些细节
- 以及一个大胆的尝试

1.1.4 ----大道至简

更新内容

- **大幅改动排版,全面重绘查分图!!!**
- 更新 ~~简陋的歌曲准度计算~~
- 更新 指令触发细节优化,对一些地方进行细节优化
- 新增 SS+,SS,S,A的准度评级
- 新增 左|右手准度数据(现阶段仅支持beatleader)
- 更改 下调pyproject.toml的httpx,pillow版本依赖
- 添加 b40,s40指令触发

0.9.7.post2

更新内容

- 修复 [#2](https://github.com/qwq12738qwq/nonebot-plugin-beatsaberscore/issues/2)

0.9.7

• 修复 #2
  
• 更改了下存储数据的逻辑

0.9.6

更新内容

- 新增 [ScoreSaber的查分支持](https://github.com/qwq12738qwq/nonebot-plugin-beatsaberscore/issues/1)
- 修复 绑定错误ID时返回的一些错误信息进行修正

0.9.3

更新内容

- 增加了歌曲id的搜歌功能

0.9.0

更新内容

- 完成基础的beatleader查分

🗨️ PS

之后的某些更新可能需要借助BeatLeader完成对ScoreSaber查分图的优化

如果你有更好的想法和建议,随时欢迎提出issues~(●´∀｀●)

可以的话,给个小小的star~,你的star会让我获得happy buff♪（＾∀＾●）ﾉｼ

💡 鸣谢

Homo大佬 ----核心成员,负责本项目的美术ヾ(´▽‘)ﾉ

Nonebot框架

🎨 效果

enjoy~(●′ω`●)

🚧 测试

测试环境
Windows-Server-2025 Unraid-6.11.5 Docker-20.10.21 Ubuntu-24.04 python-3.12.3 nonebot2-2.3.0 httpx-0.23.1 pillow-10.4.0