jlower / majsoul-mod-mahjong-helper-mitmproxy

本项目用于将雀魂的牌局发到日本麻将助手mahjong-helper，还支持了本地解锁雀魂全部皮肤mod的功能，基于mitmproxy的中间人攻击方式，不支持牌谱分析。

雀魂MAX

雀魂解锁全角色、皮肤、装扮等，基于mitmproxy的中间人攻击方式，支持网页版和客户端/Steam端。

同时支持将雀魂的牌局发到日本麻将助手mahjong-helper，不支持牌谱分析。

本工具完全免费、开源，如果您为此付费，说明您被骗了！

🧭当前雀魂各服版本（实时更新）

📢用前须知

注意：解锁人物仅在本地有效，别人还是只能看到你原来的角色，发表情也是原来角色的表情。
比如使用新角色发第3个表情，实际上其他人看到的是原来角色的第3个表情。

魔改千万条，安全第一条。
使用不规范，账号两行泪。
本插件仅供学习参考交流，请使用者于下载24小时内自行删除，不得用于商业用途，否则后果自负。
本插件仅供学习参考交流，请使用者于下载24小时内自行删除，不得用于商业用途，否则后果自负。
本插件仅供学习参考交流，请使用者于下载24小时内自行删除，不得用于商业用途，否则后果自负。

警告：
雀魂游戏官方可能会检测并封号！
如产生任何后果与作者无关！
使用本脚本则表示同意此条款！

✈️Telegram频道&交流群

可以直接点击图片进入，也可以通过扫码进入。

☕请作者喝咖啡

点我为作者发电（爱发电，支持微信/支付宝）

点我为作者发电（Patreon，支持信用卡/Paypal）

再次重申：本程序完全免费使用，没有收费功能，请喝咖啡完全自愿，作者非常感谢您！

🥰当前功能

程序包含两部分：mod和helper，可以说是雀魂mod_plus和mahjong-helper-majsoul-mitmproxy的融合。

mod功能

• 解锁所有角色与皮肤
• 解锁所有装扮
• 解锁所有语音（报菜名）
• 解锁所有称号
• 解锁所有加载CG
• 支持星标角色
• 自定义名称
• 显示玩家所在服务器
• 显示主播/Pro标识
• TODO……

helper功能

• 将对局发送到mahjong-helper（雀魂小助手）

打开一个cmd界面，执行命令

需要打开多个cmd界面时，bat文件中添加多行就行。

start cmd /k “命令”

一个cmd界面执行多个命令

1. 以“&”隔开多个命令，不管前面的命令是否成功，后面的都会执行： start cmd /k "命令1 & 命令2 & 命令3"
2. 以“&&”隔开多个命令，前面命令执行成功时，后面才会执行： start cmd /k "命令1 && 命令2 && 命令3"
3. 以“||”隔开多个命令，前面命令执行失败时，后面才会执行： start cmd /k "命令1 || 命令2 || 命令3"

更简单的新使用方法

1. 要下载Proxy SwitchyOmega浏览器插件
2. 设置代理模式将网页流量代理到 http://127.0.0.1:23410 , 使用全皮肤程序前先选择设定好的代理模式
3. 全选并复制 ._用txt里面的命令启动_要把所有edge关了才能用.txt 文件里的所有命令
4. 打开cmd粘贴即可
5. mahjong-helper的源代码在./mahjong-helper-src文件夹里面
6. 默认不能使用代理科学上网，要用代理科学上网见Q&A🤔

新使用方法

1. 要把所有edge关了才能用，先把edge所有页面关掉，把edge后台进程也都杀掉，再从快捷方式启动，如果正常的话应该能看到一行字“你使用的是不受支持的命令行标志……”，这样就是成功了。见Q&A🤔
2. 全选并复制 ._用txt里面的命令启动_要把所有edge关了才能用.txt 文件里的所有命令
3. 打开cmd粘贴即可
4. mahjong-helper的源代码在./mahjong-helper-src文件夹里面
5. 默认不能使用代理科学上网，要用代理科学上网见Q&A🤔

