Minecraft server.properties açıklaması

server.properties, bir Java Edition sunucusunun ana ayar dosyasıdır. Sunucu klasöründe bulunur, ilk başlatmada oluşturulur ve portu, dünyayı, zorluğu, güvenliği ve performansı kontrol eder. Bu rehber önemli ayarları, mantıklı değerleri ve onları değiştirdiğinde neyin ters gidebileceğini açıklıyor.

Dosya nasıl çalışır

• Her satır key=value biçimindedir ve eşittir işaretinin etrafında boşluk yoktur.
• Düzenlemeden önce sunucuyu durdur. Çoğu değişiklik yalnızca yeniden başlatmadan sonra geçerli olur ve sunucu kapanırken dosyanın üzerine yazabilir.
• # ile başlayan satırlar yorumdur.
• Dosyayı silersen sunucu bir sonraki başlatmada varsayılan değerlerle yenisini oluşturur.
• Paper, Spigot ve Purpur da bu dosyayı okur ve kendi ayarlarını spigot.yml ve Paper config klasörü gibi başka dosyalara ekler.

Aşağıdaki değerler Java 1.20 ve 1.21 içindir. 1.21.9'dan beri pvp, allow-nether, spawn-monsters ve enable-command-block artık sunucu ayarı değil: oyun içinde /gamerule ile değiştirdiğin oyun kurallarına dönüştüler. Eski sürümlerde hâlâ bu dosyadadırlar.

Bağlantı ayarları

server-port: değiştirirsen, bir SRV kaydı kurmadığın sürece oyuncular portu adrese eklemek zorunda kalır (play.example.com:25570). Yeni portu da yönlendirmen gerekir. Minecraft sunucu IP'si ve portu yazısına bak.

max-players: çok yüksek ayarlamak sunucuyu daha hızlı veya daha popüler yapmaz. Donanımının gerçekten kaldırabileceği bir sayı ayarla, böylece sunucu herkes için lag'lenmek yerine oyuncuları reddeder.

motd: \u00A7 ve ardından bir kod şeklinde yazılan renk kodlarını destekler, örneğin yeşil için \u00A7a, ikinci satır için de \n. Bunu elle yazmak zahmetlidir; MOTD oluşturucumuz satırı senin için hazırlar.

enable-status: false yaparsan, oyuncular yine de girebildiği halde sunucu çok oyunculu listesinde ve sunucu listelerinde kapalı görünür. Herkese açık bir sunucuda açık bırak.

network-compression-threshold: çoğu sunucu için 256'da bırak. -1 sıkıştırmayı kapatır; bu yalnızca sunucu ve oyuncular (veya bir proxy) aynı hızlı yerel ağdayken mantıklıdır. Çok düşük değerler gerçek bir fayda sağlamadan daha fazla işlemci kullanır.

Dünya ayarları

• level-name (varsayılan world): dünya klasörünün adı. Farklı bir dünya klasörünü yüklemek için değiştir.
• level-seed: yeni bir dünyanın seed'i. Zaten var olan bir dünyada hiçbir şey yapmaz.
• level-type (varsayılan minecraft:normal): diğer değerler minecraft:flat, minecraft:large_biomes, minecraft:amplified ve minecraft:single_biome_surface. Seed gibi, yalnızca dünya ilk oluşturulduğunda geçerlidir. Amplified dünyalar işlemciyi çok daha fazla yorar.
• generator-settings: özel düz dünyalar için JSON. Gerektiğini bilmiyorsan boş bırak.
• generate-structures (varsayılan true): köyler, tapınaklar ve diğer yapılar.
• max-world-size: blok cinsinden dünya sınırı yarıçapı. Herkese açık sunucularda, önceden oluşturulmuş bir dünyayla birlikte ayarlanan daha küçük bir sınır, disk kullanımını ve lag'i kontrol altında tutar.
• allow-nether (1.21.8 ve daha eski): false olduğunda Nether'ı kapatır. Bukkit tabanlı sunucularda End, bukkit.yml içindeki allow-end ile kontrol edilir.

Yeni bir seed veya türle yeni bir dünya başlatmak için sunucuyu durdur, değeri değiştir ve eski dünya klasörlerini yeniden adlandır veya kaldır. Önce yedek al.

Oynanış ayarları

