> ## Documentation Index
> Fetch the complete documentation index at: https://docs.zonely.gen.tr/llms.txt
> Use this file to discover all available pages before exploring further.

# WebSender, RCON ve Komut Teslimatı Sorunları

> Web sitesinden alınan ürünlerin oyunda teslim edilmemesi, WebSender 8000 portu ve konsol komut hataları.

Zonely mağazanızdan bir ürün veya bakiye satın alındığında, ilgili oyun sunucusuna komut iletimi WebSender veya RCON protokolü üzerinden gerçekleştirilir.

***

## En Sık Karşılaşılan Sorunlar ve Çözümleri

> [accordion] WebSender 'Connection timed out' veya 'Connection refused' hatası veriyor
>
> Web siteniz oyun sunucusundaki WebSender eklentisine TCP üzerinden ulaşamadığında bu hatayı alırsınız.
>
> * **1. Güvenlik Duvarı (Port 8000) Kuralı:**
>   WebSender varsayılan olarak **TCP 8000** portunu dinler. Oyun sunucunuzun barındığı makinede (Windows Güvenlik Duvarı veya Linux UFW) 8000 portu dış bağlantılara kapalıysa Zonely sunucusu bağlantı kuramaz.
>   * **Linux (UFW):**
>     ```bash title="Sunucu Terminali" theme={"theme":"css-variables"}
>     sudo ufw allow 8000/tcp
>     sudo ufw reload
>     ```
>   * **Windows Server:** Windows Defender Güvenlik Duvarı -> *Gelen Kuralları (Inbound Rules)* -> Yeni Kural -> *Bağlantı Noktası (Port)* -> TCP 8000 -> *Bağlantıya İzin Ver*.
>   * **Hosting Paneli:** Keyubu, Batihost veya Rabisu gibi oyun sunucusu panellerinde "Port Yönetimi" veya "Güvenlik Duvarı" sekmesinden WebSender portunun açık olduğunu teyit edin.
> * **2. Cloudflare Turuncu Bulut Hatası:**
>   WebSender adresiniz için `websender.alanadiniz.com` gibi bir alt alan adı kullanıyorsanız, bu kaydın Cloudflare üzerinde **Turuncu Bulut (Proxied)** değil, mutlaka **Gri Bulut (DNS Only)** olması gerekir.

> [accordion] WebSender bağlı görünüyor ama komutlar oyun konsoluna düşmüyor
>
> Bağlantı testi başarılı geçmesine rağmen satın alma sonrası komut çalışmıyorsa:
>
> * **Parola ve Hash Algoritması Uyuşmazlığı:**
>   Zonely yönetim panelindeki **Sunucular → Düzenle → WebSender Parolası** ile oyun sunucunuzdaki `plugins/WebSender/config.yml` dosyasındaki `password` alanının harfi harfine aynı olduğundan emin olun. Parolada Türkçe karakter (`ş`, `ı`, `ğ`) veya boşluk kullanmayın.
> * **Komuttaki Değişken Formatı:**
>   Komut şablonlarında oyuncu adı için `%player%`, adet için `%amount%` gibi Zonely standart değişkenlerini kullanın. Yanlış yazılan değişkenler (örneğin `{player}` veya `%oyuncu%`) sunucuda syntax hatasına yol açar.

> [accordion] Oyuncu oyunda değilken komut teslim edilmiyor veya kayboluyor
>
> Bazı Minecraft komutları (örneğin `/give %player% ...` veya `/eco give %player% ...`) oyuncunun sunucuda aktif olarak oturum açmış olmasını gerektirir.
>
> * **Kök Neden:** Oyuncu web sitesinden alışveriş yaparken oyunda değilse, sunucu komutu çalıştırdığında *"Player not found"* (Oyuncu bulunamadı) hatası verir ve eşya yere düşmeden işlem kaybolabilir.
> * **Çözüm:**
>   1. Zonely Yönetim Paneli -> **Mağaza → Ürünler** bölümüne gidin.
>   2. İlgili ürünü düzenleyin ve **"Oyuncu oyundayken teslim et" (Online Required)** seçeneğini aktif hale getirin.
>   3. Bu seçenek açık olduğunda Zonely ürünü kuyruğa alır; oyuncu sunucuya giriş yaptığı anda WebSender veya ZonelyCore komutu otomatik olarak tetikler.

> [accordion] RCON ile WebSender arasındaki fark nedir, hangisini seçmeliyim?
>
> * **WebSender (Önerilen):** Minecraft için özel geliştirilmiş bir eklentidir. Şifreli hash doğrulaması kullanır, hafiftir ve büyük sunucularda stabil çalışır.
> * **RCON:** Minecraft sunucusunun `server.properties` dosyasında yerleşik olarak bulunan protokoldür. Ek eklenti gerektirmez ancak şifreleme ve port güvenliği açısından `rcon.password` alanının çok güçlü tutulması ve `rcon.port` portunun dış erişime güvenle açılması gerekir.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.