# Sunucu Optimizasyon Rehberi

Minecraft 1.21 ve üzeri sürümler için hazırlanmış bu **profesyonel optimizasyon rehberi**, yüksek oyunculu sunucularda bile maksimum performans ve kararlılık elde etmenizi sağlar. Bu rehber, **HeisenSetups ekibinin gerçek projelerde kullandığı test edilmiş ayarları ve yöntemleri** içerir.

***

## 🪓 1. Fork Seçimi — Hangi Yazılımı Kullanmalısın?

Minecraft sunucu performansının temeli doğru sunucu yazılımıyla başlar. Vanilla Spigot artık yeterli değil. Hedefin yüksek TPS, düşük gecikme ve gelişmiş kontrol ise şu fork’lardan biriyle başlaman şart.

| Forklar                             | Kullanım Amacı                                                    | Avantajı                                                                                                                                                                                                                                   | Dezavantajı                                                                                       |
| ----------------------------------- | ----------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------- |
| 🔸 Paper                            | Orta ölçekli sunucular için başlangıç seviyesi performans sağlar. | Optimize edilmiş event sistemi, daha stabil ve hafif.                                                                                                                                                                                      | <p></p><p>Derin sistem ayarları sınırlı, çok yüksek oyunculu senaryolarda yetersiz kalabilir.</p> |
| 🔸 Purpur                           | Özelleştirme isteyen sunucular için idealdir.                     | Paper üzerine inşa edilir. Ekstra performans ayarları, anti-xray, varsayılan ayarlar.                                                                                                                                                      | Bloat riski vardır; ayarları doğru yapılandırılmazsa gereksiz işlem yükü bindirebilir.            |
| <p>🔸 Leaf <br>(Tavsiye Edilen)</p> | 100+ oyunculu sunucularda tam performans için önerilir.           | <p></p><p>Purpur’dan türetilmiş en ileri seviye optimizasyon fork’udur. <code>leaf-global.yml</code> ile kernel düzeyine yakın kontrol sağlar. Async task yönetimi, IO optimizasyonları, anti-lag sistemleri dahili olarak entegredir.</p> | Ayar bilgisi olmadan kurmak tehlikelidir. Yanlış yapılandırma sistem çökmelerine neden olabilir.  |

### ✅ Önerimiz:

Yeni kurulumlarda doğrudan **Leaf** kullanın. Gelişmiş yapılandırma dosyaları sayesinde TPS düşüşlerinin önüne geçilir.

***

## ⚙️ 2. Yapılandırma Dosyalarının Optimize Edilmesi

Fork seçiminin ardından yapılması gereken en kritik adım, sunucuya ait konfigürasyon dosyalarının ayarlanmasıdır. Varsayılan değerler genellikle performans odaklı değil, **güvenli ama verimsiz** şekilde gelir. Bu yüzden bu dosyalardaki ayarları optimize etmeden iyi bir performans beklemek saflık olur.

<details>

<summary>📁 <code>Bukkit.yml</code> Ayarları:</summary>

<kbd>**spawn-limits**</kbd>
\
Varsayılan: monsters:70, animals:10, water-animals:15, ambient:15
\
Optimize Edilmiş: monsters:50, animals:8, water-animals:3, ambient:1
\
Performansa Etkisi: Orta\
\ <kbd>**chunk-gc.period-in-ticks**</kbd>
\
Varsayılan: 600
\
Optimize Edilmiş: 400
\
Performansa Etkisi: Orta\
🧠 Sunucu içersinde bulunan oyuncu sayısına bağlı olarak doğacak mob limitlerini ayarlar. eğer sunucuda 50 kişi varsa (50 / Tüm oyuncuların Chunk Miktarı) şeklinde ne kadar mob doğacağını hesaplayabilirsiniz.\\

\ <kbd>ticks-per.monster-spawns</kbd>
\
Varsayılan: 1
\
Optimize Edilmiş: 4
\
Performansa Etkisi: Orta\
🧠 Kullanılmayan Chunk'ların daha hızlı yok olmasını sağlar, ne kadar düşük rakam girilirse TPS'e o kadar etkisi artar.