difficulty: hayatta kalma sunucularının çoğu normal veya hard kullanır. Peaceful düşman yaratıkları ve açlık hasarını kaldırır; bu da yaratık farmlarını ve birçok hayatta kalma hedefini bozar.

allow-flight: uçuş eklentileri, lag'li elytra ağırlıklı oynanış veya bazı binekler kullanıyorsan true yap. Aksi halde sunucu sadece lag'lendiğinde oyuncular "uçtukları" için atılabilir. Gerçek uçma hilelerini yakalamakta anti-cheat eklentileri bu ayardan daha iyi iş çıkarır.

spawn-protection: korunan alan dünya spawn'ı etrafındaki bir karedir ve operatörler bunu yok sayar. Yalnızca en az bir oyuncu operatörken çalışır. Birçok sunucu bunu 0 yapar ve spawn'ı bunun yerine WorldGuard ile korur; bu da oyuncuların orada ne yapabileceği üzerinde daha ince kontrol sağlar.

Performans ayarları

view-distance ile simulation-distance farkı: görüş mesafesi, her oyuncunun etrafındaki kaç chunk'ın görebilmesi için istemcisine gönderildiğidir. Simülasyon mesafesi ise her oyuncunun etrafındaki kaç chunk'ın gerçekten çalıştığıdır: yaratıklar hareket eder, ekinler büyür, redstone ve fırınlar çalışır. Pahalı olan kısım simülasyondur, bu yüzden yaygın bir kurulum orta bir görüş mesafesi ile daha düşük bir simülasyon mesafesidir. Oyuncular yine uzağı görür, ama sunucu yalnızca onlara yakın yerlerde iş yapar. Simülasyon mesafesini çok düşük ayarlamak, oyuncunun yakında olmasını gerektiren farmları bozar; bu yüzden bir hayatta kalma sunucusunda 4'ün altına inme.

entity-broadcast-range-percentage: oyuncuların varlıkları ne kadar uzaktan görebildiği, varsayılan menzilin yüzdesi olarak (10 ile 1000 arası). Düşürmek kalabalık sunucularda ağ trafiğini azaltır, ama oyuncular yaratıkları ve diğer oyuncuları daha geç belirirken görür; bu da PvP için önemlidir.

sync-chunk-writes: true olduğunda chunk'lar senkron kaydedilir; bu, sunucu çökerse daha güvenlidir. false yapmak kaydetmeyi hızlandırabilir, ama bir çökmede son değişiklikleri kaybetme riskine girersin. Neden değiştirdiğini bilmiyorsan açık bırak.

max-tick-time: bir tick bu kadar milisaniyeden uzun sürerse watchdog sunucuyu durdurur, çünkü sunucu muhtemelen donmuştur. -1 watchdog'u kapatır. Çökmeleri gizlemek için kapatma; bunun yerine nedeni bir profiler ile bul. Minecraft sunucusunda lag nasıl azaltılır yazısı nasıl yapılacağını açıklar.

1.21.2 ve sonrasında pause-when-empty-seconds, sunucu o kadar saniye boş kaldıktan sonra sunucuyu duraklatır. Bu özel bir sunucuda kaynak tasarrufu sağlar, ama herkese açık bir sunucuda bazı eklentiler ve zamanlayıcılar dünyanın çalışmaya devam etmesini bekler.

Güvenlik ayarları

online-mode

online-mode=true (varsayılan), sunucunun her oyuncunun hesabını Mojang ile doğrulamasını sağlar. Açık tut.

online-mode=false (offline mod) ile sunucu, istemcinin gönderdiği her isme güvenir. Herkes, sen veya yetkililerin dahil, herhangi bir oyuncu olarak girebilir ve onun envanterini, arazilerini ve yetkilerini alabilir. UUID kullanan eklentiler de online moddakinden farklı UUID'ler görür, bu yüzden sonradan geçiş yapmak oyuncu verilerini karıştırır.

Tek normal istisna, Velocity gibi bir proxy'nin arkasındaki sunucudur: orada proxy online modda, arka sunucular ise oyuncu bilgisi iletimiyle offline modda çalışır ve arka sunucular yalnızca proxy'den gelen bağlantıları kabul etmelidir. Velocity ağı nasıl kurulur yazısına bak.

enforce-secure-profile

