// the find
Jadis0x/il2cpp-reverse-engineering-guide
This guide provides illustrative examples demonstrating the usage of Il2cppInspector C++ scaffold.
A practical reference for reverse engineering Unity IL2CPP games via DLL injection, built around Il2CppInspector's generated C++ scaffold. It walks you through the IL2CPP runtime API from first principles — thread attachment, metadata traversal, method invocation — and provides a reusable helper class that collapses most of the boilerplate into one-liners. Aimed at people who already know C++ and C# but haven't touched IL2CPP internals before.
The IL2CPPHelper class is genuinely useful: it handles static vs. instance field dispatch automatically, and the Invoke<T> template that unboxes value types based on whether T is a pointer is a clean trick that saves a lot of repetitive casting. The thread attachment warning is prominent and correct — this is the #1 crash cause for IL2CPP injection beginners and most guides bury it. The DumpFields/DumpMethods/DumpProperties trio with hex offsets is exactly what you need before writing any memory manipulation code. The metadata system explanation (global-metadata.dat, why class names don't exist in the binary) is accurate and saves hours of confusion.
The GET_ARRAY_ELEMENT macro hardcodes a 64-bit header offset of 0x20 with no guard for 32-bit targets, and the comment warning it only works for reference types is easy to miss — this will silently return garbage for value-type arrays. The IL2CPPHelper::Invoke overload that takes assembly/namespace/class/method as separate strings isn't shown in the header-only library listing, only in usage; someone copying the code will hit a compilation error. There's no coverage of obfuscated or encrypted metadata (XOR/AES global-metadata.dat is standard in commercial games), which is the first wall most people actually hit. The guide stops at the API layer and never touches pattern scanning or signature-based method resolution, which you need the moment Il2CppInspector can't generate a clean scaffold.