Rehber BungeeCord Config.yml Ayarları ve Minecraft Network Kurulum Rehberi

BungeeCord Config.yml Detaylı Anlatım 2026 | Minecraft Network Ayar Rehberi

Konu etiketi: BungeeCord config.yml, BungeeCord ayarları, Minecraft network config, BungeeCord kurulum, BungeeCord proxy ayarları

Merhaba Minecraft sunucu sahipleri,

Bu konuda BungeeCord config.yml dosyası üzerinde bulunan temel ayarları detaylı şekilde anlatacağım. Minecraft network kurarken en önemli dosyalardan biri config.yml dosyasıdır. Çünkü oyuncuların hangi sunucuya yönleneceği, IP forwarding ayarı, sunucu listesi, listener ayarları, MOTD, slot, online mode ve bağlantı ayarları bu dosya üzerinden düzenlenir.

Eğer BungeeCord ile Lobby, Survival, Skyblock, BoxPVP, Practice veya SMP gibi birden fazla sunucuyu tek IP altında toplamak istiyorsanız config.yml dosyasını doğru yapılandırmanız gerekir.

---

BungeeCord Config.yml Nedir?

BungeeCord config.yml, proxy sunucunun ana ayar dosyasıdır. Bu dosya üzerinden BungeeCord’un nasıl çalışacağı belirlenir.

Bu dosyada genel olarak şu ayarlar bulunur:

• Sunucu listesi
• Oyuncuların bağlanacağı ana IP ve port
• MOTD yani sunucu açıklaması
• Maksimum oyuncu sayısı
• IP forwarding ayarı
• Online mode ayarı
• Fallback server ayarı
• Ping ve bağlantı limitleri
• Tab list ayarları
• Yetki ve grup ayarları

Yanlış yapılan bir config.yml ayarı oyuncuların sunucuya girememesine, yanlış sunucuya yönlenmesine veya güvenlik açıklarına sebep olabilir.

---

Örnek BungeeCord Config.yml Dosyası

Aşağıdaki örnek config.yml dosyası temel bir Minecraft network için hazırlanmıştır.


Bu config örneğinde oyuncular ana IP üzerinden BungeeCord’a bağlanır. BungeeCord ise oyuncuları lobby, survival veya skyblock sunucularına yönlendirir.

---

listeners Bölümü Nedir?


listeners bölümü, oyuncuların BungeeCord’a hangi IP ve port üzerinden bağlanacağını belirler.

En önemli ayarlar:

• host → Oyuncuların bağlanacağı IP ve porttur.
• motd → Sunucu listesinde görünen açıklamadır.
• max_players → Sunucu listesinde görünen maksimum oyuncu sayısıdır.
• priorities → Oyuncuların ilk bağlanacağı sunucuyu belirler.
• force_default_server → Oyuncunun her girişte varsayılan sunucuya gönderilip gönderilmeyeceğini belirler.

---

host Ayarı Nedir?


Bu ayar, BungeeCord’un hangi IP ve port üzerinden çalışacağını belirler.

Genellikle şu şekilde kullanılır:


Bu ayar, BungeeCord’un tüm IP adreslerinden gelen bağlantıları 25565 portu üzerinden kabul etmesini sağlar.

Eğer özel bir IP üzerinden çalıştırmak istiyorsanız şöyle yapılabilir:


Ancak çoğu sunucuda 0.0.0.0:25565 kullanılır.

---

motd Ayarı Nedir?


MOTD, Minecraft sunucu listesinde görünen açıklama yazısıdır.

Renk kodları kullanılabilir:


Örnek profesyonel MOTD:


SEO açısından forum konularında “BungeeCord MOTD ayarı” kelimesi önemli olduğu için bu ayarın doğru anlatılması faydalıdır.

---

priorities Ayarı Nedir?


priorities, oyuncuların sunucuya giriş yaptığında ilk olarak hangi backend sunucuya yönlendirileceğini belirler.

Örnek:


Bu ayarda oyuncular ilk girişte lobby sunucusuna gönderilir.

Birden fazla sunucu yazılabilir:


Eğer lobby kapalıysa oyuncu lobby2 sunucusuna gönderilebilir. Bu yüzden büyük networklerde yedek lobby kullanmak mantıklıdır.

---

