Étude de rétro-ingénierie éducative d'un jeu Android Unity/IL2CPP. Documente le décodage du protocole de passerelle, l'analyse du SDK natif anti-altération, le contournement du SSL pinning et les techniques d'analyse dynamique basées sur Frida.
Projet éducatif. L'objectif est de comprendre comment un jeu Android moderne Unity/IL2CPP communique, comment fonctionnent ses SDK de protection natifs, et comment appliquer des techniques d'analyse statique + dynamique à un APK réel.
Ce dépôt documente une étude de rétro-ingénierie en cours sur com.run.tower.defense (Kingshot, par Century Games), un jeu Unity avec un runtime IL2CPP, plusieurs SDK de protection natifs et un protocole de passerelle binaire personnalisé.
Pas de triche, pas d'exploitation, pas de modification des données de jeu en direct. L'accent porte uniquement sur la compréhension de l'architecture interne.
| Domaine | Statut | Découverte clé |
|---|---|---|
| Protocole de passerelle (port 30101) | Décodé | Binaire personnalisé, tramage uint16_BE, corps varint, pas de TLS |
| Opcodes | Cartographiés | 0x55 handshake, 0x5d actions de jeu, 0x1d synchronisation d'état, 0x15 heartbeat, 0x59 ACK client |
| Encodage des coordonnées | Décodé | 4 caractères de type ASCII85 → uint32 (x=royaume, y=position) |
| API d'analytique | Capturée | logagent-wf.centurygame.com — événements JSON, sans pinning |
| Épinglage SSL | Partiellement contourné | Couche Java contournée (OkHttp + TrustManager) ; couche native BestHTTP identifiée |
| Anti-altération (libnesec) | Identifié | Tue le processus ~58 s après l'attachement de Frida ; fonction de kill et niveau de détection cartographiés |
| libxt_a64.so | Identifié | SDK de hooking PLT chargé dans un namespace de linker isolé — invisible pour Frida/maps |
| libNetHTProtect.so | Analysé | SDK d'intégrité réseau ; empreinte MD5 ; sérialisation de style protobuf |
| Dump IL2CPP | Partiel | Liste des assemblys récupérée ; RVA de certval BestHTTP cartographié |
game-of-kingshot-re/
├── README.md ← ce fichier
├── FLOW.md ← flux de données complet découvert
├── SETUP.md ← guide de configuration de l'environnement
├── TOOLS_AND_COMMANDS.md ← référence de toutes les commandes et outils
├── CLAUDE.md ← contexte pour les sessions assistées par IA
├── captures/
│ ├── battle.pcap ← échantillon de trafic de passerelle (session 1)
│ └── battle2.pcap ← échantillon de trafic de passerelle (session 2, plus riche)
└── scripts/
├── frida/
│ ├── certval_hook.js ← observer la validation de certificat BestHTTP
│ ├── button_hook.js ← hooker les événements de boutons de l'UI Unity
│ ├── ssl_unpin.js ← désépinglage SSL (couches Java + IL2CPP)
│ └── nesec_bypass.js ← neutraliser l'anti-altération de libnesec
├── analysis/
│ ├── analyze_gateway.py ← analyser et décoder les captures pcap du port 30101
│ ├── analyze_mitm.py ← lire et filtrer les fichiers .mitm de mitmproxy
│ ├── decode_1d_v2.py ← décodage approfondi des trames de synchronisation d'état 0x1d
│ └── deep_analysis.py ← coordonnées, fragments JSON, opcode 0x59
└── proxy/
├── mitm_setup.py ← installer le CA mitmproxy sur l'appareil
├── run_ssl_unpin.py ← lanceur combiné mitmdump + désépinglage SSL Frida
└── run_button_hook.py ← lanceur combiné mitmdump + hook de bouton 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
Voir FLOW.md pour la cartographie complète du protocole et les questions ouvertes.
Voir SETUP.md pour mettre votre environnement en route.
Si vous disposez d'analyses Ghidra, de sorties il2cppdumper ou de captures pcap supplémentaires — les PR et les issues sont les bienvenues.