Lehrreiche Reverse-Engineering-Studie eines Unity/IL2CPP-Android-Spiels. Dokumentiert Gateway-Protokoll-Dekodierung, native Anti-Tampering-SDK-Analyse, SSL-Pinning-Umgehung und Frida-basierte dynamische Analysetechniken.
Bildungsprojekt. Das Ziel ist zu verstehen, wie ein modernes Unity/IL2CPP-Android-Spiel kommuniziert, wie seine nativen Schutz-SDKs funktionieren und wie man statische + dynamische Analysetechniken auf eine reale APK anwendet.
Dieses Repository dokumentiert eine laufende Reverse-Engineering-Studie von com.run.tower.defense (Kingshot, von Century Games), einem Unity-Spiel mit IL2CPP-Laufzeit, mehreren nativen Schutz-SDKs und einem eigenen binären Gateway-Protokoll.
Kein Cheating, keine Ausnutzung, keine Modifikation von Live-Spieldaten. Der Fokus liegt ausschließlich auf dem Verständnis der internen Architektur.
| Bereich | Status | Zentrale Erkenntnis |
|---|---|---|
| Gateway-Protokoll (Port 30101) | Entschlüsselt | Eigenes Binärformat, uint16_BE-Framing, Varint-Body, kein TLS |
| Opcodes | Zugeordnet | 0x55 Handshake, 0x5d Spielaktionen, 0x1d State-Sync, 0x15 Heartbeat, 0x59 Client-ACK |
| Koordinatenkodierung | Entschlüsselt | ASCII85-ähnlich 4 Zeichen → uint32 (x=Königreich, y=Position) |
| Analytics-API | Erfasst | logagent-wf.centurygame.com — JSON-Events, nicht gepinnt |
| SSL-Pinning | Teilweise umgangen | Java-Ebene umgangen (OkHttp + TrustManager); native BestHTTP-Ebene identifiziert |
| Anti-Tampering (libnesec) | Identifiziert | Beendet den Prozess ~58s nach Frida-Attach; Kill-Funktion und Erkennungsebene zugeordnet |
| libxt_a64.so | Identifiziert | PLT-Hooking-SDK, geladen in isoliertem Linker-Namespace — unsichtbar für Frida/maps |
| libNetHTProtect.so | Analysiert | Netzwerk-Integritäts-SDK; MD5-Fingerprinting; protobuf-artige Serialisierung |
| IL2CPP-Dump | Teilweise | Assembly-Liste wiederhergestellt; BestHTTP certval RVA zugeordnet |
game-of-kingshot-re/
├── README.md ← diese Datei
├── FLOW.md ← vollständiger entdeckter Datenfluss
├── SETUP.md ← Anleitung zur Umgebungseinrichtung
├── TOOLS_AND_COMMANDS.md ← Referenz aller Befehle und Tools
├── CLAUDE.md ← Kontext für KI-gestützte Sitzungen
├── captures/
│ ├── battle.pcap ← Gateway-Traffic-Beispiel (Sitzung 1)
│ └── battle2.pcap ← Gateway-Traffic-Beispiel (Sitzung 2, umfangreicher)
└── scripts/
├── frida/
│ ├── certval_hook.js ← BestHTTP-Zertifikatsvalidierung beobachten
│ ├── button_hook.js ← Unity-UI-Button-Events hooken
│ ├── ssl_unpin.js ← SSL-Unpinning (Java- + IL2CPP-Ebenen)
│ └── nesec_bypass.js ← libnesec-Anti-Tampering neutralisieren
├── analysis/
│ ├── analyze_gateway.py ← pcap-Captures von Port 30101 parsen und dekodieren
│ ├── analyze_mitm.py ← mitmproxy-.mitm-Dateien lesen und filtern
│ ├── decode_1d_v2.py ← tiefe Dekodierung von 0x1d-State-Sync-Frames
│ └── deep_analysis.py ← Koordinaten, JSON-Fragmente, Opcode 0x59
└── proxy/
├── mitm_setup.py ← mitmproxy-CA auf dem Gerät installieren
├── run_ssl_unpin.py ← kombinierter Runner aus mitmdump + Frida SSL-Unpin
└── run_button_hook.py ← kombinierter Runner aus mitmdump + Frida Button-Hook
# 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
Siehe FLOW.md für die vollständige Protokollkarte und offene Fragen.
Siehe SETUP.md, um Ihre Umgebung zum Laufen zu bringen.
Wenn Sie Ghidra-Analysen, il2cppdumper-Ausgaben oder zusätzliche pcap-Captures haben — PRs und Issues sind willkommen.