[原创]全AI流程搞定Unity IL2CPP改包、Frida-Gadget脱机注入与免死逻辑复现

样本包名:com.example.runner.game(已脱敏,不提供样本与改包成品下载)工具与环境:Il2CppDumper、apktool、adb、Cursor Agent、frida-gadget 16.5.9、jadx(辅助)

0x00 写在前面

最近在关注 AI赋能apk逆向 ,练手了几个 Unity IL2CPP 跑酷类样本。完全借助 AI,从零走完静态逆向、Hook 设计、重打包与实机验收,而不靠「凭经验逐个试偏移」。

本文选取一款渠道发行的跑酷小游戏作为练手对象(下文统称样本 App)。为不影响他人产品,真实包名、APK 文件名、启动 Activity 均已脱敏;技术路径、RVA 偏移与 AI 指令链完整保留,便于按同样方法复现。

使用到的工具及环境:Il2CppDumper、apktool、adb、Cursor Agent、frida-gadget 16.5.9、jadx(辅助查阅 Java 层)。

0x01 这次工作的最终结果

到本文写完为止,已经完成并验证了以下内容:

  1. 使用 Il2CppDumper 导出 dump.cs,定位样本引擎(命名空间已脱敏为 EngineX)中死亡/复活相关调用链。
  2. 确认实机死亡路径为 AutoRevival(闪一下原地继续),而非 RestartStage 整关重开。
  3. 确认常规 frida-server attach 被样本内反调试阻断,改用 frida-gadget 16.5.9 在 Application 早期注入。
  4. 产出脱机自启动 Hook 脚本 il2cpp_auto_hook.js v3(Gadget script 模式,无需连接 PC)。
  5. 实现 碰撞点续跑:将 RestartStage 重定向为 AutoRevival,阻断整关清零。
  6. 实现 去掉死亡闪屏:跳过 DeadFlash / OnPlayerDeadFlash / PlayerDeadFlash 三条闪屏链。
  7. 实现 无限复活次数:对 3 个 CryptInt 字段锁定 99,并 Hook CryptInt.Set/Get 防止扣减;logcat 验收 [refill] n=3。
  8. 产出需求、设计、过程执行、指令归档文档及本文。

当前最终测试包(本地 debug 重签,仅用于授权环境自测):

0x02 第一阶段:环境摸底与架构确认

本阶段目标很简单:确认手机能连、样本能装、并且搞清楚「这是不是一个能拿 Il2CppDumper 处理的 Unity IL2CPP 包」。很多后续弯路,都是因为跳过了这一步,直接开始改 smali 或 Hook。

3.1 连接设备并枚举包名

背景说明:改包前需要确认 adb 通道正常,并从大量已安装应用中定位目标包名。AI 可代为执行 shell 命令并过滤结果,省去手动翻包名的时间。这adb是封装成了adb mcp省得去频繁使用adb

指令:

连接 adb 获取包列表

执行结果:


  • 脱敏包名:com.example.runner.game

此时仅完成「找到对象」,尚未判断游戏加固。

3.2 判断加固与游戏架构

背景说明:若样本加了商业加固壳,apktool 解包与后续 smali/so 分析路径会完全不同;若是 Unity IL2CPP,则核心逻辑在 libil2cpp.so + global-metadata.dat,应优先走 Il2CppDumper 而不是只盯 Java 层。

指令:

com.example.runner.game 这个包有加固吗
判断游戏架构

执行结果:

AI 对 APK 进行解包检视、检查 lib/ 目录与 assets 结构,结论如下:

项

结论

加固

外层为某渠道 SDK 包装,非高强度商业壳;apktool 可正常反编译

架构

Unity 2017.4 IL2CPP

关键文件

lib/armeabi-v7a/libil2cpp.so、assets/.../global-metadata.dat

逻辑命名空间

自研引擎 EngineX(原 dump 中可见,此处脱敏)

ABI

样本仅含 armeabi-v7a,需注意 Gadget 与 Hook 脚本架构匹配

阶段小结: 样本属于「可解包 + IL2CPP」类型。

