Windows’ta Paper Minecraft Sunucusu Kurulumu

Windows’ta Paper Minecraft sunucusu kurulumu, Java 25 kurup Paper jar’ını bir klasöre koyduktan sonra start.bat dosyasıyla sunucuyu başatmaktan ibarettir; tüm işlem indirmeler dahil yarım saatten kısa sürer. Bu rehber Windows 10, Windows 11 ve Windows Server 2022/2025 için birebir geçerlidir.

Anlatım baştan sona Windows arayüzü üzerinden ilerler: Dosya Gezgini, Not Defteri, Komut İstemi, Görev Yöneticisi ve Windows Defender Güvenlik Duvarı. Kiralık bir Windows VDS üzerinde çalışıyorsanız önce Uzak Masaüstü (RDP) ile sunucuya bağlanın, ardından aşağıdaki adımları sunucunun masaüstünde uygulayın.

Paper’ın ne olduğunu, Spigot ve vanilla ile farklarını ve yapılandırma dosyalarının tam listesini merak ediyorsanız işletim sisteminden bağımsız Paper sunucu kurulumu ve yapılandırma rehberimiz daha kapsamlıdır. Burada odak tamamen Windows tarafındadır.

Kurulum Öncesi: Donanım ve Sürüm Kontrolü#

Paper, Spigot’a göre çok daha verimli çalışır ama sihir yapmaz. Sunucunun akıcı olması iki şeye bağlıdır: işlemcinin tek çekirdek saat hızı ve diskin gecikmesi. Minecraft’ın ana tick döngüsü tek bir çekirdekte döner, bu yüzden 32 çekirdekli yavaş bir işlemci yerine yüksek frekanslı bir AMD Ryzen tercih edin.

Dünya dosyaları sürekli okunup yazıldığı için disk tipi doğrudan TPS’i etkiler. NVMe SSD dışında bir disk üzerinde Minecraft sunucusu çalıştırmayın; chunk kaydetme sırasında oluşan gecikmeler oyunda takılma olarak görünür.

Sürüm tarafında durum şudur: 11 Ağustos 2026 itibarıyla güncel kararlı Minecraft sürümü 26.2 “Chaos Cubed” (protokol 776), Paper’ın bu sürüm için sunduğu güncel yapı build #112. 26.3 henüz yayımlanmadı, snapshot aşamasında. Yani üretim sunucunuzu 26.2 üzerine kurun.

İndirmeniz Gereken Dosyalar#

Aşağıdaki üç dosyayı indirin. Java ve Paper zorunlu, Notepad++ ise yapılandırma dosyalarını düzenlerken Not Defteri’nin satır sonu ve kodlama sorunlarından kurtardığı için kuvvetle önerilir.

Java 25 Kurulumu ve Doğrulama#

İndirdiğiniz Temurin .msi dosyasına çift tıklayın. Kurulum sihirbazının “Custom Setup” ekranında iki seçeneği açın: Add to PATH ve Set JAVA_HOME variable. Varsayılan kurulumda bu ikisi kapalı gelir ve daha sonra “java komutu tanınmıyor” hatasının en sık sebebi budur.

Kurulum bitince Başlat menüsüne cmd yazıp Komut İstemi’ni açın ve şu komutu çalıştırın:

java -version

Beklenen çıktı şuna benzer olmalıdır:

openjdk version "25.0.4"
OpenJDK Runtime Environment Temurin-25.0.4+7 (build 25.0.4+7)
OpenJDK 64-Bit Server VM Temurin-25.0.4+7 (build 25.0.4+7, mixed mode, sharing)

Sürüm numarası 25 ile başlamıyorsa ya da komut tanınmıyorsa PATH ayarı yapılmamıştır. Denetim Masası > Sistem > Gelişmiş sistem ayarları > Ortam Değişkenleri yolundan Path değişkenine Java’nın bin klasörünü elle ekleyebilirsiniz. Bu adımın ayrıntılı anlatımı ve birden fazla Java sürümünü yan yana kullanma yöntemi Windows’a Java 25 kurulumu ve JAVA_HOME ayarı sayfasında.

Klasör Yapısı ve Paper jar’ının Yerleştirilmesi#

Dosya Gezgini’ni açın ve C:\ sürücüsünün kökünde minecraft, onun içinde de server klasörünü oluşturun. Nihai yol şu olmalı:

C:\minecraft\server\

Sunucuyu Masaüstü, Belgeler veya OneDrive ile eşitlenen bir klasörde çalıştırmayın. OneDrive dünya dosyalarını sunucu çalışırken senkronize etmeye kalkar ve bozuk chunk’lara yol açar; ayrıca Türkçe karakter içeren klasör adları bazı eklentilerde yol hatası üretir.

İndirdiğiniz paper-26.2-112.jar dosyasını bu klasöre taşıyın ve adını paper.jar olarak değiştirin. Yeniden adlandırma zorunlu değil ama şiddetle önerilir: her build güncellemesinde yalnızca jar’ı değiştirirsiniz, başlatma betiğine dokunmanız gerekmez.

start.bat Dosyasını Oluşturma#

Windows’ta Minecraft sunucusu bir toplu iş (batch) dosyasıyla başlatılır. C:\minecraft\server klasöründe boş bir alana sağ tıklayın, Yeni > Metin Belgesi deyin, dosyayı start.bat olarak adlandırın ve sağ tıklayıp Düzenle ile Not Defteri’nde açın.

Başlangıç için en sade sürüm — 8 GB’lık bir pakette:

@echo off
title Paper 26.2 Sunucusu
cd /d C:\minecraft\server
java -Xms6G -Xmx6G -jar paper.jar --nogui
pause

--nogui parametresi Java’nın eski grafik konsol penceresini kapatır; sunucu doğrudan komut satırında çalışır ve birkaç yüz megabayt RAM tasarruf edersiniz. pause satırı sunucu kapandığında pencerenin açık kalmasını sağlar, hata mesajını okuyabilmeniz için önemlidir.

Aikar’s Flags ile üretim sürümü#

Sunucunuz gerçekten oyuncu alacaksa çöp toplayıcı bayraklarını ekleyin. 8-12 GB heap için doğru tercih hâlâ G1GC tabanlı Aikar’s Flags setidir; PaperMC bu dokümanı 26.x çıkışlarından sonra geri çekmedi.

@echo off
title Paper 26.2 Sunucusu
cd /d C:\minecraft\server
:start
java -Xms6G -Xmx6G -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 paper.jar --nogui
echo Sunucu kapandi, 8 saniye icinde yeniden baslatiliyor. Iptal icin Ctrl+C.
timeout /t 8
goto start

Batch dosyalarında satır sonundaki ^ karakteri “komut devam ediyor” anlamına gelir; uzun Java komutunu okunabilir tutmak için kullanılır. :start etiketi ve goto start ise sunucu beklenmedik şekilde kapandığında otomatik yeniden açılmasını sağlar.

Heap değerini pakete göre belirlerken işletim sistemine pay bırakmayı unutmayın: 8 GB pakette -Xms6G -Xmx6G, 12 GB pakette -Xms10G -Xmx10G, 16 GB pakette -Xms14G -Xmx14G, 32 GB pakette -Xms28G -Xmx28G. Betiğin tüm varyasyonlarını ve otomatik yedek alan gelişmiş sürümünü start.bat dosyası oluşturma ve RAM ayarları rehberinde bulabilirsiniz.

İlk Çalıştırma ve EULA Onayı#

1. start.bat dosyasını çalıştırın#

   start.bat dosyasına çift tıklayın. Siyah bir Komut İstemi penceresi açılır, Paper birkaç saniye çalışır ve “You need to agree to the EULA in order to run the server” mesajıyla kapanır. Bu normaldir, hata değildir.

2. eula.txt dosyasını düzenleyin#

   Klasörde yeni oluşan eula.txt dosyasını Not Defteri ile açın, son satırı değiştirin ve Ctrl+S ile kaydedin.

   eula=true

3. Betiği ikinci kez çalıştırın#

   Bu sefer Paper dünyayı üretmeye başlar. Konsolda Preparing spawn area: % satırlarını göreceksiniz. İlk açılış, spawn chunk’ları oluşturulduğu için 1-3 dakika sürebilir.

4. “Done” satırını bekleyin#

   Konsolda Done (24.512s)! For help, type "help" benzeri bir satır görürseniz sunucu ayaktadır. Artık aynı pencereye op KullaniciAdi, whitelist on gibi komutları doğrudan yazabilirsiniz.