🧐使用说明

1. 启动程序
   • 方式1（懒人模式）：在Releases里下载，解压后直接运行run.exe（Windows限定）
   • 方式2（源码运行）：通过git clone或其他方式下载源码到本地，在Python>=3.10环境下，打开命令行，在当前目录运行mitmdump -p 23410 -s addons.py启动程序（首次运行需pip install -r requirements.txt安装依赖）
2. 关闭程序，修改配置
   • 根据程序提示和自身需求修改
3. 需要安装mitmproxy证书，访问mitm.it下载并安装证书 或 google搜索：mitmproxy 安装证书 或 用Akagi项目的懒人包安装证书
4. 再次启动程序
5. 启动游戏，分为网页版和客户端/Steam端。
   • 如果要启动网页版：（限Chrome/Edge）
     • 在浏览器中禁用所有雀魂相关插件和脚本，彻底禁用或卸载代理相关插件（如Proxy SwitchyOmega）
     • 使用浏览器正常进入游戏一次
     • 关闭所有浏览器窗口，用任务管理器查看后台确保无进程残留
     • 将Chrome或者Edge的快捷方式 复制->粘贴 出现一个副本，对快捷方式副本 右键->属性->目标 的后面按一个空格后添加--proxy-server=127.0.0.1:23410 --ignore-certificate-errors https://game.maj-soul.com/1/ （如果要玩其他服务器则修改对应网址）
   • 如果要启动客户端/Steam端：
     • 启动到登录界面，不要登录
     • 如果已经自动登录进入，点击游戏右上角设置登出账号，回到登录界面
     • 运行Proxifier并配置
       • Profile > Proxy Servers > Add
       • Address: 127.0.0.1
       • Port: 23410
       • Protocol: HTTPS
       • 填写完后点击Check，确保看到Test 1下显示绿色的Test passed，其他的不用管
       • OK
     • Profile > Proxification Rules > Add
       • Name: 随便起个名字
       • Enabled: ✅
       • Applications: 根据你运行游戏的应用填写，例如Steam客户端填写jantama_mahjongsoul.exe
       • Action: Proxy HTTPS 127.0.0.1
       • OK
6. 登录游戏开始享受

🤔Q&A

1. 为什么要自动更新liqi和lqc.lqbin？更新失败有什么影响？
   • liqi：
     • 共有3个文件，包括liqi.json和根据其生成的liqi.proto和liqi.pb2.py，用于解析雀魂protobuf消息
     • 如果更新失败，可能会导致消息无法解析（如新活动的消息）
   • lqc.lqbin：
     • 用于获取全部角色、装扮、物品等游戏资源
     • 如果更新失败，可能会导致无法获取新资源（如新角色、物品等）
   • 如果自动更新失败，可以在AutoLiqi > Releases下载，并手动替换./proto文件夹下的同名文件
2. 还有其它问题？ 在上方加入我们的Telegram群
3. 为什么启动浏览器之后没有效果？
   • 关闭所有浏览器窗口后再启动带参数的浏览器。
4. 进不去游戏？
   • 先使用浏览器进入游戏一次，关闭后再启动带参数的浏览器。
   • 如果你正在使用代理，很可能是因为代理被覆盖而导致无法进入游戏，请看下一条。
5. 代理被覆盖了，不能使用梯子了怎么办？
   • 使用Clash的TUN模式
   • 或者在mitmproxy的启动参数中设置前置代理。例如，Clash默认端口为7890，则启动参数为：
     mitmdump -p 23410 -s addons.py --mode upstream:http://127.0.0.1:7890
6. 看不懂怎么办？出现错误怎么解决？出现其它问题？
   • 提issue或者加群！
7. 为什么不使用selenium之类的浏览器自动化，省去配置浏览器的麻烦？
   • 浏览器自动化的特征太多，极易被识别。为了雀魂的账号安全，不建议使用此方式。
8. 只支持浏览器吗？
   • 当然不是，也支持客户端和Steam！使用Proxifier或类似软件指向127.0.0.1:23410即可！