# lglteam/android-mod-menu architecture

> Architecture diagram of the GitHub repository lglteam/android-mod-menu, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-01). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/lglteam/android-mod-menu
- Repository: https://github.com/lglteam/android-mod-menu

## Overview

This Android mod-menu template launches a floating feature UI, passes feature changes through JNI, and runs native game modifications on a background thread after the target library loads. Its principal native capabilities include memory scanning/patching, instruction assembly and hooking, and enhanced shared-library lookup. The README documents these integrations; detailed Java menu and several native helper implementations were not excerpted, so uncertain wiring is omitted.

Main entry points: [`app/src/main/jni/Main.cpp`](https://github.com/lglteam/android-mod-menu/blob/main/app/src/main/jni/Main.cpp) (Hack Runtime), [`app/src/main/java/com/android/support/Main.java`](https://github.com/lglteam/android-mod-menu/blob/main/app/src/main/java/com/android/support/Main.java) (Menu Launcher), [`app/src/main/jni/Includes/Macros.h`](https://github.com/lglteam/android-mod-menu/blob/main/app/src/main/jni/Includes/Macros.h) (Patch Helpers), [`app/src/main/java/com/android/support/Menu.java`](https://github.com/lglteam/android-mod-menu/blob/main/app/src/main/java/com/android/support/Menu.java) (Floating Menu)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_android["Android UI"]
  node_activity["App Activity<br/>[MainActivity.java]"]
  node_java_entry["Menu Launcher<br/>[Main.java]"]
  node_java_menu["Floating Menu<br/>[Menu.java]"]
  node_preferences["Preferences<br/>[Preferences.java]"]
  node_crash["Crash Logging<br/>[CrashHandler.java]"]
end

subgraph group_native["Native Runtime"]
  node_jni["JNI Bridge<br/>[Jni.cpp]"]
  node_native_menu["Feature Menu<br/>[Menu.cpp]"]
  node_menu_setup["Menu Setup<br/>[Setup.cpp]"]
  node_hack_runtime["Hack Runtime<br/>[Main.cpp]"]
end

subgraph group_memory["Memory Tools"]
  node_memory_api["Memory Access<br/>[KittyMemory.cpp]"]
  node_scanner["Memory Scanner<br/>[KittyScanner.cpp]"]
  node_memory_patch["Memory Patching<br/>[MemoryPatch.cpp]"]
  node_assembler["Instruction Assembly<br/>[KittyAsm.cpp]"]
end

subgraph group_runtime["Native Integrations"]
  node_xdl["Library Lookup<br/>[xdl.c]"]
  node_dobby["Hooking API<br/>[dobby.h]"]
  node_patch_macros["Patch Helpers<br/>[Macros.h]"]
  node_keystone["Keystone API<br/>[keystone.h]"]
end

node_user(("User"))
node_target_game["Native Game"]

node_user -->|"opens app"| node_activity
node_activity -->|"starts"| node_java_entry
node_java_entry -->|"initializes"| node_crash
node_java_entry -->|"shows menu"| node_java_menu
node_java_entry -.->|"checks permission"| node_jni
node_java_menu -.->|"uses settings"| node_preferences
node_java_menu -.->|"sends changes"| node_jni
node_jni -->|"bridges calls"| node_native_menu
node_native_menu -.->|"sets up features"| node_menu_setup
node_hack_runtime -->|"uses menu API"| node_native_menu
node_hack_runtime -->|"applies patch calls"| node_patch_macros
node_hack_runtime -->|"checks library load"| node_xdl
node_patch_macros -->|"supports patching"| node_memory_patch
node_patch_macros -->|"invokes hooks"| node_dobby
node_patch_macros -->|"uses assembler API"| node_keystone
node_assembler -->|"assembles instructions"| node_keystone
node_scanner -->|"uses memory API"| node_memory_api
node_memory_patch -.->|"accesses memory"| node_memory_api
node_hack_runtime -->|"modifies process"| node_target_game
node_xdl -.->|"resolves libraries"| node_target_game
node_dobby -.->|"hooks native code"| node_target_game

click node_activity "https://github.com/lglteam/android-mod-menu/blob/main/app/src/main/java/com/android/support/MainActivity.java"
click node_java_entry "https://github.com/lglteam/android-mod-menu/blob/main/app/src/main/java/com/android/support/Main.java"
click node_java_menu "https://github.com/lglteam/android-mod-menu/blob/main/app/src/main/java/com/android/support/Menu.java"
click node_preferences "https://github.com/lglteam/android-mod-menu/blob/main/app/src/main/java/com/android/support/Preferences.java"
click node_crash "https://github.com/lglteam/android-mod-menu/blob/main/app/src/main/java/com/android/support/CrashHandler.java"
click node_jni "https://github.com/lglteam/android-mod-menu/blob/main/app/src/main/jni/Menu/Jni.cpp"
click node_native_menu "https://github.com/lglteam/android-mod-menu/blob/main/app/src/main/jni/Menu/Menu.cpp"
click node_menu_setup "https://github.com/lglteam/android-mod-menu/blob/main/app/src/main/jni/Menu/Setup.cpp"
click node_hack_runtime "https://github.com/lglteam/android-mod-menu/blob/main/app/src/main/jni/Main.cpp"
click node_memory_api "https://github.com/lglteam/android-mod-menu/blob/main/app/src/main/jni/KittyMemory/KittyMemory.cpp"
click node_scanner "https://github.com/lglteam/android-mod-menu/blob/main/app/src/main/jni/KittyMemory/KittyScanner.cpp"
click node_memory_patch "https://github.com/lglteam/android-mod-menu/blob/main/app/src/main/jni/KittyMemory/MemoryPatch.cpp"
click node_assembler "https://github.com/lglteam/android-mod-menu/blob/main/app/src/main/jni/KittyMemory/KittyAsm.cpp"
click node_xdl "https://github.com/lglteam/android-mod-menu/blob/main/app/src/main/jni/xDL/xdl.c"
click node_dobby "https://github.com/lglteam/android-mod-menu/blob/main/app/src/main/jni/Dobby/dobby.h"
click node_patch_macros "https://github.com/lglteam/android-mod-menu/blob/main/app/src/main/jni/Includes/Macros.h"
click node_keystone "https://github.com/lglteam/android-mod-menu/blob/main/app/src/main/jni/KittyMemory/Deps/Keystone/includes/keystone.h"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_activity,node_java_entry,node_java_menu,node_preferences,node_crash,node_user toneBlue
class node_jni,node_native_menu,node_menu_setup,node_hack_runtime toneAmber
class node_memory_api,node_scanner,node_memory_patch,node_assembler toneMint
class node_xdl,node_dobby,node_patch_macros,node_keystone toneRose
class node_target_game toneIndigo
```

## Components

### Android UI

- [App Activity](https://github.com/lglteam/android-mod-menu/blob/main/app/src/main/java/com/android/support/MainActivity.java): `app/src/main/java/com/android/support/MainActivity.java`
- [Menu Launcher](https://github.com/lglteam/android-mod-menu/blob/main/app/src/main/java/com/android/support/Main.java): `app/src/main/java/com/android/support/Main.java`
- [Floating Menu](https://github.com/lglteam/android-mod-menu/blob/main/app/src/main/java/com/android/support/Menu.java): `app/src/main/java/com/android/support/Menu.java`
- [Preferences](https://github.com/lglteam/android-mod-menu/blob/main/app/src/main/java/com/android/support/Preferences.java): `app/src/main/java/com/android/support/Preferences.java`
- [Crash Logging](https://github.com/lglteam/android-mod-menu/blob/main/app/src/main/java/com/android/support/CrashHandler.java): `app/src/main/java/com/android/support/CrashHandler.java`

### Native Runtime

- [JNI Bridge](https://github.com/lglteam/android-mod-menu/blob/main/app/src/main/jni/Menu/Jni.cpp): `app/src/main/jni/Menu/Jni.cpp`
- [Feature Menu](https://github.com/lglteam/android-mod-menu/blob/main/app/src/main/jni/Menu/Menu.cpp): `app/src/main/jni/Menu/Menu.cpp`
- [Menu Setup](https://github.com/lglteam/android-mod-menu/blob/main/app/src/main/jni/Menu/Setup.cpp): `app/src/main/jni/Menu/Setup.cpp`
- [Hack Runtime](https://github.com/lglteam/android-mod-menu/blob/main/app/src/main/jni/Main.cpp): `app/src/main/jni/Main.cpp`

### Memory Tools

- [Memory Access](https://github.com/lglteam/android-mod-menu/blob/main/app/src/main/jni/KittyMemory/KittyMemory.cpp): `app/src/main/jni/KittyMemory/KittyMemory.cpp`
- [Memory Scanner](https://github.com/lglteam/android-mod-menu/blob/main/app/src/main/jni/KittyMemory/KittyScanner.cpp): `app/src/main/jni/KittyMemory/KittyScanner.cpp`
- [Memory Patching](https://github.com/lglteam/android-mod-menu/blob/main/app/src/main/jni/KittyMemory/MemoryPatch.cpp): `app/src/main/jni/KittyMemory/MemoryPatch.cpp`
- [Instruction Assembly](https://github.com/lglteam/android-mod-menu/blob/main/app/src/main/jni/KittyMemory/KittyAsm.cpp): `app/src/main/jni/KittyMemory/KittyAsm.cpp`

### Native Integrations

- [Library Lookup](https://github.com/lglteam/android-mod-menu/blob/main/app/src/main/jni/xDL/xdl.c): `app/src/main/jni/xDL/xdl.c`
- [Hooking API](https://github.com/lglteam/android-mod-menu/blob/main/app/src/main/jni/Dobby/dobby.h): `app/src/main/jni/Dobby/dobby.h`
- [Patch Helpers](https://github.com/lglteam/android-mod-menu/blob/main/app/src/main/jni/Includes/Macros.h): `app/src/main/jni/Includes/Macros.h`
- [Keystone API](https://github.com/lglteam/android-mod-menu/blob/main/app/src/main/jni/KittyMemory/Deps/Keystone/includes/keystone.h): `app/src/main/jni/KittyMemory/Deps/Keystone/includes/keystone.h`

### Other components

- **User**
- **Native Game**

## Connections

- User → App Activity: opens app
- App Activity → Menu Launcher: starts (evidence: `app/src/main/java/com/android/support/MainActivity.java`)
- Menu Launcher → Crash Logging: initializes (evidence: `app/src/main/java/com/android/support/Main.java`)
- Menu Launcher → Floating Menu: shows menu (evidence: `app/src/main/java/com/android/support/Main.java`)
- Menu Launcher → JNI Bridge: checks permission
- Floating Menu → Preferences: uses settings (evidence: `app/src/main/java/com/android/support/Menu.java`)
- Floating Menu → JNI Bridge: sends changes
- JNI Bridge → Feature Menu: bridges calls (evidence: `app/src/main/jni/Menu/Jni.cpp`)
- Feature Menu → Menu Setup: sets up features
- Hack Runtime → Feature Menu: uses menu API (evidence: `app/src/main/jni/Main.cpp`)
- Hack Runtime → Patch Helpers: applies patch calls (evidence: `app/src/main/jni/Main.cpp`)
- Hack Runtime → Library Lookup: checks library load (evidence: `app/src/main/jni/Main.cpp`)
- Patch Helpers → Memory Patching: supports patching (evidence: `app/src/main/jni/Includes/Macros.h`)
- Patch Helpers → Hooking API: invokes hooks (evidence: `app/src/main/jni/Includes/Macros.h`)
- Patch Helpers → Keystone API: uses assembler API (evidence: `app/src/main/jni/Includes/Macros.h`)
- Instruction Assembly → Keystone API: assembles instructions (evidence: `app/src/main/jni/KittyMemory/Deps/Keystone/includes/keystone.h`)
- Memory Scanner → Memory Access: uses memory API
- Memory Patching → Memory Access: accesses memory
- Hack Runtime → Native Game: modifies process (evidence: `app/src/main/jni/Main.cpp`)
- Library Lookup → Native Game: resolves libraries
- Hooking API → Native Game: hooks native code
