Minecraft Sunucusu Nasıl Kurulur? Paper ile Adım Adım Kurulum

Minecraft sunucusu kurmak için bilgisayarına doğru Java sürümünü kurarsın, papermc.io (yeni sekmede açılır) üzerinden Paper jar dosyasını indirip bir klasörde çalıştırırsın, eula.txt içinde eula=true yazarsın ve 25565 TCP portunu modeminde yönlendirirsin. Arkadaşlarınla oynayacağın küçük bir sunucu 20–30 dakikada ayağa kalkar. Aşağıda her adımı komutlarıyla, hangi ayarın neden önemli olduğuyla birlikte anlatıyoruz.

Neden Paper? Vanilla sunucu jar'ı da çalışır, ama Paper aynı oyun kurallarını çok daha az işlemci harcayarak işletir, eklenti (plugin) desteği getirir ve yüzlerce performans ayarı sunar. Fark en çok mob çiftliği ve redstone saatlerinin yoğun çalıştığı akşamlarda hissedilir: kalabalık bir survival dünyasında vanilla'nın TPS'i düşmeye başladığı noktada Paper hâlâ 20'de durur. TPS (ticks per second) sunucunun saniyede kaç oyun döngüsü işlediğidir; 20 tam hızdır.

Java kurulumu: hangi sürüm gerekli?

Paper'ın istediği Java sürümü oyun sürümüne göre değişir. Minecraft 2026'dan itibaren yıl tabanlı sürüm numarasına geçti (26.1, 26.2…), ve Paper belgelerine (yeni sekmede açılır) göre bu yeni sürümler Java 25 istiyor. Eski bir 1.21.x modpack'i ya da eklenti setiyle çalışacaksan Java 21 yeterli.

Windows: Adoptium (yeni sekmede açılır) sitesinden Temurin JRE 25 MSI paketini indirip kurarken "Set JAVA_HOME" ve "Add to PATH" seçeneklerini işaretle. Komut satırını seviyorsan tek satır yeter:

winget install -e --id EclipseAdoptium.Temurin.25.JRE
# 1.21.x sunucusu için:
winget install -e --id EclipseAdoptium.Temurin.21.JRE

Linux (Ubuntu 24.04 / Debian tabanlı): grafik arayüz gerekmediği için headless paketi yeterli. Ubuntu 24.04 deposunda hem 21 hem 25 bulunuyor.

sudo apt update
sudo apt install openjdk-25-jre-headless   # 26.x için
# sudo apt install openjdk-21-jre-headless # 1.21.x için
java -version

