🛠️ PopControl

Luke James gibson
2026-03-10T03:29:57Z

Popmundo scriptlerini tek panelden yönetmenizi sağlayan merkezi modül

🛠️ PopControl — Ekosistem Kontrol Merkezi

Tüm Popmundo script'lerini tek bir çubuktan yönetin · Karakter menüsünü özelleştirin · Favoriler, TOP VIP ve gizleme sistemi

📋 İçindekiler

Kurulum

Ne İşe Yarar?

Kontrol Çubuğu

Ayarlar Paneli

Karakter Menüsü Yönetimi

TOP VIP Menüsü

Favoriler

Göster / Gizle

Menü Yönetimi Ekranı

Klavye Kısayolları

Özel Dil Desteği

Script Ekosistemi

İpuçları

Güvenlik ve Gizlilik

Sürüm Geçmişi

Sorun Giderme

Destek

🚀 Kurulum

1 · Tarayıcı Eklentisi

Masaüstü

Tarayıcı | İndirme
🌐 Chrome | tampermonkey.net/?browser=chrome
🦊 Firefox | tampermonkey.net/?browser=firefox

Mobil

Platform | Tavsiye Edilen Yöntem
🤖 Android | Kiwi Browser + Tampermonkey
🤖 Android | Firefox Mobile + Tampermonkey eklentisi
🍎 iPhone / iPad | Userscripts uyumlu tarayıcılar

2 · Script Kurulumu

1. Greasyfork — PopControl adresini açın

2. Yükle butonuna tıklayın

3. Script otomatik güncellenir — başka bir şey gerekmez

💡 Öneri: PopControl'ü diğer script'lerden önce yükleyin. Ekosistemi hazır bulunca diğerleri otomatik bağlanır.

🎯 Ne İşe Yarar?

PopControl, Popmundo script ekosisteminin merkezi yönetim katmanıdır. İki temel görevi vardır:

1 · Kontrol Çubuğu — Tüm aktif script'lerin butonlarını tek bir sabit çubukta toplar. Konumunu, rengini ve sırasını özelleştirebilirsiniz. Script'leri tek tıkla açıp kapatabilirsiniz.

2 · Karakter Menüsü Yöneticisi — Karakter sayfasındaki sol menüyü kişiselleştirmenizi sağlar: öğeleri gizleyin, favorilere ekleyin, sıralayın; script butonlarını TOP VIP bölümünde görüntüleyin.

ℹ️ PopControl oyunu otomatik olarak oynamaz ve haksız avantaj sağlamaz. Yalnızca arayüz yönetimi ve script koordinasyonu yapar.

📊 Kontrol Çubuğu

Konumlar

Çubuk sayfanın dört kenarına yerleştirilebilir:

Konum | Açıklama
⬇ Alt | Sayfanın en altında yatay şerit (varsayılan)
⬆ Üst | Sayfanın en üstünde yatay şerit
◀ Sol | Sol kenarda dikey sütun
▶ Sağ | Sağ kenarda dikey sütun

Buton Sıralama

Çubukta butonlar sürükle-bırak ile yeniden sıralanabilir:

🖱️ Masaüstü — Butona tıklayıp sürükleyin

📱 Dokunmatik — Butona uzun basın (300ms), ardından sürükleyin

Küçültme

Çubuğu ▼ butonuyla kapattığınızda sağ alt köşede ⚙️ FAB butonu belirir. FAB'a tıklayarak veya Alt+P ile çubuğu yeniden açabilirsiniz.

⚙️ Ayarlar Paneli

Çubukta ⚙️ PopControl butonuna tıklayarak açılır.

┌─────────────────────────────────────┐
│  🛠️ PopControl v2.3            ✕   │
├─────────────────────────────────────┤
│  📍 Konum      ⬇ Alt  ⬆ Üst        │
│                ◀ Sol  ▶ Sağ         │
├─────────────────────────────────────┤
│  🌍 Dil        TR  EN  PT  Customize│
├─────────────────────────────────────┤
│  🎨 Renk       [Bar ▐] [Yazı ▐]    │
├─────────────────────────────────────┤
│  🗂️ Menü Yönetimi    [ Yönet ]     │  ← Sadece karakter sayfasında
├─────────────────────────────────────┤
│  🔌 Script'ler                      │
│     🎨 Helper          ●──  (açık) │
│     🌐 Social          ●──  (açık) │
│     🗺️ Route49         ──○ (kapalı)│
└─────────────────────────────────────┘

