cz_kelui docs

gorilla tag mod menu — unity quad + kelui software rendering, bnm reflection, xr input.

overview

cz_kelui is a gorilla tag (android/meta quest) mod menu injected as a native shared library. it hooks into the game via bnm (il2cpp reflection), renders a floating menu panel using kelui's widget api rasterized in software, and uploads the result to a unity texture on a world-space quad attached to the left hand.

the menu is toggleable mid-game. right hand acts as a pointer. right trigger clicks. mods are organized into tabs and run every frame or once on enable.

controls

file structure

adding a mod

open src/mods.cpp. inside registermods(), call either addtick() or addoneshot() with your mod definition. that's it.

addtick("Category", "mod name", "tooltip text", []() {
    ...
});

addoneshot("Category", "mod name", "tooltip text", []() {
    ...
});

mod types

tick runs every frame

use addtick for mods that need to apply a continuous effect — overriding a field every frame, applying a force, moving the player, etc. the function is called every game frame while the checkbox is checked.

addtick("Movement", "Anti Gravity", "push up every frame", []() {
    Rigidbody* rb = gamebridge::rb();
    if (!rb) return;
    rb->AddForce(Vector3(0, 15.0f, 0), ForceMode::Acceleration);
});

oneshot runs once on enable

use addoneshot for mods that set a value once — changing a field that persists (like max arm length or jump multiplier), teleporting, one-time game state changes. the function fires on the rising edge (checkbox off to on).

addoneshot("Movement", "Max Jump", "set jump multiplier to 10", []() {
    gamebridge::setpf("jumpMultiplier", 10.0f);
    gamebridge::setpf("maxJumpSpeed", 999.0f);
});

categories

the category string you pass to addtick/addoneshot becomes a tab in the menu. the built-in tabs are:

to add a new tab, just use a new category string. the tab appears automatically. tabs are ordered by first registration.

static const char* categories[] = {
    "Movement", "Gravity", "Body", "Hands", "Visual"
};
static constexpr int ncategories = 5;

examples

trigger-gated tick mod

addtick("Movement", "Rocket Jump (R-Trigger)", "hold right trigger to launch upward", []() {
    if (XRInput::GetFloatFeature(Trigger, Right) < 0.5f) return;
    Rigidbody* rb = gamebridge::rb();
    if (rb) rb->AddForce(Vector3(0, 25.0f, 0), ForceMode::VelocityChange);
});

reading and restoring a field

static float origspeed = 0.0f;
static bool  saved     = false;

addtick("Movement", "Super Speed", "10x jump multiplier", []() {
    if (!saved) {
        origspeed = gamebridge::getpf("jumpMultiplier");
        saved = true;
    }
    gamebridge::setpf("jumpMultiplier", 10.0f);
});

addoneshot("Movement", "Restore Speed", "reset jump multiplier", []() {
    if (saved) { gamebridge::setpf("jumpMultiplier", origspeed); saved = false; }
});

button-gated movement

addtick("Movement", "Dash (R-Primary)", "press right A to dash", []() {
    if (!XRInput::GetBoolFeature(PrimaryButton, Right)) return;
    Transform* b = gamebridge::body();
    Transform* r = gamebridge::roottrans();
    if (!b || !r) return;
    r->SetPosition(r->GetPosition() + b->GetForward() * Time::GetDeltaTime() * 8.0f);
});

customizing colors

widget colors are defined as inline values in extern/kelUI/ui/Widgets.cpp. find the button(), checkbox(), and tabbutton() functions and change the Color{r, g, b, a} literals. values are 0.0 to 1.0 floats.

the menu background, border, and title bar colors are in src/ui.cpp inside buildframe():

kel::Drawing::rect(0, 0, kmenuwidth, kmenuheight, {0.06f, 0.07f, 0.10f, 0.88f});
kel::Drawing::rect(0, 0, kmenuwidth, 1.5f, {0.28f, 0.48f, 0.90f, 0.55f});

kel::Drawing::rect(0, 0, kmenuwidth, ktitleh, {0.12f, 0.30f, 0.72f, 0.98f});
kel::Drawing::text(kpadding, 8.0f, "gorilla tag mods", {0.95f, 0.96f, 1.0f, 1.0f});

color format is { red, green, blue, alpha } — all values between 0.0 and 1.0.

menu size

the framebuffer and panel dimensions are set at the top of two files. change them together to maintain correct aspect ratio.

static constexpr int   kfbw    = 540;
static constexpr int   kfbh    = 360;
static constexpr float kpanelw = 0.40f;
static constexpr float kpanelh = 0.27f;

static constexpr float kmenuwidth  = 540.0f;
static constexpr float kmenuheight = 360.0f;

menu layout

the menu is built entirely in src/ui.cpp. layout constants at the top:

to change the title text, edit the string in drawtitlebar() inside ui.cpp.

gamebridge api

the gamebridge namespace wraps all bnm player reflection. use these inside mod lambdas.

common player field names

xrinput api

use these inside tick mod lambdas to read controller state:

controllers

Left
Right

bool features

PrimaryButton
SecondaryButton
GripButton
TriggerButton

float features

Trigger
Grip

vector2 features

Primary2DAxis
Secondary2DAxis

building

open the project in android studio. select the release build variant, then build apk.

Build → Select Build Variant → release

the compiled library is output as cz_kelui.so. inject it into gorilla tag using your preferred android mod loader.