Blog’a Dön

Minecraft server.properties Ayarları: En Önemli Satırlar

Minecraft server.properties ayarları: dosyanın yeri, güvenli düzenleme ve oynanış, dünya, whitelist, ağ ve performans için hangi değerleri seçmelisiniz.

Nodesty Ekibi8 dk okumaOyun sunucuları
Koyu Nodesty arka planında server.properties yazısı ile view-distance, difficulty ve whitelist ifadeleri

Minecraft server.properties ayarları, bir Java Edition sunucusunun ana yapılandırmasıdır: oyun modu ve zorluk, yüklenecek dünya, sunucuya kimlerin girebileceği, sunucunun dinlediği port ve her oyuncu için dünyanın ne kadarının işleneceği bu dosyada belirlenir. Düz bir metin dosyasıdır, ama tek bir yanlış satır oyuncuları dışarıda bırakabilir, boş bir dünya yükleyebilir ya da sunucuyu herkese açabilir.

Bu rehberde dosyanın nerede olduğunu ve nasıl güvenle düzenleneceğini, en önemli ayarları grup grup, en sık değiştirilen anahtarların tablosunu, MOTD renk kodlarını, örnek bir dosyayı ve en sık yapılan hataları anlatıyoruz. Sunucunuzu henüz kurmadıysanız Minecraft sunucu nasıl kurulur? rehberimizle başlayın.

Dosya nerede ve nasıl düzenlenir?

Dosya indirdiğiniz paketle gelmez. Sunucu ilk kez başladığında, başlatıldığı klasörde oluşturur; bu da normalde sunucu jar dosyasının ve eula.txt dosyasının bulunduğu klasördür. Linux sunucuda SSH ile açın:

cd ~/minecraft-server
nano server.properties

Her satır anahtar=değer biçimindedir ve her satırda tek ayar bulunur:

difficulty=easy
max-players=20
level-type=minecraft\:normal
  • Anahtarlar ve true/false değerleri küçük harfle yazılır. = işaretinin çevresinde ve satır sonunda boşluk bırakmayın.
  • # ile başlayan satırlar yorumdur. Sunucu dosyayı başlarken yeniden yazar, bu yüzden kendi yorumlarınız korunmaz. İki noktadan önceki ters eğik çizgi (minecraft\:normal) normaldir.
  • server-ip= gibi boş bir değer "ayarlanmamış" demektir.

Değişiklikler yeniden başlatma ister. Sunucu dosyayı yalnızca başlarken okur ve çalışırken dosyayı geri yazabilir; örneğin whitelist'i bir komutla açtığınızda. Sunucuyu stop ile kapatın, dosyayı düzenleyin, sonra yeniden başlatın; aksi hâlde değişikliğinizin üzerine yazılabilir.

Anahtarlar sürüme göre değişir. Minecraft sürümler arasında anahtar ekler, yeniden adlandırır ve kaldırır. Aşağıdaki varsayılanlar vanilla sunucunun oluşturduğu değerlerdir. Bu rehberdeki bir anahtar dosyanızda yoksa kendi sunucunuzun oluşturduğu dosyaya güvenin.

Oynanış ayarları

  • gamemode (varsayılan survival): Yeni oyuncuların başladığı mod: survival, creative, adventure ya da spectator.
  • force-gamemode (varsayılan false): true olduğunda oyuncular her girişte varsayılan oyun moduna döndürülür.
  • difficulty (varsayılan easy): peaceful, easy, normal ya da hard.
  • hardcore (varsayılan false): true olduğunda yeni oluşturulan dünya hardcore olur: zorluk hard'dır ve ölen oyuncular yalnızca izleyici olarak kalır.
  • spawn-protection (varsayılan 16): Dünya spawn noktasının çevresinde yalnızca OP'lerin blok koyup kırabildiği yarıçap; 16 değeri 33 x 33 blokluk bir kareyi korur. 0 korumayı kapatır. Koruma, sunucuda en az bir OP olduğunda devreye girer; yeni oyuncuların spawn yakınında "blok kıramaması" çoğu zaman bundandır.
  • allow-flight (varsayılan false): Kimseye uçma yetkisi vermez. false iken sunucu, hayatta kalma modunda birkaç saniye havada kalan oyuncuları atar. Bir eklenti ya da mod oyunculara uçuş veriyorsa veya oyuncular haksız yere uçuş nedeniyle atılıyorsa true yapın.
  • pvp: Eski sürümlerde bu anahtar (varsayılan true) oyuncuların birbirine hasar verip veremeyeceğini belirler. Güncel sürümlerde, 1.21.9'dan itibaren, bunun yerine bir oyun kuralıdır: gamerule pvp false.

