https://github.com/vfsfitvnm/frida-il2cpp-bridge
A Frida module to dump, trace or hijack any IL2CPP application at runtime, without needing the global-metadata.dat file.
https://github.com/vfsfitvnm/frida-il2cpp-bridge
dump frida frida-il2cpp-bridge global-metadata il2cpp trace
Last synced: 26 days ago
JSON representation
A Frida module to dump, trace or hijack any IL2CPP application at runtime, without needing the global-metadata.dat file.
- Host: GitHub
- URL: https://github.com/vfsfitvnm/frida-il2cpp-bridge
- Owner: vfsfitvnm
- License: mit
- Created: 2021-02-08T16:32:01.000Z (about 4 years ago)
- Default Branch: master
- Last Pushed: 2025-03-30T18:36:11.000Z (about 1 month ago)
- Last Synced: 2025-04-02T01:13:31.390Z (about 1 month ago)
- Topics: dump, frida, frida-il2cpp-bridge, global-metadata, il2cpp, trace
- Language: TypeScript
- Homepage: https://github.com/vfsfitvnm/frida-il2cpp-bridge/wiki
- Size: 1.3 MB
- Stars: 1,178
- Watchers: 22
- Forks: 235
- Open Issues: 40
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
- awesome-hacking-lists - vfsfitvnm/frida-il2cpp-bridge - A Frida module to dump, trace or hijack any IL2CPP application at runtime, without needing the global-metadata.dat file. (TypeScript)
README
# frida-il2cpp-bridge
[](https://frida.re)
[](https://npmjs.org/package/frida-il2cpp-bridge)
A Frida module to dump, trace or hijack any Il2Cpp application at runtime, without needing the `global-metadata.dat` file.
## Features
- Dump classes, methods, fields and so on
- Trace, intercept and replace method calls
- Mess around with the C# runtime
- Il2Cpp structs and global metadata (almost) free
## Compatibility
#### Unity version
It should work for any Unity version in the range **5.3.0** - **2022.1.x**.
#### Platforms
**Android**, **Linux**, **Windows**, **iOS**, **macOS** are supported.
However, only Android and Linux are "tested": expect breakage if you are using another platform.
## Testing
Over the time, it was realized that some testing was necessary, as supporting many Unity version makes introducing regressions or faulty features easy. Though it's far from being complete and bullet-proof, there's a minimal testing setup contributors can get advantage of to test their changes. \
In order to test `frida-il2cpp-bridge`, a IL2CPP application is needed (of course). Here are some very useful resources:
- [IL2CPP toolchain](https://katyscode.wordpress.com/2020/06/24/il2cpp-part-1/)
- [Scripting](https://github.com/djkaty/Il2CppInspector/blob/116c6355e7ee3656eab85ca753f913d428abc7a3/Il2CppTests/il2cpp.ps1)
### Commands
Unity editors (so IL2CPP toolchains) will be downloaded and extracted automatically.
**Prerequisites**
1. Only Linux is currently supported;
2. Make sure to have `clang` and `make` installed.
#### Build IL2CPP assemblies
```sh
make assemblies
```
An assembly (`GameAssembly.so`) will be built for each of [tested Unity versions](https://github.com/vfsfitvnm/frida-il2cpp-bridge/tree/master/unity).
#### Build IL2CPP assembly for a specific Unity version only
```sh
make unity/2019.3.0f1/
```
#### Run tests
```sh
make test
```
Tests run against only the installed Unity versions.
## Acknowledgements
Thanks to [meme](https://github.com/meme) and [knobse](https://github.com/knobse) for helping and getting me into this,
and to [djkaty](https://github.com/djkaty) and [nneonneo](https://github.com/nneonneo) for providing the Il2Cpp
API.
## Problems?
Discussions and Wiki are both active. Use them!