MajsoulMax 雀魂配置文件完全指南:settings.yaml 与 settings.mod.yaml 全部参数详解
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/ 下。
✅ 修改配置的正确姿势
- 先按
Ctrl+C停止程序 - 用文本编辑器修改
config/下对应文件(建议保持 YAML 缩进格式) - 重新启动 MajsoulMax(源码方式:
mitmdump -p 23410 -s addons.py) - 角色、皮肤、装扮页等日常切换无需改文件,游戏内操作后自动回写
- 若启动时提示"更新失败",通常是 liqi 资源更新异常,可稍后重试或在 settings.yaml 中填入
github_token
❓ 常见问题
Q:为什么 config/ 下没有 settings.mod.yaml?
A:启用 mod 插件后才会生成;如果 plugin_enable 中对应插件为 false,相应配置文件不会出现。
Q:改了配置文件为什么不生效?
A:settings.yaml、settings.mod.yaml 等修改后都需要重启程序才会生效。
Q:解锁的角色别人能看到吗? A:不能。解锁仅在本地生效,其他玩家看到的仍是你的原角色,发表情也是原角色的表情。
⚠️ 使用本工具存在账号被官方检测的风险,请自行评估、谨慎使用,并仅作学习交流。