Modrinth Modpack Sunucusu Nasıl Kurulur?

Modrinth modpack sunucusu kurmak için modpack sayfasından .mrpack dosyasını indirir, dosyayı sunucuda açar, paketin istediği mod loader’ı (Fabric, NeoForge veya Forge) kurar ve mod dosyalarını mods/ klasörüne yerleştirirsiniz. Bu işi elinizle de yapabilirsiniz, mrpack-install gibi bir araca veya web paneline de yaptırabilirsiniz. Bu sayfada dört yöntemi de sırayla, tek adım atlamadan anlatıyoruz.

Modrinth’i CurseForge’dan ayıran en pratik fark şudur: Modrinth’in API’si (uygulama programlama arayüzü — sitenin verilerini program aracılığıyla sorgulama yolu) kimlik doğrulaması istemez. CurseForge’da sunucu tarafı otomasyon için API anahtarı başvurusu yapıp onay beklemek gerekirken, Modrinth’te modpack dosyasını doğrudan sunucunun komut satırından indirebilirsiniz. Bu, VDS üzerinde çalışan biri için ciddi bir zaman kazancıdır.

Baştan bir uyarı: Minecraft 26.1 ile birlikte oyun kodu artık obfuscated (karıştırılmış) olarak dağıtılmıyor. Bu bir ABI kırılmasıdır — 1.21.11 ve öncesi için derlenmiş hiçbir mod, yeniden derlenmeden 26.x sunucusunda yüklenmez. Bu yüzden modpack’in hangi Minecraft sürümü için yayınlandığını daima kontrol edin.

Modrinth modpack’i ile CurseForge modpack’i arasındaki farklar#

İki platform da modpack dağıtır ama sunucu kurma iş akışları farklıdır. Aşağıdaki tablo, hangi noktada ne beklemeniz gerektiğini özetliyor.

Kuruluma başlamadan önce: donanım ve Java sürümü#

Modlu bir sunucu, vanilla sunucudan kat kat ağırdır. Yüzlerce mod, kendi blok, eşya, varlık ve tarif kayıtlarını belleğe yükler; bu kayıtlar oyuncu sayısından bağımsız olarak sabit bir RAM maliyeti getirir. Bu yüzden modlu sunucularda RAM tabanını 16 GB’dan başlatıyoruz.

İşlemcide çekirdek sayısı değil saat hızı belirleyicidir; Minecraft’ın ana tick döngüsü tek çekirdekte çalışır. Bu yüzden düşük frekanslı çok çekirdekli sunucu işlemcileri yerine yüksek frekanslı Ryzen 9 modellerini öneriyoruz. Disk mutlaka NVMe SSD olmalı ve modlu sunucuda 100 GB’ın altına düşmemelidir; chunk (harita parçası) okuma-yazma gecikmesi doğrudan TPS’e yansır. Uygun paketlere modlu Minecraft sunucu paketlerimizden ya da yüksek frekanslı Ryzen VDS tarafından bakabilirsiniz.

Java sürümü konusunda taviz yoktur: Minecraft 26.1 ve sonrası Java 25 ister. Paketiniz 1.21.x hattındaysa Java 21, 1.20.4 ve öncesindeyse Java 17 gerekir. Doğru eşleştirmeyi hangi Java sürümü gerekir sayfasında tablo hâlinde bulabilirsiniz.

.mrpack dosyasının içinde tam olarak ne var?#

.mrpack uzantısı sizi yanıltmasın; bu dosya normal bir ZIP arşividir. Uzantıyı değiştirmeden 7-Zip ya da unzip ile açabilirsiniz. Açtığınızda kökte şunları görürsünüz:

paket.mrpack
├── modrinth.index.json    <-- mod listesi ve indirme adresleri
├── overrides/             <-- her iki tarafa kopyalanacak dosyalar
├── server-overrides/      <-- SADECE sunucuya kopyalanacak dosyalar
└── client-overrides/      <-- sadece oyuncunun bilgisayarına (sunucuda kullanılmaz)

modrinth.index.json paketin beyni sayılır. İçinde formatVersion, game, versionId, name, files ve dependencies alanları bulunur. files dizisindeki her kayıt bir modu tarif eder: dosyanın nereye konacağı (path), doğrulama özetleri (hashes), doğrudan indirme adresleri (downloads) ve o modun hangi tarafta gerektiği (env).

{
  "formatVersion": 1,
  "game": "minecraft",
  "versionId": "1.0.0",
  "name": "Ornek Pack",
  "files": [
    {
      "path": "mods/OrnekMod.jar",
      "hashes": { "sha1": "...", "sha512": "..." },
      "env": { "client": "required", "server": "unsupported" },
      "downloads": [ "https://cdn.modrinth.com/data/..." ],
      "fileSize": 184320
    }
  ],
  "dependencies": {
    "minecraft": "26.2",
    "fabric-loader": "0.19.3"
  }
}

Modpack’in .mrpack dosyasını indirme#