Aynı güncelleme allow-nether, spawn-monsters ve enable-command-block ayarlarını da oyun kurallarına taşıdı. Böyle bir anahtarı dosyanızda bulamıyorsanız konsola gamerule yazıp Tab tuşuna basarak sürümünüzdeki kuralları görün. Oyun kurallarını Minecraft sunucu komutları rehberimizde anlattık.

Dünya ayarları

  • level-name (varsayılan world): Dünya klasörünün adı. Sunucu bu addaki klasörü yükler; yoksa yeni bir dünya oluşturur. Yüklediğiniz bir dünyayı kullanmak için klasörünü sunucu jar dosyasının yanına koyun ve klasör adını buraya birebir yazın.
  • level-seed (varsayılan boş): Yeni dünyanın seed değeri. Boş bırakılırsa rastgele seçilir.
  • level-type (varsayılan minecraft:normal): Dünya ön ayarı; örneğin minecraft:flat, minecraft:large_biomes ya da minecraft:amplified.
  • generate-structures (varsayılan true): Köy gibi yapıların oluşturulup oluşturulmayacağı.
  • max-world-size (varsayılan 29999984): Dünya sınırının blok cinsinden alabileceği en büyük yarıçap. Oyuncuların gezdiği alanı sınırlamak için Minecraft sunucu lag rehberimizdeki dünya sınırı genellikle daha doğru araçtır.

level-seed, level-type ve generate-structures dünya oluşturulurken kullanılır. Sonradan değiştirmek var olan dünyayı değiştirmez.

Oyuncular ve erişim

  • max-players (varsayılan 20): Aynı anda çevrimiçi olabilecek oyuncu sayısı.
  • white-list: true olduğunda yalnızca whitelist.json dosyasındaki oyuncular girebilir. Eski sürümler false üretir; güncel bir sürümün (26.3 ve sonrası) yeni kurulumu true üretir, bu yüzden kendi dosyanıza bakın. Oyuncuları komutlar rehberinde gösterildiği gibi whitelist add ile eklersiniz.
  • enforce-whitelist (varsayılan false): true olduğunda whitelist açılınca ya da yeniden yüklenince listede olmayan çevrimiçi oyuncular atılır.
  • online-mode (varsayılan true): Sunucu, giren her oyuncuyu Minecraft'ın hesap sunucularıyla doğrular. Açık bırakın.
  • op-permission-level (varsayılan 4): op komutunun verdiği yetki seviyesi. Daha ayrıntılı rütbe ve yetkiler için bir eklenti kullanın; LuckPerms kullanımı rehberimize bakın.
  • player-idle-timeout (varsayılan 0): Hareketsiz oyuncuların kaç dakika sonra atılacağı. 0 hiçbir zaman demektir.

online-mode=false neden güvensiz? Artık hiçbir hesap doğrulanmaz; herkes istediği adla, sizin adınız dahil, girebilir ve o oyuncunun envanterini ve OP yetkisini devralır. Oyuncu UUID'leri de değişir, bu yüzden mevcut envanterler ve rütbeler kaybolmuş gibi görünür. Tek olağan istisna bir proxy'nin arkasındaki sunuculardır: Orada hesapları proxy doğrular ve güvenlik duvarı oyuncuların arka sunucuya doğrudan ulaşmasını engeller; ayrıntılar Minecraft Velocity ağı kurma rehberimizde.