5. Sunucuyu düzgün kapatın#

   Konsola stop yazıp Enter’a basın. Pencereyi çarpı düğmesiyle kapatmak dünyayı kaydetmeden süreci öldürür ve chunk bozulmasına yol açabilir.

server.properties ile Temel Ayarlar#

İlk başarılı açılıştan sonra klasörde server.properties dosyası oluşur. Sunucu kapalıyken Notepad++ ile açın ve en çok işinize yarayacak satırları düzenleyin:

server-port=25565
server-ip=
motd=Batihost Test Sunucusu
max-players=40
online-mode=true
view-distance=8
simulation-distance=6
enable-command-block=false
white-list=false
spawn-protection=0
network-compression-threshold=256

Birkaç kritik not: server-ip satırını boş bırakın; buraya IP yazmak sunucunun yalnızca o adresi dinlemesine ve dışarıdan bağlantı kabul etmemesine yol açar. online-mode=true orijinal hesap doğrulamasını açar; kapatırsanız AuthMe gibi bir giriş eklentisi kurmanız şarttır.

view-distance değeri performansı doğrudan etkileyen tek ayardır. 10 ve üzeri değerler oyuncu başına gönderilen chunk sayısını hızla artırır; 30 oyuncunun üzerinde 8 iyi bir dengedir. Tüm satırların açıklaması için server.properties ayarları tam listesi sayfasına bakın.

Windows Defender Güvenlik Duvarında 25565 Portunu Açma#

Sunucu makinede çalışıyor olsa bile Windows dışarıdan gelen TCP bağlantılarını varsayılan olarak engeller. Gelen kuralı en hızlı şekilde yönetici yetkisiyle açılmış PowerShell’den oluşturursunuz. Başlat menüsünde PowerShell’e sağ tıklayıp Yönetici olarak çalıştır deyin:

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

Komut İstemi’ni tercih ediyorsanız aynı işi netsh yapar:

netsh advfirewall firewall add rule name="Minecraft Java 25565 TCP" dir=in action=allow protocol=TCP localport=25565

Arayüzden yapmak isterseniz Başlat > wf.msc ile Gelişmiş Güvenlik Özellikli Windows Defender Güvenlik Duvarı’nı açın, sol taraftan Gelen Kuralları > Yeni Kural > Bağlantı Noktası > TCP > Belirli yerel bağlantı noktaları: 25565 yolunu izleyin ve kuralı Etki Alanı, Özel, Genel profillerinin üçü için de etkinleştirin.

Kuralın çalıştığını doğrulamak için sunucu açıkken başka bir makineden test edin. Ev bağlantısı kullanıyorsanız modem üzerinde de port yönlendirme yapmanız gerekir; kiralık bir VDS’te buna gerek yoktur. Kural ekleme adımlarının ekran ekran anlatımı Windows güvenlik duvarında Minecraft portu açma rehberinde.

Eklenti Kurulumu ve Paper Yapılandırma Dosyaları#

İlk açılışta oluşan plugins klasörü eklentilerin yeridir. Kurulum basittir: indirdiğiniz .jar dosyasını C:\minecraft\server\plugins içine kopyalayın ve sunucuyu yeniden başlatın. Çalışan sunucuya eklenti atıp reload komutu vermeyin; Paper bu komutu açıkça önermez ve bellek sızıntısına yol açar.

Klasör yapısı ilk başarılı açılıştan sonra şöyle görünür:

C:\minecraft\server\
├── config\
│   ├── paper-global.yml
│   └── paper-world-defaults.yml
├── logs\
│   └── latest.log
├── plugins\
├── world\
├── world_nether\
├── world_the_end\
├── bukkit.yml
├── eula.txt
├── paper.jar
├── server.properties
├── spigot.yml
└── start.bat

Paper’ın kendi ayarları config klasöründeki iki YAML dosyasındadır; spigot.yml ve bukkit.yml hâlâ okunur ve mob spawn limitleri gibi ayarlar oradadır. Bu dosyaların performansa etki eden satırlarını paper.yml, spigot.yml ve bukkit.yml optimizasyon rehberi sayfasında tek tek açıkladık.

Eklenti yükleme sırası, bağımlılıklar ve “plugin yüklenmedi” durumunda konsolda ne aranacağı gibi ayrıntılar için Minecraft sunucusuna plugin kurulumu sayfasına göz atın.

Sunucuyu 7/24 Açık Tutma: NSSM ile Windows Servisi#

