Web Panel Üzerinden Modlu Minecraft Sunucusu Kurma

Web panel üzerinden modlu Minecraft sunucusu kurmak, tek satır komut yazmadan Forge, NeoForge veya Fabric tabanlı bir sunucuyu ayağa kaldırmanın en kısa yoludur. Paneldeki listeden mod yükleyicisini seçer, Minecraft sürümünü yazar, kurulum düğmesine basarsınız; sunucu birkaç dakika içinde hazır olur. SSH, dosya izinleri, chmod, screen gibi konularla hiç uğraşmazsınız.

Bu rehber, paneli ilk kez açan biri için yazıldı. Üç ayrı yolu tek tek göreceksiniz: hazır mod yükleyici şablonuyla boş bir modlu sunucu açmak, CurseForge ya da Modrinth modpack’ini panele indirtmek ve elinizdeki server pack ZIP dosyasını dosya yöneticisine yükleyip açmak. Ardından RAM ayarını nereden yapacağınızı, mod eklemenin doğru yolunu ve panelde en sık takılınan noktaları anlatıyoruz.

Panelin genel kullanımını hiç bilmiyorsanız önce web panel ile Minecraft sunucusu kurma sayfasını okumanız işinizi kolaylaştırır; burada doğrudan modlu tarafa odaklanıyoruz.

Web Panel Nedir, Modlu Sunucuda Ne İşe Yarar?#

Web panel (kontrol paneli), sunucunuzu tarayıcıdan yönettiğiniz arayüzdür. Sunucuyu başlatıp durdurma, konsolu izleme, dosya yükleme, yedek alma ve RAM ayarlama gibi işleri düğmelerle yaparsınız. Oyun sunucusu dünyasında en yaygın panel yazılımları Pterodactyl ve ondan çatallanan Pelican’dır; Batihost’un web panelli sunucu paketleri de bu mantıkla çalışır.

Modlu sunucuda panelin sağladığı asıl kolaylık şudur: mod yükleyicisinin kurulumu şablon hâline getirilmiştir. Panelde bu şablonlara Pterodactyl tarafında “egg”, Pelican tarafında “Egg/şablon” denir. Siz “Forge” şablonunu seçtiğinizde panel arka planda installer’ı indirir, --installServer ile çalıştırır, kütüphaneleri kurar ve başlatma komutunu kendisi ayarlar. Bunların hiçbirini elle yapmazsınız.

Başlamadan Önce Netleştirmeniz Gereken 4 Şey#

Panele girmeden önce şu dört sorunun cevabını bilin. Bilmeden başlarsanız yarı yolda geri dönmek zorunda kalırsınız.

Minecraft sürümü

Güncel kararlı sürüm 26.2 “Chaos Cubed” (16 Haziran 2026). Ancak büyük modpacklerin çoğu hâlâ 1.21.x veya 1.20.1 üzerindedir. Sürümü modpack belirler, siz değil.

Mod yükleyici

Forge, NeoForge veya Fabric. Bunu da modpack belirler. Kendi mod listenizi topluyorsanız modların çoğunluğu hangisini hedefliyorsa onu seçin.

Java sürümü

26.1 ve sonrası Java 25 ister. 1.20.5-1.21.11 için Java 21, 1.17-1.20.4 için Java 17, 1.12.2 gibi eski paketler için Java 8 gerekir.

RAM

Modlu sunucuda taban 16 GB, büyük paketlerde 24-32 GB.

Yol 1 — Panelden Forge veya NeoForge Sunucusu Kurma#

Bu yol, kendi mod listenizi kuracaksanız veya hazır bir server pack’i sonradan yükleyecekseniz doğru başlangıçtır. Panel size boş ama mod yükleyicisi kurulu bir sunucu verir.

1. Panele giriş yapın ve sunucunuzu seçin#

   Hosting sağlayıcınızdan gelen panel adresine kullanıcı adı ve şifrenizle girin. Ana sayfada size ait sunucular listelenir; modlu sunucu olarak kullanacağınız sunucuya tıklayın.

2. “Startup” (Başlangıç) sekmesini açın#

   Sunucu sayfasının üst kısmındaki sekmelerden Startup sekmesine geçin. Burada mod yükleyici sürümü, Minecraft sürümü ve Java sürümü gibi değişkenler bulunur.

3. Minecraft ve mod yükleyici sürümünü yazın#

   MC_VERSION alanına Minecraft sürümünü (örneğin 26.2) yazın. Forge kullanıyorsanız BUILD_TYPE alanını recommended bırakmanız en güvenlisidir; belirli bir sürüm istiyorsanız FORGE_VERSION alanına tam numarayı (örneğin 65.1.0) girin. NeoForge tarafında karşılığı NEOFORGE_VERSION alanıdır.