Script Açma / Kapatma

Her script'in yanındaki toggle ile o script'i devre dışı bırakabilirsiniz. Script kapandığında kendi onUndo fonksiyonu çalışır ve DOM üzerindeki tüm değişikliklerini geri alır.

🗂️ Karakter Menüsü Yönetimi

Sadece karakter sayfasında (/World/Popmundo.aspx/Character/...) aktiftir.

PopControl, karakter sayfasındaki sol menüye üç ek katman ekler:

┌─────────────────────────┐
│  ⭐ TOP VIP             │  ← Script'lerin kaydettiği butonlar
├─────────────────────────┤
│  ⭐ Sık Kullanılanlar   │  ← Sizin favorilere eklediğiniz öğeler
├─────────────────────────┤
│  Kariyer                │  ← Oyunun orijinal menüsü
│  Aktivite               │
│  ...                    │
└─────────────────────────┘

⭐ TOP VIP Menüsü

Script'ler (Helper, Guide, Route49 vb.) kendi butonlarını TOP VIP bölümüne kaydedebilir. Bu bölüm:

Kariyer menüsünün hemen üstünde konumlanır

Mavi-mor gradyan başlıkla orijinal menüden ayrışır

Başlığa tıklanarak katlanabilir — açık/kapalı durumu sayfa yenilemelerinde de hatırlanır

İçindeki butonlar ⇅ Sırala kulakçığıyla sürükle-bırak ile sıralanabilir

Menü Yönetimi ekranından öğeler gizlenebilir 👁

⭐ Favoriler

Herhangi bir menü öğesini ⭐ butonuyla favorilere alabilirsiniz:

TOP VIP'in hemen altında, Kariyer'in üstünde ayrı bir bölümde görünür

Pembe gradyan renk temasıyla tanınır

⇅ Sırala kulakçığıyla yeniden sıralanabilir

Menü Yönetimi ekranında etiket olarak görüntülenir, ✕ ile kaldırılır

👁 Göster / Gizle

Her menü öğesinin yanındaki 👁 / 🚫 butonuyla öğeyi gizleyebilirsiniz:

Dil fark etmeksizin çalışır — metin eşleşmesi değil, URL / ID bazlı tanıma

TOP VIP butonları da gizlenebilir (v2.3 ile eklendi)

Karakter ID gibi dinamik URL segmentleri normalize edilerek eşleştirilir — URL değişse de gizleme çalışmaya devam eder

🔄 Tümünü Sıfırla butonu tüm gizleme ve favori ayarlarını temizler

⚠️ Favoriler bölümündeki öğeler gizlenme kapsamı dışındadır — zaten siz seçtiniz.

🗂️ Menü Yönetimi Ekranı

Ayarlar → 🗂️ Yönet butonuyla açılır:

┌──────────────────────────────────────────────┐
│  🗂️ Menü Yönetimi                        ✕  │
├──────────────────────────────────────────────┤
│  ⭐ Favori ekle  👁 Göster/Gizle  ⇅ Sırala  │
├──────────────────────────────────────────────┤
│  ▼ ⭐ TOP VIP (3)                            │  ← Tıkla: aç/kapat
│      🛠️ PopControl Ayarlar          👁      │
│      🧭 Guide Paneli                 👁      │
│      🗺️ Route49                     👁      │
├──────────────────────────────────────────────┤
│  ⭐ Sık Kullanılanlar                        │
│  [ Envanter ✕ ] [ Konser Ekle ✕ ] ...        │
├──────────────────────────────────────────────┤
│  ▼ Kariyer                                   │  ← Tıkla: aç/kapat
│      Envanter                   ☆  👁        │
│      Offer Item                 ⭐  🚫       │
│      ...                                     │
│  ▼ Aktivite                                  │
│      ...                                     │
├──────────────────────────────────────────────┤
│  🔄 Tümünü Sıfırla       [ Kapat ]           │
└──────────────────────────────────────────────┘

