maimaiBot

一个基于 mirai 和 舞萌 DX 查分器 以及 Xray Bot 别名信息 编写的 maimai DX QQ 机器人插件。

本项目是在 Kotlin 平台对 mai-bot 项目大部分功能进行重新实现，旨在提高生成速度及降低部署门槛。

支持的功能

• b50
• 查歌
• XXX 是什么歌
• 谱面详情（例：紫id11154）
• 歌曲分数信息（例：info 潘）
• 随机歌曲（例：随个紫12+）
• 别名查询（例：11514有什么别名）
• 定数查歌
• 分数线
• 猜歌
• 随机推分金曲（例：mai什么加2分；随机推分金曲）
• 随机推分列表
• 牌子进度（例：晓极进度）
• 牌子完成表（例：橙将完成表）
• 等级进度（例：13ss+进度，11ap进度，10fdx进度，14clear进度）
• 等级完成表（例：13+完成表）
• 等级分数列表（例：14分数列表）

部署指南

点我下载

本插件开箱即用，只需和其他插件一样放入 MCL 或其他版本的 Mirai 控制台 的 plugins 目录即可。

如果您尚不清楚 Mirai 如何安装，请阅读 Mirai 官方教程 ，在安装好控制台后再安装本插件使用。

常见问题

插件指令完全没反应？

注意！！请不要给 *:* 权限，这会导致插件误认为该群禁用了所有功能。请删除 *:*。

如何在特定群关闭本插件功能？

在控制台输入 /perm grant g114514 maimaiBot:denyall，其中 114514 请替换成需要关闭插件的群号。

如何修改字体？

修改 config/xyz.xszq.maimai-bot/主题名/theme.yml 中的 fontName值即可。

如何更新歌曲别名？

对于更新了新版本的用户：删除 config/xyz.xszq.maimai-bot/aliases.csv 并重启即可更新成新版本内置的别名表。

本项目内置的别名来自 Xray Bot ，bot 在启动时会自动更新。如需手动增加别名，请修改 config/xyz.xszq.maimai-bot/aliases.csv，未来版本将会支持通过指令修改。

查不到任何歌曲谱面信息？

请检查 舞萌 DX 查分器 是否可以访问，同时请检查您的网络连接是否畅通，是否开启了无效的代理设置等。

更新插件后部分内容没更新或者有误？

请关闭 bot 后删除 config/xyz.xszq.maimai-bot 文件夹和 data/xyz.xszq.maimai-bot 文件夹。

配置文件

config/xyz.xszq.maimai-bot/settings.yml 为本插件的主配置文件，默认情况下无需修改。

配置各项说明如下：

• theme: portrait 设置要使用的 b40 / b50 主题名称。config/xyz.xszq.maimai-bot 下的各文件夹为主题文件夹，文件夹名即主题名。插件自带的 portrait 主题为竖式 b40 / b50 ，classical 为经典的横式 b40 / b50。
• multiAccountsMode: false 开启多账号登录支持。开启后如果 bot 多个号在一个群内时，对同一请求不会处理两次。
• coverSource: WAHLAP 封面下载源。如果无法下载或者没有更新后新增的曲子，请尝试改成 ZETARAKU。
• maidataJsonUrls: 封面下载源为 WAHLAP 时，包含图片文件名信息的 maidata.json 的下载地址。您可以根据网络情况更换为能访问的 GitHub Raw 镜像网址。
• zetarakuSite: ZETARAKU 下载源服务器地址。如果无法下载，请访问 maimai-songs 并用开发者工具获取新的服务器地址。
• xrayAliasUrl: 本插件的别名数据来自于 Xray Bot 公开的别名信息，设置该项值可以指定从何处获取最新别名。
• prefix: '' 设置命令的前缀。例如，设为 '/mai' 后，生成 b50 需要输入 /mai b50 才能调用
• enableMemCache: true 是否提前载入图片到内存。如果您内存不够或者堆栈设置偏小，可以将这项设为 false 避免 Java heap size 等爆内存的情况。
• hintOnGeneration: false 开启后将在生成 b50 或完成表时提醒现在正在生成中