Minecraft Sunucusu Nasıl Kurulur? Linux'ta Paper Rehberi

Minecraft sunucusu nasıl kurulur sorusunun kısa cevabı şu: Linux bir VDS’ye Java 25 kurarsınız, Paper’ın güncel jar dosyasını indirirsiniz, EULA’yı kabul edip sunucuyu başlatırsınız ve 25565 numaralı TCP portunu açarsınız. Sunucunun 7/24 açık kalması için de bir systemd servisi tanımlamanız yeterlidir. Adımları sırayla izlerseniz Linux’a yeni başlayan biri bile kurulumu tek oturumda bitirebilir.

Bu yazıda Ubuntu veya Debian çalışan bir sunucuda Paper ile sıfırdan kurulumu adım adım anlatıyoruz: Java sürümünün seçimi, Paper’ın komut satırından indirilmesi, eula.txt ve server.properties ayarları, port açma, ilk bağlantı, systemd ile otomatik başlatma ve dünya yedeği. Kurulumu kendi sunucunuzda denemek istiyorsanız Minecraft server kiralama paketlerimiz root erişimiyle gelir; anlatılan her adımı doğrudan uygulayabilirsiniz.

Başlamadan önce: neye ihtiyacınız var?

Linux sunucu: Ubuntu’nun güncel LTS sürümlerinden biri veya Debian. Komutlar ikisinde de aynı çalışır.
Root ya da sudo yetkisi: Sunucuya SSH ile bağlanmayı bilmiyorsanız önce programsız Linux sunucuya bağlanma yazımıza göz atın.
Yeterli RAM: Oyuncu ve eklenti sayısına göre değişir. Hangi senaryoda kaç GB gerektiğini Minecraft sunucu gereksinimleri yazısında ayrıntılı anlattık. Bu rehberdeki örnekler 6 GB RAM’li bir sunucuya, yani Minecraft’a 4 GB ayrılmış bir düzene göre hazırlandı.
Minecraft Java Edition: Sunucuyla aynı sürümde bir istemci. Kasım 2026 itibarıyla Paper’ın desteklenen güncel sürümü 26.3’tür.

Komut satırıyla uğraşmak istemiyorsanız: BirSunucum müşteri panelinde sunucunuzu seçip “Uygulama Kur” bölümünden Pterodactyl oyun panelini tek tıkla kurabilirsiniz. Pterodactyl, sunucuyu başlatma, konsol, dosya yönetimi ve yedek gibi işleri web arayüzünden yapmanızı sağlar. Sunucunun arka planda nasıl çalıştığını öğrenmek ya da tam kontrolü elinizde tutmak istiyorsanız aşağıdaki manuel kurulumla devam edin.

Minecraft sunucusu nasıl kurulur: adım adım Paper kurulumu

Paper, Mojang’ın resmi sunucu yazılımının üzerine kurulu, performans iyileştirmeleri içeren ve Bukkit/Spigot eklentilerini çalıştırabilen bir sunucu yazılımıdır. Vanilla oyun deneyimini bozmadan daha az kaynakla daha fazla oyuncu taşıdığı için yeni kurulumlarda ilk tercih olarak öneriyoruz.

1. Sunucuya bağlanın ve sistemi güncelleyin

SSH ile root kullanıcısı olarak bağlanın. SUNUCU_IP yerine VDS’nizin IP adresini yazın.

ssh root@SUNUCU_IP

Paket listesini ve kurulu paketleri güncelleyin, ardından kurulumda kullanacağımız yardımcı araçları yükleyin. Root olarak bağlandıysanız komutların başındaki sudo zorunlu değildir, ama zarar da vermez.

sudo apt-get update && sudo apt-get upgrade -y
sudo apt-get install -y ca-certificates apt-transport-https gnupg wget curl jq screen ufw

2. Java 25’i kurun

Mojang’ın yeni yıl tabanlı sürüm numaralandırmasıyla gelen 26.x sürümleri en az Java 25 ister. Eski bir dünyayı eski sürümde çalıştıracaksanız gereken Java sürümü farklıdır:

Minecraft / Paper sürümü	Gereken en düşük Java sürümü
26.1 ve sonrası (26.3 dahil)	Java 25
1.20.5 – 1.21.11	Java 21
1.18 – 1.20.4	Java 17

PaperMC’nin resmi Java kurulum rehberi Amazon Corretto dağıtımını önerir. Önce Corretto deposunun imza anahtarını ve depo tanımını ekleyin:

wget -O - https://apt.corretto.aws/corretto.key | sudo gpg --dearmor -o /usr/share/keyrings/corretto-keyring.gpg && \
echo "deb [signed-by=/usr/share/keyrings/corretto-keyring.gpg] https://apt.corretto.aws stable main" | sudo tee /etc/apt/sources.list.d/corretto.list

Ardından Java 25’i kurun. PaperMC, -headless paketlerinde Paper’ın ihtiyaç duyduğu bazı bağımlılıklar eksik olduğu için tam JDK paketini kurmanızı tavsiye ediyor.

sudo apt-get update
sudo apt-get install -y java-25-amazon-corretto-jdk libxi6 libxtst6 libxrender1

Kurulumu doğrulayın. Çıktının ilk satırı openjdk 25 ile başlamalıdır.

java -version

3. Minecraft portunu açın

Java Edition sunucusu varsayılan olarak 25565/TCP portunu dinler. UFW’yi ilk kez etkinleştiriyorsanız SSH iznini mutlaka 25565’ten önce ekleyin; aksi halde ufw enable komutuyla birlikte kendi bağlantınızı kesersiniz.

sudo ufw allow OpenSSH
sudo ufw allow 25565/tcp
sudo ufw enable

Belirli IP’lere izin verme, kural silme ve port testi gibi ayrıntılar için Ubuntu UFW ile port açma rehberimize bakabilirsiniz.

4. Ayrı bir kullanıcı oluşturun ve Paper’ı indirin

Sunucuyu root ile çalıştırmak, bir eklentideki güvenlik açığının bütün sisteme erişim kazanabilmesi anlamına gelir. Bu yüzden Minecraft için yetkisiz bir kullanıcı açıp o kullanıcıya geçin:

sudo useradd -m -s /bin/bash minecraft
sudo -iu minecraft

Sunucu dosyaları için bir klasör oluşturup içine girin:

mkdir -p ~/sunucu && cd ~/sunucu

Paper’ı en kolay yoldan, PaperMC indirme sayfasından en son derlemenin bağlantısını kopyalayarak indirebilirsiniz:

wget -O paper.jar "KOPYALADIGINIZ_BAGLANTI"

Tarayıcıya hiç geçmeden indirmek isterseniz PaperMC’nin indirme servisini (Fill API) kullanabilirsiniz. Aşağıdaki komut 26.3 sürümünün en son kararlı (STABLE) derlemesini bulup paper.jar adıyla kaydeder. PaperMC bu servise yapılan isteklerde projenizi ve iletişim adresinizi belirten bir User-Agent başlığı zorunlu tutuyor; E_POSTA_ADRESINIZ kısmını kendi adresinizle değiştirin.