Ağ ayarları

  • server-port (varsayılan 25565): Sunucunun dinlediği TCP portu. Farklı bir port kullanırsanız oyuncular adrese portu eklemek zorundadır (example.com:25570); bunu bir SRV kaydıyla önleyebilirsiniz, bkz. Minecraft sunucusuna domain bağlama.
  • server-ip (varsayılan boş): Sunucunun makinedeki bütün adresleri dinlemesi için boş bırakın. Yalnızca makinede birden fazla IP adresi varsa ve sunucu bunlardan birini kullanacaksa doldurun. Buraya alan adı yazılmaz.
  • motd (varsayılan A Minecraft Server): Çok oyunculu listesinde sunucu adının altında görünen yazı; aşağıya bakın.
  • enable-status (varsayılan true): false olduğunda sunucu listede çevrimdışı görünür ama bağlantıları kabul etmeye devam eder.
  • enable-query (varsayılan false): query.port üzerinde sunucu bilgilerini veren bir UDP sorgu servisi açar. Yalnızca bir sunucu listesi ya da izleme aracı isterse açın.
  • enable-rcon (varsayılan false), rcon.port (varsayılan 25575) ve rcon.password: TCP üzerinden uzak konsol. Parola boşsa RCON başlamaz.

Portun güvenlik duvarında da açık olması gerekir: Ubuntu ve Debian'da sudo ufw allow 25565/tcp, AlmaLinux'ta sudo firewall-cmd --permanent --add-port=25565/tcp ve ardından sudo firewall-cmd --reload.

RCON'u internete açmayın. RCON tam konsol erişimi verir ve protokol parolayı şifrelemeden gönderir. Uzun, rastgele bir parola kullanın, 25575 portunu asla internete açmayın ve sunucunun kendisinden ya da bir SSH tüneli üzerinden bağlanın.

Performans ayarları

  • view-distance (varsayılan 10, aralık 3–32): Her oyuncuya gönderilen dünyanın chunk cinsinden yarıçapı.
  • simulation-distance (varsayılan 10, aralık 3–32): Mobların, bitkilerin ve redstone'un işlendiği yarıçap.
  • network-compression-threshold (varsayılan 256): En az bu kadar bayt olan paketler sıkıştırılır. Varsayılanı bırakın; -1 sıkıştırmayı kapatır ve yalnızca aynı makinedeki ya da özel ağdaki bir proxy'nin arkasındaki sunucular için anlamlıdır.
  • max-tick-time (varsayılan 60000): Tek bir tick bu kadar milisaniyeden uzun sürerse watchdog sunucuyu çökmüş sayıp durdurur. -1 watchdog'u kapatır, ama bu sorunu çözmez, yalnızca gizler.
  • sync-chunk-writes (varsayılan true): Chunk'ları eşzamanlı yazar, böylece bir çökme dünyayı bozmaz. Açık bırakın.
  • entity-broadcast-range-percentage (varsayılan 100, aralık 10–1000): Varlıkların oyunculara ne kadar uzaktan gönderileceği. 50 mesafeyi yarıya indirir ve bant genişliğinden kazandırır, ama moblar daha geç görünür.

Çoğu sunucu için view-distance 8–10, simulation-distance 6–8 uygundur. Bu değerlerin darboğazınız olup olmadığını nasıl ölçeceğinizi yukarıda bağlantısını verdiğimiz lag rehberi anlatır.

En sık değiştirilen anahtarlar