force_default_server Ayarı Nedir?


Bu ayar oyuncunun giriş yaptığında her zaman priorities kısmındaki ilk sunucuya gönderilip gönderilmeyeceğini belirler.

false olursa: Oyuncu son çıktığı sunucuya tekrar bağlanabilir.
true olursa: Oyuncu her girişte varsayılan sunucuya gönderilir.

Genellikle lobby sistemli networklerde şu ayar önerilir:


Bu sayede oyuncular her girişte lobby sunucusuna düşer.

---

max_players Ayarı Nedir?


Bu ayar sunucu listesinde görünen maksimum oyuncu sayısını belirler.

Örneğin:


Sunucu listesinde 125/1000 gibi görünür.

Bu ayar tek başına gerçek performans kapasitesi anlamına gelmez. Yani max_players değerini 5000 yapmak sunucunun gerçekten 5000 oyuncu kaldıracağı anlamına gelmez. Sunucu donanımı, proxy optimizasyonu, backend sunucu optimizasyonu ve plugin yapısı da önemlidir.

---

tab_list Ayarı Nedir?


tab_list, BungeeCord üzerinde tab listesinin nasıl gösterileceğini belirler.

Yaygın kullanılan değerler:


GLOBAL_PING: Tüm network oyuncularını gösterebilir.
SERVER: Sadece oyuncunun bulunduğu sunucudaki oyuncuları gösterebilir.

Ancak çoğu modern sunucuda TAB gibi ayrı pluginler kullanıldığı için bu ayar çok kritik olmayabilir.

---

query_enabled ve query_port Nedir?


query_enabled, Minecraft query sisteminin açık olup olmayacağını belirler. Bazı sunucu liste siteleri oyuncu sayısı ve sunucu bilgisi çekmek için query kullanabilir.

Açmak isterseniz:


Güvenlik ve gereksiz dış sorgular açısından ihtiyaç yoksa kapalı kalması tercih edilebilir.

---

ip_forward Ayarı Nedir?


BungeeCord config.yml dosyasındaki en önemli ayarlardan biridir.

ip_forward true olduğunda oyuncunun gerçek IP adresi ve UUID bilgisi backend sunucuya doğru şekilde aktarılır.

Network sunucularda genellikle şu şekilde olmalıdır:


Backend yani Spigot/Paper sunucularında da spigot.yml içinde şu ayar yapılmalıdır:


Eğer ip_forward yanlış ayarlanırsa şu problemler yaşanabilir:

• Oyuncuların UUID bilgisi değişebilir.
• Yetki sistemleri bozulabilir.
• Skin sorunları oluşabilir.
• Auth ve ban sistemleri hatalı çalışabilir.
• Güvenlik açıkları oluşabilir.

---

online_mode Ayarı Nedir?


online_mode, oyuncuların Mojang/Microsoft hesabı doğrulamasından geçip geçmeyeceğini belirler.

Premium sunucular için:


Crack/TLauncher destekleyen sunucular için:


Ancak online_mode false kullanılıyorsa mutlaka Auth sistemi, güvenlik önlemleri ve backend port koruması yapılmalıdır. Aksi takdirde oyuncu hesapları taklit edilebilir.

Önemli not:

Backend sunucularda yani lobby, survival, skyblock gibi alt sunucularda server.properties içinde genellikle şu ayar kullanılır:


Çünkü oyuncu doğrulamasını proxy yapar. Backend sunucular direkt dışarıya açık olmamalıdır.

---

servers Bölümü Nedir?


servers bölümü, BungeeCord’a bağlı alt sunucuların tanımlandığı bölümdür.

Her sunucu için şu bilgiler girilir:

• Sunucu adı
• Sunucu adresi ve portu
• MOTD
• restricted ayarı

Örnek:


Bu ayarda survival isimli backend sunucu 127.0.0.1:25567 adresinde çalışır.

---

address Ayarı Nasıl Yapılır?

Eğer BungeeCord ve backend sunucular aynı makinedeyse en güvenli kullanım şudur:


Eğer sunucular farklı makinelerdeyse özel network IP adresi kullanılabilir:


Direkt public IP kullanmak mümkündür fakat backend portları güvenlik duvarı ile sadece BungeeCord makinesine açık olmalıdır.

Yanlış örnek:


Backend sunucu adreslerinde 0.0.0.0 kullanmak önerilmez. 0.0.0.0 dinleme adresi olarak kullanılır, bağlantı adresi olarak doğru tercih değildir.

---

restricted Ayarı Nedir?


restricted ayarı true yapılırsa, o sunucuya sadece gerekli yetkiye sahip oyuncular bağlanabilir.

Örnek:


Bu durumda admin sunucusuna giriş için özel permission gerekir.

Genellikle lobby, survival, skyblock gibi genel sunucularda false bırakılır.

---

permissions Bölümü Nedir?


permissions bölümü BungeeCord komut yetkilerini belirler.

Default oyunculara genellikle şu yetkiler verilir:


Adminlere verilebilecek bazı yetkiler:


Ancak profesyonel sunucularda yetki yönetimi genellikle LuckPerms üzerinden yapılır.

---

groups Bölümü Nedir?


groups bölümü belirli oyunculara belirli BungeeCord permission grupları atamak için kullanılır.

Örnek:


Bu ayarda Kandra isimli oyuncu admin grubuna eklenir.

Fakat büyük sunucularda bu yöntemi kullanmak yerine LuckPerms Bungee/Velocity desteği ile yetki yönetimi yapmak daha düzenlidir.

---

connection_throttle Ayarı Nedir?


Bu ayar aynı IP adresinden tekrar bağlantı denemesi için beklenmesi gereken süreyi milisaniye cinsinden belirler.


Bot saldırıları ve spam bağlantılar için temel bir koruma sağlar. Ancak tek başına yeterli değildir. Büyük sunucularda ek bot koruma sistemleri kullanılmalıdır.

---

connection_throttle_limit Nedir?


Aynı IP’den kaç bağlantı denemesine izin verileceğini belirler.

Çok düşük yapılırsa aynı ev internetinden bağlanan oyuncular sorun yaşayabilir. Çok yüksek yapılırsa bot saldırılarına karşı zayıf kalabilir.

Genel kullanım için 3 veya 4 tercih edilebilir.

---

timeout Ayarı Nedir?


Oyuncu bağlantısının zaman aşımı süresini belirler. Milisaniye cinsindendir.


Oyuncunun bağlantısı bu süre içinde yanıt vermezse bağlantı kesilebilir.

---

server_connect_timeout Ayarı Nedir?


BungeeCord’un backend sunucuya bağlanırken ne kadar süre bekleyeceğini belirler.


Backend sunucu geç yanıt veriyorsa bu değer artırılabilir. Ancak çok yüksek yapmak bağlantı sorunlarının daha geç fark edilmesine sebep olabilir.

---

network_compression_threshold Nedir?


Bu ayar paket sıkıştırma eşiğini belirler. Minecraft bağlantılarında veri trafiğini etkileyebilir.

Çok düşük değer CPU kullanımını artırabilir. Çok yüksek değer ise bant genişliği kullanımını artırabilir.

Genel kullanım için 256 yaygın bir değerdir.

---

player_limit Ayarı Nedir?


player_limit, BungeeCord proxy üzerinde gerçek oyuncu limitini belirler.


max_players sunucu listesinde görünen değerdir. player_limit ise gerçek bağlantı limitidir.

Örnek:


Bu ayarda listede 1000 slot görünür, fakat proxy tarafında özel bir limit uygulanmaz.

---

disabled_commands Bölümü Nedir?


Bu bölüm BungeeCord üzerinde devre dışı bırakılacak komutları belirlemek için kullanılır.

Örnek:


Ancak bu ayar her zaman backend sunucu komutlarını tamamen kapatmayabilir. Backend sunucularda ayrıca permission ve komut engelleme ayarları yapılmalıdır.

---

forge_support Ayarı Nedir?


Forge modlu sunucular için destek ayarıdır.

Normal Survival, Skyblock, BoxPVP, Practice gibi vanilla tabanlı sunucularda false kalabilir.

Forge modlu networklerde true yapılması gerekebilir.

---

log_pings ve log_commands Ayarları


log_pings: Sunucu listesi ping sorgularını loglar.
log_commands: BungeeCord üzerinden kullanılan komutları loglar.

Büyük sunucularda log_pings çok fazla log oluşturabilir. Gereksiz log kalabalığını azaltmak için kapatılabilir.