PAPER_URL=$(curl -s -H "User-Agent: minecraft-kurulum/1.0 (E_POSTA_ADRESINIZ)" https://fill.papermc.io/v3/projects/paper/versions/26.3/builds | jq -r 'first(.[] | select(.channel == "STABLE") | .downloads."server:default".url)')
curl -o paper.jar "$PAPER_URL"

İleride yeni bir sürüm çıktığında komuttaki 26.3 değerini değiştirmeniz yeterli.

5. İlk çalıştırma ve EULA onayı

Sunucuyu ilk kez başlatın. -Xms başlangıç, -Xmx en yüksek bellek miktarıdır; ikisini aynı değerde tutmak PaperMC’nin de önerdiği yaygın bir uygulamadır. --nogui ise sunucu penceresini kapatıp yalnızca konsolu bırakır.

java -Xms4G -Xmx4G -jar paper.jar --nogui

İlk çalıştırmada sunucu gerekli dosyaları oluşturur ve Minecraft son kullanıcı lisans sözleşmesini (EULA) kabul etmediğiniz için kendiliğinden kapanır. Sözleşmeyi okuyup kabul ediyorsanız eula.txt dosyasındaki değeri true yapın:

sed -i 's/eula=false/eula=true/' eula.txt

Belleği sunucunun toplam RAM’inin tamamına ayarlamayın. İşletim sistemine ve Java’nın heap dışında kullandığı belleğe 1–2 GB pay bırakın. Fazla RAM vermek de çöp toplama (garbage collection) duraklamalarını uzatarak takılmalara yol açabilir.

6. server.properties ayarlarını yapın

Temel ayarların hepsi server.properties dosyasındadır. Dosyayı nano ile açın:

nano server.properties

En sık değiştirilen satırlar ve 26.3 sürümündeki varsayılan değerleri:

Ayar	Varsayılan	Ne işe yarar?
`server-port`	25565	Sunucunun dinlediği TCP portu.
`motd`	A Minecraft Server	Sunucu listesinde adın altında görünen açıklama.
`max-players`	20	Aynı anda bağlanabilecek en fazla oyuncu.
`white-list`	true	Yalnızca beyaz listedeki oyuncular girebilir.
`online-mode`	true	Oyuncuların Mojang/Microsoft hesabını doğrular.
`difficulty`	easy	peaceful, easy, normal veya hard.
`gamemode`	survival	Yeni oyuncuların oyun modu.
`view-distance`	10	Oyunculara gönderilen dünya mesafesi (chunk).
`simulation-distance`	10	Varlıkların ve mekanizmaların işlendiği mesafe (chunk).

İki önemli değişikliğe dikkat edin. Birincisi, Minecraft 26.3 ile white-list ayarı varsayılan olarak açık geliyor; bu, Mojang’ın 26.3 sürüm notlarında yer alan bir değişiklik. Eski rehberlerde bu bilgi yer almadığı için kurulumu bitirip kendi sunucunuza giremezseniz ilk bakmanız gereken yer burasıdır. İkincisi, PvP artık server.properties içinde değil; oyun içinden /gamerule pvp ile yönetiliyor.

Herkese açık bir sunucu kuruyorsanız white-list=false yapabilirsiniz. Sadece arkadaşlarınızla oynayacaksanız açık bırakmanız daha güvenlidir. Değişiklikleri kaydedip (Ctrl+O, Enter) nano’dan çıkın (Ctrl+X).

7. Sunucuyu başlatın ve ilk bağlantıyı yapın

SSH bağlantısı kapandığında sunucunun da kapanmaması için onu bir screen oturumunda başlatın:

screen -S minecraft

java -Xms4G -Xmx4G -jar paper.jar --nogui

Konsolda Done ile başlayan satırı gördüğünüzde sunucu hazırdır. Kendinize yönetici (op) yetkisi verin; op’lar beyaz listeye otomatik olarak dahil olur. Arkadaşlarınızı da beyaz listeye ekleyin:

op OYUNCU_ADI
whitelist add ARKADAS_ADI

Şimdi Minecraft’ı açın ve şu adımları izleyin:

Ana menüden Çok Oyunculu bölümüne girin.
Sunucu Ekle düğmesine tıklayın.
Sunucu Adresi alanına SUNUCU_IP yazın. Portu değiştirdiyseniz SUNUCU_IP:PORT biçimini kullanın.
Kaydedip listeden sunucuya bağlanın.

IP yerine akılda kalıcı bir adres kullanmak isterseniz alan adınızda mc.ALANADI.com gibi bir alt alan adı için sunucu IP’sini gösteren bir A kaydı oluşturmanız yeterlidir. Screen oturumundan sunucuyu kapatmadan çıkmak için Ctrl+A, ardından D tuşuna basın; geri dönmek için screen -r minecraft yazın.

Sunucuyu 7/24 açık tutmak: systemd servisi

Screen hızlı bir çözümdür, ancak sunucu çöktüğünde ya da VDS yeniden başladığında Minecraft kendiliğinden açılmaz. Kalıcı bir kurulum için systemd servisi tanımlayın. Önce screen oturumuna dönüp konsola stop yazarak sunucuyu kapatın, sonra exit ile minecraft kullanıcısından root’a geri dönün. Aynı sunucunun iki kopyasını aynı anda çalıştırmayın.

Servis dosyasını oluşturun:

sudo nano /etc/systemd/system/minecraft.service

Aşağıdaki içeriği yapıştırın. Restart=on-failure sunucu çökerse 10 saniye sonra yeniden başlatır. Paper, systemd’nin durdurma sinyalini alınca dünyaları kaydedip kapanır; bu sırada Java’nın döndürdüğü 143 çıkış kodunu SuccessExitStatus ile normal kapanış olarak tanımlıyoruz.

[Unit]
Description=Minecraft Paper Sunucusu
After=network-online.target
Wants=network-online.target

[Service]
User=minecraft
WorkingDirectory=/home/minecraft/sunucu
ExecStart=/usr/bin/java -Xms4G -Xmx4G -jar paper.jar --nogui
Restart=on-failure
RestartSec=10
SuccessExitStatus=0 143

[Install]
WantedBy=multi-user.target

Servisi etkinleştirip başlatın. enable --now hem sunucuyu hemen açar hem de VDS her yeniden başladığında otomatik açılmasını sağlar.

sudo systemctl daemon-reload
sudo systemctl enable --now minecraft

Durumu ve canlı logları şu komutlarla izleyebilirsiniz:

sudo systemctl status minecraft
sudo journalctl -u minecraft -f

Systemd ile çalışan sunucunun konsoluna doğrudan yazamazsınız. Yönetim komutlarını oyun içinden op yetkili hesabınızla verin; yeniden başlatmak için sudo systemctl restart minecraft, durdurmak için sudo systemctl stop minecraft kullanın.

Dünyanızı yedekleyin

Paper 26.1 ile birlikte dünya klasör yapısı değişti: Nether ve End artık ayrı world_nether ve world_the_end klasörlerinde değil, world/dimensions/ altında duruyor. En sorunsuz yöntem, sunucu kapalıyken bütün sunucu klasörünü arşivlemektir; böylece dünya, eklentiler, ops.json ve whitelist.json birlikte yedeklenir.

Yedek klasörünü bir kez oluşturun:

sudo mkdir -p /home/minecraft/yedekler

Elle yedek almak için sunucuyu durdurun, arşivleyin ve yeniden başlatın:

sudo systemctl stop minecraft
sudo tar -czf /home/minecraft/yedekler/sunucu-$(date +%F-%H%M).tar.gz -C /home/minecraft sunucu
sudo systemctl start minecraft

Bunu her gün otomatik yapmak için sudo crontab -e ile root’un cron tablosuna aşağıdaki satırı ekleyin. Satır her gece 05.00’te sunucuyu kısa süreliğine kapatıp yedek alır; cron içinde % karakteri özel anlam taşıdığı için ters bölü ile yazılır.

0 5 * * * systemctl stop minecraft; tar -czf /home/minecraft/yedekler/sunucu-$(date +\%F).tar.gz -C /home/minecraft sunucu; systemctl start minecraft

Yedekleri yalnızca aynı sunucuda tutmak, disk arızası ya da yanlışlıkla silme gibi durumlarda yeterli olmaz; arşivleri düzenli olarak başka bir konuma da kopyalayın ve eski arşivleri silerek diski doldurmayın. Sürüm yükseltmesi gibi büyük değişikliklerden önce VDS’nizin snapshot’ını almanızı da öneririz.

Sık karşılaşılan sorunlar

UnsupportedClassVersionError (class file version 69.0)

Neden: Sunucu, Paper’ın istediğinden eski bir Java sürümüyle başlatılıyor. 69.0 sınıf sürümü Java 25’e karşılık gelir.

Çözüm: Java 25’i kurun ve java -version ile doğrulayın. Sunucuda birden fazla Java varsa sudo update-alternatives --config java ile varsayılanı Java 25 yapın.

You are not white-listed on this server!

Neden: 26.3 ile beyaz liste varsayılan olarak açık geliyor ve bağlanan hesap listede değil. Türkçe istemcide mesaj Türkçe görünür ama anlamı aynıdır.

Çözüm: Konsoldan whitelist add OYUNCU_ADI komutunu çalıştırın ya da herkese açık bir sunucu istiyorsanız server.properties içinde white-list=false yapıp sunucuyu yeniden başlatın.

Connection timed out

Neden: İstemci sunucuya ulaşamıyor. Genellikle port kapalıdır, sunucu çalışmıyordur ya da yanlış IP/port yazılmıştır.

Çözüm: sudo ufw status ile 25565/tcp kuralını, sudo ss -tlnp | grep 25565 ile sunucunun portu gerçekten dinleyip dinlemediğini kontrol edin. Port listede yoksa sunucu açılmamıştır; journalctl loglarına bakın.

**** FAILED TO BIND TO PORT!

Neden: 25565 portunu başka bir süreç kullanıyor. En sık sebep, screen’de açık unutulmuş bir sunucu varken systemd servisinin de başlatılmasıdır.

Çözüm: sudo ss -tlnp | grep 25565 ile portu kullanan süreci bulun, fazladan çalışan kopyayı stop komutuyla kapatın ve sunucuyu tek bir yöntemle çalıştırın. Logdaki hata Address already in use yerine Cannot assign requested address diyorsa sorun port çakışması değildir; server.properties içindeki server-ip satırını boş bırakın.

Sunucu aniden kapanıyor veya OutOfMemoryError veriyor

Neden: -Xmx değeri sunucunun fiziksel belleğine göre çok yüksek ya da çok düşük. Çok yüksekse Linux çekirdeği belleği korumak için Java sürecini sonlandırır.

Çözüm: free -h ile toplam belleğe bakın ve sudo dmesg | grep -i "out of memory" ile çekirdeğin süreci sonlandırıp sonlandırmadığını kontrol edin. -Xmx değerini toplam RAM’den 1–2 GB az olacak şekilde ayarlayın; bellek gerçekten yetmiyorsa paket yükseltmeyi düşünün.

Sık sorulan sorular

Paper yerine Mojang’ın resmi sunucusunu kurabilir miyim?

Evet. Adımlar neredeyse aynıdır; yalnızca indirdiğiniz jar dosyası değişir. Ancak resmi sunucu eklenti desteklemez ve Paper’ın performans iyileştirmelerini içermez. Eklenti kullanmayı düşünüyorsanız baştan Paper ile başlamak sonradan taşıma zahmetinden kurtarır.

Minecraft sunucusu için kaç GB RAM gerekir?

Eklentisiz, birkaç oyunculu bir Paper sunucusu için 2–4 GB çoğu zaman yeterlidir; eklenti ve oyuncu sayısı arttıkça ihtiyaç büyür. Senaryolara göre önerileri yukarıda bağlantısını verdiğimiz Minecraft sunucu gereksinimleri yazısında tablo halinde bulabilirsiniz. Minecraft tek çekirdek hızına da çok duyarlıdır; bunun nedenini Ryzen VDS nedir yazımızda açıkladık.

online-mode=false yapmalı mıyım?

Doğrudan internete açık bir sunucuda önerilmez. Bu ayar hesap doğrulamasını kapatır; herkes istediği kullanıcı adıyla, op yetkili bir hesabın adıyla bile giriş yapabilir. Bu ayar yalnızca kimlik doğrulamayı üstlenen bir proxy (ör. Velocity) arkasındaki sunucularda kullanılmalıdır.

Sunucuyu yeni bir Minecraft sürümüne nasıl güncellerim?

Sunucuyu durdurun, tam yedek alın, yeni sürümün jar dosyasını indirip paper.jar dosyasının yerine koyun ve yeniden başlatın. Yükseltilen bir dünya eski sürüme geri döndürülemez, bu yüzden yedek şarttır. Eklenti kullanıyorsanız her eklentinin yeni sürümü desteklediğinden emin olun.

Sonuç: Kurulum bitti, sırada oyuncular var

Java 25, Paper, doğru server.properties ayarları, açık bir 25565 portu ve systemd servisiyle sunucunuz artık 7/24 çalışmaya hazır. Düzenli yedek almayı ve beyaz listeyi bilinçli yönetmeyi unutmayın. Sunucunuz için ayrılmış kaynaklı bir altyapı arıyorsanız Minecraft VDS sayfamızdaki Xeon ve Ryzen seçeneklerini inceleyebilirsiniz.