“You are not white-listed on this server!” Hatası Çözümü

Minecraft’ta “You are not white-listed on this server!” hatası, bağlanmaya çalıştığınız sunucuda beyaz liste (whitelist) açık olduğu ve hesabınızın bu listede bulunmadığı anlamına gelir. Sunucu sizi dünyaya hiç almadan, giriş el sıkışması aşamasında keser. Oyuncu tarafında değiştirebileceğiniz hiçbir ayar bu hatayı geçirmez; çözüm tek satırlıktır: sunucu yöneticisinin konsolda /whitelist add OyuncuAdi komutunu çalıştırması gerekir.

Sunucu sahibiyseniz iş biraz daha katmanlı olabilir. Oyuncuyu listeye eklediğiniz hâlde aynı hatayı almaya devam ediyorsa sorun genellikle komutta değil, kimlik eşleşmesindedir: online-mode=false ile çalışan sunucularda whitelist kaydındaki UUID ile oyuncunun bağlanırken kullandığı UUID birbirini tutmaz. Bu sayfada hatanın birebir metnini, oyuncu tarafındaki doğru davranışı, sunucu tarafındaki tüm komutları, whitelist.json dosyasının yapısını, offline mod tuzağını ve yetkili muafiyetlerini tek tek ele alıyoruz.

Hatanın Birebir Metni ve Anlamı#

Oyuncunun ekranında beliren metin Minecraft 26.2’nin resmî dil dosyasında şu çeviri anahtarıyla tanımlıdır:

multiplayer.disconnect.not_whitelisted = "You are not white-listed on this server!"

İki ayrıntıya dikkat edin, çünkü internetteki birçok Türkçe kaynak bunları yanlış aktarıyor: kelime tireli yazılır (white-listed, “whitelisted” değil) ve cümlenin sonunda ünlem işareti vardır. Sunucunuzda gördüğünüz metin bundan farklıysa, engelleme vanilla whitelist mekanizmasından değil bir eklentiden geliyordur. Örneğin EssentialsX kendi mesajını basar:

# EssentialsX messages.properties
whitelistKick=Whitelist enabled!

Bu ayrım teşhisin yarısıdır. Aşağıdaki tablo, whitelist hatasıyla en sık karıştırılan bağlantı kesme mesajlarını ve gerçek sebeplerini gösteriyor.

Oyuncuysanız Ne Yapmalısınız?#

Bu hatayı istemci tarafında çözmenin bir yolu yok. Aşağıdakiler işe yaramaz ve zaman kaybıdır: oyunu yeniden başlatmak, launcher’ı güncellemek, sunucuyu listeden silip yeniden eklemek, sürüm değiştirmek, DNS temizlemek, VPN açmak.

Yapmanız gereken tek şey doğru bilgiyi doğru kişiye iletmek:

1. Kullanıcı adınızı harfi harfine doğrulayın#

   Minecraft kullanıcı adlarında büyük/küçük harf farkı kimliği değiştirmez ama yanlış yazılan bir harf değiştirir. Launcher’ın sağ üst köşesindeki profil adını kopyalayıp gönderin, ezberden yazmayın.

2. Sunucu yetkilisine ulaşın#

   Sunucunun Discord’u, forumu veya başvuru formu varsa oradan isteyin. Yetkilinin çalıştıracağı komut tek satırdır: /whitelist add OyuncuAdi.

3. Adınızı yakın zamanda değiştirdiyseniz bunu belirtin#

   Sunucudaki kayıt eski adınıza aitse yetkilinin önce eski kaydı silmesi, sonra yeni adı eklemesi gerekir. Bu bilgiyi vermezseniz “ekledim ama giremiyor” döngüsüne girersiniz.

4. Doğru sunucuya bağlandığınızdan emin olun#

   Aynı ekibin test ve ana sunucusu ayrı adreslerde olabilir. Bağlantı bilgilerini kontrol etmek için sunucuya nasıl girilir rehberimizdeki adımları izleyin.

Sunucu Sahibi İçin: Oyuncuyu Beyaz Listeye Ekleme#

Beyaz liste vanilla sunucu yazılımının parçasıdır; Paper 26.2, Purpur, Spigot, Fabric ve Forge’da komutlar aynıdır. Konsoldan çalıştırırken komutun başına eğik çizgi koymanız gerekmez, oyun içinden çalıştırırken gerekir.

/whitelist on                    # beyaz listeyi aç
/whitelist add <oyuncuAdi>       # oyuncuyu listeye ekle
/whitelist remove <oyuncuAdi>    # oyuncuyu listeden çıkar
/whitelist list                  # listedeki tüm oyuncuları göster
/whitelist reload                # whitelist.json dosyasını diskten yeniden oku
/whitelist off                   # beyaz listeyi geçici olarak kapat

Ekleme başarılı olduğunda konsol şu yanıtı basar:

commands.whitelist.add.success = "Added %s to the whitelist"

