MajsoulMax 雀魂配置文件完全指南:settings.yaml 与 settings.mod.yaml 全部参数详解

原创2026-10-25 10:19:271,348 阅读
文章标签:网络安全应用安全逆向工程游戏开发

MajsoulMax 雀魂配置文件完全指南:settings.yaml 与 settings.mod.yaml 全部参数详解

雀魂 MAX(MajsoulMax)是一款基于 mitmproxy 的开源免费工具,可解锁雀魂全角色、皮肤、装扮等。它的行为几乎完全由 config/ 目录下的 YAML 配置文件驱动,其中最重要的是 config/settings.yaml 与 config/settings.mod.yaml。本文带你逐条读懂这两个文件的全部参数,快速完成个性化配置。

📁 配置文件在哪里?什么时候生成?

所有配置文件都位于项目根目录的 config/ 文件夹下,首次运行程序时自动生成默认配置(主入口见 addons.py):

配置文件 作用 生成条件
config/settings.yaml 主配置:插件总开关 + liqi 更新设置 首次运行自动生成
config/settings.mod.yaml mod 插件配置:角色、皮肤、装扮等 启用 mod 插件后生成
config/settings.helper.yaml helper 插件配置:小助手地址 启用 helper 插件后生成
config/settings.replace.yaml replace 插件配置:资源替换规则 启用 replace 插件后生成

💡 注意:这些文件是运行时生成的,仓库里默认只有 config/max_data.yaml。另外程序会自动回写配置——你在游戏内切换看板娘、换皮肤等操作,都会被直接保存到 settings.mod.yaml。

⚙️ settings.yaml:主配置参数详解

settings.yaml 是主程序配置文件,包含两大块:plugin_enable(插件开关)和 liqi(消息解析更新)。

plugin_enable:三大插件总开关

# 插件配置,true为开启,false为关闭
plugin_enable:
  mod: true
  helper: false
  replace: false
参数 默认值 说明
mod true 核心插件,解锁全部角色、皮肤、装扮等,对应 plugin/mod.py
helper false 将对局数据发送至雀魂小助手 mahjong-helper,不用小助手请勿开启
replace false 替换游戏资源文件(仅支持网页版),见 plugin/replace.py

liqi:消息解析与自动更新

liqi:
  auto_update: true
  github_token: ''
  liqi_version: 'v0.11.210.w'
  liqi_hash: 'bda101be...'
参数 默认值 说明
auto_update true 启动时是否自动检测并更新 liqi 文件(见 plugin/update.py)
github_token '' 可选,填入自己的 GitHub Token 以避免 API 额度用完导致更新失败;仅限自用,切勿泄露
liqi_version 当前版本号 本地 liqi 文件的版本号,程序会自动回写
liqi_hash 文件哈希 本地 liqi 文件的哈希值,用于校验

liqi 文件(liqi.json、liqi.desc 等)存放在 proto/ 目录,用于解析雀魂的 protobuf 消息。游戏更新后若 liqi 未及时更新,会导致部分新消息(如新活动)无法解析。

🎭 settings.mod.yaml:mod 配置参数逐条解读

这是 mod 插件的配置文件,由 plugin/mod.py 管理。大多数参数直接在游戏内操作即可,程序会自动保存;只有无法在游戏内设定的项才需要手动修改此文件。

角色与皮肤

参数 默认值 说明
character 200001 当前看板娘(主角色)的角色 ID,游戏内切换会自动写入
characters {} 各角色使用的皮肤,键为角色 ID、值为皮肤 ID,如 200001: 400101
random_character.enabled false 对局随机角色皮肤开关,开启后每局随机抽一个角色+皮肤
random_character.pool [] 随机候选池,元素为 character_id / skin_id 组合;开启随机时不能为空

名称与身份标识

参数 默认值 说明
nickname '' 自定义显示名,非空时覆盖你的真实昵称(仅本地可见)
verified 0 身份标识:0 无标识、1 主播标识、2 Pro 标识,显示在名字后面
show_server true 在其他玩家名字前加 [CN]/[JP]/[EN] 服务器前缀
anti_replace_nickname true 强制关闭服务器端"将玩家替换为默认名称"的功能,特殊时期必备

装扮、称号与加载 CG

参数 默认值 说明
star_chars [] 星标角色列表(按顺序排列)
title 0 当前使用的称号 ID,游戏内选用后自动写入
loading_image [] 加载界面使用的 CG 图片 ID 列表
views(0~9) [] 10 个装扮页,每页是一组 slot / type / item_id 槽位数据
views_index 0 当前正在使用的装扮页编号

对局行为

参数 默认值 说明
bianjietishi false 强制启用便捷提示(宝牌指示、和牌指示等);开启后进入王座房间左上角会显示"玉之间",属正常现象
emoji false 解锁角色全部附加表情。⚠️ 官方不推荐开启:没有额外表情的角色却发送额外表情,行为异常容易被注意
safe_mode false 地铁模式:将对局中所有角色(含电脑)统一替换为初始形象,避免暴露你的真实角色

资源与数据

参数 默认值 说明
resource.auto_update true 自动更新 lqc.lqbin 游戏资源文件
resource.lqc_lqbin_version 当前版本号 本地 lqc.lqbin 文件的版本标识
mod {} 解析出的游戏资源数据(角色、物品、称号等完整清单),不建议修改,除非你要深度自定义

角色、皮肤、称号等完整资源清单实际维护在 config/max_data.yaml,由 lqc.lqbin 自动更新。

📦 helper 与 replace 配置速览

config/settings.helper.yaml(helper 插件):

参数 默认值 说明
api_url https://localhost:12121/ 雀魂小助手的接收地址,未换过地址则无需修改

config/settings.replace.yaml(replace 插件,仅网页版):

参数 默认值 说明
http [] 需要替换的 HTTP 资源路径片段,按路径后缀匹配,可跨语言服生效
lq [] 需要替换的 lq 资源列表

被替换的文件需按路径结构放入 replace/ 目录,例如把 spine.skel.txt 配为 /charactor/you_BL/spine/spine.skel.txt,文件就放在 replace/charactor/you_BL/spine/ 下。

✅ 修改配置的正确姿势

  1. 先按 Ctrl+C 停止程序
  2. 用文本编辑器修改 config/ 下对应文件(建议保持 YAML 缩进格式)
  3. 重新启动 MajsoulMax(源码方式:mitmdump -p 23410 -s addons.py)
  4. 角色、皮肤、装扮页等日常切换无需改文件,游戏内操作后自动回写
  5. 若启动时提示"更新失败",通常是 liqi 资源更新异常,可稍后重试或在 settings.yaml 中填入 github_token

❓ 常见问题

Q:为什么 config/ 下没有 settings.mod.yaml? A:启用 mod 插件后才会生成;如果 plugin_enable 中对应插件为 false,相应配置文件不会出现。

Q:改了配置文件为什么不生效? A:settings.yaml、settings.mod.yaml 等修改后都需要重启程序才会生效。

Q:解锁的角色别人能看到吗? A:不能。解锁仅在本地生效,其他玩家看到的仍是你的原角色,发表情也是原角色的表情。

⚠️ 使用本工具存在账号被官方检测的风险,请自行评估、谨慎使用,并仅作学习交流。

登录后查看全文
MajsoulMax