Bölümlerin açık/kapalı durumu ppc-sec-* anahtarlarıyla saklanır — paneli kapatsanız bile bir sonraki açılışta aynı durumda gelir.

⌨️ Klavye Kısayolları

Kısayol | Eylem
Alt + P | Kontrol çubuğunu aç / kapat

🌍 Özel Dil Desteği (Customize)

PopControl ve bağlı tüm script'ler TR / EN / PT-BR dışında herhangi bir dile çevrilebilir.

Nasıl Kullanılır?

1. Ayarlar → 🌍 Customize butonuna tıklayın

2. 📋 Copy Export JSON ile tüm çevrilecek metinleri kopyalayın

3. Google Gemini veya başka bir yapay zekaya yapıştırın, hedef dili belirtin

4. Dönen JSON'ı Import kutusuna yapıştırıp ✅ Apply & Reload deyin

5. Tüm script arayüzleri anında yeni dile geçer

Desteklenen Script'ler

Script | JSON Anahtarı
Helper | helper
Social | social
Social Mobile | social_mobile
Depot | depot
Guide | guide
Route49 | route49

🔗 Script Ekosistemi

PopControl, tüm Popmundo script'lerinin bağlandığı merkezi noktadır:

┌──────────────────── PopControl ────────────────────┐
│     Merkezi çubuk · Dil · Renk · Script yönetimi   │
└────────┬──────────┬──────────┬──────────┬──────────┘
         │          │          │          │
    ┌────┴──┐  ┌────┴──┐  ┌───┴───┐  ┌───┴────┐
    │Helper │  │Social │  │ Guide │  │Route49 │
    └───────┘  └───┬───┘  └───────┘  └────────┘
                   │
           ┌───────┴────────┐   ┌──────────┐
           │ Social Mobile  │   │  Depot   │
           └────────────────┘   └──────────┘

Script | Açıklama
🛠️ PopControl | Merkezi yönetim — bu script
🎨 Helper | UI iyileştirmeleri, araç paneli, HelperHub API
🌐 Social | Radar, Shelf, Karakter Kartı, Hızlı Arama
📱 Social Mobile | Social'ın mobil optimize versiyonu
📦 Depot | Envanter yönetimi
🧭 Guide | Görev yardımı, yol bulma
🗺️ Route49 | Dünya turu planlama ve konser rezervasyonu

Tüm script'ler bağımsız çalışabilir. PopControl yoksa kendi başlarına devam ederler.

💡 İpuçları

Kurulum

Önce PopControl'ü kurun — diğer script'ler onu hazır bulunca otomatik bağlanır

Script sırasını iş akışınıza göre organize edin — en çok kullandıklarınız solda/üstte olsun

Çubuğu küçültün — oynarken yer kazanmak için ▼ veya Alt+P

Performans

Kullanmadığınız script'leri kapatın — toggle ile pasife alın, tarayıcı kaynakları korunur

Menü Yönetimini seyrek açın — ağır DOM taraması yaptığından sürekli açık bırakmayın

Renk değişikliklerinde ufak gecikme normaldir — çubuk yeniden oluşturulur

Menü Organizasyonu

Sık gittiğiniz sayfaları favorilere ekleyin — tek tıkla ulaşın

Seyrek kullandığınız menü öğelerini gizleyin — menü kalabalığını azaltın

TOP VIP sıralamasını en çok kullandığınız butona göre ayarlayın

🔒 Güvenlik ve Gizlilik

Yerel depolama — tüm veriler GM_setValue / localStorage ile yalnızca sizin tarayıcınızda saklanır

Dış sunucu yok — hiçbir veri dışarıya gönderilmez

İzin tabanlı erişim — yalnızca Tampermonkey'in izin verdiği GM_* fonksiyonları kullanılır

Açık kaynak — kodun tamamı Greasyfork üzerinde incelenebilir

📦 Sürüm Geçmişi

v2.3 (Güncel)

Menü Yönetimi büyük güncellemesi — gizleme düzeltildi, TOP VIP ayrıştırıldı