Örnek:

---

remote_ping_cache ve remote_ping_timeout


Bu ayarlar BungeeCord’un backend sunucuların ping bilgilerini nasıl önbelleğe alacağını ve ne kadar süre bekleyeceğini belirler.

Genellikle varsayılan değerler yeterlidir. Büyük networklerde ping gecikmeleri veya sunucu listesi problemleri yaşanıyorsa optimize edilebilir.

---

forced_hosts Nedir?


forced_hosts, farklı domain veya subdomain ile bağlanan oyuncuları farklı sunuculara yönlendirmek için kullanılır.

Örnek:


Bu adrese giren oyuncu direkt survival sunucusuna yönlendirilebilir.

Başka örnek:


Bu sistem özellikle büyük networklerde çok kullanışlıdır.

---

ping_passthrough Nedir?


ping_passthrough true yapılırsa, sunucu listesinde backend sunucunun MOTD ve oyuncu bilgileri gösterilebilir.

Genellikle proxy üzerinde özel MOTD kullanılacağı için false bırakılır.

---

proxy_protocol Nedir?


proxy_protocol genellikle TCP proxy, HAProxy veya özel DDoS koruma sistemleriyle kullanılır.

Normal kurulumlarda false kalmalıdır.

Eğer kullandığınız hosting veya DDoS koruma firması proxy protocol istiyorsa true yapılabilir. Aksi halde oyuncular bağlantı sorunu yaşayabilir.

---

bind_local_address Nedir?


Bu ayar BungeeCord’un backend sunuculara bağlantı kurarken yerel adres kullanımıyla ilgilidir.

Genellikle varsayılan şekilde true kalabilir. Özel network ve çoklu IP yapılarında değiştirilmesi gerekebilir.

---

BungeeCord Config.yml Güvenlik Ayarları

BungeeCord kurulumunda en önemli konu backend sunucuların doğrudan dışarıya açık olmamasıdır.

Güvenli yapı için:

• Oyuncular sadece BungeeCord IP adresine bağlanmalıdır.
• Lobby, Survival, Skyblock gibi backend sunucuların portları dış erişime kapalı olmalıdır.
• Backend sunucularda server.properties içinde online-mode=false olmalıdır.
• BungeeCord üzerinde online_mode ayarı sisteminize göre doğru seçilmelidir.
• ip_forward true yapılmalıdır.
• Spigot/Paper tarafında bungeecord forwarding ayarı aktif edilmelidir.
• Güvenlik duvarı ile sadece proxy IP’sine izin verilmelidir.

Yanlış güvenlik ayarları oyuncuların başka hesaplarla giriş yapmasına, yetki sistemlerinin bozulmasına veya sunucuya izinsiz erişime sebep olabilir.

---

Backend Sunucularda Yapılması Gereken Ayarlar

BungeeCord kullanırken alt sunucularda bazı ayarlar doğru yapılmalıdır.

server.properties


Her backend sunucunun portu farklı olmalıdır.

Örnek:


spigot.yml


Bu ayar IP forwarding için önemlidir.

paper-global.yml veya paper.yml

Yeni Paper sürümlerinde proxy forwarding ayarları farklı dosyalarda olabilir. Kullandığınız Paper sürümüne göre BungeeCord forwarding desteğinin aktif olduğundan emin olmalısınız.

---

Sık Yapılan Config.yml Hataları

• ip_forward false bırakmak: UUID ve IP aktarım sorunlarına yol açar.
• Backend portlarını dışarıya açık bırakmak: Büyük güvenlik açığıdır.
• Yanlış address yazmak: Oyuncular “Could not connect to default or fallback server” hatası alabilir.
• priorities kısmında olmayan sunucu adı yazmak: Oyuncular giriş yapamaz.
• online_mode ayarını yanlış yapmak: Premium/crack giriş sistemini bozabilir.
• YAML boşluk hatası yapmak: BungeeCord config dosyası okunamaz.
• Aynı portu birden fazla sunucuya vermek: Port çakışması oluşur.

---

BungeeCord Could Not Connect to Default or Fallback Server Hatası

Bu hata genellikle BungeeCord’un varsayılan sunucuya bağlanamaması nedeniyle oluşur.

Kontrol edilmesi gerekenler:

• priorities kısmında yazan sunucu adı servers bölümünde var mı?
• Backend sunucu açık mı?
• Backend sunucu portu doğru mu?
• Firewall bağlantıyı engelliyor mu?
• address kısmı doğru yazıldı mı?
• Sunucu aynı makinedeyse 127.0.0.1 kullanıldı mı?
• Backend sunucu crash yemiş olabilir mi?

Örnek doğru yapı:


Burada priorities kısmındaki lobby ile servers bölümündeki lobby ismi aynı olmalıdır.

---

BungeeCord IP Forwarding Hatası Çözümü

IP forwarding çalışmıyorsa şu ayarlar kontrol edilmelidir.

BungeeCord config.yml:


Backend spigot.yml:


Backend server.properties:


Ayrıca backend sunucular direkt oyunculara açık olmamalıdır. Sadece BungeeCord üzerinden giriş yapılmalıdır.

---

Profesyonel Minecraft Network İçin Önerilen Yapı

Orta ve büyük ölçekli bir Minecraft network için örnek yapı:


Örnek servers bölümü:

---

2026 İçin Önerilen BungeeCord Config.yml Ayarları

Yeni bir Minecraft network kuruyorsanız temel olarak şu ayarlar önerilir:


Crack/TLauncher destekli sistemlerde online_mode yapısı farklı olabilir:


Ancak bu durumda Auth sistemi ve güvenlik duvarı ayarları kesinlikle yapılmalıdır.

---

BungeeCord Config.yml SSS

BungeeCord config.yml nerede bulunur?

BungeeCord’u ilk kez çalıştırdığınızda config.yml dosyası otomatik oluşur. Bu dosya BungeeCord ana klasöründe yer alır.

BungeeCord ip_forward true ne işe yarar?

Oyuncunun gerçek IP ve UUID bilgisinin backend sunuculara aktarılmasını sağlar. Network sunucularında genellikle true yapılmalıdır.

BungeeCord online_mode true mu false mu olmalı?

Premium sunucularda true olmalıdır. Crack veya TLauncher destekli sunucularda false kullanılabilir fakat Auth ve güvenlik önlemleri alınmalıdır.

BungeeCord’da lobby nasıl varsayılan yapılır?

config.yml içinde priorities kısmına lobby yazılmalıdır.


Oyuncuların her girişte lobbyye gitmesi isteniyorsa:


BungeeCord backend sunucu portları açık olmalı mı?

Hayır. Backend sunucuların portları dışarıya açık olmamalıdır. Sadece BungeeCord sunucusu bu portlara erişebilmelidir.

BungeeCord config.yml YAML hatası nasıl çözülür?

YAML dosyalarında boşluk düzeni önemlidir. Tab kullanılmamalı, boşluklar doğru hizalanmalıdır. Özellikle servers ve listeners bölümlerinde girintiler dikkatli kontrol edilmelidir.

---

Sonuç

BungeeCord config.yml dosyası, Minecraft network altyapısının en kritik ayar dosyalarından biridir. Bu dosyada yapılan küçük bir hata bile oyuncuların sunucuya bağlanamamasına veya güvenlik açıklarının oluşmasına neden olabilir.

Özetle dikkat edilmesi gerekenler:

• ip_forward doğru ayarlanmalı.
• online_mode sistem yapısına göre seçilmeli.
• Backend sunucular dış erişime kapatılmalı.
• priorities kısmı doğru yazılmalı.
• servers bölümündeki adres ve portlar doğru olmalı.
• YAML boşluk düzenine dikkat edilmeli.
• Firewall ve port güvenliği mutlaka yapılmalı.

Doğru yapılandırılmış bir BungeeCord config.yml dosyası ile Lobby, Survival, Skyblock, BoxPVP, Practice ve SMP gibi birçok oyun modunu tek IP altında profesyonel şekilde yönetebilirsiniz.

---

Önerilen Aramalar

• BungeeCord config.yml ayarları
• BungeeCord config.yml detaylı anlatım
• BungeeCord ip_forward ayarı
• BungeeCord online_mode ayarı
• BungeeCord lobby ayarlama
• BungeeCord network kurma
• BungeeCord server ekleme
• BungeeCord fallback server hatası
• BungeeCord config.yml 2026
• Minecraft BungeeCord ayarları