Teamspeak3 Web Api [Steam+Nonsteam] Oyun Içi Ts3 Bağlantısı

Eklenti Adı: TeamSpeak3 Web Api
Eklenti Yapımcısı: Onur "MrStipFan" MASALCI
Eklenti Sürümü: 2.6
Eklenti Açıklaması; Steam - NonSteam kullanıcıların WebAPI ile TeamSpeak3 sunucunuza direkt bağlanmasını sağlar!



Önemli: Steam kullanıcılarında MOTD üzerinden HTTPS bağlantıların sorunsuz açılabilmesi için sunucuda aşağıdaki AMXX modül dosyasının kurulu olması gerekir:

Bu dosya sunucuda kurulu değilse, Steam istemcilerinde HTTPS MOTD sayfası düzgün açılmayabilir veya bağlantı ekranı siyah/boş görünebilir.

Önerilen modül konumu:

Modül yüklendikten sonra modules.ini içerisine eklenmelidir:

Modules.ini konumu:

Modül eklendikten sonra sunucu tamamen yeniden başlatılmalıdır.

Kısaca: Eğer WebAPI adresinizi https:// olarak kullanacaksanız, Steam MOTD desteği için easy_http_amxx_i386.so sunucuda kurulu olmak zorundadır.

---

Bu eklenti, Counter-Strike 1.6 sunucularında oyuncuların oyun içerisinden kolayca TeamSpeak3 sunucusuna bağlanmasını sağlar.

Oyuncu sunucuda belirlenen komutlardan birini yazdığında eklenti otomatik olarak oyuncuya özel bir WebAPI bağlantısı oluşturur. Bu bağlantı MOTD ekranı üzerinden açılır ve oyuncuya TeamSpeak3 bağlantı ekranı gösterilir.

Sistem, Steam ve NonSteam oyuncular için uygundur. Oyuncu TeamSpeak3 istemcisine otomatik yönlendirilebilir. Eğer oyuncunun istemcisi otomatik yönlendirmeyi desteklemiyorsa, açılan web sayfasında manuel bağlantı bilgileri gösterilir.

Eklenti tamamen config dosyası üzerinden yönetilir. TeamSpeak3 adresi, port, kanal adı, kanal şifresi, sunucu şifresi, oyuncu nick prefixi, chat prefixi ve WebAPI güvenlik anahtarı kolayca değiştirilebilir.

HTTPS Kullanımı Hakkında Önemli Not: WebAPI adresinizi HTTPS olarak kullanmanız önerilir. Fakat Steam MOTD ekranında HTTPS sayfanın düzgün çalışması için easy_http_amxx_i386.so modülü sunucuda kurulu olmalıdır.

---

Eklenti Özellikleri

• Oyun içerisinden TeamSpeak3 bağlantı sayfası açma.
  
• Steam ve NonSteam oyuncularla uyumlu çalışma.
  
• WebAPI destekli bağlantı sistemi.
  
• MOTD ekranı üzerinden web sayfası açma.
  
• HTTPS WebAPI desteği.
  
• Steam MOTD HTTPS desteği için easy_http_amxx_i386.so modül desteği.
  
• Oyuncunun nickini otomatik TeamSpeak3 nicki olarak kullanma.
  
• Oyuncu nickinin başına özel prefix ekleme.
  
• TeamSpeak3 sunucu adresi ve port ayarlama.
  
• TeamSpeak3 sunucu şifresi desteği.
  
• TeamSpeak3 kanal adı desteği.
  
• TeamSpeak3 kanal şifresi desteği.
  
• Chat prefixini config dosyasından değiştirme.
  
• Config dosyasını otomatik oluşturma.
  
• Admin komutu ile ayarları sunucu kapatmadan yenileme.
  
• Web tarafında shared_key güvenlik kontrolü.
  
• Firma bağımsız kullanım.
  
• KCS / KINGOFCS gibi sabit marka yazıları içermez.
  

---

Oyuncu Komutları

Oyuncular aşağıdaki komutlardan herhangi birini kullanarak TeamSpeak3 bağlantı ekranını açabilir:

Bu komutlar hem normal chat hem de takım chat üzerinden çalışır.

Örnek kullanım:

---

Admin Komutu

Eklentide ayarları sunucuyu kapatmadan tekrar yüklemek için admin komutu bulunmaktadır.

Bu komutu kullanabilmek için adminde ADMIN_CFG yetkisi olması gerekir.

AMXX yetki karşılığı:

Bu komut kullanıldığında config dosyası tekrar okunur ve aşağıdaki ayarlar güncellenir:

• WebAPI bağlantı adresi
  
• Shared key güvenlik anahtarı
  
• TeamSpeak3 başlığı
  
• TeamSpeak3 sunucu adresi
  
• TeamSpeak3 portu
  
• TeamSpeak3 sunucu şifresi
  
• TeamSpeak3 kanal adı
  
• TeamSpeak3 kanal şifresi
  
• Nick otomatik kullanımı
  