Konsol penceresi açık kaldığı sürece sunucu çalışır — ama RDP oturumunuzu kapattığınızda ya da makine yeniden başladığında sunucu düşer. Kalıcı çözüm, start.bat dosyasını NSSM ile bir Windows servisine dönüştürmektir.

İndirdiğiniz NSSM arşivini C:\nssm klasörüne çıkarın, yönetici yetkisiyle Komut İstemi açın ve şunu çalıştırın:

C:\nssm\win64\nssm.exe install PaperSunucu

Açılan pencerede Path alanına C:\minecraft\server\start.bat, Startup directory alanına C:\minecraft\server yazın. Details sekmesinden servise anlaşılır bir görünen ad verin, Exit actions sekmesinde yeniden başlatma davranışını ayarlayın ve Install service düğmesine basın. Servisi başlatmak için:

net start PaperSunucu

Servis durumunu services.msc üzerinden izleyebilir, başlangıç türünü “Otomatik” yapıp makine her açıldığında sunucunun kendiliğinden kalkmasını sağlayabilirsiniz. Servis olarak çalışan sunucuya komut göndermenin yolları ve konsol erişimi konusu Minecraft sunucusunu Windows servisi olarak 7/24 çalıştırma sayfasında.

Windows’a Özgü Sık Hatalar ve Çözümleri#

Port çakışmasını bulmak için Komut İstemi’nde şu komutu kullanın:

netstat -ano | findstr :25565

Çıktının son sütunundaki sayı işlem kimliğidir (PID). Görev Yöneticisi’nin Ayrıntılar sekmesinde PID sütununu açıp o süreci bulabilirsiniz — çoğunlukla arka planda kalmış eski bir java.exe olur. Tablodaki hataların tek tek uzun çözümlerini Minecraft sunucu hataları ve çözümleri sayfasında topladık.

Windows Server tarafında iki ek ayar#

Windows Server 2022/2025 üzerinde çalışıyorsanız iki şeyi kontrol edin. Birincisi güç planı: Denetim Masası > Donanım > Güç Seçenekleri yolundan Yüksek performans planını seçin, dengeli plan işlemciyi düşük frekansta tutabilir. İkincisi Windows Defender: sunucu klasörünü gerçek zamanlı taramadan hariç tutun, aksi hâlde her chunk yazımında disk I/O gecikmesi artar. Sanal bellek (pagefile) ayarını da elle küçültmeyin; Java heap dışına taşan bellek isteklerinde sunucu düşer.

Kendi Bilgisayarınız mı, Kiralık Sunucu mu?#

Ev bilgisayarınızda kurduğunuz sunucu test için idealdir. Ancak oyuncu almaya başladığınızda üç sorunla karşılaşırsınız: ev internetinin yükleme hızı ve ping’i, bilgisayarın 7/24 açık kalmak zorunda olması ve dışarıya açtığınız portun kendi ev ağınızı hedef hâline getirmesi.

Bu noktada iki yol var. Hazır panelli bir Minecraft sunucu paketi, jar kurulumuyla uğraşmadan doğrudan oyuncu almanızı sağlar. Windows üzerinde tam kontrol istiyorsanız yüksek frekanslı bir Ryzen tabanlı VDS kiralayıp bu rehberdeki adımları RDP üzerinden uygulayabilirsiniz. Her iki tarafta da Türkiye lokasyonu, NVMe SSD ve ücretsiz DDoS koruması standarttır.

Özetle#

Windows’ta Paper kurulumu şu zincirdir: Temurin JDK 25 kur, C:\minecraft\server klasörünü aç, Paper 26.2 jar’ını paper.jar adıyla içine koy, start.bat yaz, ilk çalıştırmadan sonra eula.txt dosyasını true yap, ikinci çalıştırmada sunucu ayağa kalksın, sonra güvenlik duvarında 25565/TCP portunu aç.

Kurulum tamamlandıktan sonraki sıralama da bellidir: server.properties ayarlarını yap, eklentileri plugins klasörüne at, NSSM ile servise dönüştür ve düzenli yedek al. Aynı işi Spigot ile yapmak isterseniz derleme adımlarını Windows’ta BuildTools ile Spigot kurulumu sayfasında bulacaksınız; Windows tarafındaki tüm kurulum konularının toplandığı ana sayfa ise Windows’ta Minecraft sunucu kurulumu rehberidir.