Web Panel Üzerinden Whitelist Açma ve Oyuncu Ekleme

Web panel whitelist yönetimi, sunucunuza kimlerin girebileceğini oyuna hiç girmeden belirlemenizi sağlar. Beyaz liste açıkken sadece adı listede olan oyuncular bağlanabilir; geri kalan herkes bağlantı ekranında “You are not white-listed on this server!” mesajını görür. Arkadaş grubu sunucuları, yeni açılmış bir yapı projesi ya da bakım süreci için en pratik koruma budur — üstelik eklenti gerektirmez.

Panelde bu işin üç durağı var: komutları yazacağınız Console sekmesi, kalıcı ayarı tutan server.properties dosyası ve listenin kendisini barındıran whitelist.json. Bu sayfada üçünü de sırayla göreceksiniz. Ayrıca oyuncu adı değiştiğinde ne olduğunu, ops.json ile beyaz listenin nasıl ilişkilendiğini ve en çok gelen “ekledim ama giremiyor” sorununun panelden nasıl çözüldüğünü anlatıyoruz.

Paneli yeni kullanmaya başladıysanız önce web panel ile Minecraft sunucusu kurma sayfasındaki genel yerleşimi görmek işinizi kolaylaştırır. Beyaz listenin oyun tarafındaki mantığını derinlemesine merak ediyorsanız whitelist rehberi tam olarak onu anlatıyor.

Panelde Whitelist Nerede Yönetilir?#

Beyaz listeyle ilgili her ayar, panelin üç ayrı ekranından birine düşer. Hangi işi nereden yapacağınızı bilmek, aşağıdaki adımların tamamını hızlandırır.

Console sekmesi

Anlık işler burada. Listeye ekleme, çıkarma, listeyi görme, açma-kapama ve dosyayı yeniden okutma komutları buradan yazılır. Sunucu çalışıyor olmalıdır.

Dosya yöneticisi

Kalıcı ayar ve toplu düzenleme burada. server.properties ve whitelist.json dosyalarını açıp düzenlediğiniz yer. Kullanımı dosya yöneticisi rehberinde anlatılıyor.

Yedekler (Backups)

Listeyi topluca değiştirmeden önce yedek almak iyi bir alışkanlıktır. Yanlış bir JSON düzenlemesi sunucunun açılışını engelleyebilir.

server.properties Üzerinden Beyaz Listeyi Kalıcı Açma#

Konsoldan verilen komut anında etki eder ama asıl kalıcı anahtar ayar dosyasındadır. Panelde şu sırayı izleyin:

1. Sunucuyu durdurun#

   Console sekmesinde Stop düğmesine basın ya da stop yazın. Ayar dosyasını sunucu açıkken düzenlerseniz sunucu kapanırken kendi bellekteki değerleri dosyanın üzerine yazar ve emeğiniz boşa gider.

2. Dosya yöneticisinden server.properties dosyasını açın#

   Sunucu kök klasöründe durur. Satırın sağındaki menüden Edit (Düzenle) seçeneğine tıklayın.

3. İki satırı bulun ve düzenleyin#

   white-list=true
   enforce-whitelist=true

   Dosyada bu satırlar zaten vardır, genellikle false değeriyle. Yeni satır eklemek yerine mevcut olanı değiştirin; aynı anahtarın iki kez geçmesi kafa karıştırır.

4. Kaydedin ve sunucuyu başlatın#

   Save Content düğmesine basın, Console sekmesine dönüp Start deyin. Açılış tamamlandığında beyaz liste devrededir.

enforce-whitelist=true satırı sık atlanır ama önemlidir. Bu ayar açıkken listeden çıkardığınız bir oyuncu o an sunucudaysa hemen atılır. Kapalıyken ise oyuncu çıkana kadar oynamaya devam eder — kural ihlali yapan birini çıkarırken bu fark can sıkıcı olabilir. Dosyadaki diğer anahtarların tamamı server.properties ayarları listesinde açıklanıyor.

Konsoldan Whitelist Komutları#

Sunucu çalışırken beyaz listeyle ilgili herşeyi tek satırla halledebilirsiniz. Komutlar vanilla, Paper, Purpur ve Spigot sunucularının hepsinde aynıdır.

Tipik bir kurulum akışı şöyle görünür:

whitelist add Ahmet
whitelist add Mehmet
whitelist add Zeynep
whitelist on
whitelist list

Her satırı ayrı ayrı yazıp Enter’a basın; konsol toplu yapıştırmayı çoğu panelde satır satır işler ama arada bir satır düşebilir. Son komutun çıktısını okumayı alışkanlık edinin: listede kaç kişi olduğunu ve adların doğru yazıldığını orada görürsünüz.

whitelist.json Dosyasının Yapısı#

