Dökümanlar Sunucu Entegrasyonu Sunucu Ekleme

Sunucu Ekleme

Minecraft sunucunu CMS'e tanıtarak mağaza entegrasyonunu etkinleştir.

Her Minecraft sunucu servers tablosunda bir kayıt olarak tutulur. Aynı CMS birden fazla sunucuyu yönetebilir; her ürün ve rütbe belirli bir sunucuya atanabilir.

Yeni Sunucu Ekleme

Admin panel → Sunucular → Yeni Sunucu. Aşağıdaki alanları doldur:

  • Adı: Kullanıcıya görünen isim (örn. "Survival", "SkyBlock").
  • Slug: URL için (otomatik oluşturulur).
  • IP adresi: Oyuncuların bağlandığı adres (örn. play.kareblok.tc).
  • Port: Oyun portu, genellikle 25565.
  • Konsol Türü: plugin (KB-Transfer — önerilen), rcon veya websender.
  • Konsol Portu: RCON için genellikle 25575 (plugin tipinde gerekmez).
  • Konsol Şifresi: RCON/WebSender şifresi (plugin tipinde gerekmez).
  • API Token: KB-Transfer (plugin) için (otomatik üretilir).

Hangi konsol tipi? Paylaşımlı hosting'lerin çoğu dışarı bağlantıyı engellediği için RCON/WebSender çalışmayabilir. Plugin (KB-Transfer) yönteminde eklenti siteye kendisi bağlanır; dışarı port açmaya gerek kalmaz, fiilen her hosting'de çalışır. Ayrıntı: Transfer (KB-Transfer).

Bağlantıyı Test Et

Sunucu satırındaki fiş (🔌) butonu ile konsol bağlantısını anında doğrulayabilirsin. Konsol tipine göre test eder:

  • Plugin: API token tanımlı mı + sunucu çevrimiçi mi kontrol edilir (eklenti push tabanlı olduğundan aktif bağlanılmaz).
  • RCON: Sunucuya gerçekten bağlanılır ve şifre doğrulanır.
  • WebSend: Konsol portuna erişilebilirlik denenir.

RCON/WebSend testi başarısızsa:

  • Sunucu server.properties dosyasında enable-rcon=true olduğundan emin ol.
  • Firewall'da RCON portu açık olmalı (aynı sunucuda değilse).
  • Hosting dışarı bağlantıyı engelliyorsa RCON/WebSend çalışmaz — bu durumda Plugin (KB-Transfer) yöntemine geç.

Çevrimiçi Durum

MinecraftQuery sınıfı sunucu durumunu 60 saniye önbellekle çeker; ana sayfa, oyun modu kartları ve mağazadaki "X oyuncu çevrimiçi" bilgisi buradan gelir.

Durum sorgusu her hosting'de çalışacak şekilde dayanıklıdır: önce alan adının SRV kaydını çözer, doğrudan soketi (fsockopen) dener, başarısız olursa dış bir durum servisine (HTTPS) düşer. Böylece paylaşımlı hosting fsockopen'i engellese bile çevrimiçi sayısı doğru görünür (oyunda erişilebilen her sunucu sitede de görünür).

RCON ile WebSender arasındaki fark için RCON ve WebSender sayfalarını incele.

Teşekkürler! Geri bildirimin kaydedildi.