Minecraft sunucu kurulumu, doğru sırayla ilerlediğinizde yarım saatlik bir iştir: uygun Java sürümünü kurarsınız, sunucu yazılımının jar dosyasını boş bir klasöre koyup bir kez çalıştırırsınız, oluşan eula.txt dosyasında lisansı onaylarsınız ve 25565 portunu dışarı açarsınız. Eklentiler, dünya ayarları, yetki sistemi ve yedekleme bu dört adımın üzerine eklenir.
2026 tarafında iki şey değişti ve eski rehberlerin çoğunu geçersiz kıldı. Birincisi, Mojang sürüm numaralandırmasını değiştirdi: artık 1.21.x değil 26.1, 26.2 biçimi kullanılıyor. Güncel kararlı sürüm 16 Haziran 2026’da çıkan 26.2 “Chaos Cubed” (protokol 776) ve Java 25 istiyor. İkincisi, 26.1 ile birlikte sunucu jar’ı unobfuscated hâle geldi; bu, mod ve NMS tabanlı eklentiler için gerçek bir uyumluluk kırılması demek.
Bu sayfa işletim sisteminden bağımsız ilerler: hangi kararı neden verdiğinizi, hangi dosyanın ne işe yaradığını ve sunucunun ilk gününde neleri ayarlamanız gerektiğini anlatır. Tuş tuş ekran adımları için Windows’ta Minecraft sunucu kurulumu veya Linux ve Ubuntu üzerinde kurulum rehberine geçebilirsiniz.
Kurulum Öncesi Kontrol Listesi#
Kuruluma başlamadan önce şu beş şeyin hazır olması gerekir. Sıra önemlidir; jar dosyasını Java’sız bir makineye kopyalamak zaman kaybıdır.
- Sunucu makinesi
- 7/24 açık kalacak, en az 8 GB RAM’li, yüksek saat hızlı AMD Ryzen işlemcili ve NVMe SSD diskli bir sistem.
- Java 25 (LTS)
- 26.x sunucularının çalışması için zorunlu. Eclipse Temurin, Amazon Corretto veya Azul Zulu dağıtımlarından biri.
- Sunucu yazılımı
- Vanilla
server.jar, Paper, Purpur, Forge veya Fabric. Ne kuracağınıza kurulumdan önce karar verin. - Açık port
- Java Edition için 25565/TCP, Bedrock için 19132/UDP. Hem güvenlik duvarında hem — ev kurulumundaysanız — modemde.
- Yönetim erişimi
- Windows tarafında Uzak Masaüstü (RDP), Linux tarafında SSH. Konsola erişemeyeceğiniz bir sunucuyu yönetemezsiniz.
Donanım ve RAM Planı: Oyuncu Sayısına Göre#
Minecraft sunucusunda performansı belirleyen ana faktör çekirdek sayısı değil, tek çekirdek saat hızıdır. Oyunun ana tik döngüsü (tick loop) tek bir iş parçacığında çalışır; dünya üretimi, varlık yapay zekâsı ve redstone hesabı bu tek döngüde sıraya girer. 32 çekirdekli düşük frekanslı bir sunucu işlemcisi, 8 çekirdekli yüksek frekanslı bir Ryzen’in yanında geri kalır.
Bu yüzden donanım seçiminde sıralama nettir: önce saat hızı, sonra RAM, sonra disk gecikmesi. Ayrıntılı karşılaştırma için Minecraft sunucusu için doğru donanım seçimi sayfasına bakabilirsiniz.
| Senaryo | RAM | Java heap | İşlemci | Disk |
|---|---|---|---|---|
| 2-10 oyuncu, vanilla / hafif eklentili | 8 GB | -Xms6G -Xmx6G | Ryzen 9 3900X ve üzeri | 50 GB NVMe |
| 10-30 oyuncu, eklentili Paper | 10-12 GB | -Xms10G -Xmx10G | Ryzen 9 7900X | 50-100 GB NVMe |
| 30-60 oyuncu, minigame / çok dünyalı | 16 GB | -Xms14G -Xmx14G | Ryzen 9 7900X / 7950X | 100 GB NVMe |
| Forge / Fabric modpack | 16 GB (büyük modpackte 24-32 GB) | -Xms14G -Xmx14G | Ryzen 9 7950X | 100 GB+ NVMe |
| 60+ oyuncu veya proxy’li sunucu ağı | 32 GB ve üzeri | -Xms28G -Xmx28G | Ryzen 9 7950X | 200 GB+ NVMe |
Tablodaki heap değerlerine dikkat edin: işletim sistemine, Java’nın kendi metaspace alanına ve chunk önbelleğine daima pay bırakılır. 8 GB RAM’li bir makinede -Xmx8G vermek sunucuyu takas alanına (swap) iter ve tik süresini uçurur. -Xms ile -Xmx her zaman eşit verilir; böylece JVM heap’i büyütüp küçültmekle uğraşmaz. RAM ve JVM bayrakları konusunun tamamı Minecraft sunucu RAM ayarları ve JVM flag’leri sayfasında.
Hangi Java Sürümünü Kurmalısınız?#
Java sürümü, kuracağınız Minecraft sürümüne bağlıdır ve yanlış seçim sunucunun hiç açılmamasına yol açar. Konsolda java.lang.UnsupportedClassVersionError görüyorsanız neredeyse kesin olarak Java sürümünüz düşüktür.
| Minecraft sürümü | Gerekli Java | Durum |
|---|---|---|
| 26.2 “Chaos Cubed” (protokol 776) | Java 25 | Güncel kararlı |
| 26.1 / 26.1.1 / 26.1.2 (protokol 775) | Java 25 | Destekleniyor |
| 1.20.5 – 1.21.11 | Java 21 | Eski hat |
| 1.17 – 1.20.4 | Java 17 | Eski hat |
| 1.16.5 ve öncesi (1.12.2, 1.8.9 dâhil) | Java 8 | Arşiv |
Java 26 yayınlandı, ancak LTS değil. Sunucu tarafında uzun ömürlü ve yamalı kalacak sürüm Java 25 LTS’tir; kurulumunuzu onun üzerine yapın. Kurulu sürümü doğrulamak her iki işletim sisteminde de aynı komutla yapılır:
java -version
# beklenen çıktı örneği:
# openjdk version "25.0.4" 2026-07-15 LTS
Aynı makinede birden fazla Java sürümü bulunabilir; bu durumda hangi sürümün çağrıldığına dikkat edin. Sürüm eşleşmelerinin tamamı ve dağıtım karşılaştırması için Minecraft sunucusu için hangi Java sürümü gerekir sayfasına bakın.
Sunucu Yazılımı Seçimi#
“Minecraft sunucusu kurmak” denince aslında beş farklı yazılımdan birini kurmaktan söz ediyoruz. Seçim, sunucunuzda eklenti mi yoksa mod mu kullanacağınıza göre yapılır. Eklenti (plugin) sadece sunucuda çalışır, oyuncular hiçbir şey yüklemez; mod ise hem sunucuda hem de her oyuncunun istemcisinde kurulu olmak zorundadır.
| Yazılım | Eklenti | Mod | Performans | Kime uygun |
|---|---|---|---|---|
| Vanilla (resmî server.jar) | Yok | Yok | Düşük | Saf oyun deneyimi, küçük arkadaş grubu |
| Paper 26.2 | Var | Yok | Yüksek | Survival, skyblock, genel amaçlı sunucular |
| Purpur 26.2 | Var | Yok | Yüksek + ek ayar | İnce ayar isteyen büyük sunucular |
| Forge 65.1.0 (MC 26.2) | Yok | Var | Modpacke bağlı | Klasik modpackler, teknik modlar |
| Fabric (Loader 0.19.3) | Yok | Var | Hafif | Performans modları, güncel sürüm modpackleri |
Pratikte çoğu Türk sunucusu için doğru cevap Paper’dır: vanilla ile aynı oyunu sunar, Bukkit/Spigot eklentilerini çalıştırır ve chunk yükleme, varlık işleme, redstone gibi ağır alanlarda ciddi optimizasyon içerir. Purpur, Paper’ın üstüne kurulu bir fork olduğu için Paper eklentilerinin tamamını çalıştırır ve yüzlerce ek yapılandırma seçeneği sunar. Aralarındaki farkın ayrıntısı sunucu yazılımları karşılaştırması sayfasında.
Sunucu Dosyalarını İndirme#
Jar dosyalarını daima resmî kaynaktan indirin. Üçüncü taraf “hazır sunucu paketi” sitelerinden indirilen jar’lar sıklıkla değiştirilmiş kod veya arka kapı içerir; sunucunuzu ilk günden ele geçirilmeye açık hâle getirirsiniz.
-
Eclipse Temurin JDK 25Önerilen / LTSİndir
-
Paper 26.2 sunucu jarÖnerilenİndir
-
Resmî Minecraft (vanilla) server.jarİndir
-
Purpur 26.2İndir
-
Minecraft Forge (MC 26.2 installer)İndir
-
Fabric Server Launcherİndir
Bağlantılar resmî kaynaklara gider. Üçüncü taraf sitelerden jar indirmeyin. Diğer bütün araçların adresleri Minecraft sunucu indirme merkezi sayfasında toplandı.
Adım Adım Minecraft Sunucu Kurulumu#
Aşağıdaki altı adım, hangi işletim sistemini kullanırsanız kullanın aynıdır. Sadece komutların yazımı ve klasör yolları değişir.
-
Sunucu için ayrı bir klasör açın#
Sunucu, çalıştırıldığı klasörün içine onlarca dosya ve klasör üretir. Masaüstüne veya İndirilenler klasörüne jar atmayın; temiz bir dizin kullanın. Windows’ta
C:\minecraft\server, Linux’ta/opt/minecraftyaygın tercihlerdir. Birden fazla sunucu çalıştıracaksanız her biri kendi klasöründe olmalı. -
Java 25’i kurun ve doğrulayın#
Temurin JDK 25’i kurduktan sonra terminali kapatıp yeniden açın, ardından sürümü doğrulayın. Sürüm 25 görünmüyorsa PATH ayarı yapılmamıştır. İşletim sistemine özel kurulum adımları için Windows tarafında JAVA_HOME ayarını, Linux tarafında paket yöneticisi kurulumunu anlatan ayrı sayfalarımız var.
java -version -
Jar dosyasını klasöre koyun ve adını sadeleştirin#
İndirdiğiniz dosyanın adı
paper-26.2-112.jargibi build numarası içerir. Başlatma betiğinizi her güncellemede düzenlemek zorunda kalmamak için dosyayıserver.jarolarak yeniden adlandırın. Böylece yeni build indirdiğinizde sadece dosyayı değiştirir, betiğe dokunmazsınız. -
Sunucuyu ilk kez çalıştırın#
İlk çalıştırma bilerek başarısız olur: sunucu yapılandırma dosyalarını üretir,
eula.txtiçine onay satırını yazar ve kapanır. Bu normaldir.java -Xms6G -Xmx6G -jar server.jar noguiWindows’ta aynı komutu bir
start.batdosyasına, Linux’ta birstart.shdosyasına yazmak işinizi kolaylaştırır. -
eula.txt dosyasını onaylayın#
Klasörde oluşan
eula.txtdosyasını açın,eula=falsesatırınıeula=trueyapıp kaydedin. Bu satır Mojang’ın son kullanıcı lisans sözleşmesini kabul ettiğiniz anlamına gelir; onaylamadan sunucu açılmaz.#By changing the setting below to TRUE you are indicating your agreement to our EULA. eula=true -
Sunucuyu yeniden başlatın ve dünyanın oluşmasını bekleyin#
İkinci çalıştırmada sunucu dünyayı üretir. Vanilla ve Paper’da bu işlem birkaç dakika sürer, büyük modpacklerde 10 dakikayı bulabilir. Konsolda
Done (…s)! For help, type "help"satırını gördüğünüzde sunucu ayaktadır ve komut kabul eder.
Done satırı göründüyse sunucu çalışıyor demektir. Kendi makinenizden localhost yazarak hemen bağlanıp test edebilirsiniz; dışarıdan bağlantı için port ayarları gerekir.Sunucu Klasöründeki Dosyalar Ne İşe Yarar?#
İlk çalıştırmadan sonra klasörünüz kalabalıklaşır. Hangi dosyayı düzenleyebileceğinizi, hangisine dokunmamanız gerektiğini bilmek ilerideki veri kayıplarını önler.
- server.properties
- Ana yapılandırma dosyası. Port, oyuncu sınırı, zorluk, görüş mesafesi ve oyun modu buradan ayarlanır.
- eula.txt
- Mojang lisans onayı. Tek satırlık bu dosya onaylanmadan sunucu açılmaz.
- world / world_nether / world_the_end
- Dünya verisinin tamamı. Yedekleyeceğiniz asıl klasörler bunlardır; sunucu çalışırken kopyalamayın.
- ops.json
- Yönetici (OP) listesi. Konsoldan
opkomutu çalıştırdığınızda otomatik güncellenir. - whitelist.json / banned-players.json
- Beyaz liste ve yasaklı oyuncu kayıtları. Elle düzenlemek yerine konsol komutlarını kullanın.
- logs/latest.log
- Güncel oturum kaydı. Hata ararken ilk bakılacak yer burasıdır; eski kayıtlar aynı klasörde sıkıştırılmış tutulur.
- plugins/ veya mods/
- Paper ve Purpur’da eklentiler
plugins, Forge ve Fabric’te modlarmodsklasörüne konur. İkisi aynı sunucuda birlikte bulunmaz. - usercache.json
- Oyuncu adı-UUID eşleşme önbelleği. Silinebilir, sunucu yeniden oluşturur.
Paper ve Purpur ek olarak kendi yapılandırma dosyalarını üretir: config/paper-global.yml, config/paper-world-defaults.yml, spigot.yml ve bukkit.yml. Bu dosyalar performans ayarlarının kalbidir ve varsayılan değerlerle bırakıldığında bile çalışır; ince ayara kurulumun ilk gününde girmenize gerek yok.
.mca) o anda yazılıyor olabilir ve yarım kopya bozuk chunk’lara yol açar. Yedek almadan önce konsoldan save-off ve save-all komutlarını çalıştırın, kopyalama bitince save-on ile geri açın.Başlatma Betiği ve JVM Bayrakları#
Sunucuyu her seferinde elle uzun bir komut yazarak açmak sürdürülebilir değil. İşletim sistemine göre bir başlatma betiği hazırlayın. Windows tarafında bu bir .bat dosyasıdır:
@echo off
title Minecraft Sunucusu
java -Xms10G -Xmx10G -jar server.jar nogui
pause
Linux tarafında ise çalıştırma izni verilmiş bir kabuk betiği kullanılır:
#!/bin/bash
cd /opt/minecraft
java -Xms10G -Xmx10G -jar server.jar nogui
Performans için bir adım ileri gitmek isterseniz Aikar’s Flags olarak bilinen G1GC bayrak setini kullanın. Bu set, PaperMC’nin resmî dokümanında hâlâ önerilen yapılandırmadır ve 26.x sunucularında geçerliliğini korur. 10 GB heap için tipik kullanım:
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 server.jar nogui
-XX:+UseZGC’dir. -XX:+ZGenerational bayrağı Java 25’te geçersizdir ve uyarı basar, kullanmayın.server.properties: İlk Yapılandırma#
Sunucunun ana ayar dosyası server.properties’tir. Düz metin biçimindedir ve her satır bir anahtar=değer çiftidir. İlk kurulumda dokunmanız gereken satırlar şunlardır:
server-port=25565
motd=Batihost Test Sunucusu
max-players=40
online-mode=true
white-list=false
difficulty=normal
gamemode=survival
view-distance=8
simulation-distance=6
spawn-protection=16
enable-command-block=false
network-compression-threshold=256
Bu satırların birkaçı özellikle önemli. online-mode=true, oyuncuların Mojang hesabıyla doğrulanmasını sağlar; false yaparsanız korsan istemciler de girer ama kimlik doğrulaması ortadan kalkar ve hesap çalma riski doğar. view-distance değeri sunucu yükünü doğrudan etkiler: 10’dan 8’e düşürmek çoğu sunucuda tik süresini gözle görülür rahatlatır. simulation-distance ise varlıkların ve redstone’un işlendiği yarıçaptır ve view-distance’tan küçük tutulur.
Dosyada 60’tan fazla ayar bulunur; her birinin ne yaptığını server.properties ayarları tam listesi sayfasında bulabilirsiniz. Dosyayı düzenledikten sonra sunucuyu yeniden başlatmanız gerekir; çalışırken yapılan değişiklikler okunmaz.
Port Açma ve Dışarıdan Bağlantı#
Sunucu çalışıyor ama arkadaşlarınız bağlanamıyorsa sorun neredeyse her zaman ağ katmanındadır. Java Edition varsayılan olarak 25565/TCP portunu dinler; Bedrock Edition ise 19132/UDP kullanır. Bu portun üç yerde açık olması gerekir:
- Sunucu güvenlik duvarı: Windows’ta Windows Defender Güvenlik Duvarı’nda gelen kural, Linux’ta UFW veya firewalld izni.
- Sağlayıcı/ağ filtresi: Kiralık sunucularda genelde açıktır, bazı sağlayıcılarda panelden izin verilir.
- Modem yönlendirmesi: Sadece ev kurulumlarında gerekir; modemin NAT/port yönlendirme bölümünden 25565 portu bilgisayarınızın yerel IP’sine yönlendirilir.
Portun gerçekten dinlenip dinlenmediğini sunucu üzerinde hızlıca kontrol edebilirsiniz:
# Linux
ss -tulpn | grep 25565
# Windows (PowerShell)
netstat -ano | findstr 25565
Çıktıda 25565 satırı yoksa sunucu portu açmamış demektir; büyük ihtimalle server-port değeri farklıdır ya da başka bir süreç portu kapmıştır. Port yönlendirme senaryolarının tamamı için Minecraft sunucu port yönlendirme ve port açma rehberine bakın.
IP:PORT biçiminde bağlanır, örneğin 185.10.20.30:25565. Port 25565 ise sadece IP yazmak yeterlidir. Kalıcı ve akılda kalıcı bir adres için alan adı bağlayıp SRV kaydı oluşturabilir, böylece port numarasını da gizleyebilirsiniz.Sunucuyu 7/24 Ayakta Tutmak#
Terminal penceresini kapattığınızda sunucunun da kapanması, kurulumdan sonra karşılaşılan ilk büyük sorundur. Çözüm işletim sistemine göre değişir:
Linux tarafı#
Kısa vadede screen veya tmux oturumu yeterlidir: SSH kopsa bile sunucu çalışmaya devam eder. Kalıcı çözüm bir systemd servisidir; makine yeniden başladığında sunucu kendiliğinden açılır ve çökmede otomatik yeniden başlar.
Windows tarafı#
RDP oturumunu kapattığınızda uygulamanın kapanmaması için sunucuyu bir Windows servisine dönüştürmek gerekir. NSSM bu iş için standart araçtır: start.bat dosyasını servis hâline getirir, otomatik başlatma ve çökme sonrası yeniden başlatma sağlar.
Her iki yolda da düzenli yedek almayı ihmal etmeyin. Dünya klasörü bozulduğunda ya da bir grief olayı yaşandığında sizi kurtaracak tek şey yedektir. Yedekleme yöntemleri, otomasyon betikleri ve saklama planı için Minecraft sunucu yedekleme rehberi sayfasına bakın.
Kurulumdan Sonra İlk Gün Yapılacaklar#
Sunucu ayağa kalktıktan sonra sırayla şunları halledin. Bu beş madde, ilerideki sorunların çoğunu baştan engeller.
- Kendinize OP verin. Sunucu konsolundan
op KullaniciAdinizyazın. Oyun içinden yönetim komutları çalıştırabilmenizin tek yolu budur. - Beyaz liste açın. Sunucu tanıtımını yapana kadar
whitelist onile kapalı tutun; ilk günlerde rastgele bağlantıları ve grief riskini sıfırlar. - Yedek zamanlaması kurun. Günde en az bir kez dünya klasörünü arşivleyin ve arşivi sunucunun dışında bir yerde saklayın.
- Konsol loglarını okumayı alışkanlık edinin.
logs/latest.logdosyası, sunucunuzun sağlık raporudur. Uyarılar sorun büyümeden görünür. - Eklentileri tek tek ekleyin. Aynı anda on eklenti atıp sunucu açmayın; bir çakışma olduğunda hangisinin sorumlu olduğunu bulamazsınız.
Sık Karşılaşılan Kurulum Hataları#
Kurulum sırasında karşınıza çıkacak hataların büyük bölümü aynı beş başlıkta toplanır. Aşağıdaki tablo, konsolda gördüğünüz satırı hızlıca nedene çevirir.
| Konsol mesajı | Sebep | Çözüm |
|---|---|---|
| You need to agree to the EULA | eula.txt onaylanmamış | eula=true yapıp kaydedin |
| UnsupportedClassVersionError | Java sürümü düşük | Java 25 kurun, PATH’i doğrulayın |
| Failed to bind to port | 25565 başka süreçte veya IP yanlış | Eski süreci kapatın ya da portu değiştirin |
| Unable to access jarfile server.jar | Dosya adı veya çalışma dizini yanlış | Betiği jar ile aynı klasörde çalıştırın |
| java.lang.OutOfMemoryError | Heap yetersiz | Xmx değerini yükseltin, RAM paketini büyütün |
EULA sorununun ayrıntısı EULA hatası çözümü sayfasında; diğer bütün hata mesajlarının kategorize edilmiş listesi ise Minecraft sunucu hataları ve çözümleri sayfasında yer alıyor.
Kendi Bilgisayarınız mı, Kiralık Sunucu mu?#
Test amaçlı bir sunucuyu kendi bilgisayarınızda çalıştırmak mantıklıdır. Sürekli açık kalacak, arkadaş grubunun dışına çıkacak bir sunucu için ise ev kurulumu üç noktada tıkanır: ev bağlantılarının upload hızı düşüktür ve 10-15 oyuncudan sonra ping fırlar; IP adresiniz dinamik olduğu için sunucu adresi zaman zaman değişir; ve ev IP’niz doğrudan internete açıldığında DDoS saldırısı tüm haneyi etkiler.
Kiralık tarafta iki seçenek var. Hazır Minecraft sunucu paketleri panel üzerinden yönetilir, Java ve jar kurulumu sizin işiniz olmaktan çıkar; 156 TL’den başlayan paketlerle hızlıca başlanır. Sistem yönetimine hâkimseniz ve tam kontrol istiyorsanız bir VDS kiralayıp bu rehberdeki adımları sıfırdan uygulayabilir, aynı makinede birden fazla sunucu ve panel çalıştırabilirsiniz.
Hangi yolu seçerseniz seçin, donanım kriterleri değişmez: 8 GB’dan başlayan RAM, yüksek saat hızlı AMD Ryzen 9 işlemci, NVMe SSD disk ve Türkiye lokasyonu. Türkiye’deki oyunculara hizmet veriyorsanız yurt dışı lokasyon, tek başına 40-60 ms fazladan gecikme demektir; bu fark PvP sunucularında doğrudan oyun deneyimine yansır.
Özetle#
Minecraft sunucu kurulumu, sırası bilindiğinde karmaşık değil: Java 25 kurun, resmî kaynaktan Paper 26.2 jar’ını indirin, temiz bir klasörde bir kez çalıştırıp eula.txt dosyasını onaylayın, server.properties içinde port ve oyuncu ayarlarını yapın, 25565/TCP portunu açın ve sunucuyu servis/screen ile kalıcı hâle getirin.
Kurulumun kalıcı başarısı iki karara bağlı: doğru sürüm eşleşmesi (26.x için Java 25, eski sürümler için tabloya bakın) ve gerçekçi donanım. 8 GB’ın altına inmeyen RAM, yüksek frekanslı Ryzen işlemci ve NVMe disk, ilerideki TPS sorunlarının çoğunu daha oluşmadan ortadan kaldırır. Sonraki adım olarak eklenti kurulumuna ve performans ayarlarına geçebilirsiniz.