🕵️‍♂️ GeoGuessr-Undercover-Cheat

Akıllı GeoGuessr auto-solver extension - XHR yakalama, React Fiber manipülasyonu ve API hooking ile gerçek koordinatları anında yakalayıp otomatik pin yerleştirme. Eğitim amaçlı geliştirme projesi!

📋 İçindekiler

• Genel Bakış
• Özellikler
• Teknik Stack
• Başlarken
• Kullanım
• Proje Yapısı
• Katkı
• Lisans

---

Genel Bakış

GeoGuessr-Undercover-Cheat, GeoGuessr oyununda gerçek koordinatları anında yakalayan ve otomatik tahmin yapan bir browser extension'ıdır. XHR isteklerini dinleyerek sunucudan gelen konum verilerini parse eder, React Fiber üzerinden haritaya erişir ve pin'i tam konuma yerleştirir.

Bu proje eğitim amaçlı geliştirilmiştir ve modern web geliştirme tekniklerini (XHR interception, React Fiber traversal, API hooking) sergiler. GeoGuessr geliştiricileri için reverse engineering örneği olarak mükemmel bir kaynaktır.

Kimler için? Web extension geliştiricileri, React internals öğrenmek isteyenler ve GeoGuessr gibi SPA'larda data extraction meraklıları.

Neden farklı? Diğer çözümlerden farklı olarak React Fiber manipülasyonu ile native pin placement yapar - external Google Maps açmaz, tamamen undercover çalışır!

---

✨ Özellikler

• 🧭 Gerçek Koordinat Yakalama — GeoGuessr sunucusundan lat/lng'yi JSON path'lerden parse eder
• 📍 Otomatik Pin Yerleştirme — React Fiber traversal ile harita component'ine direkt erişim
• ⌨️ Klavye Kısayolları — Ctrl+Space ile instant guess, Ctrl+Shift+L ile detaylar
• 🌍 Reverse Geocoding — Nominatim API ile ülke/şehir/bölge bilgisi
• 🛡️ Güvenli Mod — Fake popup arayüzü ile undercover görünüm
• 🔍 Çoklu JSON Path Desteği — Farklı game modlarında alternatif koordinat yolları
• ⚡ Hızlı Çalışma — Round başlar başlamaz koordinatları yakalar

---

🛠️ Teknik Stack

---

🚀 Başlarken

Ön Koşullar

• Google Chrome (veya Chromium tabanlı browser)
• Developer Mode erişimi

Kurulum

# Repoyu indir
git clone https://github.com/semyhist/GeoGuessr-Undercover-Cheat.git
cd GeoGuessr-Undercover-Cheat

1. chrome://extensions/ adresine git
2. Developer mode'u sağ üstten aktif et
3. Load unpacked butonuna tıkla
4. GeoGuessr-Undercover-Cheat klasörünü seç
5. ✅ Extension yüklendi!

💡 Not: İlk kurulumda permission isteyebilir - geoguessr.com için izin ver

---

🎮 Kullanım

Klavye Kısayolları

Ctrl+Space     — Otomatik pin yerleştir + tahmin gönder
Ctrl+Shift+L   — Konum detayları (ülke, şehir, koordinat)
Ctrl+Shift+H   — Yardım paneli aç/kapat

Oynama Akışı

1. GeoGuessr.com'a git, herhangi bir mode seç
2. Round başladığında koordinatlar otomatik yakalanır
3. Ctrl+Space bas → Pin yerleşir + tahmin gönderilir (5000 puan!)
4. Ctrl+Shift+L ile detaylı konum bilgisi gör

// Background console'da görebileceğin örnek output:
{
  lat: 40.7128,
  lng: -74.0060,
  country: "United States",
  city: "New York",
  formatted: "New York, NY, USA"
}

⚠️ Güvenli Mod: autoPlace(true) çağırarak tamamen otomatik çalıştır

---

📁 Proje Yapısı

GeoGuessr-Undercover-Cheat/
├── xhr_inject.js       # XHR/fetch interception
├── content.js          # Koordinat parsing + pin placement
├── bridge.js           # Content ↔ background communication
├── background.js       # Service worker + new window
├── location.js         # Nominatim reverse geocoding
├── popup.js            # Fake security UI (cover)
└── manifest.json       # Extension config

---

🤝 Katkı

Bu açık kaynak projesine katkıda bulunmak ister misin? Harika!

1. Fork'la repository
2. Yeni branch oluştur: git checkout -b feature/ozellik-adi
3. Değişikliklerini commit et: git commit -m "Add: ozellik aciklamasi"
4. Push et: git push origin feature/ozellik-adi
5. Pull Request aç

Issues için: https://github.com/semyhist/GeoGuessr-Undercover-Cheat/issues

👨‍💻 Yeni başlayanlar: good first issue etiketli task'lardan başla!

---

📄 Lisans

Bu proje MIT License altında yayınlanmıştır - detaylar için LICENSE dosyasını incele.

Created by Semih Aydın