Dokümantasyon 9.6.24

Sorun giderme

Doğru sunucuyu, kurulu sürümü, zamanı ve görünen hatayı belirleyin. Paylaşacağınız loglardan gizli bilgileri kaldırın.

Bridge veri döndürmüyor#

Sunucunun Tosun Connect kartında bağlantının kapatılmadığını, server.cfg içinde tosun_db_bridge_enabled "1" olmadan set tosun_db_bridge_manual "1" bulunmadığını ve eski mirror’ın (ts.panelMirror.enabled) kapalı olduğunu kontrol edin. Ardından oxmysql’i, desteklenen framework/tablo yapısını ve son bağlantıyı kontrol edin. 9.6.14’ten eski bir tosun-ac paketi, yeni paket kurulana kadar server.cfg içinde set tosun_db_bridge_enabled "1" ister. İstekler sayfalıdır ve yalnız desteklenen alanları içerir; bridge tüm veritabanınızı kopyalamaz.

Koruma garantili mi?#

Hayır. Sunucu doğrulaması, sınırlı olay işleme ve kısıtlı yükleme anahtarları belirli riskleri azaltır. Kaynakları güncel tutun, yanlış tespitleri inceleyin, yönetici hesaplarını koruyun ve açığa çıkan anahtarları yenileyin. Paket şifrelemesi istemci kodunu incelenemez yapmaz.

Sorunu tekrar denemeden önce sınıflandırın#

Sorunun hangi aşamada çıktığını belirleyin: hesap girişi, ödeme, paket indirme, resource başlangıcı, panel bağlantısı, köprü isteği veya web sitesi yayını. Aynı anda bütün ayarları değiştirmek yerine ilk başarısız adımı bulun ve beklenen sonucu not edin.

Son çalışan zamanı, yeni bir sürüm veya ayar değişikliğini ve hatayı gören hesabı kaydedin. Konsol hatasıyla panel mesajı farklı olabilir; ikisinin zamanını birlikte inceleyin. Ekrandaki eski duruma bakarak güncel sunucu için karar vermeyin. Tek bir kontrollü testle sorunu tekrar gözlemlemek, arka arkaya yeniden başlatmadan daha açıklayıcıdır.

Ödeme veya ekonomi değişikliğinin sonucu belirsizse tekrar denemeyi durdurup mevcut fatura veya bakiye durumunu kontrol edin. Okuma hatasını gidermek için yazma yetkisi açmayın. Üretim sunucusunda sorunu araştırırken gerçek oyuncuyu banlamak, para vermek veya toplu işlem çalıştırmak gerekli değildir.

İndirme veya başlangıç reddediliyorsa#

İndirme için hesabın hizmet hakkı, ilgili sunucuya erişimi ve sunucu yönetim izni değerlendirilir. Düğmenin görünmesi, başka hesaba veya sunucuya ait bir bağlantının çalışacağını göstermez. Paketi hesabınızın kendi indirme ekranından alın.

Doğru hesap ve sunucuyu seçin. Faturalandırma veya yetki uyarısının metnini okuyun; başka kişinin linkini kullanmayın.
Resource adının tosun-ac olarak korunduğunu ve paketin eksiksiz çıkarıldığını kontrol edin. Eski ve yeni dosyaların karışmadığından emin olun.
Bağımlılıkları ve server.cfg başlangıç sırasını inceleyin. İlk konsol hatasını düzeltin; lisansı istemciye taşımayın.
Sürüm, sunucu kimliği ve gizli değerleri çıkarılmış hata metniyle destek isteyin. İndirilen arşivi veya lisansınızı herkese açık dosya paylaşımına koymayın.

Web sitesi, köprü veya 2FA bekliyorsa#

Web sitesi oluşturma işi sırada olabilir; aynı siteyi yeniden açmayın. Aktif site ile HTTPS durumu ayrı kontrol edilir. Özel alan adında yönlendirme kaydı ve sahiplik TXT kaydı birlikte gereklidir; yalnızca adresi kaydetmek sertifika hazırlığını tamamlamaz.

Köprü varsayılan olarak açıktır ve server.cfg’ye ek satır gerektirmez; okuma ve bakiye düzenleme için yine panel yetkisi gerekir. Sunucunun Tosun Connect kartında bağlantı kapatıldıysa, manuel modda (set tosun_db_bridge_manual "1") set tosun_db_bridge_enabled "1" eklenmediyse veya eski tam mirror açıksa (configs/anticheat_config.lua içinde ts.panelMirror.enabled = true) köprü yanıt vermez; son durumda mirror çalışmaya devam etsin diye köprü kapalı kalır. 9.6.14’ten eski paketlerde yeni paket kurulana kadar set tosun_db_bridge_enabled "1" satırı hâlâ gerekir. Desteklenen framework ve şemayı, oxmysql’i ve son bağlantı durumunu kontrol edin. Desteklenmeyen alanlar veya boş sayfa, bütün oyun veritabanının boş olduğu anlamına gelmez; köprü genel amaçlı SQL tarayıcısı değildir.

