Folia ile Çok Çekirdekli Minecraft Sunucusu Kurulumu

Folia sunucu kurulumu, Minecraft’ın tek çekirdekte tıkanan ana tick döngüsünü aşmak isteyen sunucu sahiplerinin gündemine giren bir konu. Folia, PaperMC ekibinin geliştirdiği ve Paper’a bölge tabanlı çoklu iş parçacığı (regionized multithreading) ekleyen bir forktur: dünyayı birbirine yakın chunk gruplarına böler, her grubu ayrı bir iş parçacığında tick’ler ve böylece 16 çekirdekli bir makinenin gerçekten 16 çekirdeğini kullanmayı hedefler.

Kulağa her sunucunun ihtiyacı gibi geliyor. Değil. Bu sayfada Folia’nın bölge mantığını, Paper’dan farkını, hangi sunucu tipinde işe yarayıp hangisinde hiçbir şey değiştirmediğini, eklenti uyumluluğunun neden en büyük engel olduğunu ve kurulumun adımlarını anlatıyoruz. Sonunda net bir cevabınız olacak — ve o cevap çoğu Türk sunucusu için “Paper’da kal” olacak.

Folia Nedir, Neyi Çözmeye Çalışıyor?#

Minecraft sunucusunun temel darboğazı bilinen bir şey: ana oyun döngüsü tek iş parçacığında çalışır. Mob yapay zekâsı, redstone, chunk tick’leri, entity hareketi, hepsi saniyede 20 kez aynı çekirdek üzerinde sırayla işlenir. Bu yüzden Minecraft sunucusunda çekirdek sayısı değil saat hızı belirleyicidir ve bu yüzden 32 çekirdekli düşük frekanslı bir Xeon, 8 çekirdekli yüksek frekanslı bir Ryzen’in gerisinde kalır.

Paper, Purpur ve diğer forklar bu döngünün içindeki işi ucuzlatarak ilerledi: chunk yükleme ve dünya kaydetme ayrı iş parçacıklarına taşındı, entity işleme optimize edildi. Ama tick döngüsünün kendisi tekti ve öyle kaldı.

Folia bu varsayımı kırıyor. Tek bir tick döngüsü yerine birden fazla bağımsız tick döngüsü çalıştırıyor. Her döngü dünyanın bir parçasından sorumlu. Sunucu artık “tek bir sunucu” gibi değil, aynı süreç içinde yan yana koşan birçok küçük sunucu gibi davranıyor.

Bölge (Region) Mantığı Tam Olarak Nasıl Çalışır?#

Folia’nın bütün fikri şu cümlede: birbirini etkilemeyen iki alan, aynı anda ve ayrı çekirdeklerde işlenebilir.

Sunucu, yüklü chunk’lara bakar ve birbirine komşu olanları tek bir bölge altında toplar. Her bölgenin kendi tick döngüsü, kendi zamanlayıcısı ve iş parçacığı havuzundan aldığı kendi işlemci payı vardır. Sahadaki davranış üç kurala iner:

• Uzak bölgeler paraleldir. Ahmet’in üssü 4.000 blok kuzeyde, Mehmet’in madeni 6.000 blok güneydeyse iki alan farklı bölgelerdedir ve aynı anda işlenir.
• Yaklaşan bölgeler birleşir. İki oyuncu birbirine doğru yürüdükçe bölgelerin yüklü chunk’ları temas eder ve Folia bunları tek bölgeye birleştirir. Artık tek iş parçacığında işleniyorlar.
• Uzaklaşan bölgeler bölünür. Oyuncular ayrıldığında bölge tekrar ikiye ayrılır ve paralellik geri gelir.

Bu birleşme-bölünme davranışı Folia’yı anlamanın anahtarı. Çünkü doğrudan şu sonucu doğuruyor: Folia’nın kazancı oyuncu sayısıyla değil, oyuncular arasındaki mesafeyle ölçeklenir. 200 oyuncunuz olabilir; hepsi aynı lobide duruyorsa Folia için tek bölge, tek iş parçacığı, sıfır kazanç demektir.