java -version çıktısında 25.0.x ya da 21.0.x görmelisin. Bilgisayarda birden fazla Java varsa ve yanlışı açılıyorsa, başlatma dosyasına java yerine tam yolu yaz (Windows'ta genelde C:\Program Files\Eclipse Adoptium\jre-25...\bin\java.exe). "Unsupported class file major version" hatası neredeyse her zaman eski Java ile yeni Paper'ı çalıştırmaya çalıştığını gösterir.

Paper'ı indir ve ilk kez çalıştır

Resmî indirme sayfası papermc.io/downloads/paper (yeni sekmede açılır). Eylül 2026 itibarıyla kararlı sürüm 26.2; sayfadaki "experimental" düğmesi deneme derlemelerini açar, onlara ana dünyanda dokunma. Başka sitelerden "hazır paket" jar indirme; içine ne konduğunu bilemezsin.

Masaüstünde ya da /opt altında boş bir klasör aç (ör. minecraft-sunucu), jar'ı içine koy ve adını kısaltmak için paper.jar yap. Sonra o klasörde terminal açıp ilk çalıştırmayı yap:

java -Xms2G -Xmx2G -jar paper.jar --nogui

Sunucu birkaç saniye içinde durur. Bu normal: Mojang'ın sunucu dosyalarını indirip cache klasörüne koydu, eula.txt dosyasını oluşturdu ve senin onayını bekliyor. eula.txt dosyasını not defteriyle açıp son satırı eula=true yap; bu, Minecraft EULA (yeni sekmede açılır) koşullarını kabul ettiğin anlamına gelir. Komutu tekrar çalıştırdığında dünya oluşturulur ve konsolda Done (...) ile başlayan satırı görürsün.

Klasörde şunlar belirir: plugins/ (eklentiler), config/ (Paper'ın paper-global.yml ve paper-world-defaults.yml dosyaları), logs/, server.properties, ops.json, whitelist.json ve dünya klasörü. 1.21.x'te dünya world, world_nether, world_the_end olarak üç ayrı klasördür; 26.1 ile Paper vanilla düzenine geçti ve boyutlar world/dimensions/minecraft/ altında toplanıyor.

server.properties: önemli ayarlar

server.properties düz metin bir dosyadır; değişiklikler sunucu yeniden başlatılınca geçerli olur. 60'tan fazla satır var ama ev sunucusu için şu dokuzu yeter:

Arkadaş sunucusunda white-list=true açmak en ucuz güvenlik önlemidir. Listeyi konsolda whitelist add OyuncuAdı ile doldurabilirsin; kalabalık bir listeyi elle yazmak yerine whitelist oluşturucu ile adlardan doğru UUID'li whitelist.json üretip klasöre bırakmak daha az hata çıkarır. MOTD satırına renk ve biçim kodu koymak istersen MOTD oluşturucu önizlemeyle birlikte hazır motd= satırını verir.

Listede adının yanında görünen 64×64 simge için klasöre server-icon.png koyman yeterli. Boyut ya da format yanlışsa sunucu simgeyi sessizce yok sayar; sunucu ikonu aracı görseli doğru ölçüye getirir.

RAM hesabı ve Aikar flag'leri

Sunucuya ayırdığın bellek -Xms (başlangıç) ve -Xmx (üst sınır) ile belirlenir. Paper ikisinin eşit olmasını önerir. Asıl kural şu: makinedeki belleğin tamamını verme. İşletim sistemi, Java'nın yığın dışı kullanımı ve Discord gibi açık uygulamalar için en az 1,5–2 GB boş bırak. 8 GB RAM'li bir bilgisayarda sunucuya en fazla 5–6 GB ayırabilirsin, üstelik oyunu aynı makinede oynuyorsan bu sayı 4 GB'a iner.

Bu tablo bir başlangıç noktası. Oyuncuların birbirinden uzakta keşif yapması, her birinin ayrı chunk alanı yüklemesi anlamına gelir; view-distance'ı 10'dan 6'ya indirmek oyuncu başına yüklenen chunk sayısını 441'den 169'a, yani yaklaşık %40'ına düşürür. Dynmap, büyük ekonomi eklentileri ya da modlu içerik bellek ihtiyacını 1–3 GB artırabilir. Paper'ın kendi önerisi Aikar flag'leriyle 6–10 GB aralığıdır; 4 GB küçük bir arkadaş grubunda sorunsuz çalıştı, ama bellek grafiği sürekli tavandaysa bir kademe yükselt.

Aikar flag'leri, Java'nın çöp toplayıcısını (G1GC) Minecraft'ın kısa ömürlü nesne yağmuruna göre ayarlayan parametrelerdir; kısa ama sık takılmaları azaltır. Aşağıdaki satır docs.papermc.io (yeni sekmede açılır) sayfasındakiyle birebir aynı, yalnızca bellek 4G'ye çekildi:

java -Xms4G -Xmx4G -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 -Dusing.aikars.flags=https://mcflags.emc.gs -Daikars.new.flags=true -jar paper.jar --nogui

start.bat ve start.sh

Her seferinde uzun komutu yazmamak için klasöre bir başlatma dosyası koy. Windows'ta not defterine yazıp start.bat olarak kaydet; sondaki pause sunucu çöktüğünde pencerenin kapanmasını engeller, hata mesajını okuyabilirsin.

@echo off
cd /d "%~dp0"
java -Xms4G -Xmx4G -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 -Dusing.aikars.flags=https://mcflags.emc.gs -Daikars.new.flags=true -jar paper.jar --nogui
pause

#!/usr/bin/env bash
cd "$(dirname "$0")"
exec java -Xms4G -Xmx4G -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 -Dusing.aikars.flags=https://mcflags.emc.gs -Daikars.new.flags=true -jar paper.jar --nogui

Linux'ta SSH bağlantısını kapattığında sunucunun da kapanmasını istemiyorsan screen -S mc ./start.sh ya da tmux içinde başlat. Konsola geri dönmek için screen -r mc yeter.

Port yönlendirme ve güvenlik duvarı

Aynı evdeki oyuncular sunucuya yerel IP ile (ör. 192.168.1.40) hemen bağlanır. Dışarıdan gelecek arkadaşların için iki kapıyı açman gerekir: modem ve işletim sisteminin güvenlik duvarı.

1. Statik yerel IP ver. Modem arayüzünde (çoğunlukla 192.168.1.1 ya da 192.168.0.1) DHCP bölümünden sunucu bilgisayarının MAC adresine sabit IP ata. Aksi halde bilgisayar yeniden başladığında IP değişir ve yönlendirme boşa düşer.
2. Port yönlendirme kuralı ekle. "NAT", "Sanal Sunucu" ya da "Port Forwarding" menüsünde dış port 25565, iç port 25565, protokol TCP, hedef IP az önceki sabit IP olacak şekilde kural oluştur.
3. Güvenlik duvarını aç. Windows ilk çalıştırmada Java için izin penceresi gösterir; kaçırdıysan aşağıdaki PowerShell komutunu yönetici olarak çalıştır. Linux'ta ufw kullanıyorsan tek satır yeter.

New-NetFirewallRule -DisplayName "Minecraft 25565 TCP" -Direction Inbound -Protocol TCP -LocalPort 25565 -Action Allow

sudo ufw allow 25565/tcp

Sonra dış IP adresini öğren (tarayıcıda "what is my ip" araması yeterli) ve arkadaşlarına dış-ip:25565 olarak ver; port 25565 ise sonundaki kısmı yazmasalar da olur. Kendi evinden dış IP ile bağlanmayı deneme: birçok modem "NAT loopback" desteklemediği için bağlantı başarısız olur ve yönlendirmenin bozuk olduğunu sanırsın. Doğru test, sunucuyu dışarıdan sorgulamaktır. Sunucu durumu aracına dış IP'ni yazdığında MOTD ve oyuncu sayısı geliyorsa kapılar açıktır.

Ev bağlantısı mı, VDS mi?

Ev sunucusu ücretsizdir ve 3–5 arkadaş için çoğu zaman yeterlidir. Oyuncu sayısı arttıkça sınırı işlemci değil, genellikle upload hızı belirler: her oyuncu sunucudan sürekli chunk ve varlık verisi çeker. Türkiye'deki ev fiber paketlerinde upload çoğu zaman download'un küçük bir kesridir.

Pratik kural şu: 10 kişiyi geçmeyen, gece kapanması sorun olmayan arkadaş sunucusunu evde çalıştır. Halka açık bir sunucu planlıyorsan ev IP'ni yabancılara verme; ilk anlaşmazlıkta modemin saldırı altında kalabilir. Sunucu kalıcı hale geldiğinde sunucu ekle sayfasından listemize başvurabilirsin; sıralama yalnızca ölçülen çevrim içi süre ve ping verisine dayanır.

Geyser ile Bedrock oyuncularını al

Telefon, konsol ya da Windows Bedrock sürümündeki arkadaşların Java sunucusuna doğrudan bağlanamaz; iki sürüm farklı ağ protokolü kullanır (Java ve Bedrock farkları rehberinde ayrıntılı anlattık). Köprü olarak GeyserMC (yeni sekmede açılır) sitesinden Geyser'in Spigot/Paper sürümünü ve Floodgate eklentisini indirip plugins/ klasörüne koy. Geyser Bedrock bağlantılarını varsayılan olarak UDP 19132 portunda dinler; bu yüzden modemde bu port için ikinci bir yönlendirme (UDP) ve Windows'ta -Protocol UDP -LocalPort 19132 ile ikinci bir güvenlik duvarı kuralı ekle. Floodgate sayesinde Bedrock oyuncuları Java hesabı olmadan girer ve adlarının başında varsayılan olarak nokta (.) bulunur; whitelist'e eklerken bu öneki yaz.

Yedekleme

Bir dünyayı kaybetmenin en yaygın yolu disk arızası değil, sürüm yükseltmesidir. 26.1'e geçen dünya daha eski sürümle açılamaz; Paper'ın 26.1 duyurusu da yükseltmeden önce yedeği zorunlu sayıyor. Yedeklenecek şey dünya klasörleridir: 1.21.x'te world, world_nether, world_the_end; 26.x'te tüm boyutlar world içindedir. plugins/ klasörünü de yedeğe kat, çünkü eklenti verileri (ev noktaları, ekonomi bakiyeleri) oradadır.

En güvenli kopya, sunucu kapalıyken alınandır. Sunucuyu kapatmadan yedek almak istiyorsan konsolda önce save-off yaz (otomatik kayıt durur), ardından save-all flush ile her şeyi diske yazdır, kopyayı al ve save-on ile kaydı geri aç. Otomatik kayıt açıkken çalışan dünyayı kopyalamak yarım yazılmış bölge dosyası (.mca) üretebilir; bozuk chunk'ı çoğu zaman aylar sonra fark edersin.

#!/usr/bin/env bash
cd /opt/minecraft-sunucu
mkdir -p backups
tar -czf "backups/dunya-$(date +%F).tar.gz" world plugins
find backups -name 'dunya-*.tar.gz' -mtime +14 -delete

Basit bir düzen: sunucuyu her gece 05:00'te yeniden başlatan bir görev kur ve yedek betiği kapanışla açılış arasında çalışsın. Linux'ta bunu crontab -e ile, Windows'ta Görev Zamanlayıcı (Task Scheduler) ile yaparsın. Yukarıdaki betik 14 günden eski arşivleri siler; yedekleri aynı diskte tutmak yerine haftada bir harici diske ya da başka bir bilgisayara kopyala. Dünyanda portal ağı kuruyorsan koordinat hesabı için Nether portalı eşleştirme rehberi yedekten dönüşte kaybolan bağlantıları yeniden kurmayı da kolaylaştırır.