• Nick prefixi
  
• Chat prefixi
  

---

Dosya Yapısı

Eklenti dosyası:

Derlenmiş plugin dosyası:

Config dosyası:

Web dosyaları örnek konumu:

Steam MOTD HTTPS desteği için gerekli modül dosyası:

Modules.ini dosyası:

---

Config Dosyası

Eklenti ayar dosyasını şu konumdan okur:

Eğer config dosyası yoksa eklenti ilk çalışmada otomatik olarak varsayılan config dosyasını oluşturur.

Varsayılan config içeriği:

---

Config Ayarlarının Açıklaması

open_url

Oyuncu komut yazdığında açılacak web bağlantısıdır. Web dosyalarını hangi siteye yüklediyseniz buraya o adres yazılmalıdır.

HTTPS kullanımı önerilir. Fakat HTTPS kullanacaksanız Steam MOTD desteği için sunucuda easy_http_amxx_i386.so modülü kurulu olmalıdır.

Örnek:

shared_key

Eklenti ile web sitesi arasındaki güvenlik anahtarıdır.

Bu değer web tarafındaki config dosyasında bulunan TS3_SHARED_KEY değeri ile aynı olmalıdır.

AMXX config tarafı:

Web config tarafı:

İki değer aynı olmazsa web sayfası bağlantıyı reddeder.

title

Web sayfasında görünecek başlık bilgisidir.

ts3_server

TeamSpeak3 sunucu adresidir. IP veya domain yazılabilir.

Örnek:

veya

ts3_port

TeamSpeak3 sunucu portudur. Varsayılan TeamSpeak3 portu genelde 9987 olarak kullanılır.

ts3_serverpw

TeamSpeak3 sunucusunda genel sunucu şifresi varsa buraya yazılır. Şifre yoksa boş bırakılır.

Örnek:

ts3_channel

Oyuncunun bağlanırken yönlendirileceği TeamSpeak3 kanal adıdır.

Örnek:

ts3_channelpw

Belirlenen TeamSpeak3 kanalında şifre varsa buraya yazılır. Şifre yoksa boş bırakılır.

Örnek:

nick_auto

Oyuncunun oyun içindeki nickinin TeamSpeak3 nicki olarak kullanılıp kullanılmayacağını belirler.

Değerler:

nick_prefix

Oyuncunun TeamSpeak3 nickinin başına otomatik prefix eklemek için kullanılır.

Örnek:

Oyuncunun oyun içi nicki Onur ise TeamSpeak3 nicki şu şekilde hazırlanır:

chat_prefix

Eklentinin oyun içi chat mesajlarında kullanacağı prefix değeridir.

Örnek:

Oyuncuya giden mesajlar şu şekilde görünür:

---

Steam MOTD HTTPS Desteği Kurulumu

Bu eklentide WebAPI adresini https:// olarak kullanmak istiyorsanız Steam MOTD tarafında HTTPS sayfanın düzgün açılması için easy_http_amxx_i386.so modülü gereklidir.

Gerekli modül dosyası:

Modülün atılması gereken örnek dizin:

Daha sonra şu dosyayı açın:

En alta şunu ekleyin:

Ardından sunucuyu tamamen yeniden başlatın.

Not: Sadece map değiştirmek bazı durumlarda modülün yüklenmesi için yeterli olmayabilir. Modül kurulumundan sonra sunucunun tamamen kapatılıp açılması önerilir.

Kontrol için sunucu konsolunda modül listesini kontrol edebilirsiniz:

Eğer modül düzgün yüklendiyse, HTTPS MOTD sayfaları Steam istemcilerinde daha sağlıklı çalışacaktır.

---

Eklenti Nasıl Çalışır?

Oyuncu oyun içinde /ts3, /ts, /teamspeak veya /ses komutlarından birini yazdığında eklenti şu işlemleri yapar:

1. Oyuncunun sunucuda bağlı olup olmadığını kontrol eder.
   
2. open_url, shared_key ve ts3_server ayarlarının dolu olup olmadığını kontrol eder.
   
3. Oyuncunun oyun içi nickini alır.
   
4. nick_auto aktifse oyuncu nickini TeamSpeak3 nicki olarak hazırlar.
   
5. nick_prefix doluysa nickin başına prefix ekler.
   
6. Tüm bağlantı bilgilerini URL formatına uygun hale getirir.
   
7. WebAPI bağlantı adresini oluşturur.
   
8. MOTD penceresi ile oyuncuya web sayfasını açar.
   
9. Oyuncunun konsoluna bağlantı bilgilerini yazar.
   
10. Chat üzerinden oyuncuya bilgilendirme mesajı gönderir.
    

---

WebAPI Parametreleri

Eklenti web tarafına şu GET parametrelerini gönderir:

Örnek bağlantı mantığı:

Web tarafı gelen key değerini kontrol eder. Eğer key doğruysa bağlantı ekranı açılır. Key yanlışsa veya eksikse istek reddedilir.

---

