Minecraft Sunucusunda Yerdeki Eşyaları ve Entity Temizleme

Minecraft sunucusunda yerdeki eşyaları ve fazla entity’yi (varlık — item, mob, ok, deneyim küresi gibi oyun içindeki her hareketli nesne) temizlemek TPS’i toparlamanın en bilinen yoludur. Ama 2026’da doğru cevap çoğu sunucu için şaşırtıcıdır: bunun için ayrı bir eklentiye genellikle ihtiyacınız yoktur. Paper ve Spigot’un yerleşik ayarları, eski ClearLag eklentilerinin yaptığı işin büyük bölümünü oyuncuyu mağdur etmeden ve sürekli tarama yapmadan hallediyor.

Bu sayfada önce entity birikiminin neden lag ürettiğini, sonra eklentisiz çözümleri gerçek ayar satırlarıyla, ardından 26.2 uyumlu eklenti alternatiflerini ve hangi durumda gerçekten eklenti kurmanız gerektiğini bulacaksınız. Genel performans tablosu için Minecraft sunucu optimizasyonu rehberi bu sayfayı tamamlar.

Entity Birikimi Neden TPS Düşürür?#

Sunucu saniyede 20 kez (20 tick) dünyayı günceller. Her tick’te yüklü chunk’lardaki entity’lerin konumu, çarpışması, yerçekimi ve yapay zekâsı hesaplanır. Entity sayısı arttıkça bu hesap tek bir tick’e sığmamaya başlar ve TPS 20’nin altına düşer.

Pratikte yükü üreten dört tipik kaynak vardır:

• Yerdeki eşyalar (item): Kazma yapan oyuncular, patlayan TNT ve mob farmlar sürekli item üretir. Birleşmeyen yüzlerce cobblestone yığını en yaygın sebeptir.
• Deneyim küreleri (experience orb): Tek tek entity sayılır ve mob farmlarda binlere ulaşabilir.
• Aşırı çoğalan hayvanlar: Kontrolsüz üretilen inek ve tavuk sürüleri kalıcı yük bırakır.
• Armor stand ve item frame: Dekorasyon amaçlı konur, sonra unutulur; sayıları sessizce büyür.

Konsolda Can’t keep up! Is the server overloaded? uyarısını görüyorsanız sebeplerden biri budur; bu uyarının diğer nedenleri için ilgili hata sayfasına bakabilirsiniz.

Önce Teşhis: Eklenti Kurmadan Önce spark#

“Sunucum lag yapıyor” cümlesinin ardından yapılacak ilk iş temizlik eklentisi kurmak değil, sebebi ölçmektir. Bunun doğru aracı spark profiler’dır; 1.10.173 sürümü 18 Haziran 2026’da yayınlandı ve 26.1 ile 26.2’yi destekliyor.

/spark tps
/spark health
/spark profiler start
/spark profiler stop

/spark health anlık durumu özetler; /spark profiler start ile bir süre kayıt alıp stop dediğinizde tarayıcıda açılan bir rapor bağlantısı verir. Rapordaki en kalın dal entity tick’leriyle ilgiliyse temizlik doğru yoldur; değilse eşya silmek hiçbir şeyi düzeltmez. Rapor okumayı spark ve Timings analizi sayfasında adım adım anlatıyoruz.

Eklentisiz Çözüm 1: paper-world-defaults.yml#

Paper’ın dünya yapılandırması, entity yönetimi için ClearLag’in en çok kullanılan işlevlerini yerleşik olarak sunar. Dosya config/paper-world-defaults.yml içinde bulunur; tek bir dünyaya özel ayar yapmak isterseniz o dünyanın kendi paper-world.yml dosyasını kullanırsınız.

# config/paper-world-defaults.yml
entities:
  chunks:
    entity-per-chunk-save-limit:
      experience_orb: -1
  spawning:
    alt-item-despawn-rate:
      enabled: false
      items:
        cobblestone: 300
    spawn-limits:
      ambient: -1
      creature: -1
      monster: -1
      water_creature: -1
    ticks-per-spawn:
      ambient: -1
      creature: -1
      monster: -1
