20-11-2026, 09:13
TS3 query hata kodları: 512, 768, 771, 1024, 1538, 2568 ne anlama gelir?#1
Kısa özet: TS3 ServerQuery hata kodlarının en sık görülenleri: 512 invalid clientID (clid geçersiz, her bağlantıda değişir), 768 invalid channelID, 771 channel name is already in use, 1024 invalid serverID, 1033 server is not running, 1538 invalid parameter (çoğu zaman kaçış karakteri unutulmuş), 1539 parameter not found, 520 invalid loginname or password ve 2568 insufficient client permissions (failed_permid eksik izni gösterir). Flood durumunda komutlar arasına bekleme koyun ve botun IP'sini izin listesine ekletin.
Hata kodları
ServerQuery komutları başarısız olduğunda error id=... satırında bir kod döner. Kodu bilmek hatayı hızla çözmenizi sağlar.
Kullanıcı ve kanal
- 512 invalid clientID: kullanıcı numarası (clid) geçersiz. Kullanıcı çıkmış olabilir; clid her bağlantıda değişir.
- 768 invalid channelID: kanal yok ya da silinmiş.
- 771 channel name is already in use: aynı seviyede aynı isimde kanal var.
Sunucu
- 1024 invalid serverID: seçmeye çalıştığınız sanal sunucu yok.
- 1033 server is not running: sanal sunucu kapalı.
Parametreler
- 1538 invalid parameter: bir parametre hatalı; çoğu zaman kaçış karakteri (boşluk için kaçış dizisi) unutulmuştur.
- 1539 parameter not found: zorunlu parametre eksik.
İzin ve oturum
- 520 invalid loginname or password: giriş bilgileri yanlış.
- 2568 insufficient client permissions: query hesabının bu işlem için izni yok. Cevapta hangi iznin eksik olduğu failed_permid ile gösterilir.
Flood
Kısa sürede çok fazla komut gönderen bağlantı geçici olarak banlanır. Komutlar arasına bekleme koyun ve botun IP'sini izin listesine ekletin. Hata sonrası hızlı tekrar denemekten kaçının.
Mesajları okumak
Hata mesajlarındaki msg= kısmı kaçış karakterleriyle gelir: invalid\sclientID, "invalid clientID" anlamına gelir. Mesajı çözen küçük bir fonksiyon hata ayıklamayı kolaylaştırır. Botunuzda hata kodlarını günlüğe yazmak sorunları sonradan incelemeyi sağlar.
Sık yapılan hatalar
- clid'yi saklayıp tekrar kullanmak.
- Kaçış karakterlerini unutmak.
- Flood'a rağmen hızlı denemek.
- Eksik izni araştırmamak.
- Hata kodlarını günlüğe yazmamak.
Sık sorulan sorular
512 ne demek? Geçersiz kullanıcı numarası.
1538 neden? Parametre hatalı; kaçış unutulmuş olabilir.
2568 ne yapmalı? failed_permid'e bakıp izni verin.
Örnek senaryo
Botunuz 2568 hatası alıyor. failed_permid alanından eksik izni bulup bot grubuna verince komut çalışıyor; hata kodlarını artık günlüğe yazdığınız için sorunları hızla çözüyorsunuz.
Kontrol listesi
- Kod anlaşıldı mı?
- Kaçış doğru mu?
- İzin verildi mi?
- Flood önlendi mi?
- Günlük tutuluyor mu?
Ek ipucu
Sık gördüğünüz hata kodlarını ve çözümlerini bir tabloda tutun; zamanla kendi ServerQuery hata sözlüğünüz oluşur ve botlarınızı çok daha hızlı hata ayıklarsınız. Değişiklikleri önce test ortamında deneyin, çalışan son hâli yedekte tutun ve işe yarayan çözümü bir not dosyasına yazın. Her adımdan sonra sonucu doğrulayın; küçük ve ölçülü değişiklikler hataları bulmayı çok kolaylaştırır.
Takıldığınız bir yer olursa bu konunun altına yazın; ekip ve topluluk yardımcı olur.