دراسة تعليمية في الهندسة العكسية للعبة Android تستخدم Unity/IL2CPP. توثق فك تشفير بروتوكول البوابة، تحليل SDK الأصلي لمكافحة التلاعب، تجاوز تثبيت SSL، وتقنيات التحليل الديناميكي القائمة على Frida.
مشروع تعليمي. الهدف هو فهم كيفية تواصل لعبة Android حديثة مبنية على Unity/IL2CPP، وكيفية عمل حزم SDK الحماية الأصلية الخاصة بها، وكيفية تطبيق تقنيات التحليل الساكن والديناميكي على ملف APK حقيقي.
يوثّق هذا المستودع دراسة هندسة عكسية جارية لـ com.run.tower.defense (Kingshot، من Century Games)، وهي لعبة Unity تعمل ببيئة IL2CPP، وتحتوي على عدة حزم SDK حماية أصلية، وبروتوكول بوابة ثنائي مخصص.
لا غش، ولا استغلال، ولا تعديل لبيانات اللعبة الحية. التركيز ينصبّ حصراً على فهم البنية الداخلية.
| المجال | الحالة | النتيجة الرئيسية |
|---|---|---|
| بروتوكول البوابة (المنفذ 30101) | مُفكَّك | ثنائي مخصص، تأطير uint16_BE، جسم varint، بدون TLS |
| رموز العمليات (Opcodes) | مُخطَّطة | 0x55 مصافحة، 0x5d إجراءات اللعبة، 0x1d مزامنة الحالة، 0x15 نبضة حياة، 0x59 إقرار العميل (ACK) |
| ترميز الإحداثيات | مُفكَّك | 4 أحرف شبيهة بـ ASCII85 → uint32 (x=المملكة، y=الموقع) |
| واجهة التحليلات (Analytics API) | مُلتقطة | logagent-wf.centurygame.com — أحداث JSON، غير مثبَّتة (not pinned) |
| تثبيت SSL | تم تجاوزه جزئياً | تم تجاوز طبقة Java (OkHttp + TrustManager)؛ تم تحديد طبقة BestHTTP الأصلية |
| مكافحة العبث (libnesec) | مُحدَّدة | تقتل العملية بعد ~58 ثانية من إرفاق Frida؛ تم تخطيط دالة القتل ومستوى الكشف |
| libxt_a64.so | مُحدَّدة | حزمة SDK لاعتراض PLT تُحمَّل في نطاق رابط معزول — غير مرئية لـ Frida/maps |
| libNetHTProtect.so | مُحلَّلة | حزمة SDK لسلامة الشبكة؛ بصمة MD5؛ تسلسل بأسلوب protobuf |
| تفريغ IL2CPP | جزئي | تم استرداد قائمة التجميعات (assemblies)؛ تم تخطيط RVA الخاص بـ BestHTTP certval |
game-of-kingshot-re/
├── README.md ← this file
├── FLOW.md ← complete discovered data flow
├── SETUP.md ← environment setup guide
├── TOOLS_AND_COMMANDS.md ← all commands and tools reference
├── CLAUDE.md ← context for AI-assisted sessions
├── captures/
│ ├── battle.pcap ← gateway traffic sample (session 1)
│ └── battle2.pcap ← gateway traffic sample (session 2, richer)
└── scripts/
├── frida/
│ ├── certval_hook.js ← observe BestHTTP certificate validation
│ ├── button_hook.js ← hook Unity UI button events
│ ├── ssl_unpin.js ← SSL unpinning (Java + IL2CPP layers)
│ └── nesec_bypass.js ← neutralize libnesec anti-tampering
├── analysis/
│ ├── analyze_gateway.py ← parse and decode port 30101 pcap captures
│ ├── analyze_mitm.py ← read and filter mitmproxy .mitm files
│ ├── decode_1d_v2.py ← deep decode of 0x1d state-sync frames
│ └── deep_analysis.py ← coordinates, JSON fragments, opcode 0x59
└── proxy/
├── mitm_setup.py ← install mitmproxy CA on device
├── run_ssl_unpin.py ← mitmdump + Frida SSL unpin combined runner
└── run_button_hook.py ← mitmdump + Frida button hook combined runner
# 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 إضافية — فإن طلبات السحب (PRs) والمسائل (issues) مرحّب بها.