hopper:
  cooldown-when-full: true
  disable-move-event: false

Bu blokta üç ayar hayat kurtarır:

entity-per-chunk-save-limit

Chunk kaydedilirken saklanacak entity üst sınırıdır. -1 sınırsız demektir. experience_orb ve item için sınır koymak, chunk yükleme/kaydetme sırasındaki takılmaları keser.

alt-item-despawn-rate

Belirli eşyaların normalden daha hızlı yok olmasını sağlar. ClearLag’in en çok kullanılan işlevi tam olarak budur ve Paper bunu eklentisiz yapar. enabled: true yapıp listeye cobblestone, dirt, netherrack gibi çöp blokları ekleyin.

spawn-limits

Dünya başına aynı anda kaç mob doğabileceğini belirler. -1 vanilla değerini kullanır; kalabalık sunucularda monster sınırını düşürmek belirgin fark yaratır.

Eklentisiz Çözüm 2: spigot.yml#

İkinci kritik dosya spigot.yml’dir. Buradaki iki ayar — merge-radius.item ve entity-activation-range — entity yükünü doğrudan aşağı çeker. Varsayılan değerler şöyledir:

# spigot.yml
world-settings:
  default:
    entity-activation-range:
      animals: 32
      monsters: 32
      raiders: 64
      misc: 16
      water: 16
      villagers: 32
      flying-monsters: 32
    merge-radius:
      exp: -1
      item: 0.5
    mob-spawn-range: 8
    item-despawn-rate: 6000
    arrow-despawn-rate: 1200
    ticks-per:
      hopper-check: 1
      hopper-transfer: 8
      hopper-amount: 1
    view-distance: default

item-despawn-rate: 6000 değeri tick cinsindendir; 6000 tick = 5 dakika. merge-radius.item: 0.5 ise yerdeki eşyaların ancak yarım blok yakınlıkta birleşeceği anlamına gelir — bu değeri yükseltmek entity sayısını gözle görülür azaltır.

Bu iki dosyanın tamamını satır satır incelemek isterseniz paper.yml, spigot.yml ve bukkit.yml optimizasyon rehberi ayrıntılı bir referans sunuyor. Görüş mesafesinin entity yüküne etkisi için view distance ve simulation distance ayarları sayfasına bakın.

26.2 Uyumlu ClearLag Alternatifleri#

Yerleşik ayarlar yetmiyorsa sıra eklentiye gelir. 26.2 destekleyen, aktif geliştirilen seçenekler şunlardır:

Kurulum yöntemi hepsinde aynıdır: jar dosyasını plugins klasörüne kopyalayıp sunucuyu yeniden başlatırsınız. Adım adım anlatım için plugin kurulumu sayfasına bakabilirsiniz. Komut ve ayar adları eklentiden eklentiye değiştiği için kurduğunuz eklentinin kendi dokümanını okuyun; ortak bir standart yoktur.

Ne Zaman Gerçekten Eklenti Kurmalı?#

Paper ve Spigot ayarları yeterli olmadığında karar şu üç duruma bakılarak verilir:

1. Oyuncuya uyarı göstererek zamanlanmış temizlik istiyorsanız#

   “Temizliğe 60 saniye kaldı” tipi geri sayım ve sohbet duyurusu yerleşik ayarlarla yapılamaz. Bu bir eklenti işidir.

2. Armor stand ve item frame birikimi varsa#

   Paper bu iki entity türü için doğrudan bir despawn mekanizması sunmaz. Dekorasyon amaçlı konup unutulan yüzlerce armor stand’ı sınırlamak eklentiyle daha kolaydır.

3. Hangi chunk’ın yük ürettiğini bulamıyorsanız#

   Bazı eklentiler “laggy chunk finder” özelliğiyle sorunlu bölgeyi koordinatıyla listeler. spark raporu size işlemi söyler, bu araçlar yeri söyler.

