Tool il2cpp resolver for theos v0.3

batchh · July 6

Hello everyone today i want to present my il2cpp resolver for theos

Are you lazy and don't won't to update your offset everytime a new version comes out? Then this is for you!

Enjoy ❤️

Download:

Hidden Content

React or reply to this topic to see the hidden content & download link.

What is this?

This project provides tools for interacting with Unity's IL2CPP (Intermediate Language to C++), specifically designed to work within Theos.

What it allows to do:
- Retrieve Il2cpp metadata (assembly, classes, methods, fields)
- Manipulating field values
- Invoking methods

Todos:
- Add support for strings
- Add support for arrays
- More stuff

Important:
- This is set to target "UnityFramework", if il2cpp is initialize in another file, just change it in Il2CppAttach function!
- Don't forget to #import "il2cpp.h"
- You need to Initialize IL2CPP, how? -> Call Il2CppAttach();

#import "il2cpp.h"

void setup() {
    Il2CppAttach();
}

Example of usage:

- Fields

//getClass
Il2CppField& getClass(const char* namespaze, const char* className)  //getClass argument is namespace, class name

// Create an Il2CppField instance for the specified assembly
Il2CppField fieldAccess("Assembly-CSharp.dll");

// Get the offset of the 'wasKnifed' field in the 'PlayerScript' class
size_t offsetField = fieldAccess.getClass("", "PlayerScript").getField("wasKnifed").getOffset();

// Get the current value of the 'wasKnifed' field
bool fieldValue = fieldAccess.getValue<bool>();

// Set the 'wasKnifed' field to true
fieldAccess.setValue<bool>(true);

- Methods

//getClass
Il2CppMethod& getClass(const char* namespaze, const char* className) //getClass argument is namespace, class name
  
//getMethod
uint64_t getMethod(const char* methodName, int argsCount) //getMethod argument is method name, number of arguments in the method
  
//invoke
invoke(Args... args) //this will invoke the method, if the method has arguments just add them

// Create an Il2CppMethod instance for the specified assembly
Il2CppMethod methodAccess("Assembly-CSharp.dll");

// Get the RVA offset of the 'CanShoot' method in the 'PlayerScript' class
uint64_t methodOffset = methodAccess.getClass("", "PlayerScript").getMethod("CanShoot", 1);

// Invoke the 'CanShoot' method
bool canShoot = methodAccess.invoke<bool>();

//Invoke with arguments
uint64_t setHealthOffset = methodAccess.getClass("", "PlayerScript").getMethod("set_health", 1);
// Replace with your desired value
float newHealthValue = 100.0f; 
// Invoke the 'set_health' method with the new value
methodAccess.invoke<void, float>(newHealthValue);

- Strings

//Create string utf8
const char *utf8String = "Hello World!";
Il2CppString il2cppStr(utf8String);

//Create string utf16
const wchar_t *utf16Str = L"Hello, World!";
Il2CppString il2cppStr(utf16Str, wcslen(utf16Str));

// Convert IL2CPP string to UTF-8
std::string utf8Str = il2cppStr.toUtf8String();

// Convert IL2CPP string to UTF-16
std::wstring utf16StrConverted = il2cppStr.toUtf16String();

// Get IL2CPP string characters directly
uint16_t *chars = il2cppStr.getChars();

//Get internal string 
void *strPointer = il2cppStr.getInternalString();

//Pratical Usage example Fields:
Il2CppField field("Assembly-CSharp.dll");

field.getClass("", "PlayerScript").getField("nickname");

// Get current nickname value
Il2CppString currentNickname(field.getValue<void*>()); 

// Create new IL2CPP string for new nickname
Il2CppString newNicknameStr("newNickname");

// Set the new nickname using setValue template method
field.setValue<void*>(newNicknameStr.getInternalString());

//Pratical Usage Methods:
Il2CppMethod methodAccess("Assembly-CSharp.dll");
methodAccess.getClass("", "PlayerScript").getMethod("set_nickname", 1);

// Create IL2CppString for the new nickname
Il2CppString newNicknameStr("newNickname");

// Invoke the set_nickname method with the new nickname argument
method.invoke<void>(newNicknameStr.getInternalString());