0x04 第二阶段:静态逆向与调用链分析

静态阶段要解决的核心问题是:撞障碍死后,游戏到底会走「原地复活」还是「整关重来」。答案不在 Java 层 Manifest,而在 IL2CPP 的 PanelGamePlay 一类 UI 控制类中。

4.1 设计执行流程

背景说明:在动手 dump 之前,先让 AI 输出分步计划,可以避免「dump 完不知道搜什么」。本样本的需求是跑酷碰撞后不要从头再来,因此流程应围绕「死亡事件 → 复活分支」展开。

指令:

跑酷碰撞到障碍物就从头再来,我想不要重头再来,直接从碰撞哪里开始。
帮我设计执行流程。

执行结果:

AI 给出可执行的六步流程:


4.2 执行 Il2CppDumper

背景说明:Il2CppDumper 需要成对的 libil2cpp.so 与 global-metadata.dat。AI 可自动检测本机 .NET 环境、调用 Dumper 并将产出整理到工程目录。

指令:

Step 1 Il2CppDumper 出 dump.cs 那你直接执行这个步骤吧

执行结果:

  • 检测/安装 .NET 6 运行环境
  • 从样本 APK 提取 so 与 metadata,执行 Il2CppDumper
  • 生成:
  • dump/dump.cs — 伪 C# 可读逻辑
  • dump/script.json — Frida 用 Address 表
  • dump/il2cpp.h — 结构体字段偏移

完成后即可在 dump.cs 中搜索 Revival、Dead、Restart 等关键词,而不用盲扫二进制。

搜索出来的关键类:

4.3 执行调用链分析

背景说明:dump 只提供「有什么类和方法」,调用链需要结合引擎事件流还原。AI 根据 GameSystem、PanelGamePlay、TimeEventCreator 等类名,整理出从碰撞到复活/重开的完整路径,并标注哪些方法是必须 Hook 的点。

指令:

直接执行 Step 2

执行结果:

输出 docs/collision-callchain-step2.md。核心调用链如下:

碰撞
  → TimeEventCreator.Dead / DeadFlash
  → GameSystem.PlayerDeadFlash()  → OnPlayerDeadFlash()   [闪屏]
  → GameSystem.PlayerDead()       → OnPlayerDead()        [★分叉点]
        ├─ AutoRevival()           碰撞点续跑(目标路径)
        ├─ PanelContinue.*         金币/广告续命
        └─ RestartStage()          整关重来(需拦截)
              → GameProperty.Revival()  (m_death_pos_backup)
              → Actor.OnRevival()

说明: GameProperty 中保存了 m_death_pos_backup(死亡位置备份),说明游戏本身具备「在碰撞点恢复」的数据基础;我们要做的是强制走这条路径,并在次数耗尽时也不让逻辑掉进 RestartStage。

关键 RVA(libil2cpp.so 基址 + 偏移,随版本变化,下文为当前样本实测值):

符号

RVA

PanelGamePlay.OnPlayerDead

0xF7818

PanelGamePlay.AutoRevival

0xF776C

PanelGamePlay.RestartStage

0xFA5DC

GameProperty.Revival

0x7496C4

TimeEventCreator.DeadFlash

0xC72B0

CryptInt.Set / Get

0x73EB10 / 0x73EB2C

4.4 注入实机行为(关键分支锁定)

背景说明:静态分析通常列出 2~3 条可能分支,但真正走哪条取决于关卡配置、道具与复活次数。必须用实机现象收窄 Hook 范围,否则容易 Hook 了 OnPlayerDead,实机却从 DeadFlash 直接进 AutoRevival。

指令:

C. 闪一下自动继续 → AutoRevival,
你直接帮我执行接下来的步骤

执行结果:

  • 根据「闪一下自动继续」描述,锁定主路径为 AutoRevival,排除 RestartStage 与 PanelContinue 金币弹窗
  • 编写观测脚本 frida_trace_death.js 与续跑 Hook 骨架 frida_hook_autorevival.js

0x05 第三阶段:Frida 验证与 Gadget 重打包