AnahtarVarsayılanÖneri
motdA Minecraft ServerSunucunuzun adı ve kısa bir satır
max-players20RAM ve işlemcinizin gerçekten taşıyabileceği bir sayı
difficultyeasySurvival sunucular için normal ya da hard
white-listfalse (26.3'ten itibaren true)Arkadaş grupları ve özel topluluklar için true
online-modetruetrue kalsın
server-port25565Aynı IP adresinde birden fazla sunucu yoksa değiştirmeyin
level-nameworldDünyanızın klasör adı, birebir
view-distance108–10
simulation-distance106–8
spawn-protection16Spawn'ı WorldGuard gibi bir eklenti koruyorsa 0
enable-rconfalseBir araç gerektirmedikçe false kalsın, asla internete açmayın

MOTD biçimlendirme ve renk kodları

MOTD en fazla iki satırdır; \n ikinci satırı başlatır. Renkler ve stiller, bölüm işareti § ve ardından gelen tek karakterle ayarlanır: renkler için §0–§9 ve §a–§f, kalın için §l, italik için §o, altı çizili için §n, sıfırlamak için §r. Dosyada bölüm işaretini \u00A7 kaçış dizisiyle yazın; bu her sürümde çalışır. Güncel sürümler, düzenleyiciniz dosyayı UTF-8 olarak kaydediyorsa doğrudan yazılan § karakterini de kabul eder.

motd=\u00A7a\u00A7lSurvival Sunucum\u00A7r\n\u00A77Sadece davetliler \u00A7f| \u00A7eJava Edition

Bu satır, kalın yeşil bir ilk satır ile gri, beyaz ve sarı bir ikinci satır gösterir. Sunucu listesine sığması için iki satırı da kısa tutun.

Örnek server.properties bölümü

Özel bir survival sunucusu için makul bir başlangıç. Kontrol etmeye değer satırlar bunlardır; dosyanın geri kalanını sunucunun oluşturduğu gibi bırakın:

motd=\u00A7aSurvival Sunucum\u00A7r\n\u00A77Sadece davetliler
max-players=20
gamemode=survival
difficulty=normal
white-list=true
enforce-whitelist=true
online-mode=true
server-port=25565
server-ip=
level-name=world
view-distance=8
simulation-distance=6
enable-rcon=false

Paper ve Bedrock farkları

Paper, Spigot ve Purpur da server.properties dosyasını okur ve yukarıdakilerin hepsi geçerlidir. Bunlara kendi dosyalarını eklerler: bukkit.yml, spigot.yml ve config klasöründeki paper-global.yml ile paper-world-defaults.yml. Bazıları bir değeri dünya bazında geçersiz kılabilir; örneğin spigot.yml içindeki görüş ve simülasyon mesafesi. Paper'da bir ayar etkisiz görünüyorsa oraya bakın. Eklentiler ayarlarını plugins klasöründe tutar; bkz. Minecraft plugin kurulumu.

Bedrock Dedicated Server'da da server.properties adında bir dosya vardır, ama anahtarları farklıdır (örneğin allow-list ve 19132 portu); bunu Minecraft Bedrock sunucu kurma rehberimizde anlattık.

Sık yapılan hatalar

  • Sunucu çalışırken düzenlemek: Değişiklik uygulanmaz ve üzerine yazılabilir. Kapatın, düzenleyin, başlatın.
  • Anahtarda ya da değerde yazım hatası: Sunucu sizi açıkça uyarmaz. Yanlış yazılmış anahtar yok sayılır ve doğru anahtar varsayılan değerinde kalır; view-distance=sekiz gibi geçersiz bir değer varsayılanla değiştirilir. Yeniden başlattıktan sonra dosyayı tekrar açıp değerinizin yerinde olduğunu kontrol edin.
  • Yanlış level-name: Sunucu o adda bir klasör bulamaz ve yeni, boş bir dünya oluşturur. Eski dünyanız silinmez: Adı düzeltin, Linux'ta büyük küçük harfe dikkat edin ve yeniden başlatın.
  • Herkese açık sunucuda online-mode=false: Herkes herhangi bir oyuncu olarak girebilir. Yeniden açın.
  • Port çakışmaları: Aynı server-port değerine sahip iki sunucu tek IP adresinde çalışamaz; ikincisi FAILED TO BIND TO PORT hatasıyla durur. Portu neyin kullandığına bakın ve her sunucuya ayrı bir port verin; ayrıntılar Port kullanımda hatası yazımızda:
sudo ss -tlnp | grep 25565

Büyük değişikliklerden önce cp server.properties server.properties.bak ile bir kopya alın.

Nodesty'de Minecraft sunucusu

Nodesty Minecraft sunucu kiralama paketleri, Frankfurt'ta 5,7 GHz'e çıkan AMD Ryzen 9 9950X işlemci, NVMe disk ve DDoS korumasıyla çalışır. Paper, Forge ya da Fabric ile dakikalar içinde başlayabilir, server.properties dahil bütün dosyaları tam yönetici erişimiyle düzenleyebilirsiniz. Oyun sunucularında günlük yedekler ücretsizdir ve 7 gün saklanır.

Minecraft, Mojang AB'nin ticari markasıdır. Nodesty, Mojang ve Microsoft ile bağlantılı değildir ve onlar tarafından onaylanmamıştır.

Sıkça Sorulan Sorular

server.properties dosyası nerede?

Sunucunun başlatıldığı klasörde, normalde sunucu jar dosyasının ve eula.txt dosyasının hemen yanındadır. Dosya indirdiğiniz paketin içinde gelmez; sunucu ilk kez başladığında kendisi oluşturur. Kiralık sunucuda SFTP, SSH ya da panelinizin dosya yöneticisiyle ulaşırsınız.

server.properties dosyasını değiştirdikten sonra sunucuyu yeniden başlatmam gerekir mi?

Evet. Sunucu dosyayı yalnızca başlarken okur, bu yüzden değişiklik bir sonraki başlatmaya kadar etkili olmaz. En güvenli sıra, sunucuyu stop komutuyla kapatmak, dosyayı düzenleyip kaydetmek ve sunucuyu yeniden başlatmaktır.

server.properties dosyasındaki değişikliklerim neden sıfırlanıyor?

Genellikle iki sebebi vardır. Ya dosya sunucu çalışırken düzenlenmiş ve sunucu kendi sürümünü geri yazmıştır ya da bir anahtar veya değer yanlış yazıldığı için sunucu onu yok sayıp varsayılanı kullanmıştır. Önce sunucuyu kapatın, yazımı kontrol edin ve yeniden başlattıktan sonra dosyaya tekrar bakın.

online-mode ayarını false yapmak güvenli mi?

Oyuncuların doğrudan bağlandığı bir sunucuda hayır. online-mode kapalıyken hesaplar doğrulanmaz, yani herkes istediği adla, bir yöneticinin adı dahil, sunucuya girebilir. Tek olağan istisna Velocity gibi bir proxy'nin arkasındaki sunuculardır; orada doğrulamayı proxy yapar ve güvenlik duvarı doğrudan bağlantıları engeller.

server.properties dosyamda pvp satırı neden yok?

Minecraft 1.21.9'dan itibaren pvp artık bir server.properties anahtarı değildir. Birkaç ayarla birlikte oyun kuralına dönüştü; güncel sürümlerde gamerule pvp false komutuyla kapatırsınız. Eski sürümlerde pvp satırı hâlâ dosyadadır.

MOTD yazısına nasıl renk eklerim?

Metnin önüne bölüm işareti ve bir kod koyun; örneğin bölüm işaretinden sonra a yeşil, l kalın demektir. Dosyada bölüm işareti yerine \u00A7 kaçış dizisini yazabilirsiniz, bu her sürümde çalışır. \n ise MOTD'nin ikinci satırını başlatır.

Nodesty

Yazar hakkında

Nodesty Ekibi · Altyapı ve Destek

Nodesty ekibi sunucularımızı, ağımızı ve DDoS korumamızı her gün işletir ve müşteri destek taleplerini 7/24 yanıtlar. Bu rehberler o deneyimden yazılır.

İlgili yazılar

Sunucunuzu şimdi başlatın.

Nodesty'nin üstün altyapısı ile projelerinizi özgürce inşa edin ve sınır tanımadan ölçeklendirin.

                                                                                                                                                                                                                            
                                                                                                                                                                                                                            
                                                                                                                                                                                                                            
                                                                                                                             ············································                                                   
                                                ··································································································..........···························                                     
                                       ················..........................................................................................................................··············                             
                                  ·············.................::::::::::::::::::::::::::::::::::::::::::::::....................:::::::::::::::::::::::::::::::::::::::................···········                        
                             ············................:::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::............·········                     
                         ············.................:::::::::::::::::::::::::::::::::::::::::::::::::::------------::::::::::::::::::::::::::::::----------------:::::::::::::::::::::..........········                  
                    ············......................::::::::::::::::::::::::::::::::::::------------------------------------------------------------------------------------:::::::::::::.........········                
                ··········.............................................::::::::::::::::::-------------==========================================-----------------------------------:::::::::::........·······               
             ········..................:.....................................::::::::::--------=======+++++++++++++++++++++++++++++++++++++=========================------------------::::::::::.......·······              
           ······.........::::::::::::::::::::................................:::::::-----=====++++xxxxxx**************************xxxxxxxxx++++++++++++++===================------------::::::::.......·······             
          ·····.......:::::::::::::::::::::::::::.............................:::::----===+++xxx****%%%%&&&&&&#############&&&&&&&%%%%%*******xxxxxxxx++++++++++++++==============----------:::::::......······             
         ····......::::::::-------------:::::::::::..........................::::---===+++xx***%%%&&&####@@@@@@@@@@@@@@@@@@@@@@@@####&&&&&%%%%*******xxxxxxxxx+++++++++++++===========--------::::::......·····             
        ····.....:::::::--------------------:::::::::.......................::::---===++xxx**%%&&&###@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@###&&&&%%%%%********xxxxxxxxxxx++++++++++++========------::::::.....······            
        ····.....:::::--------------------------::::::::....................::::---===++xx***%%&&&####@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@###&&&&&%%%%%**********xxxxxxxxxxxxx+++++++++=======------:::::.....·····            
        ····....::::::-------=============---------:::::::::................:::::---===+++xx***%%%&&&#####@@@@@@@@@@@@@@@@@@@@@@@@@#####&&&&&%%%%%%*************xxxxxxxxxxxxxx+++++++++======-----:::::....·····            
         ····....:::::-------================---------:::::::::...............:::::----===++++xxx***%%%%&&&&&&#################&&&&&&%%%%%%%*******************xxxxxxxxxxxxxxxxx++++++++======----:::::....·····            
         ·····....:::::--------=================---------::::::::::..............:::::::-----====+++++xxxxxx**************************xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx++++++++=====-----::::....·····            
          ·····.....:::::--------=================----------:::::::::::.................:::::::::-------=============++++++++++++++++++++++++++++++++++++xxxxxxxxxxxxxxxxxxxxxxx++++++++======-----::::....·····            
            ·····.....:::::::----------===========-------------::::::::::::.........................::::::::::::::::::------------------=============+++++++++++++++++++++++++++++++++=======-----::::.....·····            
              ······......:::::::---------------------------------:::::::::::::........................................:::::::::::::::-----------============+++++++++++++++++++++========------:::::.....·····             
                 ······........:::::::::---------------------------:::::::::::::::::...........................................:::::::::::::------------=============================--------::::::.....······              
                    ·········.........:::::::::::::::-------------::::::::::::::::::::::::.......................................::::::::::::::::--------------------------------------::::::::......·······                
                          ··········............::::::::::::::::::::::::::::::::::::::::::::::::::................................::::::::::::::::::::::::::-------------:::::::::::::::.........········                   
                                  ············..................:::::::::::::::::::::::::::::::::::::::::::.........................:::::::::::::::::::::::::::::::::::::................···········                        
                                             ················.............................................................................................................·················                                 
                                                           ······················................................................................···························                                                
                                                                               ·········································································