如何用Majsoul_bot打造你的专属雀魂QQ助手？新手必备的功能全解析 🀄️

【免费下载链接】Majsoul_bot 适用于HoshinoBot下的雀魂QQ机器人插件。可进行近期对局查询、对局监测、查询个人数据等功能，更多功能正在扩展 项目地址: https://gitcode.com/gh_mirrors/ma/Majsoul_bot

Majsoul_bot是一款基于HoshinoBot框架的雀魂QQ机器人插件，专为《雀魂Majestic Souls》玩家设计，提供战绩查询、对局订阅、抽卡模拟等实用功能，让你轻松掌握游戏动态，提升社交互动体验。

🌟 为什么选择Majsoul_bot？核心功能一览

作为雀魂玩家的得力助手，Majsoul_bot整合了多项实用功能，覆盖从数据查询到社交互动的全场景需求：

📊 战绩查询模块：全方位掌握你的牌技数据

基于雀魂牌谱屋API，提供金之间及以上场次的详细数据统计：

• 个人总体数据：涵盖对局总数、胜率、放铳率、平均位次等核心指标
• 段位场细分：可单独查看金之间/玉之间等特定场的表现数据
• 近期牌谱：调取最近5场对局的详细记录，复盘分析好帮手

图：Majsoul_bot的基本数据查询界面，清晰展示玩家核心战绩指标

🔔 对局订阅系统：实时掌握好友动态

通过绑定游戏昵称实现对局监控，当订阅对象完成对局时自动推送结果到QQ群，不错过任何一场高手对决。订阅管理简单直观，支持开启/删除订阅：

图：订阅控制界面，可轻松管理对局监控设置

🎰 趣味功能合集：不止于查数据

• 抽卡模拟器：还原游戏内卡池机制，支持联动UP池切换（功能源码）
• 麻兜猜手牌：根据提示猜手牌组合的互动小游戏（游戏素材）
• 天凤牌理分析：提供专业的牌效率建议（不含七对子与国士无双）

🚀 3步快速上手Majsoul_bot

1️⃣ 环境准备

确保已安装：

• Python 3.8+
• HoshinoBot V2.0.0+
• go-cqhttp 1.0.0+

2️⃣ 一键安装流程

在HoshinoBot的modules目录执行：

git clone https://gitcode.com/gh_mirrors/ma/Majsoul_bot
pip install -r requirements.txt

3️⃣ 简单配置

1. 编辑HoshinoBot/hoshino/config/__bot__.py，在MODULES_ON中添加Majsoul_bot
2. 重启HoshinoBot，邀请机器人入群即可使用

⚠️ 注意：所有数据来源于雀魂牌谱屋，仅统计2019年11月29日后的金场及以上对局

💡 实用功能详解

📈 如何精准分析自己的牌谱数据？

1. 在QQ群发送查询指令获取个人数据
2. 重点关注"放铳率"和"平均顺位"指标
3. 通过"近期对局"功能复盘关键场次

图：详细数据界面展示段位场细分数据，助你针对性提升

🤖 自定义你的机器人

开发者可通过修改配置文件调整功能参数，或基于现有模块进行二次开发：

• 订阅逻辑：Subscription/RecordLoader.py
• 图像处理：mahjong_handle/imghandler.py

❓ 常见问题解答

Q: 为什么查询不到我的数据？

A: 牌谱屋仅收录金之间及以上场次，请确保：

1. 已在金场以上完成至少一场对局
2. 游戏昵称与查询时输入一致
3. 数据同步可能延迟10-15分钟

Q: 如何开启对局播报？

A: 在群内发送"订阅+游戏昵称"即可，取消订阅发送"取消订阅+游戏昵称"

🎯 总结

Majsoul_bot通过轻量化的设计，为雀魂玩家提供了一站式的数据查询与社交互动解决方案。无论是想提升牌技的认真玩家，还是喜欢趣味互动的休闲用户，都能在这里找到适合自己的功能。立即部署体验，让这款开源工具成为你的雀魂社交新纽带！

项目遵循AGPL-3.0开源协议，持续更新中，欢迎提交Issue和PR参与共建

【免费下载链接】Majsoul_bot 适用于HoshinoBot下的雀魂QQ机器人插件。可进行近期对局查询、对局监测、查询个人数据等功能，更多功能正在扩展 项目地址: https://gitcode.com/gh_mirrors/ma/Majsoul_bot