移植自mai-bot 开源项目,基于 HoshinoBotV2 的街机音游 舞萌DX 的查询插件
项目地址:https://github.com/Yuri-YuzuChaN/maimaiDX
2025-08-16
-
修改别名推送机制,请各开发者进行取舍
- 更新别名推送设置与指令,新增了
maimaidxaliaspush
配置项,该设置将替代原先group_alias_switch.json
文件的global_switch
配置项 - 当设置为
false
时,不再连接别名推送服务器,如果群组的推送为开启状态,也不再进行推送,与原先一致。申请的别名通过审核了也不再推送
{ "enable": [], "disable": [88888888], "global_switch": false // 该配置项将被代替并删除 }
- 不会接收到别名申请以及别名通过的消息,如果服务器新增新的别名时无法实时获取最新的别名,仅能手动更新别名库。
- 更新别名推送设置与指令,新增了
-
指令
全局开启/关闭别名推送
的功能将修改为开关全部群组的推送开关。 -
新增别名推送服务器代理地址,修改
maimaiDX/static/config.json
文件的maimaidxaliaspush
配置项即可,其实是忘记添加代理地址
首次使用请务必看完 README.MD
所有内容
- 不要再问为什么
资源文件
的plate
和rating
文件夹是空的或缺少文件 - 不要再问为什么
资源文件
的plate
和rating
文件夹是空的或缺少文件 - 不要再问为什么
资源文件
的plate
和rating
文件夹是空的或缺少文件
-
将该项目放在HoshinoBot插件目录
modules
下,或者clone本项目git clone https://github.com/Yuri-YuzuChaN/maimaiDX
-
下载静态资源文件,将该压缩文件解压后,将
static
文件夹复制到插件根目录并覆盖,即maimaiDX/static
-
配置可选项,请修改
maimaiDX/static/config.json
文件- 如果您拥有查分器的开发者
token
,请将token
填入文件中的maimaidxtoken
项 - 如果你的服务器或主机不能顺利流畅的访问查分器和别名库的API,请配置代理。均为香港服务器代理中转,例如你的服务器访问查分器很困难,请设置
maimaidxproberproxy
为true
,别名库同理 - 可选,是否将部分图片在保存在内存中,不需要请在设置
saveinmem
为false
- 可选,是否开启别名推送,不需要请设置
maimaidxaliaspush
为false
,注意,该配置为false
时,将不会实时更新别名库,仅会在别名查歌或者跨日更新数据的时候才会更新别名库。如果群组的推送为开启状态,也不再进行推送,推送指令也一并失效
{ "maimaidxtoken": "maimaidxtoken", "maimaidxproberproxy": true, "maimaidxaliasproxy": false, "maimaidxaliaspush": true, "saveinmem": false }
- 如果您拥有查分器的开发者
-
安装插件所需模块:
pip install -r requirements.txt
-
安装
chromium
,相关依赖已安装,请直接使用该指令执行playwright install --with-deps chromium
-
安装
微软雅黑
字体,解决使用ginfo
指令字体不渲染的问题,例如ubuntu
:apt install fonts-wqy-microhei
,windows
平台可跳过 -
在
config/__bot__.py
模块列表中添加maimaiDX
-
重启HoshinoBot
2025-08-16
-
修改别名推送机制,请各开发者进行取舍
- 更新别名推送设置与指令,新增了
maimaidxaliaspush
配置项,该设置将替代原先group_alias_switch.json
文件的global_switch
配置项 - 当设置为
false
时,不再连接别名推送服务器,如果群组的推送为开启状态,也不再进行推送,与原先一致。申请的别名通过审核了也不再推送
{ "enable": [], "disable": [88888888], "global_switch": false // 该配置项将被代替并删除 }
- 不会接收到别名申请以及别名通过的消息,如果服务器新增新的别名时无法实时获取最新的别名,仅能手动更新别名库。
- 更新别名推送设置与指令,新增了
-
指令
全局开启/关闭别名推送
的功能将修改为开关全部群组的推送开关。 -
新增别名推送服务器代理地址,修改
maimaiDX/static/config.json
文件的maimaidxaliaspush
配置项即可,其实是忘记添加代理地址
2025-06-11
-
- 更新
舞萌DX2025
,资源全部更换,更新部分依赖和文件
- 更新
2025-03-28
- 预更新
舞萌DX2025
UI - 修改所有
BOT管理员
私聊指令为群聊指令:更新别名库
、更新maimai数据
、更新定数表
、更新完成表
2024-07-24
- 更新部分牌子完成表和
SyncPlay
图片 - 修复
新增机厅
指令id
未增加的问题 - 修复
牌子进度
指令sync
未匹配的问题 - 修复
别名查歌
指令查询到已删除的曲目时发生错误的问题
2024-06-07
- 更新至
舞萌DX 2024
- 更换所有图片绘制,需删除除
json
后缀的所有文件,请重新进行使用方法第二步 - 更改部分
json
文件名称,便于识别,具体文件如下,请务必修改文件名,否则开关文件以及本地别名文件将不会被读取all_alias.json
修改为music_alias.json
local_alias.json
修改为local_music_alias.json
chart_stats.json
修改为music_chart.json
group_alias.json
修改为group_alias_switch.json
guess_config.json
修改为group_guess_switch.json
- 新增管理员私聊指令
更新完成表
,用于更新BUDDiES
版本双系
牌子 - 新增指令
完成表
,可查询牌子完成表,例如:祝极完成表
- 新增指令
猜曲绘
- 查看谱面支持计算个人加分情况,指令包括
是什么歌
,id
- 指令
mai什么
支持随机发送推分谱面,指令中需包含加分
,上分
字样,例如:今日mai打什么上分
- 修改指令
分数列表
和进度
发送方式 - 优化所有模块
2024-03-12
- 变更别名服务器地址
- 修改所有别名请求以及参数
- 开放普通用户申请别名
2024-01-14
- 优先使用本地谱面
- 使用
numpy
模块重新绘制定数表
2023-09-23
- 重写
API
方法 - 重写机厅模块
- 将同步生成定数表方法修改为异步方法,防止堵塞进程
- 将
当前别名投票
发送方式修改为图片形式 - 本地添加别名单独存储为一个文件,不再添加在暂存别名文件中
2023-08-10
- 新增后缀指令
定数表
,完成表
,查询指定等级的定数表和完成表,例如:13+完成表
- 新增BOT管理员私聊指令
更新定数表
,用于生成和更新定数表 - 新增BOT管理员私聊指令
更新maimai数据
,用于版本更新手动更新bot已存数据 - 拆分并移除
maimaidx_project.py
的代码和文件,便于所有功能维护 - 修复曲绘不存在时下载错误的问题
- 修复猜歌提前发出答案的bug
- 修改指令
minfo
部分绘图
2023-06-15
- 新增添加本地别名的功能
2023-06-09
- 更新至
舞萌DX 2023
- 移除指令
b40
- 更换静态资源
- 修改指令
b50
部分绘图
2023-04-22
- 限制所有网络请求时长
- 新增别名文件本地备份
- 新增ginfo指令默认使用紫谱数据
2023-04-21
- 新增BOT管理员私聊指令
全局关闭别名推送
和全局开启别名推送
,关闭所有群的推送消息,无论先前开启还是关闭 - 修复新版本更新后API暂未收录曲目的问题
- 新增乐曲游玩总览
ginfo
指令 - 新增猜歌库根据乐曲游玩次数添加
- 新增每日更新机厅信息,删除旧版更新机厅机制
2023-04-15
- 将获取数据的方式由启动Bot时获取改为连接到CQHTTP后获取
- 修复因查分器API内容变动而无法启动Bot的问题
2023-03-29
- 重制
b40/b50
,minfo
和曲目信息的绘图 - 修改投票网页端,改成共用网站
- 修改垃圾代码
2023-03-02
- 新增
开启别名推送
和关闭别名推送
指令
2023-02-25
- 修复猜歌答对后无法结束的问题
2023-02-23
- 投票网页端
2023-02-22
- 修复启动BOT时无法获取所有曲目信息的问题,添加本地缓存
- 修改别名库,使用API获取和添加,并同步所有使用该插件的BOT
- 修改猜歌和别名功能
- 新增指令
当前别名投票
和同意别名
2023-2-18
- 别称同步临时解决方案 #47
2023-2-15
- 更新本地缓存水鱼网数据 #43
2022-9-14
- 新增查询单曲指令
minfo
- 修改查曲绘图
2022-8-30
- 修复新版b40/b50 isinstance bug #38
- 修复新版b40/b50 找不到图片问题
- 修复安慰分隐性bug
2022-08-27
- 修复b40/b50小数点后四位错误的问题
2022-08-25
- 修复猜歌模块发送曲绘时为未知曲绘的问题
2022-08-16
- 修改
b40/b50
指令绘图,如不喜欢请将libraries/maimaidx_project.py
第6
行maimai_best_50
改成maimai_best_40
- 修改查曲绘图
2022-07-11
- 修复指令
分数列表
没有提供2022谱面的问题
2022-06-23
- 支持2022
- 修改所有曲绘后缀
- 修改获取在线文件的路径
2022-03-10
- 新增段位显示,感谢 Kurokitu 提供源码及资源
2022-02-13
- 修复部分新曲没有难易度参考的问题
2022-01-27
- 修复添加/删除别名无效的问题
2022-01-16
- 修复b40/b50查询@Ta人情况下无效的问题
2022-01-03
- 修改获取音乐数据的函数,不在使用同步进程
- 不再使用正则表达式获取@人员的QQ号
- 不再使用CQ码方式发送图片
- 修改大部分源码
2021-11-15
- 在请求获取maimaiDX数据的函数添加
@retry
装饰器,遇到请求数据失败的情况时重新尝试请求
2021-10-18
- 添加排卡功能,感谢 CrazyKid
2021-10-14
- 更新查看推荐的上分乐曲
- 更新查看牌子完成进度
- 更新查看等级评价完成进度
- 查看水鱼网站的用户ra排行
2021-09-29
- 更新b50、乐曲推荐功能,感谢 BlueDeer233
2021-09-13
- 更新猜歌功能以及开关,感谢 BlueDeer233
感谢 zhanbao2000 提供的 nonebot2
分支
感谢 CrazyKid 提供的源码支持
感谢 Diving-Fish 提供的源码支持
感谢 BlueDeer233 提供猜歌功能的源码支持
MIT
您可以自由使用本项目的代码用于商业或非商业的用途,但必须附带 MIT 授权协议。