Güvenli Temizleme Politikası#

Temizlik yapılandırmasında en sık yapılan hata, oyuncuları düşünmeden agresif değerler girmektir. Aşağıdaki çerçeve şikâyet üretmeyen bir denge kurar:

Vanilla tarafında acil bir müdahale gerekiyorsa yerdeki eşyaları silen komut şudur; ancak istisnasız her item’i sileceği için yalnızca kontrollü durumlarda kullanın:

/kill @e[type=item]
/kill @e[type=experience_orb]

Sık Yapılan Dört Hata#

1. Teşhis koymadan eklenti kurmak#

Lag’in sebebi entity değil de bir eklentinin ana iş parçacığını kilitlemesiyse, temizlik hiçbir şeyi düzeltmez. Önce ölçün, sonra müdahale edin. Bu, sayfada tekrar tekrar vurgulanacak kadar önemlidir.

2. Temizlik aralığını çok kısa tutmak#

Bir dakikada bir çalışan temizlik, hem oyuncu şikâyeti üretir hem de her taramada CPU harcar. İronik biçimde temizliğin kendisi lag kaynağına dönüşebilir. Beş dakikanın altına inmeyin.

3. Aynı işi iki kez yapmak#

Paper’ın alt-item-despawn-rate ayarını açıp aynı anda eklentiye de aynı eşyaları sildirmek gereksizdir ve hangi mekanizmanın çalıştığını takip etmeyi zorlaştırır. Bir işlevi tek yerde yönetin.

4. Deneyim kürelerini görmezden gelmek#

Mob farmı olan sunucularda deneyim küreleri item sayısını çoğu zaman geçer. merge-radius.exp değerini -1 bırakmak yerine 4.0 gibi bir değere çekmek tek başına belirgin fark yaratır. Farm tasarımının yük tarafını mob farm yapımı sayfasında da ele alıyoruz.

Donanım Tarafı: Temizlik Her Şeyi Çözmez#

Entity temizliği bir bant yardımıdır; sunucu donanımı yetersizse TPS yine düşer. Minecraft’ın ana tick döngüsü tek çekirdekte çalıştığı için belirleyici olan çekirdek sayısı değil saat hızıdır. Bu yüzden Ryzen 9 7900X / 7950X sınıfı yüksek frekanslı işlemciler tercih edilmeli, disk tarafında chunk okuma/yazma gecikmesini düşüren NVMe SSD kullanılmalıdır.

java -Xms14G -Xmx14G -XX:+UseG1GC -jar paper.jar nogui

Heap değerlerini işletim sistemine pay bırakacak şekilde verin ve -Xms ile -Xmx değerlerini daima eşitleyin. Kaç GB ile başlamanız gerektiğini oyuncu sayısına göre RAM tablosundan hesaplayabilir, donanım seçimini doğru donanım nasıl seçilir sayfasıyla netleştirebilirsiniz. Batihost’un Minecraft sunucu paketleri 156 TL’den başlar ve tamamı Ryzen tabanlı NVMe diskli donanımda çalışır.

Özetle#

Entity temizliğinde doğru sıra şudur: önce /spark health ile ölçün, sonra spigot.yml ve paper-world-defaults.yml ayarlarını düzenleyin, ancak bunlar yetmezse eklenti kurun. Çoğu sunucu ikinci adımda durur.

Eklenti kuracaksanız orijinal ClearLagg’ı unutun — 2021’den beri güncellenmiyor ve 26.1’in unobfuscation değişikliği sonrası eski NMS tabanlı eklentiler yeniden derlenmeden çalışmıyor. 26.2 için ClearLaggEnhanced 26.8.0 veya ClearLag++ 1.12.5 seçin, temizliği 5 dakikadan sık yapmayın ve oyunculara mutlaka uyarı gösterin. TPS hâlâ düşükse sorun entity değil başka bir yerdedir; TPS düşüklüğü ve çözüm yolları sayfası bir sonraki durağınız olsun.