> ## 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.

# Sunucu Bağlantısı, Giriş Adresi ve Oyuncu Durumu Sorunları

> Minecraft sunucusuna play/oyna adresi bağlama, özel portlar için SRV kaydı, sitede aktif oyuncu sayısı gösterme ve BungeeCord IP yönlendirme.

Minecraft sunucunuzun oyuncular tarafından kolayca hatırlanan bir adresle (`oyna.alanadiniz.com`) açılması, web sitenizde canlı oyuncu sayısının görüntülenmesi ve mağaza komutlarının doğru sunucuya teslim edilmesi; DNS kayıtları ve sunucu yapılandırmasının uyumuna bağlıdır.

***

## 1. Oyun Giriş Adresi (play / oyna) Alt Alan Adı Nasıl Bağlanır?

Oyuncularınızın sunucunuza sayısal IP adresi yerine alan adınızla bağlanmasını sağlamak için Cloudflare üzerinde bir **A Kaydı** açmanız gerekir.

### Adım Adım A Kaydı Kurulumu

1. [Cloudflare Dashboard](https://dash.cloudflare.com/)'a giriş yapın ve alan adınızı seçin.
2. Sol menüden **DNS → Records** sekmesine geçin ve **Add record** butonuna tıklayın.
3. Alanları aşağıdaki gibi doldurun:

| Alan | Değer | Açıklama |
| :- | :- | :- |
| **Type (Tür)** | `A` | IPv4 adresi yönlendirmesi. |
| **Name (Ad)** | `oyna` *(veya `play`)* | `oyna.alanadiniz.com` adresini oluşturur. |
| **IPv4 address** | `Sunucu_Sayisal_IP` | Oyun sunucunuzun VDS/Dedicated IP adresi (örn: `185.198.x.x`). |
| **Proxy status** | **DNS Only (Gri Bulut)** | **Çok Önemli:** Asla Turuncu Bulut yapılmamalıdır! |
| **TTL** | `Auto` | Otomatik önbellek süresi. |

4. **Save** butonuna basarak kaydı tamamlayın.

> [!WARNING]
>
> **Oyun Kayıtlarında Turuncu Bulut (Proxy) Neden Kapatılmalıdır?**
> Cloudflare'ın ücretsiz proxy katmanı yalnızca web protokollerini (HTTP / HTTPS) destekler; Minecraft oyun trafiğinin kullandığı TCP 25565 portunu filtreleyemez. Oyun kaydını Turuncu Bulut yaparsanız oyuncular oyuna bağlanırken *"Can't resolve hostname"*, *"Bilinmeyen ana bilgisayar"* veya *"Bağlantı zaman aşımına uğradı"* hataları alır. Bu nedenle `oyna` ve `play` kayıtları **mutlaka Gri Bulut (DNS Only)** olmalıdır.

***

## 2. Özel Portlu Sunucularda Portsuz Giriş (SRV Kaydı Kurulumu)

Sunucu sağlayıcınız (Batihost, Keyubu, Rabisu, Nitrado vb.) size standart `25565` yerine özel bir port verdiyse (örneğin `25577`, `25585`, `30120` vb.), oyuncuların `oyna.alanadiniz.com:25577` gibi hatırlanması zor bir port yazmadan doğrudan `oyna.alanadiniz.com` yazarak oyuna girebilmesi için **SRV Kaydı** tanımlanmalıdır.

### Cloudflare Üzerinde SRV Kaydı Nasıl Açılır?

1. Cloudflare DNS sekmesinde **Add record** deyin ve türü **`SRV`** seçin.
2. Açılan formdaki alanları şu şekilde yapılandırın:

| Parametre | Değer | Açıklama |
| :- | :- | :- |
| **Service (Hizmet)** | `_minecraft` | Minecraft oyun protokolü. |
| **Protocol (Protokol)** | `TCP` | İletim protokolü. |
| **Name (Ad)** | `oyna` *(veya `play`)* | Portsuz bağlanılacak alt alan adı. |
| **Priority (Öncelik)** | `0` | Birincil öncelik. |
| **Weight (Ağırlık)** | `5` | Yük dağılımı ağırlığı. |
| **Port** | `25577` *(kendi portunuz)* | Sağlayıcınızın verdiği özel port numarası. |
| **Target (Hedef)** | `oyna.alanadiniz.com` | Önceden açtığınız Gri Bulut A kaydı. |
| **TTL** | `Auto` | Otomatik yenileme. |

3. Kaydettiğinizde Cloudflare bu kaydı otomatik olarak `_minecraft._tcp.oyna` formatında birleştirecektir. Artık oyuncular port girmeden doğrudan oyuna katılabilir.

***

## 3. Web Sitesinde Canlı Oyuncu Sayısı ve MOTD Gösterimi

Web sitenizin ana sayfasındaki veya başlığındaki (Header) *"142/500 Oyuncu Çevrim İçi"* sayacının çalışabilmesi için web sunucunuzun oyun sunucusuna sorgu (Query) gönderebilmesi gerekir.

> [accordion] Sitede sunucu sürekli 'Kapalı' veya '0 Oyuncu' görünüyor
>
> * **1. server.properties Ayarları:**
>   Oyun sunucunuzun ana dizinindeki `server.properties` dosyasını bir metin düzenleyici ile açın ve şu satırları kontrol edin:
>   ```properties title="server.properties" theme={"theme":"css-variables"}
>   enable-query=true
>   query.port=25565
>   ```
>   `enable-query` parametresi `false` ise web siteniz sunucunun durumunu okuyamaz. Portun oyun portunuzla aynı olduğundan emin olun.
> * **2. UDP Port İzni (Güvenlik Duvarı):**
>   Minecraft Query sorguları **UDP protokolü** üzerinden çalışır. VDS sunucunuzun güvenlik duvarında veya hosting panelinde `25565/UDP` portunun gelen trafiğe açık olduğunu teyit edin.
> * **3. Zonely Sunucu Kaydı:**
>   Zonely Yönetim Paneli -> **Mağaza → Sunucular** bölümünde sunucunuzun IP ve Sorgu Portu bilgilerinin doğru girildiğini kontrol edin.

> [accordion] Sitedeki 'Sunucu IP'sini Kopyala' butonu yanlış adresi alıyor
>
> Web sitenizde oyuncuların tıkladığı "IP'yi Kopyala" kutusunda gösterilen metin Zonely genel ayarlarından yönetilir.
>
> * **Çözüm:**
>   1. Zonely Yönetim Paneli -> **Ayarlar → Genel Ayarlar** bölümüne gidin.
>   2. **Sunucu IP Adresi / Giriş Adresi** alanına oyuncuların bağlanmasını istediğiniz adresi (örneğin `oyna.alanadiniz.com`) yazın.
>   3. Sayfayı kaydedip tarayıcınızı yenilediğinizde kopyalama butonu doğrudan bu adresi panoya kopyalayacaktır.

***

## 4. BungeeCord ve Velocity Ağlarında Kritik Yapılandırmalar

Eğer birden fazla sunucudan oluşan bir ağ (Network) yönetiyorsanız:

* **Gerçek Oyuncu IP Yönlendirmesi (IP Forwarding):**
  Alt sunuculardaki (Lobi, Survival vb.) `spigot.yml` dosyasında `bungeecord: true` veya Velocity kullanıyorsanız `paper-global.yml` dosyasında `velocity-support` yapılandırmasını açmazsanız, sunucuya giren tüm oyuncuların IP adresi `127.0.0.1` görünür. Bu durum AuthMe tek IP'den kayıt limitlerinin kilitlenmesine ve mağaza güvenlik denetimlerinin aksamasına yol açar.
* **Doğru Teslimat Sunucusu Seçimi:**
  Zonely mağazasında ürün eklerken teslimat aracının (WebSender/ZonelyCore) kurulu olduğu doğru sunucuyu seçin. Global yetkiler (VIP vb.) için ana lobi veya yetki sunucusu; oyuna özel eşyalar (Kasa anahtarı, coin vb.) içinse ilgili alt oyun sunucusu seçilmelidir.


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