🐛 Hata Düzeltmeleri

Gizleme hiç çalışmıyordu — applyNativeItemVisibility() içinde menü öğelerinin key'i _normalizePath() uygulanmadan kontrol ediliyordu. URL'de karakter ID barındıran linkler (/OfferItem/3117642 gibi) normalize edilmiş key'lerle (/OfferItem/) hiçbir zaman eşleşmiyordu; tüm gizleme işlemi sessizce başarısız oluyordu.

✨ Yeni Özellikler

TOP VIP ayrı bölüm — Menü Yönetimi ekranında TOP VIP öğeleri Kariyer/Aktivite ile karışmıyor; kendi başlığı altında listeleniyor

TOP VIP gizleme — TOP VIP butonları artık 👁/🚫 ile gizlenebilir

Section state kalıcı — Menü Yönetimi bölümlerinin açık/kapalı durumu ppc-sec-* anahtarlarıyla localStorage'a kaydedilir; panel her açılışta sıfırlanmaz

🧹 Kod Temizliği

openMenuCustomizationUI() içinde tekrar eden inline CSS'ler CSS_* sabitlerine çekildi

Satır/buton oluşturma kodu mkItemRow() yardımcı fonksiyonuna taşındı

mkSecHdr() opsiyonel gradient parametresi aldı — TOP VIP için ayrı renk tonu

v2.2

TOP VIP menüsü eklendi (position: 'above-career')

Favoriler bölümü ve sürükle-bırak sıralama

Karakter menüsü gizleme altyapısı (normalize hatası bu versiyonda mevcuttu)

Menü Yönetimi overlay'i

Renk seçici ile bar rengi özelleştirme

_openCustomize() — özel dil import/export sistemi

v2.1 ve öncesi

Temel kontrol çubuğu (yatay/dikey konumlar)

Script kayıt sistemi (PopControl.register())

Sürükle-bırak buton sıralama (masaüstü + dokunmatik)

FAB (küçültülmüş durum butonu)

Alt+P klavye kısayolu

TR / EN / PT-BR dil desteği

Özel dil import/export (Customize) altyapısı

❓ Sorun Giderme

Çubuk hiç görünmüyor mu? → Alt+P kısayolunu deneyin. Hâlâ yoksa sayfayı yenileyin — PopControl #ppm-main veya #ppm-footer elementini bekler, bunlar yüklenmeden başlamaz.

Script butonları çubukta çıkmıyor mu? → Ayarlar → Script'ler bölümünden o script'in toggle'ının açık olduğunu kontrol edin.

Menü öğeleri gizlenmiyor mu? → v2.3'e güncelleyin. Eski versiyonlarda URL normalize hatası nedeniyle gizleme çalışmıyordu.

TOP VIP menüsü görünmüyor mu? → Yalnızca karakter sayfasında (/World/Popmundo.aspx/Character/...) görünür; diğer sayfalarda aktif değildir.

Favoriler kaydedilmiyor mu? → Tampermonkey'in GM_setValue izninin etkin olduğunu kontrol edin.

Menü Yönetimi her açılışta kapalı geliyor mu? → v2.3'e güncelleyin; bu versiyondan itibaren bölüm durumları hatırlanıyor.

Çubuk FAB moduna geçti, geri açılmıyor mu? → Sağ alt köşedeki ⚙️ butonuna tıklayın ya da Alt+P kullanın.

Ayarlar kaydedilmiyor mu? → Tampermonkey'in GM_setValue fonksiyonuna izin verildiğinden emin olun; tarayıcı depolama izinlerini kontrol edin.

📞 Destek

Kaynak | Bağlantı
🐛 Hata bildirimi | Greasyfork yorum bölümü
🇹🇷 Ekosistem dokümantasyonu | rentry.org/PopControlEkosistemi
🇬🇧 Ecosystem documentation | rentry.org/PopControlEcosystem
🇧🇷 Documentação do ecossistema | rentry.org/EcossistemaPopControl

PopControl, luke-james-gibson tarafından geliştirilen Popmundo script ekosisteminin merkezi yönetim modülüdür.