nonebot-plugin-rikka 0.4.0

一个简简单单的舞萌机器人插件

Nonebot-Plugin-Rikka

一个简单的 NoneBot2 舞萌查询成绩插件

介绍✨

基于 Nonebot2 的舞萌DX的查分插件

看板娘: Rikka

功能🪄

✅ 支持游戏: 舞萌DX(Ver.CN 1.5x), 中二节奏(Not Plan yet.)

✅ 支持数据源: 落雪咖啡屋(未绑定的首选), 水鱼查分器

✅ 支持功能: 基础查分功能、拟合系数查询、曲目标签查询

指令列表🕹️

带有🚧标志的指令暂不可用或仍在开发中

指令	说明
.bind lxns|divingfish|maimai	[查分器相关]绑定游戏账号/查分器
.unbind lxns|divingfish|maimai|all	[查分器相关]解绑游戏账号/查分器
.source lxns|divingfish	[查分器相关]设置默认查分器
.b50	[舞萌DX]生成玩家 Best50
.r50	[舞萌DX]生成玩家 Recent 50（需绑定落雪查分器）
.ap50	[舞萌DX]生成玩家 ALL PERFECT 50
.pc50	[舞萌DX]生成玩家游玩次数 Top50
.minfo <id|乐曲名称|别名>	[舞萌DX]获取乐曲信息
.alias add <song_id> <别名>	[舞萌DX]添加乐曲别名（不会被 update 操作覆盖）
.alias update	[舞萌DX]从落雪查分器更新乐曲别名数据库
.alias query <id|乐曲名称|别名>	[舞萌DX]查询该歌曲有什么别名
.score <id|乐曲名称|别名>	[舞萌DX]获取玩家游玩该乐曲的成绩
.scorelist <level|achXX.X>	[舞萌DX]获取玩家对应等级/达成率的成绩列表
.update maisong|alias	[舞萌DX]更新乐曲或别名数据库
.今日舞萌	[舞萌DX]获取今日舞萌运势
.成分分析	[舞萌DX]获取基于 B100 的玩家成分分析
.舞萌状态	[舞萌DX]获取舞萌服务器状态
.推分推荐	[舞萌DX]生成随机推分曲目
.trend	[舞萌DX]获取玩家的 DX Rating 趋势 （需绑定落雪查分器）

安装🪄

你需要一个 Nonebot 项目环境，参考：快速上手

1. 安装 nonebot-plugin-rikka:

• 使用源代码安装：

  定位到插件目录，执行：

  git clone https://github.com/Moemu/Nonebot-Plugin-Rikka
  cd Nonebot-Plugin-Rikka
  pip install .
  

2. 获取资源文件：下载静态资源文件，并解压到 static 目录中: 私人云盘, OneDrive

3. 配置查分器开发者密钥，参考配置小节。

4. 运行 python -m playwright install chromium 来安装 playwright 浏览器环境，用于模拟浏览器请求游戏资源和获取舞萌状态页截图

5. 启动 Nonebot 项目并根据提示运行数据库迁移脚本

6. 更新乐曲信息：使用 SUPERUSER 账号执行指令: .update maisong 和 .alias update

7. （可选）如果需要支持乐曲标签，您需要自行获取来自 DXRating 的 combined_tags.json 并放置在 static 文件夹中

8. （可选）如果需要支持舞萌状态的获取，您需要自己搭建 Uptime kuma 服务或借助外部状态页

配置⚙️

使用 .env 文件中配置以下内容

lxns_developer_api_key

• 说明: 落雪开发者密钥

• 类型: str

divingfish_developer_api_key

• 说明: 水鱼查分器开发者密钥

• 类型: Optional[str]

• 默认值: None

static_resource_path

• 说明: 静态资源路径（类似于 Yuri-YuzuChaN/maimaiDX 的实现，你需要从 此处 获取游戏的资源文件，这将用于 Best 50 等的渲染）

• 类型: str

• 默认值: static

enable_arcade_provider

• 说明: 启用 Maimai.py 的机台源查询（需要将此值设置为 True 才可以查询 PC 数）

• 类型: bool

• 默认值: False

arcade_provider_http_proxy

• 说明: 机台源的代理地址(部分云服务器厂商的 IP 段被华立阻断，因此需要使用家用代理绕开限制)

• 类型: Optional[str]

• 默认值: False

maistatus_url

• 说明: 能够显示舞萌服务器状态的外部状态服务页面

• 类型: Optional[str]

• 默认值: None

关于🎗️

本项目基于 MIT License 许可证提供，涉及到再分发时请保留许可文件的副本。

本项目的产生离不开下列开发者的支持，感谢你们的贡献：

本项目同样是 MuikaAI 的一部分

Star History：