Minecraft sunucu RAM ayarı, -Xms ve -Xmx değerlerini eşit vermek ve toplam sistem belleğinin tamamını heap’e boşaltmamakla başlar. 8 GB’lık bir pakette doğru başlangıç -Xms6G -Xmx6G, 16 GB’lık pakette -Xms14G -Xmx14G’dir. Kalan 2 GB işletim sistemi, JVM’in heap dışı belleği (metaspace, thread yığınları, ağ tamponları) ve disk önbelleği içindir. Bu payı bırakmadığınızda sunucu bir süre sorunsuz görünür, sonra takas alanına düşüp saniyeler süren donmalar yaşatır.
Bu sayfada heap boyutunu paket büyüklüğüne göre nasıl seçeceğinizi, 26.x ile çokça yanlış aktarılan ZGC konusunun sunucu tarafındaki gerçeğini, Aikar’s Flags’in 2026’daki durumunu ve bellek kullanımını nasıl doğrulayacağınızı bulacaksınız. Verilen bayrak setleri Paper, Purpur, Spigot, Forge ve Fabric sunucularının hepsinde aynı şekilde çalışır; fark yalnızca çalıştırdığınız jar dosyasının adındadır.
Minecraft sunucusunda RAM tam olarak neye harcanır?#
Sunucu belleğinin büyük kısmı yüklü chunk’lara gider. Her oyuncunun çevresinde view-distance ve simulation-distance ayarlarıyla belirlenen bir chunk kümesi RAM’de tutulur; oyuncu sayısı arttıkça bu küme doğrusal değil, üst üste binen alanlar nedeniyle kırıklı bir eğriyle büyür. İkinci büyük kalem entity’lerdir: item frame, armor stand, yerde bekleyen eşya, mob çiftliklerindeki yaratıklar. Üçüncü kalem eklenti verisidir — ekonomi kayıtları, bölge tanımları, oyuncu profilleri, arazi koruması.
Heap dışında kalan bellek de gerçektir ve görmezden gelinemez. JVM’in metaspace alanı yüklenen tüm sınıfları tutar; 40-50 eklentili bir sunucuda bu tek başına birkaç yüz megabayt eder. Netty’nin doğrudan bellek tamponları, GC’nin kendi veri yapıları ve her iş parçacığının yığını da toplam kullanımı -Xmx değerinin üstüne çıkarır. İşletim sisteminde “java.exe 7,4 GB kullanıyor” görüyorsanız ve -Xmx6G verdiyseniz ortada hata yok, normal davranış bu.
view-distance=8 ile view-distance=12 arasındaki fark, 30 oyunculu bir sunucuda gigabaytlarla ölçülür. Ayrıntılar view distance ve simulation distance ayarları sayfasında.Xms ve Xmx neden eşit verilir?#
-Xms JVM’in açılışta ayırdığı heap, -Xmx ise büyüyebileceği üst sınırdır. Masaüstü uygulamalarında bu ikisini farklı vermek mantıklıdır, çünkü program çoğu zaman az bellekle çalışır. Minecraft sunucusu ise açıldığı andan itibaren tavan değere doğru koşar: dünya yüklenir, eklentiler önbelleklerini kurar, oyuncular girer. Heap’i kademeli büyütmek burada yalnızca maliyet üretir.
Değerleri eşitlediğinizde JVM tek seferde bellek ayırır, adres alanı boyunca genişleme yapmaz ve -XX:+AlwaysPreTouch ile birlikte sayfaları önceden dokunulmuş hale getirir. Açılış birkaç saniye uzar, karşılığında ilk yarım saatteki tick sıçramaları kaybolur. Bu yüzden aşağıdaki tüm örneklerde iki değer birbirine eşittir.
Pakete göre doğru heap değeri#
Aşağıdaki tablo Batihost paketlerinin RAM kapasitesine göre kullanılacak heap değerlerini verir. Sol sütun makinenin toplam belleği, ikinci sütun jar’a vereceğiniz değerdir. Aradaki fark bilinçli olarak bırakılan işletim sistemi payıdır.
| Paket RAM | Heap (-Xms / -Xmx) | Tipik senaryo | Önerilen GC |
|---|---|---|---|
| 8 GB | -Xms6G -Xmx6G | 2-10 oyuncu, vanilla veya hafif eklentili | G1GC + Aikar’s Flags |
| 12 GB | -Xms10G -Xmx10G | 10-30 oyuncu, eklentili Paper sunucu | G1GC + Aikar’s Flags |
| 16 GB | -Xms14G -Xmx14G | 30-60 oyuncu, minigame / çok dünyalı, Forge-Fabric modpack | G1GC (büyük heap varyantı) veya ZGC |
| 32 GB | -Xms28G -Xmx28G | 60+ oyuncu, proxy’li sunucu ağı, büyük modpack | ZGC değerlendirilir |
Sunucu ağı işletiyorsanız hesabı proxy’yi de katarak yapın. Velocity veya BungeeCord süreci oyun mantığı çalıştırmadığı için görece hafiftir, ama aynı makinede duruyorsa payını ayırmanız gerekir. Arka arkaya iki alt sunucu ve bir proxy barındıran 32 GB’lık bir makinede heap’leri örneğin 12 GB + 12 GB + 2 GB olarak bölmek, tek sunucuya 28 GB vermekten daha akıllıcadır. Mimari kararı için BungeeCord ve Velocity kurulum rehberine göz atın.
26.x ile ZGC’ye mi geçildi? Sunucu tarafındaki gerçek#
26.1 sürüm notlarında yer alan “garbage collection has been changed from G1GC to ZGC for compatible computers” satırı forumlarda sunucu değişikliği sanıldı. Değil. Bu satır Minecraft Launcher’ın oyun istemcisi için ürettiği JVM argümanlarını anlatır. Aynı sürüm notundaki “oyun artık varsayılan olarak 4 GB RAM ayırıyor” maddesi de istemci tahsisidir.
Sunucu jar’ının bir launcher’ı yoktur. java -jar paper.jar yazdığınızda hangi çöp toplayıcının kullanılacağını yalnızca sizin verdiğiniz bayraklar ve JVM’in kendi varsayılanı belirler. Java 25’te JEP 523 ile G1, kısıtlı ortamlar dahil tüm ortamlarda genel varsayılan çöp toplayıcıdır. Yani bayraksız açtığınız bir 26.2 sunucusu ZGC değil G1GC ile çalışır.
-XX:+UseZGC -XX:+ZGenerational kombinasyonunu kopyalamayın. JEP 490 ile ZGC’nin non-generational modu kaldırıldı; -XX:+ZGenerational Java 25’te obsolete durumdadır ve her açılışta uyarı basar. Doğru kullanım yalnızca -XX:+UseZGC şeklindedir.Aikar’s Flags: 2026’da hâlâ geçerli#
Aikar’s Flags, G1GC’yi Minecraft’ın ayırma davranışına göre ayarlayan bir bayrak setidir. PaperMC’nin resmî dokümanı 26.x çıkışlarından sonra geri çekilmedi; set hâlâ G1GC tabanlıdır ve 8-12 GB heap aralığında en öngörülebilir sonucu verir. “Aikar’s Flags artık geçersiz” bilgisi yanlıştır.
12 GB’lık bir pakette (10 GB heap) tam komut şu şekildedir. Tek satırdır, satır sonlarını silmeden kopyalayacaksanız birleştirin.
java -Xms10G -Xmx10G --add-modules=jdk.incubator.vector -XX:+UseG1GC -XX:+ParallelRefProcEnabled -XX:MaxGCPauseMillis=200 -XX:+UnlockExperimentalVMOptions -XX:+DisableExplicitGC -XX:+AlwaysPreTouch -XX:G1NewSizePercent=30 -XX:G1MaxNewSizePercent=40 -XX:G1HeapRegionSize=8M -XX:G1ReservePercent=20 -XX:G1HeapWastePercent=5 -XX:G1MixedGCCountTarget=4 -XX:InitiatingHeapOccupancyPercent=15 -XX:G1MixedGCLiveThresholdPercent=90 -XX:G1RSetUpdatingPauseTimePercent=5 -XX:SurvivorRatio=32 -XX:+PerfDisableSharedMem -XX:MaxTenuringThreshold=1 -jar paper.jar --nogui12 GB’ın üzerindeki heap için değişen dört bayrak#
Heap 12 GB’ı aştığında Aikar’s Flags dört değeri değiştirmenizi ister. Genç kuşak büyütülür, bölge boyutu iki katına çıkar ve toplama daha geç tetiklenir:
-XX:G1NewSizePercent=40
-XX:G1MaxNewSizePercent=50
-XX:G1HeapRegionSize=16M
-XX:G1ReservePercent=15
-XX:InitiatingHeapOccupancyPercent=20Geri kalan bayraklar aynen kalır. 16 GB’lık pakette bu değişikliklerle birlikte -Xms14G -Xmx14G kullanırsınız.
ZGC ne zaman mantıklı olur?#
ZGC duraklama sürelerini heap büyüklüğünden bağımsız olarak milisaniyenin altında tutmayı hedefler. Buna karşılık daha fazla CPU zamanı ve daha fazla heap dışı bellek harcar. Pratik ayrım şudur: 8-12 GB heap’te G1GC + Aikar’s Flags kalın; 16 GB ve üzeri heap ya da yüzlerce mod barındıran ağır bir modpack çalıştırıyorsanız ZGC’yi deneyin ve iki yapılandırmayı kendi sunucunuzda ölçün.
java -Xms28G -Xmx28G -XX:+UseZGC -XX:+AlwaysPreTouch -XX:+DisableExplicitGC -XX:+PerfDisableSharedMem -jar paper.jar --noguiZGC’ye geçerken Aikar’s Flags’teki G1 bayraklarını (G1NewSizePercent, G1HeapRegionSize, MaxGCPauseMillis gibi) taşımayın; bunlar G1’e özgüdür ve ZGC ile birlikte ya yok sayılır ya da hata verir. İki seti karıştırmak, forumlarda en sık rastlanan “sunucu açılmıyor” nedenlerinden biridir.
Java 25 kurulumu ve gerekli indirmeler#
26.1 ve sonrası Java 25 ister; daha eski bir JDK ile açmaya çalışırsanız UnsupportedClassVersionError alırsınız. Sunucu için LTS olan Java 25’te kalın, Java 26 LTS değildir. Eski sürümlerde kalan sunucular için eşleşme tablosu hangi Java sürümü gerekir sayfasındadır.
-
Eclipse Temurin JDK 25Önerilen LTSİndir
-
Amazon Corretto 25Alternatifİndir
-
Paper 26.2 sunucu jarİndir
-
spark profilerÖlçüm içinİndir
Bağlantılar resmî kaynaklara gider. Üçüncü taraf sitelerden jar veya JDK indirmeyin.
Bayrakları başlatma dosyasına yazmak#
Bayrakları konsola her seferinde elle yazmazsınız; bir başlatma dosyasına koyarsınız. İşletim sistemine göre ayrıntılı adımlar ayrı sayfalarda:
-
Windows tarafında start.bat#
Sunucu klasöründe bir
start.batoluşturup java komutunu içine yazarsınız. Dosyanın tam yapısı, kodlama tuzakları ve RAM değerinin nereye yazılacağı start.bat oluşturma sayfasında anlatılıyor. -
Linux tarafında start.sh ve servis#
Aynı komut bir
start.shiçine yazılır ve çalıştırma izni verilir. Sunucunun yeniden başlatmalarda otomatik ayağa kalkması için systemd servisi oluşturma ya da oturum kapansa da çalışması için screen/tmux kullanımı sayfasını izleyin. -
Panel kullanıyorsanız#
Pterodactyl veya benzeri bir panelde bayraklar sunucunun başlatma parametreleri alanına girilir, RAM sınırı ise panelin bellek limitinden ayrıca uygulanır. İki değeri çelişkili verirseniz konteyner OOM ile öldürülür; panelin limiti heap’ten en az 2 GB büyük olmalıdır.
Bellek kullanımını izlemek ve doğrulamak#
Ayarı yaptıktan sonra gerçekten uygulandığını doğrulayın. En hızlı yol, sunucu çalışırken JVM’in aldığı argümanlara bakmaktır:
jcmd $(pgrep -f paper.jar) VM.flags
jcmd $(pgrep -f paper.jar) GC.heap_infoWindows tarafında aynı bilgiyi jcmd -l ile süreç kimliğini bulup aynı alt komutlarla alırsınız. Uzun vadeli takip içinse GC günlüğü açın; bu bayrak günlükleri döndürerek beş dosyada tutar ve diski şişirmez:
-Xlog:gc*:file=logs/gc.log:time,uptime:filecount=5,filesize=10MOyun içinden bakmak isterseniz spark eklentisiyle /spark healthreport komutu TPS, tick süresi ve bellek kullanımını tek ekranda özetler. /spark profiler start ile de hangi eklentinin ne kadar tick harcadığını çıkarırsınız. Rapor okumayı spark ve timings analizi sayfasında adım adım gösterdik.
En sık yapılan RAM hataları#
Tüm belleği heap’e vermek#
16 GB’lık makinede -Xmx16G yazmak klasik hatadır. JVM’in heap dışı ihtiyacı ve işletim sistemi payı kalmadığı için sistem takasa düşer, tick süresi saniyelere çıkar. Doğrusu -Xmx14G’dir.
Küçük harf G kullanmak veya birim yazmamak#
-Xmx6g geçerlidir ama -Xmx6 yazarsanız JVM bunu 6 bayt olarak okur ve süreç anında ölür. -Xms6G -Xmx6G biçiminde, birimiyle birlikte yazın.
G1 ve ZGC bayraklarını karıştırmak#
Aikar’s Flags setinin üstüne -XX:+UseZGC eklemek işe yaramaz, çelişkili yapılandırma üretir. Bir GC seçin, o GC’nin bayraklarıyla devam edin.
RAM’i lag ilacı sanmak#
“Can’t keep up!” uyarısı çoğunlukla bellek değil CPU ve disk I/O kaynaklıdır. 8 GB’tan 16 GB’a çıkmak entity yığılmasını çözmez. Uyarının gerçek nedenlerini Can’t keep up uyarısı sayfasında, sunucu genelindeki ayarları ise paper.yml ve spigot.yml optimizasyon rehberinde bulabilirsiniz.
Eski sürümün bayraklarını 26.2’ye taşımak#
1.12.2 döneminden kalma -XX:+UseConcMarkSweepGC gibi bayraklar modern JVM’de kaldırıldı; sunucu açılmaz. 26.1 ile gelen unobfuscated yapının eklenti tarafındaki etkileri için 26.1 kurulum sayfasına bakın.
Donanım tarafında ne değişir?#
Bellek ayarı ancak altındaki donanım tutarlıysa anlam kazanır. Minecraft’ın ana tick döngüsü tek çekirdekte çalıştığı için yüksek saat hızı, çekirdek sayısından önce gelir; Ryzen 9 7900X veya 7950X sınıfı bir işlemci ideal, Ryzen 9 3900X makul alt sınırdır. Disk tarafında chunk okuma/yazma gecikmesi doğrudan tick süresine yansıdığı için NVMe SSD şarttır — vanilla sunucuda en az 50 GB, modlu sunucuda 100 GB ve üzeri planlayın.
Bu profildeki hazır paketleri Minecraft sunucu paketleri sayfasında, tüm kaynağı kendiniz yönetmek isterseniz yüksek frekanslı Ryzen VDS tarafında bulursunuz. Modlu sunucuların bellek profili farklı olduğu için modpack rehberindeki RAM notlarını da okumanızı öneririz.
Özetle#
Xms ve Xmx’i eşitleyin, toplam RAM’den 2 GB pay ayırın ve alt sınır olarak 8 GB paket / 6 GB heap ile başlayın. 8-12 GB heap’te G1GC ve Aikar’s Flags kullanın; 16 GB üzeri heap veya ağır modpackte ZGC’yi ölçerek değerlendirin, -XX:+ZGenerational yazmayın. 26.x’in ZGC değişikliğinin istemciye ait olduğunu unutmayın: sunucunuzun çöp toplayıcısı tamamen sizin verdiğiniz bayraklara bağlıdır. Ayar sonrası jcmd ve spark ile doğrulama yapın; RAM’i lag ilacı olarak değil, doğru boyutlandırılması gereken bir kaynak olarak ele alın.