majsoul-hook-mitm

mhm 使用 Proxinject 在雀魂客户端中注入 Socks5 代理

拦截 WebSocket 连接并使用 Protobuf 进行解析

通过修改和转发数据以实现以下功能：

• 兼容小助手
• 本地全皮肤
• 本地昵称
• 本地寻觅
• 随机星标皮肤
• 支持Akagi
• 自动打牌

用前须知

魔改千万条，安全第一条。

使用不规范，账号两行泪。

本插件仅供学习参考交流，

请使用者于下载 24 小时内自行删除，不得用于商业用途，否则后果自负。

支持平台

• 雀魂客户端

• 雀魂网页端

使用方法

安装配置 mhm 需求 Python >= 3.10

同步仓库

git clone https://github.com/lqgl/majsoul-hook-mitm && cd majsoul-hook-mitm

配置国内镜像源（可选）

python -m pip config set global.index-url https://mirror.nju.edu.cn/pypi/web/simple

安装依赖

python -m pip install --upgrade pip
python -m pip install -r requirements.txt
python -m playwright install chromium

使用 Akagi

到 Discord 下载 Akagi 提供的 bot.zip。 注: 网盘中除v2版本均可用，任选一个下载，确保 bot 目录里面有且只有下面四个档案：bot.py, libriichi.so, model.py, mortal.pth 其中如果你是apple芯片的话，需要自行替换对应架构的 libriichi.so 文件。

启动 mhm

python -m mhm

安装 mitmproxy 证书

首次启动 mhm 成功后，关闭它。 然后到用户目录 ~/.mitmproxy 安装证书

配置文件

首次启动 mhm 会自动生成配置文件 mhmp.json

可以编辑此文件以根据需求自定义设置，以下表格解释了 hook 可用的配置选项：

释义	键	可用值
启用全皮肤	enable_skins	true | false
启用小助手	enable_aider	true | false
启用伪寻觅	enable_chest	true | false
随机星标皮肤	random_star_char	true | false

有关代理模式

mhm.json 中默认代理模式为 "mode": ["regular"]。

使用 steam 雀魂客户端, 修改为: "mode": ["socks5"], "proxinject": { "name": "jantama_mahjongsoul", "set-proxy": "127.0.0.1:7878"}, 这里的7878端口是mitm监听的端口。

网页加载慢可尝试使用上游代理，可以更改为 "mode": ["upstream:http://127.0.0.1:7890/"], 示例为clash的7890端口。

特别感谢

• Akagi
• Avenshy
• PragmaTwice
• 747929791
• EndlessCheng

更新内容说明

本项目是 majsoul-hook-mitm 和 Akagi 的聚合版本。在 majsoul-hook-mitm 项目的基础上增加了对 Akagi 项目中 mortal 模型的支持与自动打牌功能支持，与 Akagi 项目中的不同是无美观好看的终端界面。