Tarayıcıdan indirmek en basit yoldur: modpack sayfasında Versions (Sürümler) sekmesine girin, sunucunuzun Minecraft sürümüne ve mod loader’ına uyan satırı seçin, indirme simgesine basın. İnen dosya .mrpack uzantılıdır.

Sunucuya doğrudan indirmek isterseniz Modrinth API’sini kullanabilirsiniz. Aşağıdaki komut, bir modpack’in 26.2 sürümüne ait dosyanın gerçek indirme adresini döndürür:

# Modpack sürümlerini listele ve 26.2 dosyasının adresini al
curl -s 'https://api.modrinth.com/v2/project/PAKET-SLUG/version?game_versions=%5B%2226.2%22%5D' \
  | jq -r '.[0].files[0].url'

# Dönen adresi doğrudan indir
wget -O paket.mrpack "YUKARIDA_DONEN_ADRES"

PAKET-SLUG yerine modpack’in adres çubuğundaki kısa adını yazın. Windows tarafında aynı işi tarayıcıyla yapıp dosyayı Uzak Masaüstü ya da SFTP ile sunucuya taşımak daha pratiktir; SFTP bağlantısı için panele FTP ve SFTP ile bağlanma sayfasına bakabilirsiniz.

Yöntem 1: mrpack-install ile otomatik kurulum#

mrpack-install, .mrpack dosyasını okuyup mod loader’ı indiren ve modları yerine koyan tek dosyalık bir komut satırı aracıdır. En hızlı yol budur ama bir çekincesi vardır.

# Linux x64 kurulumu
curl -sSL -o /tmp/mrpack-install \
  "https://github.com/nothub/mrpack-install/releases/download/v0.16.10/mrpack-install-linux"
sudo install -t /usr/local/bin /tmp/mrpack-install
mrpack-install --help

# Yerel dosyadan kurulum
mrpack-install paket.mrpack --server-dir /opt/minecraft/modrinth

# Doğrudan Modrinth slug'ı ile kurulum
mrpack-install adrenaserver --server-dir /opt/minecraft/modrinth

Araç işini bitirdiğinde klasörde bir sunucu jar’ı, mods/ klasörü ve paketin yapılandırma dosyaları hazır olur. Kurulum sonrası ls -la ile jar dosyasının gerçekten oluştuğunu doğrulayın.

Yöntem 2: .mrpack dosyasını elle kurma (her sürümde çalışır)#

Otomatik araçlar tökezlediğinde bu yöntem her zaman çalışır, çünkü hiçbir üçüncü taraf araca bağlı değildir. Sırayı bozmayın.

1. Arşivi ayrı bir klasöre açın#

   Doğrudan sunucu klasörüne açmayın; önce geçici bir klasörde inceleyin.

   mkdir -p ~/pack && unzip paket.mrpack -d ~/pack
   ls ~/pack
   # modrinth.index.json  overrides/  server-overrides/

2. Hangi loader ve sürüm gerektiğini okuyun#

   modrinth.index.json içindeki dependencies bölümü size Minecraft sürümünü ve loader sürümünü birebir söyler. Windows’ta dosyayı Not Defteri ya da Notepad++ ile açabilirsiniz.

   jq '.dependencies, .name, .versionId' ~/pack/modrinth.index.json

3. Mod loader’ı sunucu klasörüne kurun#

   Paket Fabric istiyorsa Fabric Server Launcher’ı, NeoForge istiyorsa NeoForge installer’ı kullanın. NeoForge tarafında komut şudur:

   java -jar neoforge-26.2.0.63-installer.jar --installServer

   Fabric kurulumunun ayrıntısı için Fabric sunucu kurulumu sayfasına bakın.

4. Modları indirin#

   files dizisindeki her kaydın downloads adresini indirip path alanının söylediği yere koyun. Sunucuda env.server değeri unsupported olanları atlayın.

   cd /opt/minecraft/modrinth
   jq -r '.files[] | select(.env.server != "unsupported") | .downloads[0]' \
     ~/pack/modrinth.index.json | while read url; do wget -P mods/ "$url"; done

5. overrides ve server-overrides klasörlerini sırayla kopyalayın#

   Önce overrides/, hemen ardından üzerine yazacak şekilde server-overrides/. Bu sıra bozulursa paketin sunucuya özel ayarları devre dışı kalır.

   cp -r ~/pack/overrides/. /opt/minecraft/modrinth/
   cp -r ~/pack/server-overrides/. /opt/minecraft/modrinth/

6. EULA’yı kabul edin ve sunucuyu başlatın#

   İlk çalıştırmada eula.txt oluşur ve sunucu durur. Dosyadaki değeri eula=true yapıp yeniden başlatın.

Yöntem 3: Web panelinden Modrinth modpack’i kurma#

Komut satırına hiç girmek istemiyorsanız panel yolu vardır. Pterodactyl ve Pelican için hazırlanmış “Modrinth Generic” egg’i, modpack’i proje ID’sinden otomatik indirip kurar ve CurseForge’un aksine API anahtarı istemez. Egg iki değişken sorar: PROJECT_ID (8 karakterlik proje kimliği) ve VERSION_ID (varsayılan latest).