Beyaz liste, sunucu kök klasöründeki whitelist.json dosyasında tutulur. Yapısı basit: köşeli parantez içinde bir dizi, her elemanı iki alanlı bir nesne.

[
  {
    "uuid": "069a79f4-44e9-4726-a5be-fca90e38aaf5",
    "name": "Notch"
  },
  {
    "uuid": "d8d5a923-7b20-43d8-883b-1150148d6955",
    "name": "Ahmet"
  }
]

Asıl kimlik uuid alanıdır; name yalnızca sizin okumanız için tutulan bir etikettir. Sunucu bir oyuncuyu tanırken adına değil, UUID’sine bakar. Bu ayrım sonraki bölümde çok işinize yarayacak.

Dosyayı panelden düzenlemek, on kişiyi tek tek eklemekten hızlıdır. Ama tek bir eksik virgül ya da fazladan bir köşeli parantez dosyayı geçersiz kılar; sunucu o durumda listeyi boş kabul eder ve kimse giremez. Düzenlemeden önce dosyanın bir kopyasını almak (ya da panelden hızlı bir yedek oluşturmak) beş saniyenizi alır.

1. Dosyayı açın#

   Dosya yöneticisinde whitelist.json satırının sağındaki menüden Edit deyin. Dosya yoksa sunucu henüz hiç whitelist komutu almamış demektir; whitelist add ile bir kayıt oluşturduğunuzda kendiliğinden yaratılır.

2. Kayıtları ekleyin veya çıkarın#

   Her nesne arasında virgül olduğundan, son nesneden sonra virgül olmadığından emin olun. UUID’yi biliyorsanız adı yanlış yazmanız sorun çıkarmaz.

3. Kaydedip yeniden okutun#

   whitelist reload

   Bu komut olmadan sunucu bellekteki eski listeyi kullanmaya devam eder. Panelde en sık atlanan adım budur.

4. Sonucu doğrulayın#

   whitelist list

   Çıktı beklediğiniz adları gösteriyorsa iş tamam. Göstermiyorsa dosyada sözdizimi hatası vardır.

Oyuncu Adını Değiştirirse Ne Olur?#

Bu, panel destek taleplerinde sürekli karşımıza çıkan bir durum. Cevap sunucunuzun kimlik doğrulama moduna göre tamamen değişiyor.

Premium bir sunucuda oyuncu adını değiştirdiğinde whitelist.json içindeki name alanı bir süre eski adı göstermeye devam eder. Sorun değil, çünkü eşleşme UUID üzerinden yapılıyor. Ancak bu durumda whitelist remove EskiAd komutu çalışmayabilir; sunucu artık o adı tanımıyordur. Böyle bir durumda dosyayı panelden açıp ilgili UUID satırını elle silmek en kestirme yoldur.

Offline modda ise ad kimliğin ta kendisidir. Oyuncu adını değiştirdiği anda sunucu için yepyeni biri olur, eski ilerlemesi de dâhil olmak üzere hiçbir şeye erişemez. Offline modun bu ve benzeri yan etkileri online-mode ayarı sayfasında tek tek sıralanıyor.

whitelist.json ile ops.json Arasındaki İlişki#

İki dosya birbirine benzer ama farklı işler yapar. whitelist.json “kim girebilir” sorusunu, ops.json “kim yönetici” sorusunu cevaplar.

[
  {
    "uuid": "d8d5a923-7b20-43d8-883b-1150148d6955",
    "name": "Ahmet",
    "level": 4,
    "bypassesPlayerLimit": false
  }
]

Vanilla davranışta ops.json içindeki bir oyuncu, beyaz listede olmasa bile sunucuya bağlanabilir. Sunucu önce “bu kişi operatör mü” diye bakar, öyleyse whitelist kontrolünü geçer. Kulağa pratik geliyor ama üzerine sistem kurmayın:

• Eklenti tabanlı whitelist sistemleri (EssentialsX’in kendi kontrolü veya ayrı bir whitelist eklentisi) bu istisnayı tanımaz; kendi listesine bakar.
• enforce-whitelist=true ile yapılan toplu atmalarda operatörlerin de etkilenebildiği durumlar vardır.
• Bir yetkiliden OP’yi geri aldığınızda kişi hem yetkisini hem de sunucuya erişimini aynı anda kaybeder; oysa çoğu zaman sadece yetkisini almak istersiniz.

Bu yüzden kural şu olsun: yetkilileri de whitelist’e ekleyin. İki dosya birbirinin yedeği değildir. OP verme, yetki seviyeleri ve level alanının anlamı için OP verme ve yetki yönetimi sayfasına bakabilirsiniz.

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

