21-11-2026, 21:07
TS3 botu Node.js ile yazmak: hazır kütüphane kullanımı#1
Kısa özet: JavaScript biliyorsanız TS3 botunu Node.js ile yazabilirsiniz. ts3-nodejs-library gibi topluluk kütüphaneleri ServerQuery kaçış kurallarını, olay dinlemeyi ve canlı tutmayı sizin yerinize yapar. npm init -y ve npm install ts3-nodejs-library ile kurulur; TeamSpeak.connect ile bağlanılır ve ts.on("clientconnect", ...) ile olaylar dinlenir. Kullanıcı adı ve parola gibi gizli bilgileri kodun içine yazmak yerine ortam değişkeninden okuyun. Kütüphane sürümleri değişebilir, bağlantı koparsa yeniden bağlanmayı ele alın.
TS3 botunu Node.js ile yazmak
JavaScript'e alışkınsanız TS3 botunu Node.js ile yazmak hızlı bir yoldur. Bu konuda kurulum, basit örnek ve dikkat edilecek noktaları anlatıyoruz.
Kurulum
KOD
npm init -y
npm install ts3-nodejs-libraryBasit örnek
KOD
const { TeamSpeak, QueryProtocol } = require("ts3-nodejs-library");
const ps = process.env.TS_PAROLA;
(async () => {
const ts = await TeamSpeak.connect({
host: "127.0.0.1",
protocol: QueryProtocol.RAW,
queryport: 10011,
serverport: 9987,
username: process.env.TS_KULLANICI,
password: ps,
nickname: "HepOyuncu Bot"
});
ts.on("clientconnect", async ({ client }) => {
await client.message("Hoş geldin " + client.nickname + "!");
});
})();Kütüphanenin avantajları
- Kaçış ve ayrıştırma otomatik
- Olaylar hazır (clientconnect, clientdisconnect, textmessage)
- Canlı tutma kendiliğinden
Dikkat
- Kütüphane sürümleri değişebilir; belgelerini kontrol edin.
- Bağlantı koparsa yeniden bağlanmayı ele alın.
- Çok sık komut göndererek flood korumasına takılmayın.
Gizli bilgiler
Şifreleri ortam değişkeninden okumak (örnekteki gibi), kodu paylaşırken şifrenin sızmasını önler. Kodu bir depoya yüklüyorsanız gizli bilgilerin bulunduğu dosyayı yoksayma listesine ekleyin.
Sık yapılan hatalar
- Parolayı kodun içine yazmak.
- Kütüphane sürümünü sabitlememek.
- Bağlantı kopmasını ele almamak.
- Çok sık komut göndermek.
- Hata yakalama koymamamak.
Sık sorulan sorular
Hangi kütüphane? Örnekte ts3-nodejs-library kullanıldı; güncel belgelerini kontrol edin.
Gizli bilgileri nereye koymalı? Ortam değişkenlerine.
Olaylar nelerdir? clientconnect, clientdisconnect, textmessage gibi.
Örnek senaryo
Bir topluluk, kullanıcı bağlandığında karşılama mesajı gönderen küçük bir Node.js botu yazdı. Parolayı ortam değişkenine taşıyınca botun kodunu güvenle paylaşabildi.
Kontrol listesi
- Kütüphane kuruldu mu?
- Gizli bilgiler ortamda mı?
- Yeniden bağlanma ele alındı mı?
- Komut hızı makul mü?
- Bot kullanıcısı kısıtlı mı?
Ek ipucu
Botu çalıştıracağınız query kullanıcısına yalnızca gerekli yetkileri verin; böylece bot kodunda bir hata ya da sızıntı olsa bile sunucunun tamamı risk altına girmez. Değişiklikleri önce test ortamında deneyin, çalışan son hâli yedekte tutun ve oyuncu geri bildirimlerini düzenli toplayın; ayarlarınızı gerçek ihtiyaca göre şekillendirmenin en güvenilir yolu budur.
Takıldığınız bir yer olursa bu konunun altına yazın; ekip ve topluluk yardımcı olur.
Ek ipuçları
Bot koduna hata yakalama (try/catch) eklemeyi unutmayın; yakalanmamış bir hata botu sessizce durdurabilir. Botu bir süreç yöneticisiyle (ör. systemd ya da benzeri) çalıştırırsanız çöktüğünde otomatik yeniden başlar. Günlüklere önemli olayları yazmak, sonradan sorun bulmayı kolaylaştırır.