</details>

<details>

<summary>📁 <code>Spigot.yml</code> Ayarları:</summary>

<kbd>save-user-cache-on-stop-only</kbd>
\
Varsayılan: false
\
Optimize Edilmiş: true
\
Performansa Etkisi: Orta\
🧠 Sunucu da yapılan cache kayıtlarının oyunda sürekli olarak kaydetmesini istiyorsanız false olarak bırakın, eğer sadece sunucu kapanırken kayıt etsin diyorsanız true ayarına getirin true olması sunucunuzda performansı arttıracaktır. (eğer true ise lütfen sunucuyu kapatırken stop yazarak kapatınız)

<kbd>max-tick-time</kbd>
\
Varsayılan: tile:50, entity:50
\
Optimize Edilmiş: tile:1000, entity:1000
\
Performansa Etkisi: Düşük.

<kbd>mob-spawn-range</kbd>
\
Varsayılan: 8
\
Optimize Edilmiş: 6
\
Performansa Etkisi: Düşük\
🧠 Oyuncuların oyunda giderken yüklenen chunk uzaklık alan mesafesine göre doğacağı alan'ı belirler. daha anlaşılır şekilde yazacak olursak görüş mesafenize göre oluşacak kısım. örneğin görüş mesafeniz 6 ise oyunda o 6'lık mesafe içinde moblar doğacaktır.

<kbd>entity-activation-range</kbd>
\
Varsayılan: animals:32, monsters:32, raiders: 48, misc:16
\
Optimize Edilmiş: animals:16, monsters:24, raiders: 48, misc:8
\
Performansa Etkisi: Orta\
🧠 Bu ayarı çok düşük olarak ayarlamayın, bozabilirsiniz.

<kbd>merge-radius</kbd>
\
Varsayılan: item:2.5, exp:3.0
\
Optimize Edilmiş: item:4.0, exp:6.0
\
Performansa Etkisi: Orta\
🧠 birleştirme mesafesini ayarlar.

<kbd>nerf-spawner-mobs</kbd>
\
Varsayılan: false
\
Optimize Edilmiş: true
\
Performansa Etkisi: Orta\
🧠 Bunu aktif hale getirdiğiniz zaman moblarda ki bazı davranışları değiştirecektir, saldırganlık/hareket etme/zıplama gibi özellikleriyle oynayacaktır. eğer sunucunuz da hayvan/canavar farmları yapılıyorsa true yapmanızı öneririm sunucunuz'a gerçekten katkı sağlayacaktır.

<kbd>item-despawn-rate</kbd>
\
Varsayılan: 6000 (5 minutes)
\
Optimize Edilmiş: daha az?
\
Performansa Etkisi: Duruma göre\
🧠 Yere düşen eşyaların silinmeden önce ki süreyi ayarlar.

<kbd>arrow-despawn-rate</kbd>
\
default: 1200
\
optimize: 300
\
Performansa Etkisi: Düşük

</details>

<details>

<summary>📁 <code>Paper.yml</code> Ayarları:</summary>

<kbd>max-auto-save-chunks-per-tick</kbd>
\
Varsayılan: 24
\
Optimized: 6
\
Performance etkisi: Yüksek\
🧠 Aşırı düşük ayarlarsan dünya kaydedilmesi gecikir, crash sonrası rollback riski olur.

<kbd>optimize-explosions</kbd>
\
Varsayılan: false
\
Optimize Edilmiş: true
\
Performansa Etkisi: Düşük

<kbd>mob-spawner-tick-rate</kbd>
\
Varsayılan: 1
\
Optimize Edilmiş: 2
\
Performansa Etkisi: Düşük

disable-chest-cat-detection
\
Varsayılan: false
\
Optimize Edilmiş: true
\
Performansa Etkisi: Düşük

<kbd>container-update-tick-rate</kbd>
\
Varsayılan: 1
\
Optimize Edilmiş: 3
\
Performansa Etkisi: Düşük

<kbd>max-entity-collisions</kbd>
\
Varsayılan: 8
\
Optimize Edilmiş: 2
\
Performansa Etkisi: Orta