4. Java sürümünü Java 25 yapın#

   Aynı sayfadaki Docker Image açılır menüsünden Java 25 seçeneğini işaretleyin. 26.x sunucusunu Java 21 imajıyla açmaya çalışırsanız konsolda UnsupportedClassVersionError hatası görürsünüz.

5. Kurulumu başlatın ve konsolu izleyin#

   Ayarları kaydedin ve sunucuyu yeniden kurun (panelde genellikle Reinstall Server düğmesi). Konsol sekmesinde installer’ın kütüphaneleri indirdiğini görürsünüz. Kurulum bitince sunucuyu başlatın.

6. EULA’yı kabul edin#

   İlk açılışta sunucu eula.txt üretip kapanır. Dosya yöneticisinden bu dosyayı açıp eula=false satırını eula=true yapın ve kaydedin. Bazı paneller bunu ilk kurulumda otomatik yapar.

Yol 2 — CurseForge veya Modrinth Modpack’ini Panele Kurdurma#

Hazır bir modpack kuracaksanız en pratik yol budur: panel modpack’in tüm modlarını ve yapılandırma dosyalarını sizin yerinize indirir. Bunun için panelde “CurseForge Generic” veya “Modrinth Generic” şablonunun tanımlı olması gerekir.

CurseForge modpack’i için gerekenler#

CurseForge şablonu, modpack’in proje kimliğini (Project ID) ister. Bu numarayı modpack’in CurseForge sayfasında sağ taraftaki “About Project” bölümünde bulursunuz. Şablon ayrıca CurseForge API anahtarına ihtiyaç duyar; bu anahtar genelde hosting sağlayıcısı tarafından tanımlanır ve size gösterilmez, o alanı boş görüyorsanız endişelenmeyin.

Modrinth modpack’i için gerekenler#

Modrinth şablonu API anahtarı istemez, bu yüzden yeni başlayanlar için daha az sürtünmelidir. Yine bir proje kimliği istenir; Modrinth’te bu kimlik 8 karakterlik alfanümerik bir koddur (örneğin 1KVo5zza) ve modpack sayfasının teknik bilgi bölümünde yazar.

Yol 3 — Server Pack ZIP’ini Dosya Yöneticisiyle Yükleme#

Elinizde indirilmiş bir sunucu paketi (server pack) varsa ya da panelde modpack şablonu yoksa bu yolu kullanırsınız. Server pack’in nereden indirileceğini CurseForge server pack indirme sayfasında adım adım anlattık.

1. Sunucuyu durdurun#

   Panelin konsol ekranındaki Stop düğmesine basın. Çalışan sunucunun dosyalarını değiştirmek bozuk dünya ve yarım yapılandırma dosyaları üretir.

2. Dosya yöneticisini açın ve ZIP’i yükleyin#

   Files (Dosyalar) sekmesine geçin, sunucu kök dizininde olduğunuzdan emin olun ve Upload düğmesiyle ZIP dosyasını yükleyin. Dosya 200-300 MB’ı geçiyorsa tarayıcı yerine SFTP kullanın; panele FTP ve SFTP ile bağlanma sayfasında bağlantı bilgilerinin nerede yazdığını gösterdik.

3. Arşivi sunucu kökünde açın#

   Yüklenen dosyanın sağındaki üç noktaya tıklayıp Decompress (Arşivi Aç) seçeneğini kullanın. Açılan içeriğin mods, config ve user_jvm_args.txt gibi öğelerinin doğrudan kök dizinde olduğundan emin olun; bunlar bir alt klasörün içinde kaldıysa dosyaları tek seviye yukarı taşıyın.

4. Klasör yapısını doğrulayın#

   sunucu-koku/
   ├── mods/                 <-- mod .jar dosyaları burada
   ├── config/               <-- mod ayar dosyaları
   ├── libraries/            <-- kurulum sonrası oluşur
   ├── user_jvm_args.txt     <-- RAM ayarı burada
   ├── server.properties
   └── eula.txt

5. Başlatma komutunu kontrol edip sunucuyu açın#

   Startup sekmesinde jar dosya adı ya da başlatma komutu paketle uyumlu olmalıdır. Ardından Start düğmesine basıp konsolu izleyin.

RAM ve Başlatma Komutunu Panelden Ayarlama#

Modlu sunucuda RAM ayarının nerede yapıldığı mod yükleyicisine göre değişir ve yeni başlayanların en çok karıştırdığı konu budur.

Forge ve NeoForge (1.17 ve sonrası): RAM, sunucu kökündeki user_jvm_args.txt dosyasındadır. Bu dosyaya yalnızca JVM argümanları yazılır; tam java komutu, -jar veya dosya yolu yazılmaz.

# user_jvm_args.txt — 16 GB’lık bir pakette
-Xms14G
-Xmx14G

