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!
ÖNEMLİ BİLGİ - STEAM MOTD HTTPS DESTEĞİ
Ö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:
Kod:
easy_http_amxx_i386.soÖnerilen modül konumu:
Kod:
addons/amxmodx/modules/easy_http_amxx_i386.soKod:
easy_http_amxx_i386.soKod:
addons/amxmodx/configs/modules.iniKı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.
Eklenti Hakkında Detaylı Bilgi
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:
Kod:
/ts3
/ts
/teamspeak
/sesÖrnek kullanım:
Kod:
say /ts3
say /ts
say /teamspeak
say /sesAdmin Komutu
Eklentide ayarları sunucuyu kapatmadan tekrar yüklemek için admin komutu bulunmaktadır.
Kod:
amx_ts3_reloadAMXX yetki karşılığı:
Kod:
h- 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ı:
Kod:
addons/amxmodx/scripting/ts3_webapi.smaKod:
addons/amxmodx/plugins/ts3_webapi.amxxKod:
addons/amxmodx/configs/ts3_webapi.iniKod:
public_html/ts3/open.php
public_html/ts3/config.php
public_html/ts3/index.php
public_html/ts3/assets/style.cssKod:
addons/amxmodx/modules/easy_http_amxx_i386.soKod:
addons/amxmodx/configs/modules.iniConfig Dosyası
Eklenti ayar dosyasını şu konumdan okur:
Kod:
addons/amxmodx/configs/ts3_webapi.iniVarsayılan config içeriği:
Kod:
; =======================================================
; TeamSpeak3 WebAPI Ayarlari
; shared_key degeri web/ts3/config.php icindeki TS3_SHARED_KEY ile ayni olmalidir.
; =======================================================
open_url=https://siteadiniz.com/ts3/open.php
shared_key=CHANGE_ME_TS3_SHARED_KEY_2026
title=TeamSpeak3 Sunucusu
ts3_server=ts3.siteadiniz.com
ts3_port=9987
ts3_serverpw=
ts3_channel=Genel Sohbet
ts3_channelpw=
nick_auto=1
nick_prefix=
chat_prefix=TS3Config Ayarlarının Açıklaması
open_url
Kod:
open_url=https://siteadiniz.com/ts3/open.phpHTTPS 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:
Kod:
open_url=https://panel.siteadiniz.com/ts3/open.phpKod:
shared_key=CHANGE_ME_TS3_SHARED_KEY_2026Bu değer web tarafındaki config dosyasında bulunan TS3_SHARED_KEY değeri ile aynı olmalıdır.
AMXX config tarafı:
Kod:
shared_key=CHANGE_ME_TS3_SHARED_KEY_2026Kod:
const TS3_SHARED_KEY = 'CHANGE_ME_TS3_SHARED_KEY_2026';title
Kod:
title=TeamSpeak3 Sunucusuts3_server
Kod:
ts3_server=ts3.siteadiniz.comÖrnek:
Kod:
ts3_server=185.10.10.10Kod:
ts3_server=ts3.siteadiniz.comKod:
ts3_port=9987ts3_serverpw
Kod:
ts3_serverpw=Örnek:
Kod:
ts3_serverpw=12345Kod:
ts3_channel=Genel SohbetÖrnek:
Kod:
ts3_channel=Counter-Strike 1.6 OdasiKod:
ts3_channelpw=Örnek:
Kod:
ts3_channelpw=kanalsifresiKod:
nick_auto=1Değerler:
Kod:
1 = Aktif
0 = PasifKod:
nick_prefix=Örnek:
Kod:
nick_prefix=CS-Kod:
CS-OnurKod:
chat_prefix=TS3Örnek:
Kod:
chat_prefix=Ses SunucusuKod:
[TS3] TeamSpeak3 baglanti sayfasi aciliyor.
[TS3] Otomatik acilmazsa sayfadaki manuel bilgileri kullanabilirsiniz.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ı:
Kod:
easy_http_amxx_i386.soKod:
addons/amxmodx/modules/easy_http_amxx_i386.soKod:
addons/amxmodx/configs/modules.iniKod:
easy_http_amxx_i386.soNot: 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:
Kod:
amxx modulesEklenti Nasıl Çalışır?
Oyuncu oyun içinde /ts3, /ts, /teamspeak veya /ses komutlarından birini yazdığında eklenti şu işlemleri yapar:
- Oyuncunun sunucuda bağlı olup olmadığını kontrol eder.
- open_url, shared_key ve ts3_server ayarlarının dolu olup olmadığını kontrol eder.
- Oyuncunun oyun içi nickini alır.
- nick_auto aktifse oyuncu nickini TeamSpeak3 nicki olarak hazırlar.
- nick_prefix doluysa nickin başına prefix ekler.
- Tüm bağlantı bilgilerini URL formatına uygun hale getirir.
- WebAPI bağlantı adresini oluşturur.
- MOTD penceresi ile oyuncuya web sayfasını açar.
- Oyuncunun konsoluna bağlantı bilgilerini yazar.
- Chat üzerinden oyuncuya bilgilendirme mesajı gönderir.
WebAPI Parametreleri
Eklenti web tarafına şu GET parametrelerini gönderir:
Kod:
key
title
server
port
serverpw
channel
channelpw
name
nickKod:
https://siteadiniz.com/ts3/open.php?key=ANAHTAR&title=BASLIK&server=TS3_ADRESI&port=9987&serverpw=&channel=Genel%20Sohbet&channelpw=&name=Oyuncu&nick=OyuncuWeb Site Dosyaları
Web dosyaları sitenizin public dizinine yüklenmelidir.
Örnek kurulum:
Kod:
public_html/ts3/open.php
public_html/ts3/config.php
public_html/ts3/index.php
public_html/ts3/assets/style.cssKod:
/var/www/html/ts3/open.php
/var/www/html/ts3/config.php
/var/www/html/ts3/index.php
/var/www/html/ts3/assets/style.cssKod:
https://siteadiniz.com/ts3/open.phpÖ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.
Kod:
addons/amxmodx/scripting/ts3_webapi.smaLinux örnek:
Kod:
cd /home/server/cstrike/addons/amxmodx/scripting
./amxxpc ts3_webapi.smaKod:
ts3_webapi.amxxKod:
addons/amxmodx/plugins/ts3_webapi.amxxKod:
addons/amxmodx/configs/plugins.iniKod:
ts3_webapi.amxxKod:
addons/amxmodx/configs/ts3_webapi.iniKod:
open_url=https://siteadiniz.com/ts3/open.php
shared_key=GUCLU_BIR_GIZLI_ANAHTAR
title=TeamSpeak3 Sunucusu
ts3_server=ts3.siteadiniz.com
ts3_port=9987
ts3_serverpw=
ts3_channel=Genel Sohbet
ts3_channelpw=
nick_auto=1
nick_prefix=
chat_prefix=TS3Kod:
public_html/ts3/AMXX config:
Kod:
shared_key=GUCLU_BIR_GIZLI_ANAHTARKod:
const TS3_SHARED_KEY = 'GUCLU_BIR_GIZLI_ANAHTAR';Modül dosyasını şuraya atın:
Kod:
addons/amxmodx/modules/easy_http_amxx_i386.soKod:
easy_http_amxx_i386.soKod:
addons/amxmodx/configs/modules.iniModül kurulumu yaptıysanız tam sunucu restart önerilir.
Config değişikliklerinden sonra sunucuyu kapatmadan yenilemek için:
Kod:
amx_ts3_reloadÖrnek Hazır Config
Kod:
; =======================================================
; TeamSpeak3 WebAPI Ayarlari
; =======================================================
open_url=https://siteadiniz.com/ts3/open.php
shared_key=TS3_WEBAPI_2026_GuvenliAnahtar
title=SiteAdiniz TeamSpeak3
ts3_server=ts3.siteadiniz.com
ts3_port=9987
ts3_serverpw=
ts3_channel=Genel Sohbet
ts3_channelpw=
nick_auto=1
nick_prefix=
chat_prefix=TS3Şifreli Sunucu İçin Örnek Config
Kod:
open_url=https://siteadiniz.com/ts3/open.php
shared_key=TS3_WEBAPI_2026_GuvenliAnahtar
title=Ozel TeamSpeak3 Sunucusu
ts3_server=ts3.siteadiniz.com
ts3_port=9987
ts3_serverpw=sunucusifresi
ts3_channel=Yetkili Odasi
ts3_channelpw=kanalsifresi
nick_auto=1
nick_prefix=CS-
chat_prefix=TS3Gereksinimler
AMXX tarafı:
Kod:
AMX Mod X 1.10 onerilir
Counter-Strike 1.6 / GoldSrc sunucu
MOTD destegi
client_print_color destekli AMXX surumuKod:
easy_http_amxx_i386.soKod:
addons/amxmodx/modules/easy_http_amxx_i386.soKod:
easy_http_amxx_i386.soKod:
PHP 7.4 veya uzeri onerilir
Apache / Nginx / LiteSpeed / OpenLiteSpeed
HTTPS onerilir
TeamSpeak3 istemcisiDikkat 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:
Kod:
easy_http_amxx_i386.so modülü sunucuda kurulu değildir veya modules.ini içine eklenmemiştir.Modül dosyasını şu konuma atın:
Kod:
addons/amxmodx/modules/easy_http_amxx_i386.soKod:
easy_http_amxx_i386.soWeb sayfası açılıyor ama bağlantı reddediliyor.
Sebep:
Kod:
shared_key değeri hatalı veya iki tarafta farklı.Şu iki dosyadaki key değerini aynı yapın:
Kod:
addons/amxmodx/configs/ts3_webapi.ini
web/ts3/config.phpKontrol edilmesi gerekenler:
Kod:
ts3_webapi.amxx plugins klasöründe var mı?
plugins.ini içine eklenmiş mi?
Sunucu yeniden başlatılmış mı?
Eklenti amxx plugins listesinde çalışıyor mu?Kod:
amxx pluginsÇözüm:
Kod:
amx_ts3_reloadMOTD 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.