Skip to content

Home

Jump to bottom
黛笙笙 edited this page May 20, 2022 · 6 revisions

Majsoul_bot Wiki

丨前言&插件简介

一个雀魂信息查询 Bot 插件，该插件不包括本体，应该配合HoshinoBot并结合go-cqhttp使用：

项目地址：https://github.com/DaiShengSheng/Majsoul_bot

本插件数据来源于雀魂牌谱屋:https://amae-koromo.sapk.ch/

由于牌谱屋不收录铜之间以及银之间牌谱，故所有数据仅统计2019年11月29日后金场及以上场次的数据

这个项目使用的HoshinoBot的消息触发器，如果你了解其他QQ机器人框架的api(比如nonebot)可以只修改消息触发器就将本项目移植到其他框架

移植后转载及发布请标注本项目原地址，谢谢。

丨已实现的功能列表

丨战绩查询&订阅模块

基于雀魂牌谱屋提供的 API

  • 金之间以上的个人总体数据查询（包括总体对局信息、南场/东场个人的对局信息、放铳率、位次等）
  • 个人特定段位场的总体详细数数据查询（如个人在金之间/玉之间对局的的详细信息）
  • 金之间以上的个人牌谱查询（可查询近期个人最近五场的对局牌谱信息）
  • 对局信息订阅与播报（基于牌谱屋对绑定的昵称进行对局监控）

丨其他功能模块

  • 雀魂卡池的模拟抽卡（支持切换联动UP池）
  • 麻将猜手牌（麻兜，代码源自艾琳佬的插件）
  • 天凤牌理（不考虑国士无双与七对子）

丨安装

下面介绍HoshinoBot的安装方法

  1. 在 HoshinoBot\hoshino\modules 目录下使用以下命令拉取本项目
git clone https://github.com/Daishengsheng/Majsoul_bot.git
  1. 然后使用如下命令安装依赖
pip install -r requirements.txt
  1. 然后在 HoshinoBot\hoshino\config\_bot_.py 文件的 MODULES_ON 加入 Majsoul_bot
  2. 重启 HoshinoBot，进入机器人在的群聊，即可正常使用本插件。

丨指令列表

丨牌谱及个人数据查询

命令 说明 例
雀魂信息/雀魂查询 昵称 查询该昵称的基本对局数据(所有场次) 雀魂信息 天才麻将杏杏
三麻信息/三麻查询 昵称 查询该昵称的三麻的基本对局数据(所有场次) 三麻信息 天才麻将杏杏
雀魂信息/雀魂查询 (金/金之间/金场/玉/王座) 昵称 查询该ID在金/玉/王座之间的详细数据 雀魂信息 王座 天才麻将杏杏
三麻信息/三麻查询 (金/金之间/金场/玉/王座) 昵称 查询该ID在三麻金/玉/王座之间的详细数据 三麻信息 王座 天才麻将杏杏
雀魂牌谱/牌谱查询 昵称 查询该ID下最近五场的四麻对局信息 雀魂牌谱 天才麻将杏杏
三麻牌谱 昵称 查询该ID下最近五场的三麻对局信息 三麻牌谱 天才麻将杏杏

丨雀魂对局订阅

命令 说明 例
雀魂订阅 昵称 订阅该昵称在金之间以上的四麻对局信息 雀魂订阅 天才麻将杏杏
三麻订阅 昵称 订阅该昵称在金之间以上的三麻对局信息 三麻订阅 天才麻将杏杏
(取消/关闭)雀魂订阅 昵称 将该昵称在本群的订阅暂时关闭 关闭雀魂订阅 天才麻将杏杏
(取消/关闭)三麻订阅 昵称 将该昵称在本群的三麻订阅暂时关闭 关闭三麻订阅 天才麻将杏杏
开启雀魂订阅 昵称 将该昵称在本群的订阅开启 开启雀魂订阅 天才麻将杏杏
开启三麻订阅 昵称 将该昵称在本群的三麻订阅开启 开启三麻订阅 天才麻将杏杏
删除雀魂订阅 昵称 将该昵称在本群的订阅删除 删除雀魂订阅 天才麻将杏杏
删除三麻订阅 昵称 将该昵称在本群的三麻订阅删除 删除三麻订阅 天才麻将杏杏
雀魂订阅状态 查询本群的雀魂订阅信息的开启状态 雀魂订阅状态
三麻订阅状态 查询本群的雀魂三麻订阅信息的开启状态 三麻订阅状态

丨其他功能

命令 说明 例
牌理 手牌 查询手牌牌理（m为万、s为索、p为饼、z为字牌） 牌理 123m44567p578s123z
雀魂十连 来一发当前群内卡池的十连抽 雀魂十连
切换雀魂卡池 卡池名称 切换本群的雀魂卡池（当前up池、辉夜up池、天麻up池、标配池、斗牌传说up池、狂赌up池） 切换雀魂卡池 天麻up池
查看/当前雀魂卡池 查看本群当前生效的雀魂卡池 查看雀魂卡池
麻将猜手牌/开启麻兜 开始一局麻兜游戏 麻将猜手牌
结束猜手牌/结束麻兜 强制结束本群的麻兜游戏 结束麻兜

丨常见问题 Q&A

丨为何 Bot 启动时，报错类似No module named 'xxxxx'？

依赖未安装，使用命令pip install xxxxx即可.

若无效可尝试pip3 install xxxxx或者pip39 install xxxxx

丨为何我对局结束后 Bot 没有播报我的对局？

由于本插件使用的是牌谱屋的API，雀魂牌谱屋获取对局信息存在延迟，等待片刻即可。

丨为何查询不到我的个人信息？

由于牌谱屋只统计金之间以上的数据，请务必在查询或者订阅前在金之间对局一次，然后等待牌谱屋更新。

若还没有获取到相应信息，请再次进行查询。如果尝试几次都无法正常查询，请检查控制台后将报错截图提交到在issues当中

| 更新记录

2022-05-17

  • 更新了雀魂卡池的抽卡功能
  • 实现了雀魂up卡池的切换并更新了相应的图片资源

2021-10-19

  • 运用极其暴力的手段修复了一些低级的bug，并更新了雀魂魂天段位的记分方式

2021-06-01

  • 更新了三麻信息查询以及订阅功能

2021-05-31

  • 修复了由于获取订阅超时造成的Bot卡顿问题
  • 修复了长时间不启动对对局订阅更新失败的Bug
  • 将对局订阅播报更新为图片形式发送
  • 修复了订阅对局触发多条消息的Bug

2021-05-30

  • 新增了金之间以上的四麻群友对局订阅(迫害)功能（群友又吃四了.jpg
  • 修复了一些不为人知的bug

2021-05-27

  • 雀魂插件出生啦！初步实现了角色四麻数据的查询以及其牌谱的查询
  • 计划加入卡池(新建文件夹)以及三麻查询功能

| 感谢

Clone this wiki locally