Skip to content

Il2Cpp Dumper for Unity Android games built on LSPosed + Dobby, with cross-process config sync and one-tap dump.

License

Notifications You must be signed in to change notification settings

PenguinAndy/il2Fusion

Repository files navigation

il2Fusion

il2Fusion icon

LSPosed(Java 层 hook)+ Dobby(Native 层 hook)+ ContentProvider 跨进程通信的架构,围绕 Il2Cpp Dump/工具链的开源项目。

English version: see README_EN.

il2Fusion screenshot 1 il2Fusion screenshot 2 il2Fusion screenshot 3

功能特性

  • Dump 模式优先:一键触发 Il2CppDumper 生成 dump.cs,自动尝试复制到 /sdcard/Download/<pkg>.cs 并 Toast 结果;通过 LSPosed+Provider 配置,缓解原版 Zygisk-Il2CppDumper 在配置同步和产物获取上的痛点。
  • 文本拦截:在 libil2cpp.so 中按方法签名(如 TextMesh.set_text)安装 hook,记录传入的 set_text 字符串到本地数据库,作为“民间汉化”尝试性的工具能力,欢迎扩展更多玩法。
  • 配置同步:插件 App 写入 ContentProvider (com.tools.il2fusion.provider/config),注入进程读取后下发到 native。
  • 文件解析:可从 .cs dump 文件自动解析 set_text 上方的方法全名,并生成 JSON 供导入。
  • 游戏插件功能:同文本拦截,可以制作插件脱离游戏使用,而不需要对游戏解包回编译。

环境要求

  • 已 Root 的设备,Magisk + LSPosed 环境。
  • Android 12+(minSdk 31,targetSdk 35,compileSdk 36)。
  • 默认 ABI:arm64-v8a(如需其他 ABI,请补齐 app/src/main/cpp/libs/<abi>/libdobby.a 并调整 ndk.abiFilters)。
  • 已验证设备:
    • Google Pixel 3 XL,Android 12(SP1A.210812.016.C2 / 8618562)。
    • MacOS、Windows 端 MuMu Android 12 模拟器

快速开始

  1. 构建模块:./gradlew :app:assembleDebug(包含 CMake,生成 libnative_hook.so)。
  2. 安装并在 LSPosed 勾选目标应用(仅一个)。
  3. 打开插件 App:
    • 关闭 Dump 开关即为“文本拦截”模式,解析 dump.cs 自动获取 Namespace.Class.set_text 列表(无需手填,解析后自动保存)。
    • 开启 Dump 开关进入 Dump 模式,启动目标应用后会自动生成 dump.cs 并尝试复制到 Download。
  4. 启动目标应用验证:
    • 文本拦截模式:等待 libil2cpp.so 后安装 hook,logcat 标签 [il2Fusion]/DobbyStub,文本存储于 /data/data/<pkg>/text.db
    • Dump 模式:等待 libil2cpp.so 后自动 dump,并 Toast 提示复制结果。

架构与目录

  • LSPosed 入口:app/src/main/java/com/tools/module/MainHook.ktassets/xposed_init 指定),在 Application.attach 后加载 libnative_hook.so 并调用 JNI。
  • 配置与仓库:app/src/main/java/com/tools/il2fusion/config/,通过 ContentProvider 同步 Dump 开关与方法列表。
  • Compose UI:app/src/main/java/com/tools/il2fusion/ui/,包含三页 Tab 及文件解析逻辑。
  • Native Hook:app/src/main/cpp/native_hook.cpp 等,等待 libil2cpp.so,使用 Dobby 挂钩并写入 SQLite。
  • Il2CppDumper:app/src/main/cpp/il2CppDumper/,Dump 完成后尝试复制到 Download。
  • 资源声明:app/src/main/assets/xposed/(模块描述、入口配置)。

第三方致谢

贡献与反馈

  • 欢迎提交 issue 与 feature 请求,描述清楚环境、目标 App 和期望行为。
  • 也欢迎 PR 修复 bug、完善多 ABI 支持或改进 UI/交互。

免责声明

  • 本项目仅供学习、研究与安全测试之用,不得用于任何违法、侵权或商业牟利场景。
  • 使用者需自行确保遵守所在地法律法规,对由此产生的全部后果自行承担。

About

Il2Cpp Dumper for Unity Android games built on LSPosed + Dobby, with cross-process config sync and one-tap dump.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages