CharlyEngine 🟢>_ — mini Cheat Engine per Android (root)

Selezioni un gioco → scansioni la memoria cercando il valore della valuta → la valuta cambia nel gioco → riscansioni → gli indirizzi si restringono → INIETTI il valore che vuoi (o lo CONGELI per sempre) e vedi i cambiamenti in tempo reale nel terminale.

Un Cheat Engine minimale per Android: app Kotlin + Jetpack Compose, core di scansione in C (NDK) eseguito come root.

⚠️ Solo per uso legittimo: dispositivo tuo, giochi offline/single-player. Usarlo su giochi online viola i ToS e porta al ban dell'account; testare sistemi di terzi senza autorizzazione è un reato (art. 615-ter c.p. in Italia).

---

Funzioni

• 🔎 SCANSIONA — cerca nella memoria del gioco tutti gli indirizzi che contengono un valore
• 🔄 RISCANSIONA — raffina dopo un cambio della valuta nel gioco (il classico ciclo Cheat Engine)
• 💰 INIETTA / INIETTA IN TUTTI — scrive il valore scelto in un indirizzo o in tutti insieme
• ❄ CONGELA / CONGELA TUTTI — blocca il valore per sempre (riscritto ogni 250 ms)
• 💾 Sessioni salvate — esci dall'app e torna quando vuoi: indirizzi e congelamenti di ogni gioco restano salvati e si ripristinano da soli
• 📲 AVVIA e aggancia — puoi partire anche col gioco chiuso: CharlyEngine lo apre e lo aggancia appena parte
• 🖥️ Terminale live — registro di tutto + righe [LIVE] quando un valore cambia
• 📖 Guida integrata — procedura a 4 passi spiegata per utenti non esperti (si apre al primo avvio)
• Tipi di valore: intero, decimale, long, word, byte

Screenshot del flusso

1 · App      →  2 · Cerco      →  3 · Affino        →  4 · Inietto
  scegli il      scrivi 850       cambia la valuta     💰 999999 + ❄ congelati
  gioco          e SCANSIONA      e RISCANSIONA        e guardali nel terminale

Requisiti

Cosa	Perché
Dispositivo rootato (Magisk o KernelSU)	leggere/scrivere /proc/<pid>/mem di un'altra app
Android 8.0+ (API 26)	—
Android Studio + NDK + CMake (SDK Manager → SDK Tools)	compilare la parte nativa

Compilazione

# 1. apri la cartella memscan/ in Android Studio (la prima sync scarica tutto)
# 2. Build ▸ Build APK(s)     oppure da terminale:
./gradlew assembleDebug
# 3. installa:
adb install app/build/outputs/apk/debug/app-debug.apk

All'avvio concedi l'accesso root quando Magisk lo chiede (il daemon deve girare come root).

Come si usa — il flusso della "valuta"

1. Trova il gioco nell'elenco (se è chiuso: ▶ AVVIA, CharlyEngine lo aggancia da solo)
2. Guarda la valuta nel gioco (es. monete = 850), scrivi 850 e premi SCANSIONA
3. Cambia la valuta nel gioco (spendi o guadagna, es. diventa 743)
4. Scrivi 743 e premi RISCANSIONA — ripeti 3-4 finché restano pochi indirizzi
5. Scrivi il valore dei sogni (es. 999999) e premi 💰 INIETTA IN TUTTI
6. Se il gioco riporta il valore indietro: ❄ CONGELA TUTTI

Consigli: monete → tipo «Intero»; vite/energia → «Decimale». Se non trovi il valore, prova ×10/×100 (il gioco mostra 850 ma salva 8500).

Architettura

┌────────────────────────────── app (Kotlin/Compose, uid app) ──────────┐
│  UI: lista app · procedura 4 passi · risultati live · terminale       │
│  SessionStore: indirizzi/congelamenti salvati per ogni gioco          │
│           │  righe di testo (stdin/stdout via `su`)                   │
└───────────┼───────────────────────────────────────────────────────────┘
            ▼
┌──────────────────── memscand (C, eseguito come root) ────────────────┐
│ ATTACH pid → legge /proc/pid/maps (solo regioni rw-p)                │
│ SCAN valore   → pread64 a blocchi di 1 MB + confronto in memoria     │
│ RESCAN valore → rilegge SOLO gli indirizzi candidati e filtra        │
│ RESTORE addrs → ricarica una sessione salvata (indirizzi validati)   │
│ WRITE addr    → pwrite64 del nuovo valore (+ verifica read-back)     │
│ FREEZE addr   → thread che riscrive il valore ogni 250 ms            │
└───────────────────────────────────────────────────────────────────────┘

L'eseguibile C è pacchettizzato nell'APK col trucco libmemscand.so (CMake PREFIX lib + SUFFIX .so), copiato all'avvio in /data/local/tmp e lanciato con su. Quando l'app muore, il daemon riceve EOF su stdin e si spegne da solo.

Protocollo del daemon (per giocarci da Termux)

su -c /data/local/tmp/memscand
PING · HELLO · PROCS · ATTACH <pid> · REGIONS
SCAN <tipo> <valore> · RESCAN <tipo> <valore> · COUNT · RESULTS <start> <count>
READ <tipo> <addr> · WRITE <tipo> <addr> <valore>
FREEZE <tipo> <addr> <valore> · UNFREEZE <addr> · UNFREEZE_ALL
RESTORE <tipo> <addr> [<addr> …] · RESET · DETACH · QUIT
(tipi: b w d q f D)

Ogni risposta: righe dati opzionali + una riga finale OK … / ERR ….

Test del core nativo (Linux o Termux, senza Android)

cd native-test && ./run_test.sh

22 controlli end-to-end: scansione, restringimento dopo cambio valore, scrittura, freeze (il bersaglio prova a cambiare il valore ma resta bloccato), float, restore delle sessioni, detach.

Struttura

memscan/
├── app/src/main/cpp/memscand.c      ← il cuore: scanner/patcher di memoria (C)
├── app/src/main/java/com/memscan/app/
│   ├── MainActivity.kt              ← navigazione + edge-to-edge corretto
│   ├── scan/RootShell.kt            ← wrapper `su -c`
│   ├── scan/MemscanDaemon.kt        ← ciclo di vita + protocollo col daemon
│   ├── scan/ScanViewModel.kt        ← stato, polling live, sessioni, restore
│   ├── scan/SessionStore.kt         ← persistenza sessioni per ogni gioco
│   └── ui/                          ← Compose: lista app, procedura, terminale, guida
├── native-test/                     ← test end-to-end del core (gcc + python)
└── gradle/…                         ← build Android (AGP 8.7, Kotlin 2.0, Compose BOM)

Licenza

MIT — vedi LICENSE.