Oyuncu bağlanmayı deniyor ve anında bu mesajla atılıyor. Metin tam olarak böyledir: “white-listed” tireli yazılır ve sonunda ünlem vardır. Panelde çözüm sırası şudur:

Vakaların büyük bölümü ilk iki satırda çözülür. Geri kalanın çoğu ise şu sinsi durumdur: sunucu online-mode=false ile çalışıyordur, siz whitelist add yaptığınızda sunucu Mojang tarafından üretilen kimliği kaydetmiştir, oyuncu ise bağlanırken addan türetilen kimlikle gelir. İki kimlik uyuşmaz ve oyuncu listede olmasına rağmen kapıda kalır. Çözüm, dosyadaki uuid alanını doğru değerle değiştirip whitelist reload çalıştırmaktır. Hatanın tüm varyantları whitelist hatası çözüm sayfasında ele alınıyor.

Whitelist’i Geçici Kapatmak Yerine Bakım Modu#

Klasik senaryo: bir arkadaşınız girmek istiyor, listeye eklemekle uğraşmamak için whitelist off yazıyorsunuz, “nasılsa on dakika sonra kaparım” diyorsunuz. O on dakika çoğu zaman akşamın tamamına yayılıyor. İnternette açık Minecraft portlarını tarayan botlar bu aralıkları bulmakta oldukça hızlıdır; bunun sonucu bazen bir grief, bazen de spam bot akınıdır.

Daha temiz iki yol var:

İkinci yöntem, panelde uygulanabilecek en pratik bakım modudur. Bakım öncesi konsolda say ile duyuru yapın, oyuncuları listeden geçici olarak çıkarın, whitelist reload deyin ve işiniz bitince listeyi geri yükleyin. Bunun için baştan iki ayrı liste dosyası hazırlayıp panelde saklamak (örneğin whitelist.json ve whitelist-bakim.json) ve gereken anda içeriği değiştirmek çoğu sunucu sahibinin işini görüyor.

Bakımı belirli bir saate almak istiyorsanız aynı işi zamanlanmış görev olarak da kurabilirsiniz; adım adım anlatımı panelde zamanlanmış görev oluşturma sayfasında. Sunucuyu bakım için tamamen kapatacaksanız da önce konsoldan stop deyip kapanışın bittiğini görün; Kill düğmesi son çaredir.

Panelde Whitelist Yönetirken İşe Yarayan Alışkanlıklar#

• Ekledikten sonra doğrulayın. whitelist add yazıp geçmeyin; konsolun döndüğü yanıtı okuyun. “Player is already whitelisted” yanıtı da bir bilgidir.
• Toplu eklemeyi dosyadan yapın. Yirmi kişilik bir liste için yirmi komut yazmak yerine whitelist.json dosyasını düzenleyip tek bir whitelist reload çalıştırın.
• Listeyi yedekleyin. Yeni bir sezon açarken eski beyaz liste dosyasını saklamak, oyuncuları yeniden toplarken zaman kazandırır.
• Yetkilileri hem whitelist’e hem ops.json’a yazın. İki liste ayrı ayrı yönetilir.
• Panel erişimini ayrıştırın. Whitelist’i yönetsin diye kimseye panel hesabınızın şifresini vermeyin; alt kullanıcı ekleyip yalnızca konsol iznini verin.

Beyaz liste küçük ve orta ölçekli sunucularda tek başına yeterli bir kapıdır. Oyuncu sayınız arttıkça kapının arkasındaki donanım da önem kazanır: Minecraft’ın ana tick döngüsü tek çekirdekte çalıştığı için çekirdek sayısından çok saat hızı belirleyicidir. Minecraft sunucu paketleri arasından 8 GB RAM, Ryzen 9 işlemci ve NVMe SSD sunan bir seçenek, whitelist’li bir arkadaş sunucusu için rahat rahat yeter.

Özetle#

Panelden whitelist yönetmek üç dosya ve altı komuttan ibaret. Kalıcı ayarı server.properties içindeki white-list=true satırı belirler, günlük işleri Console sekmesindeki whitelist add ve whitelist remove komutları halleder, listenin kendisi ise whitelist.json dosyasında UUID ve ad çiftleri hâlinde durur. Dosyayı elle düzenlediyseniz whitelist reload yazmayı unutmayın; “ekledim ama giremiyor” şikâyetlerinin yarısı bu tek satırla bitiyor.

İki noktayı da aklınızda tutun: OP yetkisi whitelist’in yerine geçmez, yetkililerinizi listeye ayrıca ekleyin. Ve tek bir oyuncu için beyaz listeyi kapatmayın — o birkaç dakika sunucunuzun tüm internete açık olduğu süredir. Listeyi kapatmak yerine daraltmak, hem bakım için hem de günlük kullanım için çok daha güvenli bir alışkanlıktır.