Учебное исследование обратной разработки игры на Unity/IL2CPP для Android. Документирует декодирование шлюзового протокола, анализ нативного SDK для защиты от взлома, обход SSL-пиннинга и методы динамического анализа на основе Frida.
Образовательный проект. Цель — понять, как современная Unity/IL2CPP-игра для Android осуществляет связь, как работают её нативные SDK защиты и как применять методы статического и динамического анализа к реальному APK.
Этот репозиторий документирует продолжающееся исследование реверс-инжиниринга com.run.tower.defense (Kingshot от Century Games) — Unity-игры с рантаймом IL2CPP, несколькими нативными SDK защиты и собственным бинарным протоколом шлюза.
Без читерства, без эксплуатации, без изменения живых игровых данных. Фокус исключительно на понимании внутренней архитектуры.
| Область | Статус | Ключевая находка |
|---|---|---|
| Протокол шлюза (порт 30101) | Декодирован | Собственный бинарный формат, кадрирование uint16_BE, тело varint, без TLS |
| Опкоды | Сопоставлены | 0x55 рукопожатие, 0x5d игровые действия, 0x1d синхронизация состояния, 0x15 heartbeat, 0x59 клиентский ACK |
| Кодирование координат | Декодировано | 4 символа в стиле ASCII85 → uint32 (x=королевство, y=позиция) |
| Analytics API | Захвачен | logagent-wf.centurygame.com — JSON-события, без пиннинга |
| SSL-пиннинг | Частично обойдён | Java-слой обойдён (OkHttp + TrustManager); нативный слой BestHTTP идентифицирован |
| Анти-тамперинг (libnesec) | Идентифицирован | Убивает процесс примерно через 58 с после подключения Frida; функция убийства и уровень обнаружения сопоставлены |
| libxt_a64.so | Идентифицирован | SDK PLT-хукинга, загружаемый в изолированном пространстве имён линкера — невидим для Frida/maps |
| libNetHTProtect.so | Проанализирован | SDK сетевой целостности; MD5-фингерпринтинг; сериализация в стиле protobuf |
| Дамп IL2CPP | Частичный | Список сборок восстановлен; RVA certval BestHTTP сопоставлен |
game-of-kingshot-re/
├── README.md ← этот файл
├── FLOW.md ← полная обнаруженная схема потоков данных
├── SETUP.md ← руководство по настройке окружения
├── TOOLS_AND_COMMANDS.md ← справочник всех команд и инструментов
├── CLAUDE.md ← контекст для сессий с ИИ-ассистентом
├── captures/
│ ├── battle.pcap ← образец трафика шлюза (сессия 1)
│ └── battle2.pcap ← образец трафика шлюза (сессия 2, богаче)
└── scripts/
├── frida/
│ ├── certval_hook.js ← наблюдение за валидацией сертификатов BestHTTP
│ ├── button_hook.js ← хукинг событий кнопок Unity UI
│ ├── ssl_unpin.js ← снятие SSL-пиннинга (слои Java + IL2CPP)
│ └── nesec_bypass.js ← нейтрализация анти-тамперинга libnesec
├── analysis/
│ ├── analyze_gateway.py ← разбор и декодирование pcap-захватов порта 30101
│ ├── analyze_mitm.py ← чтение и фильтрация файлов .mitm mitmproxy
│ ├── decode_1d_v2.py ← глубокое декодирование кадров синхронизации состояния 0x1d
│ └── deep_analysis.py ← координаты, фрагменты JSON, опкод 0x59
└── proxy/
├── mitm_setup.py ← установка CA mitmproxy на устройство
├── run_ssl_unpin.py ← комбинированный запуск mitmdump + снятие SSL-пиннинга через Frida
└── run_button_hook.py ← комбинированный запуск mitmdump + хукинг кнопок через 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
См. FLOW.md для полной карты протокола и открытых вопросов.
См. SETUP.md, чтобы запустить своё окружение.
Если у вас есть результаты анализа в Ghidra, вывод il2cppdumper или дополнительные pcap-захваты — PR и issues приветствуются.