Estudio educativo de ingeniería inversa de un juego de Android en Unity/IL2CPP. Documenta la decodificación del protocolo de puerta de enlace, el análisis del SDK nativo anti-manipulación, la omisión del anclaje SSL y las técnicas de análisis dinámico basadas en Frida.
Proyecto educativo. El objetivo es comprender cómo se comunica un juego moderno de Android Unity/IL2CPP, cómo funcionan sus SDK de protección nativos y cómo aplicar técnicas de análisis estático y dinámico a un APK del mundo real.
Este repositorio documenta un estudio de ingeniería inversa en curso sobre com.run.tower.defense (Kingshot, de Century Games), un juego Unity con runtime IL2CPP, múltiples SDK de protección nativos y un protocolo de puerta de enlace binario personalizado.
Sin trampas, sin explotación, sin modificación de datos del juego en vivo. El enfoque es puramente comprender la arquitectura interna.
| Área | Estado | Hallazgo clave |
|---|---|---|
| Protocolo de puerta de enlace (puerto 30101) | Decodificado | Binario personalizado, framing uint16_BE, cuerpo varint, sin TLS |
| Opcodes | Mapeados | 0x55 handshake, 0x5d acciones de juego, 0x1d sincronización de estado, 0x15 heartbeat, 0x59 ACK del cliente |
| Codificación de coordenadas | Decodificada | 4 caracteres tipo ASCII85 → uint32 (x=reino, y=posición) |
| API de analítica | Capturada | logagent-wf.centurygame.com — eventos JSON, sin pinning |
| SSL pinning | Parcialmente evadido | Capa Java evadida (OkHttp + TrustManager); capa nativa BestHTTP identificada |
| Anti-tampering (libnesec) | Identificado | Mata el proceso ~58s después de adjuntar Frida; función de kill y nivel de detección mapeados |
| libxt_a64.so | Identificado | SDK de hooking PLT cargado en un namespace de linker aislado — invisible para Frida/maps |
| libNetHTProtect.so | Analizado | SDK de integridad de red; fingerprinting MD5; serialización estilo protobuf |
| Volcado IL2CPP | Parcial | Lista de ensamblados recuperada; RVA de certval de BestHTTP mapeado |
game-of-kingshot-re/
├── README.md ← este archivo
├── FLOW.md ← flujo de datos completo descubierto
├── SETUP.md ← guía de configuración del entorno
├── TOOLS_AND_COMMANDS.md ← referencia de todos los comandos y herramientas
├── CLAUDE.md ← contexto para sesiones asistidas por IA
├── captures/
│ ├── battle.pcap ← muestra de tráfico de la puerta de enlace (sesión 1)
│ └── battle2.pcap ← muestra de tráfico de la puerta de enlace (sesión 2, más rica)
└── scripts/
├── frida/
│ ├── certval_hook.js ← observar la validación de certificados de BestHTTP
│ ├── button_hook.js ← hookear eventos de botones de la UI de Unity
│ ├── ssl_unpin.js ← SSL unpinning (capas Java + IL2CPP)
│ └── nesec_bypass.js ← neutralizar el anti-tampering de libnesec
├── analysis/
│ ├── analyze_gateway.py ← parsear y decodificar capturas pcap del puerto 30101
│ ├── analyze_mitm.py ← leer y filtrar archivos .mitm de mitmproxy
│ ├── decode_1d_v2.py ← decodificación profunda de tramas de sincronización de estado 0x1d
│ └── deep_analysis.py ← coordenadas, fragmentos JSON, opcode 0x59
└── proxy/
├── mitm_setup.py ← instalar el CA de mitmproxy en el dispositivo
├── run_ssl_unpin.py ← ejecutor combinado de mitmdump + SSL unpin de Frida
└── run_button_hook.py ← ejecutor combinado de mitmdump + hook de botones de 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 para el mapa completo del protocolo y las preguntas abiertas.
Consulta SETUP.md para poner en marcha tu entorno.
Si tienes análisis de Ghidra, salida de il2cppdumper o capturas pcap adicionales — los PRs y issues son bienvenidos.