Proje ID’sini modpack sayfasında sol taraftaki “Technical information” bölümünde bulursunuz. Docker imajı olarak Minecraft 26.x sunucularında ghcr.io/pterodactyl/yolks:java_25 seçilmelidir.

Panelli hazır bir çözüm arıyorsanız web panel üzerinden modlu sunucu kurma sayfası, tıklamayla ilerleyen sürümü anlatıyor.

Yöntem 4: Docker ile tek yapılandırmada kurulum#

Docker kullanıyorsanız itzg/minecraft-server imajı Modrinth modpack’lerini yerleşik olarak destekler. TYPE=MODRINTH verildiğinde imaj hem modpack’i hem de gereken loader’ı kendisi indirir.

services:
  minecraft:
    image: itzg/minecraft-server
    environment:
      EULA: "true"
      TYPE: MODRINTH
      MODRINTH_MODPACK: paket-slug
      MODRINTH_LOADER: fabric
      VERSION: "26.2"
      MEMORY: 14G
    ports:
      - "25565:25565"
    volumes:
      - ./data:/data

Docker kurulumunun temellerini Docker ile Minecraft sunucusu kurma sayfasında bulabilirsiniz.

RAM ayarı, başlatma ve ilk açılış#

Fabric tabanlı paketlerde sunucu klasik -jar yöntemiyle başlar. 16 GB’lık bir pakette başlatma komutu şöyledir:

java -Xms14G -Xmx14G -XX:+UseZGC -XX:+UseStringDeduplication \
  -XX:+UseCompactObjectHeaders -XX:+AlwaysPreTouch \
  -jar fabric-server-launch.jar nogui

NeoForge veya Forge tabanlı paketlerde durum farklıdır: 1.17 ve sonrasında çalıştırılabilir tek bir sunucu jar’ı yoktur. RAM ayarı user_jvm_args.txt dosyasına yazılır ve sunucu run.sh (Windows’ta run.bat) ile başlatılır.

Modlu sunucunun ilk açılışı 1-3 dakika sürer; 200 modun üzerindeki paketlerde 10 dakikaya kadar çıkabilir. Konsolda Done (312.845s)! For help, type "help" satırını görene kadar süreci kesmeyin. Başlatma bayraklarını derinlemesine ayarlamak için modlu sunucu optimizasyonu sayfasına geçin.

Oyuncular sunucuya nasıl bağlanır?#

Oyuncuların bilgisayarında da aynı modpack’in aynı sürümü kurulu olmalıdır. Modrinth App ya da Prism Launcher gibi bir başlatıcıya .mrpack dosyasını içe aktarmaları yeterlidir. Modpack adının aynı olması yetmez; sürüm numarası da birebir eşleşmelidir.

Fabric sunucularında istemci-only modlar (minimap, shader, FPS modları) genellikle sorun çıkarmaz. NeoForge sunucularında ise ağ kanalı ve registry karşılaştırması yapılır; oyun içeriği ekleyen bir mod taraflardan birinde eksikse bağlantı reddedilir. Bağlantı adımlarının tamamı modlu sunucuya arkadaş bağlama sayfasında anlatılıyor.

Kurulumda takıldığınız yerler#

En sık görülen üç durum ve çözümleri:

Sunucu açılırken “Incompatible mod set!” yazıyor

Fabric’in mod çözümleme hatasıdır. Hemen altındaki “A potential solution has been determined:” satırı hangi modu hangi sürüme çekmeniz gerektiğini yazar; o satırı okuyun.

Modlar yüklenmiyor, sunucu vanilla açılıyor

mods/ klasörü yanlış yere kopyalanmıştır ya da loader kurulmamıştır. Sunucu kökünde loader’ın oluşturduğu libraries/ klasörünü arayın.

Bellek hatası alıyorsunuz

OutOfMemoryError: Java heap space için -Xmx artırılır, Metaspace hatası içinse -XX:MaxMetaspaceSize=1g eklenir — bu ikisi farklı hatalardır.

Daha geniş bir hata listesi için modlu sunucu hataları ve çözümleri ile mod uyuşmazlığı hatası sayfalarına bakabilirsiniz.

Özetle#

Modrinth modpack sunucusu kurmak, CurseForge’a göre daha az engelli bir yoldur: tek bir .mrpack dosyası, anahtar istemeyen bir API ve dosyanın içinde açıkça yazan indirme adresleri. Sırayı doğru uygularsanız — arşivi aç, loader’ı kur, modları indir, önce overrides/ sonra server-overrides/ kopyala — kurulum yarım saatten kısa sürer.

Donanımda taviz vermeyin: modlu sunucuda 16 GB RAM, yüksek frekanslı Ryzen 9 işlemci ve NVMe SSD taban kabul edilmelidir. Genel resmi görmek isterseniz modlu Minecraft sunucusu kurma rehberimiz tüm loader ve platformları tek sayfada topluyor.