雀魂Max-rs

本项目启发自MajsoulMax

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

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

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

🤔为什么重新造轮子

🥰优点

• 本项目使用Rust语言编写，相比Python有更好的性能和更小的体积（Python版经常因为延迟过高使用体验不佳）
• 使用了多线程异步处理，提高了性能
• 原生支持Windows、Linux、macOS、Android等多平台，只需下载二进制一键运行
• 支持Android客户端（通过Termux和NekoBox）

🥲缺点

• hudsucker相比mitmproxy，不支持上游代理，需要借助Clash
• 无法动态更新lq.rs，需要重新编译

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

📢用前须知

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

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

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

✈️Telegram频道&交流群

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

🥰当前功能

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

程序默认配置为启用helper、禁用mod。如需自定义，请修改.\liqi_config\settings.json中的mod_switch和helper_switch。

mod功能

• 解锁所有角色与皮肤
• 解锁所有装扮
• 解锁所有语音（报菜名）
• 解锁所有称号
• 解锁所有加载CG
• 解锁所有表情（不推荐开启）
• 强制启用便捷提示
  • 由于雀魂本身代码限制，王座无法正常启用便捷提示，因此，开启此功能后进入王座对局，左上角会变成“玉之间”。请注意，这不是BUG！
• 支持星标角色
• 自定义名称
• 显示玩家所在服务器
• TODO……

helper功能

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

🧐使用说明 (Windows)

1. 修改配置
   • 根据程序提示和自身需求修改
   • 在liqi_config/settings.json可以设置通用设置，包括Helper和Mod的开关——modSwitch与helperSwitch，false为关true为开
   • 在liqi_config/settings.mod.json可以设置Mod专有设置
2. 启动程序，直接运行可执行文件
3. 启动游戏，分为网页版和客户端/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
4. 登录游戏开始享受

macOS或Linux用户，可以参考Windows的步骤，步骤3有所不同。

如果你想使用Android版，默认你已经有足够的技术能力，这里不再赘述，只提几个关键词：Termux、NekoBox，并且只在线路1有效。

🤔Q&A

1. 为什么要自动更新liqi和lqc.lqbin？更新失败有什么影响？
   • liqi：
     • 共有3个文件，包括liqi.json和根据其生成的liqi.proto和liqi.desc，用于解析雀魂protobuf消息
     • 如果更新失败，可能会导致消息无法解析（如新活动的消息）
   • lqc.lqbin：
     • 用于获取全部角色、装扮、物品等游戏资源
     • 如果更新失败，可能会导致无法获取新资源（如新角色、物品等）
   • 如果自动更新失败，可以在AutoLiqi > Releases下载，并手动替换./liqi_config文件夹下的同名文件
2. 如何同时启用代理？
   1. 使用Clash Verge
   2. 关闭系统代理，开启服务模式、Tun模式
   3. （可选）打开局域网连接；进入系统设置>网络>代理，打开“使用代理服务器”，填入地址和端口（默认为 http://127.0.0.1 和 7897 ），注意地址前一定要加前缀
3. 还有其它问题？ 在上方加入我们的Telegram群

🛠️开发依赖

• Rust >= 1.80.0
• Protoc