Skip to content

HomeArchbishop/majsoul-analyser

Repository files navigation

Majsoul-analyser 雀力展开!v2.x

2023-7 project started

23-08-18 修复了由于命令行应用造成的线程阻塞

23-12-3 发布Ma2: 重新组织业务逻辑。统一支持 Mjai Protocol。降低代码耦合度

【这个项目还在更新,请及时关注。有想法和 Bug 欢迎 issue。】

平台支持:

  • Darwin (MacOS)
  • Windows (test on Windows 11, works fine)
  • Linux 正在测试

游戏支持:

  • 雀魂 / Majsoul / MahjongSoul
  • 天凤 / Tenhou (正在开发)

【Notice】 考虑到下列原因,已停用Bot自动点击

  • 2024年夏季雀魂的一次界面升级

  • 自动点击的cv识别不准确

  • 可能的自动化鼠标检测(反作弊)

  • 未来对天凤(tenhou)等其他平台的完整支持

介绍

  • 自动提供帮助,处理麻将牌局

Usage

Step1 安装依赖

yarn run install:dependence

Step2 构建前端注入脚本

yarn run build:user

Step3dist/majsoul-analyser.user.js 脚本注入油猴/暴力猴中

Step4 开启后端服务

yarn start
# 直到出现 'Service started at port: xxxxx' 才真正开始

Step5 打开雀魂网页(国服)game.maj-soul.com

注意:一定要先启动服务,再进入游戏。由于雀魂服务器的消息特性,本程序不能从对局中途开始监听(但是刷新网页后重新进入可以)

例如:

(x) 开局摸完牌了 -> 开启助手

(√) 开局摸完牌了 -> 开启助手 -> 刷新网页重进牌桌

实现讲解

本程序由 Typescript 编写,用 vite 构建用户浏览器脚本,用 ts-node 运行服务端

  • 用户脚本,负责将雀魂的牌桌 WS 消息转发给服务端。目前仅转发对局消息,不转发Lobby类的消息。

  • 服务器由主入口启动,将收到的二进制消息转发给消息处理器(server/msgHandler.ts),通过雀魂消息解析器模块 (server/majsoul)、牌桌记录模块 (server/gameRecords)、分析器模块 (server/analyser)、自动操作模块 (server/bot)贯通处理

    雀魂消息解析器模块 (server/majsoul):解析雀魂的二进制消息,解析规则可能有更新而导致这一块解析出错,届时请及时提醒开发者更新。

    牌桌记录模块 (server/gameRecords):记录对局状态。因为雀魂的消息是流程化的,也就是每一条消息只会告诉前端这一步的动作,而非牌桌信息,所以需要记录流程。

    分析器模块 (server/analyser):暂时使用 mahjong-helper 包装了一个初级分析器,返回一些操作结果 (operations)

    自动操作模块 (server/bot):使用 opencv.js 识别桌面,并通过 robot.js 操作鼠标点击