Varsayılan true. Oyuncuların girebilmesi için Mojang tarafından imzalanmış bir profil anahtarı olması gerekir; bu anahtar imzalı sohbet için kullanılır. Bazı oyuncular eksik bir genel anahtarla ilgili bir mesajla giremiyorsa veya belirli sohbet ya da proxy kurulumları kullanıyorsan, sahipler bazen bunu false yapar. Belirli bir sebebin yoksa true bırak.

Whitelist

• white-list (varsayılan false): yalnızca whitelist'teki oyuncular girebilir.
• enforce-whitelist (varsayılan false): true olduğunda, çevrimiçi olup listede olmayan oyuncular whitelist yeniden yüklenir yüklenmez atılır.

Oyun içinde /whitelist on ile de açabilirsin. Tüm adımlar Minecraft sunucusuna whitelist nasıl eklenir yazısında.

Query ve RCON

enable-query (varsayılan false), query.port üzerinde (UDP, varsayılan 25565) GameSpy4 query protokolünü açar. Bazı araçlar ve listeler eklentileri ve oyuncu adlarını okumak için bunu kullanır. İsteğe bağlıdır; durum ping'leri onsuz da çalışır.

enable-rcon (varsayılan false), rcon.port üzerinde (TCP, varsayılan 25575) rcon.password ile uzaktan konsol erişimine izin verir. RCON komutları tam konsol yetkisiyle gönderir ve şifre şifrelenmez. Kullanırsan:

• Uzun, rastgele bir şifre kullan.
• RCON portunu asla yönlendirme veya internete açma. Yalnızca aynı makineden veya özel bir ağdan erişime izin ver.
• İhtiyacın yoksa kapalı bırak.

Diğer güvenlik ayarları

• op-permission-level (varsayılan 4): operatörlerin ne yapabileceği. 4, sunucuyu durdurmak dahil her şeye izin verir.
• prevent-proxy-connections (varsayılan false): adresleri Mojang ile karşılaştırarak bağlantısı bir VPN veya proxy üzerinden geliyor gibi görünen oyuncuları atar. Gerçek oyuncuları da engelleyebilir.
• rate-limit (varsayılan 0): saniyede çok fazla paket gönderen istemcileri atar. 0 kapatır.
• log-ips (varsayılan true, 1.20.2+): oyuncu IP adreslerinin loga yazılıp yazılmayacağı.
• accepts-transfers (varsayılan false, 1.20.5+): sunucunun transfer paketiyle başka bir sunucudan gönderilen oyuncuları kabul edip etmeyeceği.

Kaynak paketi ayarları

• resource-pack: bir zip dosyasına doğrudan indirme URL'si. İndirme sayfalarına giden bağlantılar çalışmaz; URL dosyanın kendisini döndürmelidir.
• resource-pack-sha1: zip'in SHA-1 hash'i. İstemcilerin paketi önbelleğe almasını ve değiştiğini fark etmesini sağlar. Dosyayı her değiştirdiğinde güncelle.
• require-resource-pack: true ise paketi reddeden oyuncuların bağlantısı kesilir.
• resource-pack-prompt: indirme isteminde gösterilen özel bir mesaj.

Paketi yalnızca sunucun gerçekten ihtiyaç duyuyorsa zorunlu tut ve küçük tut. Büyük, zorunlu bir paket, yeni bir oyuncunun vazgeçmesi için bir sebep daha demektir. Geyser üzerinden giren Bedrock oyuncularının dönüştürülmüş bir pakete ihtiyacı vardır.

Mantıklı bir başlangıç noktası

Paper üzerinde küçük, herkese açık bir hayatta kalma sunucusu için:

server-port=25565
online-mode=true
enforce-secure-profile=true
max-players=50
difficulty=normal
view-distance=8
simulation-distance=6
spawn-protection=0
white-list=false
enable-status=true
enable-query=false
enable-rcon=false
network-compression-threshold=256
max-tick-time=60000
sync-chunk-writes=true

max-players, view-distance ve simulation-distance değerlerini donanımına göre ayarla ve oyuncular çevrimiçiyken sunucunun nasıl davrandığını izle. Ayarları değiştirdikten sonra yeniden başlat ve sunucunun hâlâ doğru göründüğünü sunucu durumu kontrol aracıyla kontrol et.