Hytale modlarını yükle

Önemli: Hytale şu anda Erken Erişim (Early Access) aşamasındadır. Modlar kararsızlığa neden olabilir. Yeni modlar yüklemeden önce dünyanızın ("universe" klasörü) yedeğini almanızı her zaman öneririz.

Giriş

Hytale sunucunuzu modlamak, yeni silahlardan ve mobilyalardan gelişmiş sunucu eklentilerine kadar yepyeni bir olasılıklar dünyasının kapılarını aralar. Bizimle modları yüklemenin iki yolu vardır: otomatik Gamepanel aracılığıyla (yeni başlayanlar için önerilir) veya FTP aracılığıyla Manuel olarak (gelişmiş kullanıcılar için).

Yöntem 1: Gamepanel ile Otomatik Kurulum

Gamepanel'imiz doğrudan CurseForge ile entegredir, bu da güvenli modları tek bir tıklamayla bulmayı ve yüklemeyi kolaylaştırır.

Gamepanel hesabınıza giriş yapın.
Sunucunuza gidin ve sunucuyu tamamen kapatmak için Durdur (Stop) düğmesine tıklayın.
Soldaki menüden "Hytale Mods" seçeneğine tıklayın.
İstediğiniz modu bulmak için arama çubuğunu kullanın (ör. "Advanced Item Info").
Yükle (Install) düğmesine tıklayın. Sistem şimdi sunucunuza uygun en son sürümü indirecektir.
Kurulum tamamlandığında, Konsol'a geri dönün ve sunucuyu başlatın.

İpucu: Bir modun çalışması için başka modlar gerekiyorsa (bağımlılıklar), panelimiz bunları genellikle otomatik olarak yükler. Yine de emin olmak için her zaman mod açıklamasını kontrol edin.

Yöntem 2: Manuel Kurulum (FTP)

Kendi modunuzu geliştirdiyseniz veya Mod Yöneticimizde bulunmayan bir dosya indirdiyseniz, bunu manuel olarak yükleyebilirsiniz. FileZilla gibi bir FTP istemcisine ihtiyacınız olacak veya paneldeki yerleşik "Dosya Yöneticisi"ni (File Manager) kullanabilirsiniz.

Adım 1: Dosyayı Hazırlayın

Modunuzu indirin. Bu genellikle bir .zip dosyası (varlıklar/modlar için) veya bir .jar dosyası (eklentiler/plugins için) olacaktır.

UYARI: Dosyayı arşivden ÇIKARMAYIN (unzip yapmayın)! Sunucu doğrudan .zip arşivinden okuma yapar. Eğer bir klasöre çıkarırsanız, mod çalışmayacaktır.

Adım 2: Sunucuya Yükleme

FTP aracılığıyla sunucunuza bağlanın (giriş bilgileriniz paneldeki "Settings" altında bulunur).
mods adlı klasörü açın. Eğer yoksa, oluşturun (küçük harflerle).
.zip veya .jar dosyanızı bu klasöre sürükleyin.
Dosyanın doğrudan mods/ içinde olduğundan ve bir alt klasörde olmadığından emin olun.

Adım 3: "Early Plugins" Etkinleştirme (Gelişmiş)

Bazı eklentiler çalışmak için özel izinler gerektirir. Bir sunucu eklentisi (.jar) yüklerseniz ve sunucu başlangıçta çökerse, "Early Plugins" özelliğini etkinleştirmeniz gerekebilir.

Gamepanel'deki "Startup" sekmesine gidin.
"Accept Early Plugins" ayarını bulun ve On konumuna getirin (veya başlangıç satırına --accept-early-plugins ekleyin).

Adım 4: Yeniden Başlatma

Sunucunuzu başlatın ve konsolu izleyin. [ModLoader] Loaded mod: İsim gibi mesajlar görmelisiniz. Hata mesajları görürseniz, lütfen sorun giderme kılavuzumuza bakın veya desteğimizle iletişime geçin.

Sıkça Sorulan Sorular (SSS)

Sorun	Çözüm
Mod kurulumundan sonra sunucu başlamıyor	Zip dosyasını yanlışlıkla arşivden çıkarıp çıkarmadığınızı kontrol edin. Klasörü silin ve orijinal .zip dosyasını tekrar yükleyin. Ayrıca Java 25 kullanıp kullanmadığınızı kontrol edin.
Oyuncular yeni eşyaları (items) göremiyor	Bu genellikle ağ sorunlarından kaynaklanır. UDP portu 5520'nin açık olduğundan emin olun, çünkü Hytale varlıkları (assets) oyunculara bu port üzerinden yayınlar.
"Server session token not available"	Sunucuyu yeniden başlatın. Sorun devam ederse, Hytale'in durum sayfası üzerinden kimlik doğrulama sunucularının kapalı olup olmadığını kontrol edin.