
Unity/IL2CPP Androidゲームの教育的リバースエンジニアリング研究。ゲートウェイプロトコルデコード、ネイティブ改ざん防止SDK解析、SSLピンバイパス、およびFridaベースの動的解析手法を文書化する。
教育目的のプロジェクト。 目的は、現代の Unity/IL2CPP Android ゲームがどのように通信するのか、そのネイティブ保護 SDK がどのように動作するのかを理解し、静的解析と動的解析の手法を実際の APK に適用する方法を学ぶことです。
このリポジトリは、com.run.tower.defense(Century Games による Kingshot)の継続的なリバースエンジニアリング調査を記録したものです。このゲームは Unity 製で IL2CPP ランタイムを持ち、複数のネイティブ保護 SDK と独自のバイナリゲートウェイプロトコルを備えています。
チート、エクスプロイト、ライブゲームデータの改変は一切行いません。焦点は純粋に内部アーキテクチャの理解にあります。
| 領域 | ステータス | 主な発見 |
|---|---|---|
| ゲートウェイプロトコル (ポート 30101) | 解読済み | 独自バイナリ、uint16_BE フレーミング、varint ボディ、TLS なし |
| オペコード | マッピング済み | 0x55 ハンドシェイク、0x5d ゲームアクション、0x1d 状態同期、0x15 ハートビート、0x59 クライアント ACK |
| 座標エンコーディング | 解読済み | ASCII85 風の 4 文字 → uint32 (x=王国、y=位置) |
| アナリティクス API | キャプチャ済み | logagent-wf.centurygame.com — JSON イベント、ピン留めなし |
| SSL ピン留め | 部分的にバイパス済み | Java レイヤーはバイパス済み (OkHttp + TrustManager)、ネイティブ BestHTTP レイヤーを特定 |
| 改ざん防止 (libnesec) | 特定済み | Frida アタッチ後約 58 秒でプロセスを kill、kill 関数と検出レベルをマッピング済み |
| libxt_a64.so | 特定済み | 分離リンカーネームスペースにロードされる PLT フッキング SDK — Frida/maps から不可視 |
| libNetHTProtect.so | 解析済み | ネットワーク整合性 SDK、MD5 フィンガープリント、protobuf 風シリアライゼーション |
| IL2CPP ダンプ | 部分的 | アセンブリ一覧を復元、BestHTTP certval の RVA をマッピング済み |
game-of-kingshot-re/
├── README.md ← このファイル
├── FLOW.md ← 判明した完全なデータフロー
├── SETUP.md ← 環境構築ガイド
├── TOOLS_AND_COMMANDS.md ← すべてのコマンドとツールのリファレンス
├── CLAUDE.md ← AI 支援セッション用のコンテキスト
├── 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 ← ポート 30101 の pcap キャプチャを解析・デコード
│ ├── analyze_mitm.py ← mitmproxy の .mitm ファイルを読み取り・フィルタ
│ ├── decode_1d_v2.py ← 0x1d 状態同期フレームの詳細デコード
│ └── deep_analysis.py ← 座標、JSON フラグメント、オペコード 0x59
└── proxy/
├── mitm_setup.py ← デバイスに mitmproxy CA をインストール
├── run_ssl_unpin.py ← mitmdump + Frida SSL アンピンの統合ランナー
└── 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 や issue を歓迎します。