<kbd>grass-spread-tick-rate</kbd>
\
Varsayılan: 1
\
Optimize Edilmiş: 4
\
Performansa Etkisi: Orta\
🧠 Oyunu etkilemez FPS düşürmez, çimenlerin oluşmasıyla ilgili bir ayar.

<kbd>despawn-ranges</kbd>
\
Varsayılan: soft: 32, hard: 128
\
Optimize Edilmiş: soft: 28, hard: 96
\
Performansa Etkisi: Düşük

<kbd>hopper.disable-move-event</kbd>
\
Varsayılan: false
\
Optimize Edilmiş: true
\
Performansa Etkisi: Yüksek\
🧠 Her bir slot için InventoryMoveItemEvent eventini çağırmayı kapatır bu ayarı kapatmak performansa büyük ölçüde katkı sağlar eğer InventoryMoveItemEvent çağıran bir eklentiniz varsa false olarak bırakın.

<kbd>non-player-arrow-despawn-rate</kbd>
\
Varsayılan: -1
\
Optimize Edilmiş: 60 (3 saniye)
\
Performansa Etkisi: Düşük

<kbd>creative-arrow-despawn-rate</kbd>
\
Varsayılan: -1
\
Optimize Edilmiş: 60 (3 saniye)
\
Performansa Etkisi: Düşük

<kbd>prevent-moving-into-unloaded-chunks</kbd>
\
Varsayılan: false
\
Optimize Edilmiş: true
\
Performansa Etkisi: Orta\
🧠 Bu ayarı aktif etmeniz yüklenmemiş chunk'ta yani oyunda görülmeyen yere oyuncu gidince onu güvenli bir yere geldiği yöne doğru geri atmasıdır.
\
daha net anlamanız için oyunda çok hızlı uçtuğunuzda bazen chunklar yüklenmez ve orası boş görünür oraya girdiğinizde yazı yazamazssınız lag gibi bir şey olur bu ayarı true yaptığınız da öyle bir yere gidince sizi güvenli yere geri bırakacaktır.

<kbd>use-faster-eigencraft-redstone</kbd>
\
Varsayılan: false
\
Optimize Edilmiş: true
\
Performansa Etkisi: Yüksek\
🧠 Bu ayar gereksiz kızıltaş işlemlerini 95% azaltmaktadır. eğer redstone ile ilgili bir eklenti kullanıyorsanız o eklenti yerine bunu değiştirmeyi deneyin.

<kbd>armor-stands-tick</kbd>
\
Varsayılan: true
\
Optimize Edilmiş: false
\
Performansa Etkisi: Düşük

<kbd>per-player-mob-spawns</kbd>
\
Varsayılan: false
\
Optimize Edilmiş: true
\
Performansa Etkisi: Düşük

<kbd>alt-item-despawn-rate</kbd>
\
Varsayılan: false
\
Optimize Edilmiş: true
\
Performansa Etkisi: Orta

</details>

***

## 🧠 3. Spark ile Gerçek Zamanlı Lag Analizi ve Teşhis

Sunucu lag yapıyor ama sebebi ne? TPS düşük ama nedenini göremiyorsun? İşte burada **Spark** devreye girer. Spark, Minecraft sunucularında **milisaniye hassasiyetinde** performans analizi yapmanı sağlar. "Tahmin" değil, **kanıtlı veri** verir.

### 📥 Spark Nasıl Kurulur?

**Spark** artık **Paper, Purpur ve Leaf** forklarının *çoğunda entegre* olarak gelir. Ekstra eklenti olarak yüklemeye gerek yoktur.

### 📑 Spark Raporu Nasıl Alınır?

`/spark profiler --timeout 60` \
Bu komut, sunucunun 60 saniyelik işlem geçmişini kaydeder ve otomatik olarak detaylı bir site raporu oluşturur.

### 🔍 Alternatif Spark Komutları:

