Studio educativo di reverse engineering di un gioco Android Unity/IL2CPP. Documenta il decoding del protocollo gateway, l'analisi dell'SDK nativo anti-manomissione, il bypass del SSL pinning e le tecniche di analisi dinamica basate su Frida.
Progetto didattico. L'obiettivo è comprendere come comunica un moderno gioco Android Unity/IL2CPP, come funzionano i suoi SDK di protezione nativi e come applicare tecniche di analisi statica e dinamica a un APK reale.
Questo repository documenta uno studio di reverse engineering in corso su com.run.tower.defense (Kingshot, di Century Games), un gioco Unity con runtime IL2CPP, molteplici SDK di protezione nativi e un protocollo gateway binario personalizzato.
Nessun cheating, nessuno sfruttamento, nessuna modifica dei dati di gioco live. L'attenzione è rivolta esclusivamente alla comprensione dell'architettura interna.
| Area | Stato | Risultato chiave |
|---|---|---|
| Protocollo gateway (porta 30101) | Decodificato | Binario personalizzato, framing uint16_BE, corpo varint, nessun TLS |
| Opcode | Mappati | 0x55 handshake, 0x5d azioni di gioco, 0x1d sincronizzazione stato, 0x15 heartbeat, 0x59 ACK client |
| Codifica coordinate | Decodificata | 4 caratteri in stile ASCII85 → uint32 (x=regno, y=posizione) |
| API di analytics | Catturata | logagent-wf.centurygame.com — eventi JSON, senza pinning |
| SSL pinning | Parzialmente aggirato | Livello Java aggirato (OkHttp + TrustManager); livello nativo BestHTTP identificato |
| Anti-tampering (libnesec) | Identificato | Termina il processo ~58s dopo l'aggancio di Frida; funzione di kill e livello di rilevamento mappati |
| libxt_a64.so | Identificato | SDK di PLT hooking caricato in un namespace del linker isolato — invisibile a Frida/maps |
| libNetHTProtect.so | Analizzato | SDK di integrità di rete; fingerprinting MD5; serializzazione in stile protobuf |
| Dump IL2CPP | Parziale | Lista degli assembly recuperata; RVA di BestHTTP certval mappato |
game-of-kingshot-re/
├── README.md ← questo file
├── FLOW.md ← flusso dati completo scoperto
├── SETUP.md ← guida alla configurazione dell'ambiente
├── TOOLS_AND_COMMANDS.md ← riferimento a tutti i comandi e strumenti
├── CLAUDE.md ← contesto per sessioni assistite da AI
├── captures/
│ ├── battle.pcap ← campione di traffico gateway (sessione 1)
│ └── battle2.pcap ← campione di traffico gateway (sessione 2, più ricco)
└── scripts/
├── frida/
│ ├── certval_hook.js ← osserva la validazione dei certificati BestHTTP
│ ├── button_hook.js ← aggancia gli eventi dei pulsanti UI di Unity
│ ├── ssl_unpin.js ← SSL unpinning (livelli Java + IL2CPP)
│ └── nesec_bypass.js ← neutralizza l'anti-tampering di libnesec
├── analysis/
│ ├── analyze_gateway.py ← analizza e decodifica le catture pcap della porta 30101
│ ├── analyze_mitm.py ← legge e filtra i file .mitm di mitmproxy
│ ├── decode_1d_v2.py ← decodifica approfondita dei frame di sincronizzazione stato 0x1d
│ └── deep_analysis.py ← coordinate, frammenti JSON, opcode 0x59
└── proxy/
├── mitm_setup.py ← installa la CA di mitmproxy sul dispositivo
├── run_ssl_unpin.py ← runner combinato mitmdump + SSL unpin di Frida
└── run_button_hook.py ← runner combinato mitmdump + button hook di Frida
# 1. Start frida-server on device
adb shell "su -c '/data/local/tmp/fs17 -l 0.0.0.0:37555 &'"
adb forward tcp:37555 tcp:37555
# 2. Capture gateway traffic
adb shell "su -c 'tcpdump -i any -w /sdcard/session.pcap port 30101'"
# ... play the game ...
adb pull /sdcard/session.pcap captures/
# 3. Analyze it
python scripts/analysis/analyze_gateway.py captures/session.pcap
Consulta FLOW.md per la mappa completa del protocollo e le questioni aperte.
Consulta SETUP.md per avviare il tuo ambiente.
Se disponi di analisi Ghidra, output di il2cppdumper o ulteriori catture pcap — PR e issue sono benvenute.