2FA kurulumunda on dakikalık süre dolduysa yeniden başlatın ve yeni QR/anahtarı kullanın. QR yerel oluşturulur; elle anahtar girmek de mümkündür. Kod reddinde doğru doğrulayıcı hesabını ve telefon saatini kontrol edin. Yedek kodlar ve kurulum anahtarı destek ekibine gönderilmez.

Destek talebini çözülebilir hâle getirin#

Kısa ama tam bir kayıt hazırlayın. “Çalışmıyor” yerine hangi işlem, hangi sonuç ve hangi zamanda olduğunu yazın. Bu bilgiler sorunun aynı kaynak üzerinde incelenmesini sağlar; gizli bilgilere ihtiyaç duyulmaz.

Kaynak: sunucu, site veya fatura kimliği; kullandığınız sürüm ve ilgili framework.
Adımlar: açılan ekran, yapılan işlem, beklenen sonuç ve görünen hata.
Zaman: hata tarihi ve saat dilimi; son çalışan durum ve yakın zamanda değişen ayar.
Gizlilik: lisans, parola, token, QR, banka kodu, tam kart bilgisi ve oyuncuya ait gereksiz kişisel bilgiler çıkarıldı.

Kanıtı kaybetmeden tarayıcı sorununu ayırın#

Sayfa yanlış yükleniyorsa yenilemeden önce adresini, seçilen hesabı ve görünen mesajı yazın. Sorunun görsel, reddedilen kayıt veya dış yönlendirme olup olmadığını belirleyin. Bu belirtilerin nedenleri farklıdır; bütün tarayıcı ayarlarını hemen temizlemek alttaki yetki veya hizmet durumunu düzeltmeden işe yarayan bağlamı silebilir. Ekran görüntüsü alıyorsanız adres ve hassas alanları kontrol edin.

Yalnızca görüntüleme sorunu için aynı sayfayı yeni tarayıcı oturumunda karşılaştırın, betik veya gezinmeyi engelleyen eklentileri kontrol edin. Amaçlanan hesaba tekrar giriş yaptığınızı doğrulayın. Eski form güvenlik oturumunun sona erdiğini bildiriyorsa eski formu tekrar tekrar göndermek yerine sayfayı normal gezinmeyle açın. Deneme sırasında değişen tarayıcı veya hesap koşullarını not edin.

Ödeme denemelerini ve ekonomi yazmalarını ilk sonuçları bilinene kadar bu karşılaştırmanın dışında tutun. Destek isteğine oturum çerezlerini veya kimlik doğrulama başlıklarını kopyalamayın. Tarayıcı sürümünü ve yeni oturumun sonucu değiştirip değiştirmediğini ilk hata ve zamanla birlikte bildirin. Böylece yalnızca yerel görüntüleme davranışı değiştiğinde bunu gerçek hizmet durumundan ayırmak mümkün olur.

Açık durma noktası olan kısa bir tekrar hazırlayın#

Bildirilen hataya ulaşan en küçük adım dizisini o işlemi yapmaya yetkili hesapla seçin. Örneğin sunucuyu seçip oyuncu listesini açın ve yanıtı kaydedin; okuma hatasını göstermek için bakiyeleri düzenlemek gerekmez. Her adımda ne olması gerektiğini belirtin. Destek ekibi aynı kaynak ve koşulları anlamadan yalnızca son mesaj üzerinden hatayı güvenilir biçimde değerlendiremez.

Sorun yalnızca belirli kaynak güncellemesinden sonra veya belli oyun eyleminde oluşuyorsa bu koşulu ekleyin. Son çalışan düzenle ve ilgili sürümle karşılaştırın. İlk başarısızlığı kaydettikten sonra durun; ek istekler, yeniden başlatmalar veya değişiklikler biriktirerek ilk nedeni belirsizleştirmeyin. Bir olayın yalnızca belirli zamanda oluşması önemliyse o aralığı ve saat dilimini de yazın.

Neleri kontrol ettiğinizi ve hangi sonuçların değişmediğini açıklayın. Yalnızca ilgili hatanın çevresindeki konsol satırlarını paylaşın, sırları ve ilgisiz oyuncu bilgilerini çıkarın. Kısa tekrar kaydı inceleyen kişiye sınanabilir bir durum ve önerilen düzeltmenin işe yarayıp yaramadığını belirleyeceği açık sınır verir. Tek bir somut örnek uzun fakat bağlamı olmayan bir günlük yığınından daha kullanışlıdır.

Düzeltmeyi ilk belirtiye karşı doğrulayın#

Önerilen düzeltmeden sonra ilk okuma veya oynanış senaryosunu benzer koşullarda tekrarlayın. Hem anlık yanıtı hem ilgili panel veya konsol kaydını kontrol edin. Bir uyarının kaybolması indirme, sunucu bağlantısı, website hazırlığı veya ödeme onayının beklenen sonuca ulaştığını tek başına göstermez. Beklenen sonucu değişiklikten önce yazmanız sonraki değerlendirmeyi daha açık hâle getirir.

