转发规则配置
转发规则通过 POST /forward/add 提交,分为三类:用户规则、机台行为规则、机台配置规则。
参数说明:
rule为规则 Key,enable控制开关,value为具体参数值。机台相关规则必须附带clientId。
获取当前规则
POST/forward/get
加载当前账号配置的所有转发规则。机台模式下需填入 clientId。
| 参数名 | 类型 | 说明 |
|---|---|---|
token | string | Token |
clientId | string | 机台 ID(可选) |
clientPwd | string | 机台密码(可选) |
删除规则
POST/forward/del
重置某条规则为默认不生效状态。
| 参数名 | 类型 | 说明 |
|---|---|---|
token | string | Token |
rule | string | 规则 Key |
第一类:用户规则
这类规则直接关联玩家个人账号,登录即生效,与机台无关。
| 规则 Key | 默认值 | 说明 |
|---|---|---|
LogonMachineList | 空 | 绑定的游玩机台加密 ID,英文逗号分隔 |
fixUserName | 舞萌DX2025 | 游戏内显示的用户名,请勿使用违禁词 |
fixRegionName | 广东 | 上传数据时使用的省份(如:北京、广东) |
fixAuthTime | 114514 | 自定义机台 Auth 时间戳,配合解禁小黑屋使用 |
fixLoginState | 禁用 | 强制规避官服小黑屋,数据先缓存于转发服 |
fixDisableAutoBlackRoomSolution | 禁用 | 控制是否自动尝试解禁小黑屋 |
fixBanState | 0 | 娱乐功能,修改显示的封禁状态(不影响官服) |
fixInheritLastLoginDate | 禁用 | 是否继承服务器数据的最后登录时间 |
fixRival | 11451419,11451420 | 自定义 Rival 对手 UserID,逗号分隔 |
fixForceGetRival | 禁用 | 强制拉取 Rival 数据,解决 1.35-1.45 版本兼容问题 |
fixDisableEmptyRival | 禁用 | 禁用后不向客户端返回空 Rival 数据 |
fixKaleidxScopeKey | 1,2,3,4 | 自定义下发万花筒钥匙,逗号分隔 |
fixForceSetPartner | 1 | 强制设置指定的搭档 ID |
fixAutoFixTicket | 0 | 自动修复游戏内的票据错误 |
fixUnlockCHNMusic | 禁用 | 解锁国服目前所有乐曲 |
fixUnlockHOTMusic | 禁用 | 解锁内测服较新较热乐曲 |
fixUnlockALLMusic | 禁用 | 解锁内测服目前全部乐曲 |
fixLockFanmadeMusic | 禁用 | 强制锁定并隐藏自制谱乐曲 |
fixUploadHighVersionUserData | 禁用 | 高版本客户端上传时不覆盖原始数据,防止污染 |
fixForceUploadItemAndMapDataForDifferentVersion | 禁用 | 跨版本拉取时强制不上传物品和跑图数据 |
fixLastDataVersion | 空 | 下拉数据时账号显示的数据版本号 |
fixLastRomVersion | 空 | 下拉数据时账号显示的 ROM 版本号 |
fixUploadDataVersion | 空 | 保存数据时上传的数据版本号 |
fixUploadRomVersion | 空 | 保存数据时上传的 ROM 版本号 |
fixSpecialClientPassword | 空 | 自定义内测机台公钥,逗号分隔 |
fixTestSwallowCookies | 禁用 | 测试功能,始终显示"吞饼干"弹窗 |
fixTestEmptyMusic | 禁用 | 返回空的音乐数据(调试用) |
fixTestEmptyItem | 禁用 | 返回空的物品数据(调试用) |
fixTestEmptyMap | 禁用 | 返回空的地图数据(调试用) |
fixTestEmptyCharacter | 禁用 | 返回空的角色数据(调试用) |
fixTestEmptyLoginBonus | 禁用 | 返回空的登录奖励数据(调试用) |
fixTestEmptyCharge | 禁用 | 返回空的充值数据(调试用) |
POST/forward/add
添加或更新一条用户规则。
| 参数名 | 类型 | 说明 |
|---|---|---|
token | string | Token |
rule | select | 规则名称 |
enable | boolean | 启用 |
value | string | 参数值 |
第二类:机台行为规则
以 fixClientBehavior 开头,控制机台客户端与服务器的交互行为,需填入 clientId。
| 规则 Key | 默认值 | 说明 |
|---|---|---|
fixClientBehaviorEnableForwardRules | 1(启用) | 控制该机台是否应用用户规则,关闭则进入纯转发模式 |
fixClientBehaviorEnablePassword | 0(禁用) | 启用后编辑此机台行为规则必须验证密钥 |
fixClientBehaviorEnableUserName | 0(禁用) | 控制该机台是否允许修改用户名功能 |
fixClientBehaviorEnableCamera | 0(禁用) | 远程控制该机台摄像头是否启用 |
fixClientBehaviorEnableMai2LinkQRCode | 0(禁用) | 控制是否支持 Mai2Link 生成的二维码/访问码登录 |
fixClientBehaviorEnableUnlockMusic | 0(禁用) | 控制该机台是否允许乐曲解禁功能 |
fixClientBehaviorEnableOffline | 不启用断网规则 | 控制机台是否开启黑屋/离线功能 |
POST/forward/add
添加或更新一条机台行为规则。需填入机台 ID。
| 参数名 | 类型 | 说明 |
|---|---|---|
token | string | Token |
rule | select | 规则名称 |
enable | boolean | 启用 |
value | string | 参数值 |
clientId | string | 机台 ID |
clientPwd | string | 机台密码(可选) |
第三类:机台配置规则
以 fixMachine 开头,属于底层网络与安全配置,仅机台私钥登录后可见。
| 规则 Key | 默认值 | 说明 |
|---|---|---|
fixMachineConnectToOfficialServer | 禁用 | 强制直连官服,26年中旬后主分支必须开启,侧载版本必须关闭 |
fixMachineEnableMai2LinkVPN | 禁用 | 通过 Mai2Link 专用 VPN 连接游戏服务器 |
fixMachineEnableMai2LinkMachineProxy | 禁用 | 请求通过机台原生 IP 转发,会略微增加延迟 |
fixMachineUserWhiteList | [UserID](UserName) | 白名单,只有列表内 UserID 或持密钥用户可游玩,设为 ALL 允许所有人 |
fixMachineUserBlackList | [UserID](UserName) | 黑名单,优先级高于白名单 |
fixMachineBanMusicList | 1,2,3 | 在该机台被 Ban 的内测乐曲 ID,逗号分隔 |
fixMachineLockFanmadeMusic | 禁用 | 在该机台彻底锁定并隐藏自制谱乐曲 |
fixMachineDisableAutoAddUserWhiteList | 禁用 | 禁用后新玩家登录不会自动进入白名单 |
fixMachineHOTCache | 禁用(直传国服) | 内测用户上传时是否过滤最新热门歌曲存入转发服 |
fixMachineLastDataVersion | 空 | 机台级数据版本号强制覆盖 |
fixMachineLastRomVersion | 空 | 机台级 ROM 版本号强制覆盖 |
fixMachineUploadDataVersion | 空 | 机台级上传数据版本号 |
fixMachineUploadRomVersion | 空 | 机台级上传 ROM 版本号 |
POST/forward/add
添加或更新一条机台配置规则。仅机台账号可操作。
| 参数名 | 类型 | 说明 |
|---|---|---|
token | string | Token |
rule | select | 规则名称 |
enable | boolean | 启用 |
value | textarea | 参数值(textarea) |
clientId | string | 机台 ID |
clientPwd | string | 机台密码(可选) |