静态链路与 Hook 脚本写好后,需要验证「运行时能否挂上」。本样本在 attach 阶段即被反调试拦截,因此第三阶段的重点从 frida-server 转向 gadget 重打包 + 早期注入。

5.1 Frida attach 失败

背景说明:在尚未重打包前,AI 尝试用 frida-server 附加游戏进程,用于动态验证 Step 2 的调用链。若 attach 成功,本可不必走 gadget;失败则说明必须换注入时机。

执行结果(AI 自动尝试):

操作

结果

frida-server attach 游戏进程

超时 ProcessNotRespondingError

字符串扫描 libunity.so / libil2cpp.so

含 frida、ptrace 等特征

结论: 样本在 native 层存在反 Frida/反调试逻辑,不能依赖运行时 attach;须在 Application.onCreate 等更早阶段加载 gadget,并配合 strstr/strcmp 绕过。

5.2 方案选型

背景说明:绕过早期的 native 校验,常见两条路:一是 frida-gadget 重打包(注入 so + 脚本,迭代快);二是 离线 patch libil2cpp.so(无 Frida 依赖,但版本升级维护成本高)。让 AI 对比后由人拍板,避免选错路线大面积返工。

指令:

frida-gadget 重打包 或 离线 patch 反调试你更推荐那个?

执行结果:

AI 建议优先 frida-gadget 重打包:Hook 逻辑用 JavaScript 迭代,无需每次改 so 重编;适合本样本「多次试 Hook 点、看 logcat」的节奏。

指令:

frida-gadget 重打包

5.3 重打包执行结果

背景说明:重打包不仅是「把 gadget.so 塞进 APK」,还包括:选注入点、写 gadget 配置、处理签名与架构匹配。AI 在本步骤中完成 apktool 解包、修改 Application 入口 smali、写入 config、重签,并记录所有踩坑。

项

结果

解包

apktool 2.9.3 → 目录 gadget-repack/decompiled/

注入点

渠道 Application.onCreate() → System.loadLibrary("frida-gadget")

注入时机

必须在 onCreate;在 attachBaseContext 加载曾导致 SIGSEGV

Gadget 版本

16.5.9 arm32(17.x 在本机加载即崩溃)

配置

单行 JSON、LF 换行;曾用 listen 模式端口 27052

签名

debug.keystore 重签(与原版签名不同,需卸载原包后安装)

产出

gadget-repack/repacked-signed.apk

踩坑记录:

问题

原因

处理

Gadget 17.x SIGSEGV

与样本/机型不兼容

固定使用 16.5.9

config CRLF 崩溃

Windows 换行写入 config

强制 LF

attachBaseContext 加载崩溃

注入过早,MultiDex 未就绪

改到 onCreate

PC Frida 17 ProtocolError

与 Gadget 16 协议不一致

独立 venv 安装 16.5.9

5.4 首次 Hook 联调验证

背景说明:重打包后先用 listen 模式在 PC 连接 Gadget,验证 Hook 脚本逻辑是否正确(续跑重定向、反调试 bypass 等)。此阶段不要求脱机,重点是「脚本能不能挂上、撞障碍有没有日志」。

指令:

装 Frida 16.5.9 并跑第一次 Hook 验证

执行结果:

adb forward tcp:27052 tcp:27052
gadget-repack\venv\Scripts\python.exe gadget-repack\connect_gadget.py 30
  • frida_bypass_antifrida.js:strstr/strcmp 绕过加载成功
  • 6 个 IL2CPP Hook 挂上:OnPlayerDead、AutoRevival、RestartStage(replace)、GameProperty.Revival、Actor.OnRevival
  • 局限发现: listen 模式仅在与 PC 保持连接时生效;断开连接后玩游戏,行为恢复原版

5.5 改为脱机 script 自启动

背景说明:最终需求是「装改包 APK 就能玩」,不能每次开电脑连 Frida。因此将 Gadget 配置从 listen 改为 script 自启动:游戏启动时自动加载 il2cpp_auto_hook.js,无需 adb forward。