Nether ve End da ayrı dünyalar oldukları için ayrı bölge kümeleri oluşturur. Çok dünyalı kurulumlarda bu, kendiliğinden gelen küçük bir avantaj.

Folia ile Paper Arasındaki Gerçek Farklar#

Tablodaki en kritik satır eklenti satırı. Diğer her şey ayarla telafi edilebilir, o satır edilemez. Sunucu yazılımlarının tamamının nerede durduğunu görmek isterseniz sunucu yazılımları karşılaştırmamıza bakın.

Hangi Sunucuya Uyar, Hangisine Faydası Yok?#

Bu bölümü dikkatli okuyun, çünkü Folia hakkındaki yanlış beklentilerin tamamı buradan çıkıyor.

Şöyle bir kural koyun: sunucunuzda oyuncuların yarısından fazlası aynı anda birbirini görebiliyorsa Folia size bir şey vermez. Türkiye’deki sunucuların önemli kısmı da tam olarak bu grupta — survival sunucusu bile olsa oyuncular genelde spawn çevresindeki ilk 500 blokta yaşıyor, birbirine yakın ev yapıyor, aynı ticaret alanında toplanıyor. O tabloda Folia’nın bölme algoritması yeterli sayıda bağımsız bölge bulamaz.

Eklenti Uyumluluğu: Asıl Engel Burada#

Folia’nın teknik başarısını gölgeleyen tek konu bu. Paper’da bir eklenti oyunla ilgili bir iş yapacağı zaman işi ana iş parçacığına verir; ana iş parçacığı tek olduğu için bu güvenlidir. Folia’da tek bir ana iş parçacığı yoktur. Bir bloğa dokunacak kod, o bloğun bağlı olduğu bölgenin iş parçacığında çalışmak zorundadır.

Bu yüzden eklenti geliştiricisinin yapması gereken şey basit bir yeniden derleme değil: klasik Bukkit zamanlayıcı çağrılarını bölge, varlık ve global zamanlayıcılara taşımak, dünya erişimlerini doğru iş parçacığına yönlendirmek zorunda. Ciddi bir iş. Sonrasında da eklentinin Folia desteğini açıkça bildirmesi gerekiyor; bildirmeyen eklentiyi Folia güvenlik gerekçesiyle yüklemez.

Pratikte karşınıza çıkacak tablo şu:

Yani Folia’ya geçiş kararı aslında bir eklenti kararıdır. Önce eklenti listenizi çıkarın, her birinin Folia desteğini tek tek doğrulayın; listede vazgeçemeyeceğiniz bir eklenti destelemiyorsa konu orada kapanır ve karar kendiliğinden verilmiş olur.

Donanım: Çekirdek Sayısının Gerçekten Önem Kazandığı Yer#

Wiki’nin geri kalanında sürekli “Minecraft’ta çekirdek sayısı değil saat hızı önemlidir” diyoruz. Folia, bu cümlenin istisnasıdır — ama yarım istisnasıdır.

Bölgeler paralel işlendiği için toplam kapasite çekirdek sayısıyla artar. Buna karşılık tek bir bölgenin içindeki iş hâlâ tek iş parçacığında akar. Yani 32 çekirdekli düşük frekanslı bir işlemci, kalabalık bir bölgede yine tıkanır. Doğru hedef ikisinin birlikte olması: yüksek saat hızı ve yeterli çekirdek.

Paylaşımlı ya da kısıtlı vCPU verilen paketlerde Folia denemeye değmez: iş parçacıkları gerçek çekirdek bulamazsa bölge paralelliği kâğıt üstünde kalır. Fiziksel çekirdek garantisi arıyorsanız dedicated sunucu tarafına bakmanız gerekebilir; ayrıntılı donanım kriterleri donanım seçimi rehberimizde.