Eski ve yeni sürümü veya ayar değerlerini değişiklik kaydında tutun. Oynanış sorunu için etkilenen olağan eylemi ve yakınındaki etkilenmemiş bir eylemi deneyin. Website sorunu için amaçlanan adresi ve HTTPS sonucunu doğrulayın. Ödemede test çekimi üretmek yerine mevcut fatura sonucunu kullanın. Kontrolün ne zaman ve hangi hesapla yapıldığını da kaydedin.

Belirti tekrar ortaya çıkarsa tekrar zamanını ve doğrulamadan sonra değişen koşulları bildirin. Bilinen çalışan yapılandırmaya yalnızca hazırladığınız kurtarma yöntemiyle dönün. Kısa vaka geçmişini saklayın ki sonraki inceleme aynı başarısız tahminleri tekrarlamak yerine doğrulanmış gözlemlerden başlasın. Düzeldiğini düşündüğünüz sonuçla yeniden oluşan hatayı aynı olaymış gibi birleştirmeden ayrı zamanlarda gösterin.

Destek formunu doldurulmuş anonim vaka ile hazırlayın#

Panelde Destek bölümünden yeni talep açın; hesabın support.create izni bulunmalıdır. Formun konu, kategori, öncelik ve mesaj alanlarını aşağıdaki kurgu örnek gibi doldurabilirsiniz. Teknik bir oyuncu listesi okuma sorunu için technical kategorisi ve normal öncelik seçilmiştir. Önceliği gerçek etkiye göre belirleyin: yalnız bir okuma ekranının sorununu bütün sunucunun kapalı olduğu olay gibi anlatmayın. Kategori ve öncelik etiketleri arayüz diline göre değişebilir; parantez içindeki değerler mevcut form seçenekleridir. Talep için lisans, parola veya veritabanı erişimi gerekmez.

Örnekteki sunucu ve referans adları gerçek müşteri kaydı değildir. Kendi yetkili destek talebinizde ilgili sunucuyu açıkça belirtin; aynı metni herkese açık kanalda paylaşırken gerekli anonimleştirmeyi yapın. Mesaj, tekrarlama adımlarını ve durma noktasını içerir: bakiye değiştirilmemiştir ve yeni iş başlatılmamıştır. Form konu için en az beş, mesaj için en az on karakter denetler; kısa bir başlık ve açıklama bu sınırları zaten karşılar. Yanıt geldikçe aynı talebe güncel gözlemi ekleyin. Konuyla ilgisiz bütün konsolu, SQL dökümünü veya çerezleri göndermek yerine yalnız arındırılmış ilgili satırları kullanın; öncelik seçimi yanıt süresi garantisi değildir.

Konu: Oyuncu listesi isteği tamamlanmıyor
Kategori: Teknik (technical)
Öncelik: Normal (normal)
Mesaj:
Sunucu: TEST-SERVER — bu örnekte anonim
Sürüm / framework: 9.6.3 / QBCore — örnek değerler
Zaman: 2026-09-26 14:03 UTC
Adımlar: Sunucuyu seçtim; oyuncu listesini bir kez açtım.
Beklenen: Tamamlanmış ilk oyuncu sayfası.
Gözlenen: pending sonrasında bağlantı zaman aşımı.
Referans: TEST-REQUEST — gerçek kimlik değildir
Kontrol edilen: resource başladı; ilgili okuma yetkisi mevcut.
Durma noktası: Yeni iş veya bakiye değişimi başlatmadım.
Gizli anahtar, çerez, _csrf ve oyuncu kimlikleri çıkarıldı.

Belirtiye göre ilerleme ve durma sınırını seçin#

Aşağıdaki karar sırası ilk başarısız adımı bulmak içindir; otomatik düzeltme ya da her hata için yeniden deneme kuralı değildir. Oyuncu listesi hiç açılmıyorsa önce HTTP sonucuna bakın: 401 oturum, 419 form güvenlik değeri, 403 hesap veya hizmet yetkisi, 429 kapasite/bekleme yoluna gider. Yalnız bir kayıt boş görünüyorsa karakterin ve desteklenen şemanın doğru olduğunu inceleyin. Aynı belirtinin farklı nedenleri olabilir; örneğin başarılı ama boş sayfa, reddedilen istekle aynı olay değildir. Her dalda önce mevcut kanıtı koruyun.

Bekleyen bir ekonomi yazması veya sonucu belirsiz ödeme varsa karar ağacının durma dalını seçin: mevcut istek, fatura ve güncel durum incelenmeden yeni işlem açmayın. Resource başlamıyorsa kurulum ve ilk konsol hatasına; meşru oyun hareketi işaretleniyorsa etkilenen entegrasyon ve dar izin süresine dönün. Geçici çözüm olarak bütün korumaları kapatmayın. Site aktif görünüp HTTPS açılmıyorsa alan adı ve sertifika aşamasını ayrı inceleyin. Yerel saat/ekran değişikliğini sunucudaki işlemin tamamlanması sanmayın. Hangi dalın hangi gözlemle seçildiğini destek mesajına yazın; bulamadığınız sonucu “başarılı” diye tamamlamayın. Bekleme, yetki reddi ve tamamlanmış boş sonucu ayrı kaydedin.