项

变更

Gadget 模式

listen → script

脚本路径

/data/data/com.example.runner.game/files/il2cpp_auto_hook.js(脱敏)

脚本来源

打包进 assets/il2cpp_auto_hook.js,onCreate 时复制到私有目录

脚本内容

合并 anti-frida bypass + 续跑 Hook 为单文件

说明: config 中 on_load: resume 表示加载脚本后不阻塞游戏启动;on_change: reload 便于开发时替换脚本调试。

0x06 第四阶段:去掉闪屏 + 无限复活

前三阶段解决了「Hook 能挂上、能续跑」。第四阶段在已稳定的续跑基础上,增加两项体验优化:去掉死亡白屏、复活次数永不耗尽。

6.1 提出需求

背景说明:续跑逻辑走通后,仍有两处原版体验不理想:一是死亡时全屏闪白影响节奏;二是 m_revival_chance 会随死亡递减,多撞几次后仍可能因次数为 0 走入失败分支。两项都可通过对已有 Hook 脚本增量修改完成。

指令:

去掉闪屏、无限复活次数

6.2 步骤 6.2.1 — 静态定位闪屏链

说明:闪屏不是单一 API,而是从 DeadFlash 时间线事件到 UI 层 OnPlayerDeadFlash 的一条短链。AI 在 dump.cs 中检索 DeadFlash、PlayerDeadFlash,确定应对三处做 replace 空实现,而不是只改 UI 层(否则底层仍可能触发闪光效果)。

项

结果

闪屏入口

TimeEventCreator.DeadFlash @ 0xC72B0

广播链

GameSystem.PlayerDeadFlash @ 0x74E9A0 → OnPlayerDeadFlash @ 0xF739C

结论

三处拦截即可去闪屏;且 DeadFlash 是实机最稳定的死亡挂钩点,后续无限复活也应在此补次数

6.3 步骤 6.2.2 — 静态定位复活次数字段

说明:样本使用 CryptInt 加密整型 存储复活次数、道具数量等,不能像改普通 int 一样直接搜内存。须先定位字段偏移,再通过 CryptInt.Set(int) 写入,并 Hook Get/Set 防止被逻辑扣回 0。

项

结果

GameProperty.m_revival_chance

偏移 0x34(局内剩余复活次数,核心)

GameProperty.m_ability_equip_revival

偏移 0x38(装备类复活能力)

GameData.m_revival_item_count

偏移 0x1C(复活道具库存)

读写 API

CryptInt.Set @ 0x73EB10、CryptInt.Get @ 0x73EB2C

6.4 步骤 6.2.3 — Hook 脚本 v1

说明:第一版脚本在已有续跑 Hook 上叠加:闪屏三处 replace;复活次数通过 GameSystem.Get() 取 GameProperty 再 Set(99)。此时尚未做多点触发与防扣减,属于「最小可行增量」。

项

结果

去闪屏

Interceptor.replace 空实现 DeadFlash、OnPlayerDeadFlash、PlayerDeadFlash

无限复活

refillRevivalChance() → 对 m_revival_chance 执行 CryptInt.Set(99)

续跑

保留 RestartStage → AutoRevival 重定向

产出

更新 il2cpp_auto_hook.js,同步至 decompiled/assets/

6.5 步骤 6.2.4 — 重打包安装

说明:每次改 Hook 脚本后需重新打包 APK,使 assets 内脚本与 gadget 配置一并更新。AI 执行 prepare_gadget.py、apktool、jarsigner,再通过 adb 安装到测试机。

项

结果

打包

prepare_gadget.py → apktool build → jarsigner

安装

adb install -r repacked-signed.apk 成功

启动日志

=== il2cpp_auto_hook ACTIVE ===、* hooks ready (no-flash + infinite-revival)

6.6 步骤 6.2.5 — v1 实机验证(部分生效)

说明:v1 装包后实机测试:闪屏已去掉,但复活次数仍会减少。这说明 Hook「挂上了」,但「写次数」的逻辑未真正执行成功,属于典型的半生效状态,需要 logcat 精确定位。