| Komut            | Açıklama                                                              |
| ---------------- | --------------------------------------------------------------------- |
| `/spark tps`     | TPS ve ping bilgilerini görürsün.                                     |
| `/spark heap`    | RAM kullanımını analiz eder.                                          |
| `/spark sampler` | CPU’nun anlık olarak neye harcandığını milisaniye düzeyinde gösterir. |
| `/spark report`  | Tüm analizleri birleştirir, otomatik rapor linki oluşturur.           |

### 📊 Raporu Yorumlama (Kısa İpucu):

* `Plugin::PluginAdı::onPlayerMove()` - Lag eklentiden kaynaklı.
* `Entity::Tick()` - Çok fazla canlı var.
* `World::ChunkLoad()` - Chunk yüklemeleri ani lag yaratıyor.
* `Task::Scheduler::runTaskTimer()` - Eklentilerin main thread’i yoğun kullanıyor olabilir.

***

## 🧪 4. FarmControl — Gelişmiş Mob/Farm Optimizasyon Sistemi

[FarmControl ](https://www.spigotmc.org/resources/farmcontrol.86923/)sunucunuzda çalışan tüm mob AI davranışlarını **dinamik olarak analiz eder ve kontrol altına alır.**\
Mob sayısı arttıkça veya TPS düştükçe sistem **otomatik olarak** devreye girer.

<figure><img src="/files/5QzGFg80vZ6iQ4pcu6RL" alt=""><figcaption></figcaption></figure>

### 🚀 Özellikleri:

* **TPS’ye duyarlı mob AI kapatma** (lag olduğunda geçici AI devre dışı)
* **Chunk başına mob sınırı** (farm spam'ını önler)
* **Mobların etkinliğini azaltma** (örn. pathfinding’i yavaşlatma)
* **Yüksek yoğunlukta chunklarda otomatik farm dondurma**
* Eklenti tarafından çağrılan mobların da kontrolünü alır
* Async çalışır, TPS’ye baskı yapmaz

***

## ⚙️ 5. Aikar JVM Flags ve Başlatma Komutları

### 📌 Kimdir Aikar?

Aikar, Minecraft sunucu performansı optimizasyonunda en otoriter isimlerden biridir.\
Geliştiricilere özel, güncel ve farklı sunucu tiplerine göre optimize edilmiş JVM başlatma komutları sağlar.

### 🌐Aikar Optimizasyonlu Sunucu Başlatma Kodu Üreticisi

<https://flags.sh/> Sitesi, Minecraft sunucunuz için en uygun JVM bayraklarını otomatik olarak oluşturur.

***

## 🗂️ Chunky — Minecraft Önceden Chunkları Yükleme Optimizasyon Eklentisi

Chunky, Minecraft sunucularında **chunk yükleme, unload işlemleri ve önbellekleme** süreçlerini daha verimli hale getiren, böylece sunucu performansını artıran bir optimizasyon eklentisidir.

Sunucu üzerindeki **yüklenmiş chunk sayısını kontrol eder, gereksiz chunk’ların bellekten atılmasını sağlar** ve chunk yükleme sırasında oluşan lagları minimize eder.

### ⚙️ Kurulum ve Kullanım:

{% hint style="info" %}
/chunky world Dünya İsmi\
/chunky center 0 0
\
/chunky shape square
\
/chunky radius 35000
\
/chunky start
{% endhint %}

***

## 🚀 Sonuç

Minecraft sunucu optimizasyonu, yüzeysel ayarlardan çok daha fazlasıdır. Fork konfigürasyonları, JVM ayarları, plugin yönetimi, chunk optimizasyonu ve entity kontrolü gibi birçok detayın bir arada doğru uygulanması gerekir.

**HeisenSetups olarak, yılların tecrübesi ve geniş müşteri portföyümüzle, Minecraft sunucunuzun performansını maksimum seviyeye çıkarmak için profesyonel optimizasyon hizmeti sunuyoruz.**\
\
🌐 **Web Sitemiz:**\
[`🌍 heisensetups.com`](https://heisensetups.com.tr/)

💬 **Discord Sunucumuz:**\
[`💠 discord.gg/EHm9srvgVf`](https://discord.gg/EHm9srvgVf)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://trwiki.gitbook.io/heisensetups/rehber/sunucu-optimizasyon-rehberi.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.