Folia Kurulumu#

Kurulum, Paper kurmayı bilen biri için sürprizsiz. Dosya yapısı, eula.txt, server.properties ve plugins klasörü aynı yerde duruyor.

1. Java 25’i doğrulayın#

   Folia 26.x, Minecraft’ın kendi kuralına tabidir: 26.1 ve sonrası Java 25 ister. Sürüm tablosunun tamamı Java sürüm rehberimizde.

   java -version
   # beklenen: openjdk version "25..." veya üzeri

2. Jar dosyasını indirin#

   İndirme sayfası varsayılan olarak kararlı hattı (26.1.2, build #8) sunar. 26.2 yapısı beta kanalındadır ve sayfada ayrıca seçilmesi gerekir. İşletim sistemine özel ayrıntılar için Windows ve Linux kurulum rehberlerimize bakın; buradaki adımlar her iki tarafta da aynıdır.

   # Linux
   mkdir -p /opt/folia && cd /opt/folia
   # jar dosyasını papermc.io/downloads/folia adresinden indirip
   # folia.jar adıyla bu klasöre koyun
   
   # Windows (PowerShell)
   New-Item -ItemType Directory C:\folia
   Set-Location C:\folia

3. İlk açılışı yapıp EULA’yı kabul edin#

   İlk çalıştırma eula.txt dosyasını oluşturup durur. Dosyadaki değeri eula=true yapıp tekrar başlatın.

   #By changing the setting below to TRUE you are indicating your agreement to our EULA.
   eula=true

4. server.properties dosyasını ayarlayın#

   Folia’da view-distance ve simulation-distance değerleri normalden daha kritiktir: yüksek değerler bölgelerin gereğinden erken birleşmesine yol açar ve paralelliği azaltır.

   server-port=25565
   online-mode=true
   view-distance=8
   simulation-distance=6
   max-players=100

5. Eklentileri tek tek ekleyin#

   Hepsini birden atmayın. Her eklentiyi ekleyip sunucuyu başlatın, konsolda reddedilme uyarısı var mı bakın. Reddedilen eklentiyi plugins klasöründen çıkarın.

6. Dünyayı ön üretimden geçirin#

   Canlı dünya üretimi Folia’da da pahalıdır. Açılıştan önce chunk ön üretimi yapmak ilk günlerdeki takılmaların çoğunu ortadan kaldırır; Chunky gibi araçlar Folia’yı desteklenen platformlar arasında sayıyor.

Başlatma Komutu ve Bellek Ayarı#

Folia’nın kendi başlatma betiği yoktur; klasik java -jar komutuyla açılır. Heap değerini paketinize göre verin ve -Xms ile -Xmx’i daima eşit tutun.

#!/bin/bash
# start.sh - 16 GB paket icin
java -Xms14G -Xmx14G \
  -XX:+UseG1GC -XX:+ParallelRefProcEnabled -XX:MaxGCPauseMillis=200 \
  -XX:+UnlockExperimentalVMOptions -XX:+DisableExplicitGC -XX:+AlwaysPreTouch \
  -XX:G1NewSizePercent=30 -XX:G1MaxNewSizePercent=40 -XX:G1HeapRegionSize=8M \
  -jar folia.jar nogui

@echo off
rem start.bat - 12 GB paket icin
java -Xms10G -Xmx10G -XX:+UseG1GC -XX:+ParallelRefProcEnabled -XX:MaxGCPauseMillis=200 -jar folia.jar nogui
pause

Folia’nın bölge iş parçacığı havuzu varsayılan olarak makinenin çekirdek sayısına göre kendini ayarlar. Bu değeri elle değiştirmeden önce PaperMC’nin Folia dokümanına bakın; ayar adları sürümden sürüme değişebiliyor ve yanlış bir değer, kazanmayı umduğunuz paralelliği tamamen kapatabiliyor. Genel performans ayarlarının tamamı için sunucu optimizasyonu rehberimiz daha kapsamlı bir kaynak.

Geçiş Öncesi Dürüst Kontrol Listesi#

Destek taleplerinde en sık gördüğümüz senaryo şu: sunucu sahibi TPS düşüklüğü yaşıyor, bir yerde Folia’yı okuyor, jar’ı değiştiriyor ve yarısı yüklenmeyen eklentilerle baş başa kalıyor. Bunu yaşamamak için sırayla cevaplayın:

1. Oyuncularım gerçekten dağınık mı? Haritada işaretleyin, tahmin etmeyin.
2. Eklenti listemdeki her öğe Folia’yı destekliyor mu? Bir tanesi bile hayırsa durun.
3. Makinemde en az 12 gerçek çekirdek var mı?
4. Elimde çalışan bir yedek ve geri dönüş planı var mı?
5. Sorunu ölçtüm mü, yoksa sadece tahmin mi ediyorum?

Bir de alternatifi masaya koyun: oyuncu sayısı tek sunucuyu zorluyorsa Folia yerine Velocity proxy arkasında birden fazla Paper sunucusu çalıştırmak çok daha öngörülebilir bir çözüm. Eklentileriniz aynen çalışır, yükü siz bölersiniz ve bir sunucu düşse bile diğerleri ayakta kalır. Çoğu durumda doğru cevap budur.

Sık Karşılaşılan Sorunlar#

Eklenti yüklenmiyor

Konsolda Folia desteği bulunmadığına dair uyarı görürsünüz. Çözüm yok; ya eklentinin Folia uyumlu bir sürümü çıkacak ya da o eklentiden vazgeçeceksiniz.

TPS ölçemiyorum

Tek bir global TPS yok. Bölge başına ölçüm yapan araçlar kullanın. Kavramın kendisi için tick, TPS ve MSPT sayfamıza bakın.

Beklediğim kazanç gelmedi

Neredeyse her zaman sebep aynı: oyuncular yeterince dağınık değil. Bölge sayısını gözlemleyin.

Sunucu açılmıyor

Önce Java sürümünü kontrol edin. UnsupportedClassVersionError görüyorsanız Java 25 kurulu değildir.

26.2 yapısında hata alıyorum

26.2 hattı beta. Üretimde 26.1.2 kararlı yapısında kalmak daha güvenli.

Hazır yapılandırılmış bir sunucuyla başlamak isterseniz Minecraft sunucu paketlerimiz Ryzen tabanlı donanım ve NVMe disk ile teslim ediliyor; Folia denemesi için ikinci bir örnek açmak da mümkün.

Özetle#

Folia, Minecraft sunucularının en eski darboğazına gerçek bir mühendislik cevabı: dünyayı bölgelere ayırıp her bölgeyi ayrı çekirdekte tick’lemek. Doğru senaryoda — geniş harita, dağınık oyuncular, çok çekirdekli makine — Paper’ın yapamayacağı bir şeyi yapıyor. Bu, teknik olarak etkileyici.

Ama sunucu işletmek teknik etkileyicilikle değil, çalışan bir eklenti listesiyle yürüyor. Folia’nın eklenti ekosistemi hala dar; 26.2 yapısı beta; ve Türkiye’deki sunucuların çoğunda oyuncular Folia’nın ihtiyaç duyduğu kadar dağınık değil. Bu üç gerçek yan yana gelince tavsiyemiz net: çoğu sunucu için doğru tercih Paper’dır.

Folia’yı ikinci bir sunucuda deneyin, eklentilerinizi tek tek sınayın, oyuncu dağılımınızı ölçün. Sonuç lehinize çıkarsa geçersiniz. Çıkmazsa herşey yerinde durur ve zaten kaybettiğiniz bir şey olmaz — kaybedilen tek şey, canlı sunucuyu deneme tahtası yapanların kaybettiği oyunculardır.