项

结果

去闪屏

logcat 出现 [DeadFlash] skipped ✅

无限复活

未生效;无 [refill] n=3,UI/逻辑层次数仍减 ❌

根因初判

① 仅在 OnPlayerDead 补次数,实机死亡多走 DeadFlash 链;② setCrypt(ptr,...) 中参数名 ptr 遮蔽 Frida 全局函数 ptr(),导致 TypeError: not a function,CryptInt.Set 从未成功

6.7 读 logcat 并修复 v3

背景说明:用户反馈「没有重头开始,但也没有无限复活」,并主动提供观测命令。AI 读取 FRIDA_HOOK 标签日志后,从「闪屏 Hook 正常 + Set 报错」反推修复点,发布 v3 而非在 v1 上小修小补。

指令:

撞击了没有重头开始也没有无限复活你看下日志并改正
adb logcat -s FRIDA_HOOK:*

AI 诊断:

日志

含义

[DeadFlash] skipped

闪屏拦截正常,死亡确实经过 DeadFlash

[setCrypt] chance TypeError: not a function

参数名遮蔽,CryptInt.Set 全部失败

[refill] n=0 ptrs=3

三个 CryptInt* 指针已找到,但写入成功数为 0

无 [OnPlayerDead]

实机未走该入口,不能单点依赖

AI 修复(v3)说明:

修复项

动作

结果

命名 bug

参数改为 ci,NO_MI = ptr(0) 在 main 内初始化

TypeError 消失

补满时机

在 DeadFlash、PlayerDead、定时 1.5s、Revival 链均调用 refillAllRevival

死亡瞬间即补满

补满范围

m_revival_chance + m_ability_equip_revival + m_revival_item_count 三个字段

logcat [refill] n=3

防扣减

已跟踪指针的 Set/Get 白名单 + 调用方 RVA 范围兜底

逻辑层无法再将次数扣到 0

日志

改用 __android_log_write,标签 FRIDA_HOOK

启动早期即可输出,不依赖 Java.perform

验收项

结果

去闪屏

✅

无限复活(n=99)

✅

碰撞点续跑

✅

修改前生命值x1

修改后生命值x99

0x07 Hook 架构摘要

改包后的运行时结构如下:Application 启动时复制并加载脚本,Gadget 在 libil2cpp.so 映射完成后由轮询逻辑挂 Hook,无需 PC 参与。

repacked-signed.apk
  ChannelSdkApplication.onCreate          # 脱敏:原渠道 Application 子类
    ├─ assets/il2cpp_auto_hook.js → files/
    └─ loadLibrary("frida-gadget")
         libfrida-gadget.config.so       (type: script, on_load: resume)
              il2cpp_auto_hook.js v3
                ├─ M1 反调试 (strstr/strcmp)
                ├─ M2 RestartStage → AutoRevival
                ├─ M4 去闪屏 (DeadFlash...)
                └─ M5 refill n=3 + CryptInt 防扣减

无限复活 v3 逻辑(文字说明):

  1. refillAllRevival() 通过 GameSystem.Get() 取得 GameProperty / GameData,对三个 CryptInt* 调用 Set(99)。
  2. 触发点覆盖:DeadFlash(实机主路径)、PlayerDead、1.5s 定时器、GameProperty.Revival。
  3. 对已跟踪指针 Hook CryptInt.Set/Get:写入小于 99 时强制抬到 99,读取小于 99 时返回 99。
  4. 对 PanelGamePlay / PanelContinue 等代码段内的未知 CryptInt 读取做 RVA 兜底,防止漏网。

关键 Native 符号(RVA,随版本变化)

符号

RVA

处理

TimeEventCreator.DeadFlash

0xC72B0

replace 跳过 + refill

PanelGamePlay.AutoRevival

0xF776C

attach / NativeFunction 调用

PanelGamePlay.RestartStage

0xFA5DC

replace → AutoRevival

CryptInt.Set

0x73EB10

attach 防扣减

CryptInt.Get

0x73EB2C

attach 防读零


​