Web Site Dosyaları

Web dosyaları sitenizin public dizinine yüklenmelidir.

Örnek kurulum:

Eğer siteniz sunucuda /var/www/html dizinini kullanıyorsa:

Kurulumdan sonra WebAPI adresiniz şu şekilde olur:

Bu adresi AMXX config dosyasındaki open_url alanına yazmanız gerekir.

Önemli: WebAPI adresiniz https:// ile başlıyorsa Steam MOTD HTTPS desteği için easy_http_amxx_i386.so modülü kurulu olmalıdır.

---

Kurulum Anlatımı

1. SMA dosyasını scripting klasörüne atın.

2. SMA dosyasını derleyin.

Linux örnek:

Derleme sonrası oluşan dosya:

3. AMXX dosyasını plugins klasörüne atın.

4. plugins.ini içine ekleyin.

En alta ekleyin:

5. Config dosyasını düzenleyin.

Örnek:

6. Web dosyalarını sitenize yükleyin.

7. Shared key değerini eşitleyin.

AMXX config:

Web config:

8. HTTPS kullanacaksanız easy_http_amxx_i386.so modülünü kurun.

Modül dosyasını şuraya atın:

Modules.ini dosyasına ekleyin:

Modules.ini konumu:

9. Sunucuyu yeniden başlatın veya map değiştirin.

Modül kurulumu yaptıysanız tam sunucu restart önerilir.

Config değişikliklerinden sonra sunucuyu kapatmadan yenilemek için:

---

Örnek Hazır Config

---

Şifreli Sunucu İçin Örnek Config

---

Gereksinimler

AMXX tarafı:

Steam MOTD HTTPS desteği için gerekli modül:

Modül yolu:

Modules.ini satırı:

Web tarafı:

---

Dikkat Edilmesi Gerekenler

• shared_key varsayılan bırakılmamalıdır.
  
• shared_key AMXX ve web tarafında aynı olmalıdır.
  
• open_url doğru web adresini göstermelidir.
  
• WebAPI adresi HTTPS ise Steam MOTD desteği için easy_http_amxx_i386.so kurulu olmalıdır.
  
• easy_http_amxx_i386.so modülünü kurduktan sonra sunucu tamamen yeniden başlatılmalıdır.
  
• Web dosyaları HTTPS çalışan bir domaine yüklenirse daha sağlıklı çalışır.
  
• TeamSpeak3 protokol bağlantısı bazı oyun istemcilerinde otomatik açılmayabilir.
  
• Otomatik açılmayan durumlarda oyuncu sayfadaki manuel bilgileri kullanabilir.
  
• Sunucu ve kanal şifreleri config dosyasında tutulduğu için dosya izinlerine dikkat edilmelidir.
  

---

Sık Karşılaşılan Sorunlar

Steam kullanıcılarda MOTD siyah/boş görünüyor veya HTTPS sayfa açılmıyor.

Sebep:

Çözüm:

Modül dosyasını şu konuma atın:

Sonra modules.ini içine ekleyin:

Ardından sunucuyu tamamen yeniden başlatın.

Web sayfası açılıyor ama bağlantı reddediliyor.

Sebep:

Çözüm:

Şu iki dosyadaki key değerini aynı yapın:

Komut yazınca hiçbir şey olmuyor.

Kontrol edilmesi gerekenler:

Kontrol komutu:

Config değişti ama ayarlar uygulanmadı.

Çözüm:

veya sunucuyu yeniden başlatın.

MOTD açılıyor ama TeamSpeak3 otomatik açılmıyor.

Sebep:

Bazı istemciler ts3server:// protokolünü MOTD içinden otomatik çalıştırmayabilir.

Çözüm:

Oyuncu sayfadaki manuel bağlantı bilgilerini kullanarak TeamSpeak3 uygulamasından giriş yapabilir.

---

Sonuç

TeamSpeak3 Web Api v2.6, CS 1.6 sunucuları için hazırlanmış kullanışlı, sade ve ayarlanabilir bir TeamSpeak3 yönlendirme sistemidir.

Oyuncular oyun içinden tek komutla TeamSpeak3 bağlantı ekranına ulaşabilir. Sunucu sahibi ise tüm bağlantı bilgilerini config dosyası üzerinden kolayca yönetebilir.

WebAPI adresi HTTPS olarak kullanılacaksa Steam MOTD desteği için easy_http_amxx_i386.so modülünün sunucuda kurulu olması gerekir. Bu modül kurulu olduğunda HTTPS bağlantı ekranı Steam kullanıcılarında daha sağlıklı şekilde çalışır.

Firma bağımsız yapısı sayesinde farklı sunuculara, farklı web sitelerine ve farklı TeamSpeak3 adreslerine kolayca uyarlanabilir.

Bu içeriği görebilmek için kayıt olmanız gerekiyor!

Konunuz onaylanmıştır, teşekkürler.

Teşekkür ederim.

Tesekkurler

Teşekrüller ellerine sağlık