# Unity Il2cpp Reverse

> Unity 游戏逆向专项（IL2CPP / Mono）。当分析 Unity 引擎打包的安卓游戏 App（识别标志：assets/bin/Data/、libil2cpp.so、libunity.so、global-metadata.dat）需要还原 C# 逻辑、导出符号、改数值时使用。

- Skill: `xiamiya/unity-il2cpp-reverse` (Agent Skill)
- Install (CLI): `npx skillmds@latest add xiamiya/unity-il2cpp-reverse`
- Raw SKILL.md: https://api.skillmd.com/api/skills/xiamiya/unity-il2cpp-reverse/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: xiamiya (https://skillmd.com/u/xiamiya)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/xiamiya/unity-il2cpp-reverse

---


# Unity 游戏逆向（IL2CPP / Mono）

## 一、先判断是 Mono 还是 IL2CPP
- **Mono**：`assets/bin/Data/Managed/*.dll`（标准 .NET 程序集）→ 用 dnSpy / ILSpy 直接反编译 C#，可改可回编，最简单
- **IL2CPP**：`lib/*/libil2cpp.so` + `assets/bin/Data/Managed/Metadata/global-metadata.dat` → C# 已编译成 native，需还原符号

## 二、IL2CPP 还原符号（核心工具 Il2CppDumper）
1. 从 APK 提取两个文件：
   - `lib/arm64-v8a/libil2cpp.so`
   - `assets/bin/Data/Managed/Metadata/global-metadata.dat`
2. 用 **Il2CppDumper** 处理这两个文件，产出：
   - `dump.cs`：所有 C# 类/方法/字段的定义（含偏移地址）
   - `script.json` / `il2cpp.h`：给 IDA/Ghidra 用的符号脚本
3. 把 libil2cpp.so 拖进 IDA，运行 Il2CppDumper 生成的 `ida_with_struct_py3.py` 脚本 → 自动命名所有函数

## 三、定位关键逻辑
- 在 `dump.cs` 里搜关键词：`Gold`、`Coin`、`Hp`、`Damage`、`IsVip`、`CheckPurchase`、`Verify`
- 找到方法的 `RVA`（相对虚拟地址）→ 到 IDA 对应偏移看反汇编
- 数值类：找 get_/set_ 属性方法
- 校验类：找返回 bool 的 Check/Verify/Validate 方法

## 四、修改手段
1. **改 so 汇编**：定位方法，patch 汇编（如把校验函数改成直接 `mov w0,#1; ret`）→ 用 `reverse-patch-techniques` 技能的方法
2. **Frida 动态 hook**（推荐，配合 frida-scripts 技能）：
   ```javascript
   // hook IL2CPP 方法：先拿到 libil2cpp.so 基址 + RVA
   var base = Module.findBaseAddress("libil2cpp.so");
   var target = base.add(0x1234560); // dump.cs 里的 RVA
   Interceptor.attach(target, {
     onLeave: function(ret) { ret.replace(ptr(1)); } // 校验恒为真
   });
   ```
3. **改 global-metadata.dat**：改字符串常量（部分版本有 XOR 加密头，需先解密）

## 五、常见反制
- **metadata 加密**：global-metadata.dat 头部被改/加密 → 需从 libil2cpp.so 的初始化函数里找解密逻辑，或用 Zygisk-Il2CppDumper 运行时 dump
- **字符串加密**：dump.cs 里字符串是密文 → 运行时 Frida hook 解密函数

## 边界
用于自有游戏、已授权测试、学习引擎原理、单机存档研究。不协助破坏在线游戏公平性、外挂牟利、侵犯他人版权。