Skip to content

xszqxszq/maimai-bot

Repository files navigation

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 或完成表时提醒现在正在生成中