cleat

Android IL2CPP game modding toolkit.

中文 | API | Build

What

Rust bindings over IL2CPP. You get a safe API for field access, method calls, and inline hooks. The unsafe stays inside the library.

use cleat::prelude::*;

#[cleat::main]
fn my_mod() -> cleat::Result<()> {
    cleat::set_app_data("/data/data/com.example.game/files");

    let klass = Il2CppClass::find("Player")?;
    let hp: i32 = klass.static_field_value("maxHealth")?;

    Ok(())
}

#[cleat::hook("Assembly-CSharp", "Player", "TakeDamage")]
fn god_mode(this: &Il2CppObject, damage: i32) -> cleat::Result<()> {
    god_mode::original(this, 0);
    Ok(())
}

Setup

# Cargo.toml
[lib]
crate-type = ["cdylib"]

[dependencies]
cleat = "0.1"

// src/lib.rs
use cleat::prelude::*;

#[cleat::main]
fn main() -> cleat::Result<()> {
    cleat::set_app_data("/data/data/com.example.game/files");

    let klass = Il2CppClass::find("UnityEngine.Time")?;
    let time: f32 = klass.static_field_value("timeScale")?;
    log::info!("timeScale = {}", time);

    Ok(())
}

cargo ndk -t arm64-v8a -o ./target/jniLibs build --release

Docs

Requires

• Rust nightly
• Android NDK r26+
• cargo-ndk ≥ 3.0
• libshadowhook.so (runtime, packed in APK)

License

MIT