Bu satırı görüyorsanız komut işini yapmıştır. Oyuncu hâlâ giremiyorsa sorun komutta değil, aşağıdaki bölümlerde anlattığımız kimlik eşleşmesindedir. Konsola erişiminiz yoksa web panel konsolundan komut çalıştırma sayfasındaki adımları izleyebilirsiniz.

server.properties tarafındaki iki ayar#

white-list=true
enforce-whitelist=true

white-list varsayılan olarak false’tur ve beyaz listenin açık olup olmadığını belirler. enforce-whitelist=true ise liste her yeniden yüklendiğinde, listede olmayan çevrimiçi oyuncuların anında atılmasını sağlar; varsayılan false iken listeden çıkardığınız kişi oyundan atılmaz, yalnızca bir sonraki girişinde engellenir. Bu dosyadaki diğer ayarların tam listesi için server.properties ayarları rehberine bakabilirsiniz.

whitelist.json Dosyası ve /whitelist reload#

Beyaz liste, sunucu jar dosyasıyla aynı klasördeki whitelist.json dosyasında tutulur. Yapısı sadedir: her oyuncu için uuid ve name alanları taşıyan bir JSON dizisi.

[
  {
    "uuid": "069a79f4-44e9-4726-a5be-fca90e38aaf5",
    "name": "Notch"
  }
]

Dosyayı elle düzenlerken üç kural var:

• Düzenledikten sonra mutlaka /whitelist reload çalıştırın. Sunucu listeyi bellekte tutar; diskteki değişikliği kendiliğinden okumaz.
• Reload çalıştırmadan sunucuyu kapatmayın. Sunucu kapanırken bellekteki listeyi diske yazar ve elle yaptığınız düzenlemelerin üzerine geçer.
• JSON sözdizimine dikkat edin. Eksik virgül veya kapatılmamış süslü parantez, listenin tamamının okunamamasına yol açar. Dosyayı Not Defteri yerine JSON sözdizimini renklendiren bir düzenleyiciyle açın.

Listede Olduğu Hâlde Giremiyorsa: offline-mode UUID Tuzağı#

Hosting destek biletlerinde en sık karşılaşılan whitelist sorunu budur ve tamamen sessizce çalışır: komut başarılı görünür, /whitelist list oyuncunun adını gösterir, ama oyuncu yine de “You are not white-listed on this server!” yer.

Sebep şu: Minecraft oyuncuyu isimle değil UUID (evrensel benzersiz kimlik) ile tanır. online-mode=true olan normal bir sunucuda UUID, Mojang hesabından gelir. online-mode=false yapılmış sunucularda (cracked sunucular veya bazı proxy arkası kurulumlar) UUID Mojang’dan değil, doğrudan oyuncu adından türetilir; buna offline UUID denir.

Sorun tam burada çıkar: /whitelist add komutu, sunucu offline modda olsa bile Mojang API’sinden online UUID’yi çeker ve dosyaya onu yazar. Oyuncu bağlandığında ise offline UUID ile gelir. İki kimlik eşleşmez, sunucu oyuncuyu tanımaz ve reddeder.

# Bu adres oyuncunun ONLINE UUID'sini döndürür:
curl https://api.mojang.com/users/profiles/minecraft/<oyuncuAdi>

# UYARI: online-mode=false çalışan bir sunucuda bu UUID İŞE YARAMAZ.

Çözüm iki adımdır: whitelist.json içindeki kaydın uuid alanını oyuncunun offline UUID’siyle değiştirin ve /whitelist reload çalıştırın. Offline UUID’yi öğrenmenin en pratik yolu, oyuncunun bir kez bağlanmayı denemesidir: sunucu konsolu bağlantı denemesi sırasında oyuncunun kullandığı UUID’yi loglar, siz de o değeri kopyalayıp kullanırsınız. Sunucu loglarını okuma sayfasında hangi satıra bakacağınız ayrıntılı anlatılıyor.

Cracked sunucu işletiyorsanız beyaz listeyi tek başına kimlik doğrulama olarak kullanmayın: listedeki bir ismi yazan herkes o kişi gibi girebilir. Bu senaryoda whitelist’i mutlaka AuthMe gibi bir giriş eklentisiyle birlikte kullanın.

Yetkili Muafiyeti: OP ve EssentialsX Bypass İzni#

Beyaz liste açıkken yetkililerinizin kilitli kalmaması için iki yol var.

Birincisi OP yetkisi. ops.json içinde kayıtlı operatörler whitelist’i varsayılan olarak aşar. Bu pratiktir ama tehlikelidir: OP, sunucudaki her komuta erişim demektir. Yetki dağıtımını daha ince ayarlamak için OP verme ve yetki yönetimi sayfasını okuyun.

İkincisi izin düğümü. EssentialsX kuruluysa aşağıdaki izne sahip oyuncular, beyaz listede olmasalar bile girebilir:

# EssentialsX izin düğümü
essentials.whitelist.bypass   # "Allows a player to join the server even if they are not whitelisted."

# LuckPerms ile bir gruba vermek:
/lp group yetkili permission set essentials.whitelist.bypass true

Bu yaklaşım OP vermekten çok daha güvenlidir, çünkü sadece tek bir yetkiyi açar. LuckPerms ile yetki sistemi kurma ve EssentialsX kurulumu sayfaları grup yapısını sıfırdan kurmayı anlatıyor.

Proxy, Bedrock ve İsim Değişikliği Kaynaklı Özel Durumlar#

BungeeCord / Velocity arkasındaki sunucular#

Proxy’li bir ağda arka uç sunucular genellikle online-mode=false çalışır ve kimlik doğrulamayı proxy yapar. Bu yapıda beyaz listeyi arka uç sunucuların her birinde ayrı ayrı yönetmeye çalışmak hem zahmetli hem hataya açıktır; doğrusu erişim kontrolünü proxy katmanında toplamaktır. Ağ kurulumunun ayrıntıları BungeeCord ve Velocity ile sunucu ağı kurulumu sayfasında.

Geyser ve Floodgate ile gelen Bedrock oyuncuları#

Bedrock tarafından bağlanan oyuncular Java sunucusunda ayrı bir UUID ve çoğunlukla önekli bir kullanıcı adıyla görünür. Adı tahmin ederek eklemeye çalışmak neredeyse her zaman başarısız olur. Doğru yöntem: oyuncu bir kez bağlanmayı denesin, konsoldaki giriş satırından adı önek dahil birebir kopyalayın. Geyser ve Floodgate kurulumu sayfasında önek ayarının nerede yapılandırıldığı anlatılıyor.

Oyuncu adını değiştirdiyse#

online-mode=true sunucularda UUID sabit kaldığı için isim değişikliği erişimi bozmaz; kayıttaki isim eskimiş görünür ama giriş çalışır. online-mode=false sunucularda ise UUID isimden türetildiği için isim değişikliği doğrudan yeni bir kimlik yaratır: eski kaydı silip yeni adı eklemeniz gerekir.

Eklenti Tabanlı Whitelist Yönetimi#

Vanilla beyaz liste tek bir düz liste sunar; zaman sınırlı erişim, başvuru sistemi ya da Discord entegrasyonu istiyorsanız eklentiye ihtiyacınız olur. Minecraft 26.2 sürüm listesinde yer alan, bakımı sürdürülen bir seçenek Noble Whitelist’tir (1.2.24, Haziran 2026). Bukkit, Paper, Purpur, Spigot ve Folia üzerinde çalışır.

Eklenti kullanmaya karar verdiyseniz iki noktayı unutmayın: eklenti kendi reddetme mesajını bastığı için oyuncular artık vanilla metnini görmez, bu da teşhisi değiştirir; ayrıca vanilla whitelist açık kalırsa iki katman üst üste biner ve hangisinin engellediğini ayırt etmek zorlaşır. Genellikle doğru yaklaşım white-list=false yapıp kontrolü tamamen eklentiye bırakmaktır. Eklenti yükleme adımları için plugin kurulumu rehberimize bakın.

Hatayı Tekrar Yaşamamak İçin Kontrol Listesi#

• Beyaz listeyi açtığınız gün, giriş yapması gereken herkesi tek seferde ekleyin; teker teker ekleme en çok unutulan adımdır.
• /whitelist list çıktısını arada bir kontrol edin; artık sunucuda olmayan kişileri temizleyin.
• whitelist.json dosyasını da yedekleme kapsamınıza alın. Dünya yedeği alıp yapılandırma dosyalarını atlamak sık yapılan bir hatadır.
• Yetkililere OP yerine essentials.whitelist.bypass iznini verin.
• Sunucunuz online-mode=false çalışıyorsa, whitelist kayıtlarının offline UUID ile yazıldığını ekip içinde not olarak paylaşın.

Özetle#

“You are not white-listed on this server!” hatası, sunucuda beyaz listenin açık olduğunu ve hesabınızın listede bulunmadığını söyler. Oyuncu tarafında çözümü yoktur; sunucu yöneticisinin /whitelist add OyuncuAdi komutunu çalıştırması gerekir. Dosya elle düzenlendiyse /whitelist reload şarttır, aksi hâlde değişiklik uygulanmaz ve sunucu kapanırken üzerine yazılır.

Oyuncu listede göründüğü hâlde hata devam ediyorsa ilk bakacağınız yer online-mode ayarıdır: offline modda whitelist kaydına yanlış (online) UUID yazılmış olabilir. Yetkililerin kilitli kalmaması için OP yerine essentials.whitelist.bypass iznini tercih edin. Beyaz listeyi sıfırdan kurmak istiyorsanız whitelist kurulum rehberi, başka bir bağlantı hatasıyla uğraşıyorsanız Minecraft sunucu hataları ve çözümleri sayfası doğru duraklar.