Fabric: Klasik jar başlatma kullanılır, RAM doğrudan başlatma komutundaki -Xmx değerinden gelir.

java -Xms14G -Xmx14G -jar server.jar nogui

Panelde ayrıca bir bellek limiti (Memory) alanı vardır. Burası konteynerin toplam bellek sınırıdır ve Java’nın heap’inden fazlasını sayar: sınıf metadata’sı, iş parçacığı yığınları ve yerel bellek de bu limitin içindedir. Bu yüzden Java heap’ini konteyner limitine eşit vermeyin.

Panelde Mod Ekleme ve Çıkarma#

Kurulum bittikten sonra mod eklemek panelde birkaç tıklamalık iştir, ama üç kuralı atlamayın.

1. Önce yedek alın#

   Backups sekmesinden yedek oluşturun. Mod eklemek ya da çıkarmak dünya verisini kalıcı biçimde etkileyebilir. Yedek almanın ayrıntısı panelden yedek alma ve geri yükleme sayfasında.

2. Sunucuyu durdurun ve jar’ı mods klasörüne yükleyin#

   Dosya yöneticisinde mods klasörüne girip mod jar dosyasını yükleyin. Mod dosyasının Minecraft sürümü ve mod yükleyicisi sunucunuzla birebir aynı olmalıdır.

3. Aynı modu oyunculara da dağıtın#

   Blok, eşya, boyut veya canlı ekleyen modlar hem sunucuda hem oyuncuda bulunmak zorundadır. Yalnızca sunucuya kurulursa oyuncular bağlanırken mod uyuşmazlığı hatası alır. Konunun ayrıntısı için sonradan mod ekleme ve çıkarma sayfasına bakın.

Panelde En Sık Karşılaşılan 5 Sorun#

1. Sunucu açılır açılmaz kapanıyor#

Konsolda UnsupportedClassVersionError geçiyorsa Java sürümü yanlıştır. Startup sekmesinden Docker Image alanını doğru Java sürümüne çekin. 26.x için Java 25 zorunludur.

2. “You need to agree to the EULA” yazıyor#

Dosya yöneticisinden eula.txt dosyasını açıp eula=true yapın ve sunucuyu tekrar başlatın. Ayrıntı için EULA hatası çözümü sayfasına bakabilirsiniz.

3. ZIP yüklerken 413 hatası alıyorum#

Tarayıcı üzerinden yükleme boyutu sınırına takıldınız. Dosyayı SFTP ile yükleyin ya da sağlayıcınızdan limiti yükseltmesini isteyin.

4. Arşivi açarken “yeterli alan yok” diyor#

Panel, arşivi açmadan önce içeriğin disk kotanıza sığıp sığmayacağını hesaplar. 800 MB’lık bir modpack ZIP’i açıldığında 3-4 GB olabilir. Disk alanınızı artırın ya da gereksiz eski dünya yedeklerini silin.

5. Sunucu açılıyor ama oyuncular bağlanamıyor#

Modlu sunucuda bunun bir numaralı nedeni mod listesi uyuşmazlığıdır. Oyuncuların istemcisinde sunucudakiyle aynı modlar ve aynı sürümler olmalıdır. Hata metinlerini ve çözümlerini mod uyuşmazlığı hatası sayfasında topladık; daha genel sorunlar için modlu sunucu hataları ve çözümleri sayfası işinizi görür.

Modlu Sunucu İçin Panel Paketi Seçerken#

Panel kullanmak donanım gereksinimini azaltmaz. Modlu bir sunucu, eklentili bir Paper sunucusundan kat kat fazla bellek ve tek çekirdek gücü ister. Paket seçerken şunlara bakın:

Hazır panelli bir modlu sunucu arıyorsanız modlu Minecraft sunucu paketlerine göz atabilirsiniz; kendi sunucunuzu baştan sona yönetmek istiyorsanız yüksek frekanslı Ryzen VDS tarafı daha uygun olur. Panelli paket kurulumu ve yönetimi sizin yerinize halleder; VDS ise her ayarı elinizde tutar ama işletim sistemi bakımını da size bırakır.

Özetle#

Web panelden modlu sunucu kurmak üç adıma iner: doğru şablonu seç, doğru Java sürümünü seç, modpack’i ya panele indirt ya da server pack ZIP’ini yükle. Panel installer’ı, kütüphaneleri ve başlatma komutunu sizin yerinize hallettiği için komut satırı bilgisine ihtiyacınız olmaz.

Aklınızda kalması gereken üç şey var: 26.x sunucuları Java 25 ister, modlar mods klasörüne gider ve oyuncularınızın mod listesi sunucununkiyle birebir aynı olmalıdır. Panel yazılımının kendisini derinlemesine öğrenmek isterseniz Pterodactyl panelinde modlu sunucu kurma sayfası bir sonraki durağınız olsun.