关卡与语言素材维护
本页面向需要校准坐标、维护关卡数据或识别素材的使用者。修改前备份配置和自定义素材;源码路径以桌面程序仓库为准。
Hard 关卡数据维护
resources/common/hard_stages.json 维护各作品的 Hard 关卡信息,格式:
{
"hardStages": [
{
"work": "Mobile Suit Gundam",
"hardCount": 3,
"screenshot": "mobile_suit_gundam.png"
}
]
}work:作品名(第一段)hardCount:该作品的 Hard 关卡数量,1~5(第二段)screenshot:该作品的截图文件(第三段)
主要关卡导航
主要关卡使用“左端绝对定位 + 居中相对导航”策略:
- 第一次从主界面进入画布时,逐次向左拖动并查找初代高达锚点;识别后再大幅拖动一次到达边界;
- 从作品具体关卡页退出后,当前作品固定居中,直接按两个作品的绝对坐标差快速切换;
- 仅在左端复位时识别固定的初代高达锚点,目标作品进入和连续切换仍使用坐标计算;
- 最后一次作品定位滑动保留五秒以内的动画设置;较长设置改为连续截图确认画布停稳,再识别并点击作品节点;
- 整屏滑动无法把节点带入安全点击区时,才会补一次固定半屏滑动;其余路径仍优先使用已校准的整屏滑动;
- 普通与挑战模式共享作品绝对位置,挑战模式接口已经预留但尚未启用。
resources/common/stage_work_positions.json 保存作品稳定绝对位置。新增作品时追加配置即可, 不要在代码中写死作品总数。标准滑动画布距离可通过 stageSwipeCanvasDelta 调整, 该值需要根据真实模拟器行为校准。左端复位使用 mobile_suit_gundam.png 作为锚点, 最大搜索次数与锚点阈值均可通过配置调整。
半屏滑动补偿在 config/ggea.config.json 中按手指移动方向区分(与画布移动方向相反):
stageHalfSwipeLeftTapCorrection:手指从右向左拖动(1500 → 960),缺省值200;stageHalfSwipeRightTapCorrection:手指从左向右拖动(420 → 960),缺省值-200。
两个参数均支持正负数:正数让点击 X 向右偏移,负数向左偏移,0 关闭对应方向补偿。 若需要将原有补偿方向反转,可将左滑设为 -200、右滑设为 200。 补偿同时计入预计视口偏移,并在补偿后检查点击安全区;完整滑动不应用此参数。 修改配置后重启程序生效,具体数值需实机校准。
右侧“AP消耗”TAB 会从 hard_stages.json 加载作品及其 Hard1~Hard5 可选范围。 勾选关卡后可拖拽作品调整顺序;每日任务中的“消耗AP”会严格按列表从上到下执行。 当前顺序及勾选状态可以保存为多个命名配置,并通过下拉框快速切换。 AP 消耗已接入略过流程:进入作品详情后先识别右下角“选择”按钮;暗态表示作品未解锁,会安全返回画布并继续下一部作品。可用时点击按钮进入关卡页,优先识别当前 HARD 标题;标题连续未命中 2 秒时改为识别左侧轨道的黄色选中节点,确认 HARD 编号后按五槽位映射倒序选中已解锁关卡,并依次执行“略过 → SKIP RESULT → OK → 次数上限暗态确认”。
左侧“每日任务”列表同样支持拖拽排序,列表从上到下的顺序就是“任务开始”按钮实际执行任务的顺序。 拖拽排序参考 Ant Design 表格示例:拖动行时显示虚线插入指示,目标在拖动行下方时显示底边线、上方时显示顶边线。 “领取奖励”与“消耗AP”任务左侧带齿轮设置入口,点击任务行或齿轮可跳转到对应的“奖励”或“AP消耗”TAB。 “奖励”TAB 中的“领取邮件奖励”已接入现有礼物箱流程,“领取每日使命奖励”已接入使命页全部领取。
区服与语言素材
设置 → 模拟器与游戏中选择区服和游戏实际显示语言。日服包名为 com.bandainamcoent.gget_JP,国际服为 com.bandainamcoent.gget_WW,包名由区服自动确定,不再提供自定义输入。国际服支持简体中文、英语、韩语、中文(台湾)和中文(香港特别行政区),日服只支持日语。保存后在空闲状态重建服务并生效,不修改助手的中文界面。
| 目录 | 用途 |
|---|---|
resources/common/ | 通用资源,现有素材全部原样迁入 |
resources/zh-CN/ | 简体中文 |
resources/ja/ | 日语 |
resources/en/ | 英语 |
resources/ko/ | 韩语 |
resources/zh-TW/ | 中文(台湾) |
resources/zh-HK/ | 中文(香港特别行政区) |
例如,将中文按钮从 common/templates/gift/button_collect_all.png 移到 zh-CN/templates/gift/button_collect_all.png,日语对应素材放在 ja/templates/gift/button_collect_all.png。所有语言保持相对子路径和文件名一致,无需修改任务代码。配置和代码仍使用逻辑路径 resources/templates/...;读取时先查当前语言;没有语言文件则直接使用 common。图像识别中,语言素材未命中时,在同一帧按原阈值和区域补试一次同路径同名 common 素材;命中即停止,不回退到其他语言。配置与 OCR 文件仍仅按文件是否存在选择,不参与图像匹配回退。
中文基准移出 common 后,其他语言必须提供对应文件;缺失时按原有缺失素材处理停止相关操作,不降低匹配阈值。目录扫描合并两层并去重,不要求复制完整素材树。模板采集写入当前语言目录,外部自定义目录保持原样。手工整理素材后重新启动助手,以清除已经加载的模板缓存。
选择一种语言不代表该语言的流程已经适配完成:日语已针对上述五项每日任务完成 MuMu 1920×1080 实机操作和生产服务截图回放,消耗 AP 另已完成 ID 1、2 的 HARD 1~3 实机略过及生产服务截图回放(未触发 AP 不足与玩家升级);其余任务及其他语言尚未逐项验证;不能据此宣称全流程或所有模拟器兼容。升级时旧 resources/stage_work_positions.json 用户坐标继续优先读取,新目录文件同样受到更新保留规则保护。