Valheim Mod Kurulumu: BepInEx ile Sunucuya Mod Ekleme

Valheim mod kurulumu, oyunun resmî bir mod desteği bulunmadığı için Unity oyunlarına eklenti yükleyen açık kaynaklı BepInEx çatısı üzerinden yapılır. Topluluğun hazırladığı BepInExPack_Valheim paketi, yükleyiciyi Valheim’e uygun ayarlarla bir arada sunar ve modların büyük çoğunluğu bu pakete bağımlıdır.

Aşağıdaki adımlar kendi kurduğunuz bir sunucu için geçerlidir; temel sunucuyu henüz kurmadıysanız önce Valheim sunucu kurulumu rehberini tamamlayın. LIONFIN oyun sunucusu paketlerinde dosyalara SFTP ile eriştiğiniz için aynı işlemleri panel üzerinden de yapabilirsiniz.

BepInEx nedir, Valheim modları neden ona ihtiyaç duyar?

BepInEx, Unity ve .NET tabanlı oyunlara harici eklenti (plugin) yükleyen bir mod çatısıdır; Valheim modları ayrı programlar değil, BepInEx’in açılışta oyuna yüklediği .dll dosyalarıdır. Valheim için hazırlanmış BepInExPack_Valheim paketi, Thunderstore mod deposunda yayımlanır ve gerekli ön ayarları içerir.

Modlar etki alanına göre üçe ayrılır:

• Yalnız istemci: Arayüz, harita ya da görsel modları; sunucuya kurulması gerekmez.
• Yalnız sunucu: Yönetim, otomatik duyuru ya da kayıt araçları; oyuncuların kurması gerekmez.
• İki taraf: Yeni eşya, yapı, yaratık ya da oyun kuralı ekleyen modlar; sunucu ve tüm oyuncular aynı sürümü kullanmalıdır.

Mod sayfasındaki açıklama hangi grupta olduğunu belirtir. Birçok içerik modu Jötunn gibi ortak bir kütüphaneye bağımlıdır; bağımlılıkları da aynı klasöre kurmanız gerekir.

Valheim mod kurulumu sunucuda adım adım nasıl yapılır?

Sunucu tarafında Valheim mod kurulumu, BepInEx paketini sunucu klasörünün köküne açmak ve sunucuyu BepInEx betiğiyle başlatmaktan oluşur.

1. Sunucuyu kapatın ve dünya dosyalarının yedeğini alın.
2. Thunderstore’dan BepInExPack_Valheim arşivini indirin. Arşivin içindeki BepInExPack_Valheim klasörünün içeriğini (klasörün kendisini değil) valheim_server.x86_64 dosyasının bulunduğu dizine kopyalayın.
3. Linux’ta paketle gelen start_server_bepinex.sh dosyasını açın; sunucu adı, port, dünya ve şifre parametrelerini mevcut başlatma satırınızla aynı yapın.
4. Betiği çalıştırılabilir yapın ve başlatın:

chmod +x start_server_bepinex.sh
./start_server_bepinex.sh

5. İlk açılıştan sonra BepInEx/config, BepInEx/plugins klasörlerinin ve BepInEx/LogOutput.log dosyasının oluştuğunu doğrulayın.

Windows sunucularda BepInEx, paketle gelen yükleyici dosyası sayesinde normal start_headless_server.bat ile birlikte devreye girer; ayrıca betik gerekmez. Dosyaları yüklemek için SFTP kullanabilirsiniz; Linux’ta temel dosya işlemleri için Linux temel komutlar rehberi yardımcı olur.

Mod dosyaları hangi klasöre konur?

Mod dosyaları BepInEx/plugins klasörüne konur; düzenli kalması için her modu kendi alt klasörüne açmanız önerilir. Thunderstore arşivlerinde genellikle bir .dll, bir manifest.json ve bazen ek varlık klasörleri bulunur.

Ayar değiştirmek için sunucuyu kapatıp ilgili .cfg dosyasını düzenleyin. Bazı modlar ayarlarını sunucudan oyunculara zorla eşitler; bu durumda yalnızca sunucudaki dosyayı değiştirmeniz yeterlidir.

Oyuncular modları nasıl kurar ve sürümler nasıl eşlenir?

İki tarafta çalışan modlarda oyuncuların bilgisayarında da aynı BepInEx paketi ve aynı mod sürümleri bulunmalıdır; aksi hâlde bağlantı reddedilir ya da eşyalar görünmez. En pratik yöntem, Thunderstore Mod Manager ya da r2modman gibi bir mod yöneticisiyle bir profil hazırlayıp bu profilin paylaşım kodunu oyunculara vermektir.

1. Mod yöneticisinde yeni bir Valheim profili açın ve sunucudaki modları aynı sürümlerle ekleyin.
2. Profili dışa aktarın ve kodu oyuncularla paylaşın.
3. Oyuncular kodu içe aktarıp oyunu mod yöneticisinden “modlu” olarak başlatır.
4. Sunucuda bir modu güncellediğinizde profili de güncelleyin ve oyunculara duyurun.

Valheim’in kendisi güncellendiğinde bazı modlar geçici olarak çalışmayabilir. Sunucuyu oyun güncellemesinin hemen ardından değil, kullandığınız modların uyumlu sürümleri yayımlandıktan sonra güncellemek sürprizleri azaltır.

Mod kurulduktan sonra sunucu açılmıyorsa ne yapılmalı?

Modlu sunucunun açılmaması ya da oyuncuların bağlanamaması çoğu zaman eksik bağımlılık, sürüm uyuşmazlığı ya da yanlış klasör yapısından kaynaklanır. İlk bakılacak yer BepInEx/LogOutput.log dosyasıdır.

• Log dosyası hiç oluşmuyorsa: BepInEx devreye girmiyor demektir; paket içeriğinin doğru dizine kopyalandığını ve doğru betikle başlattığınızı kontrol edin.
• “Missing dependency” uyarısı: Modun istediği kütüphaneyi (örneğin Jötunn) plugins klasörüne ekleyin.
• Sürüm uyuşmazlığı mesajı: Oyuncu ve sunucudaki mod sürümlerini eşitleyin.
• Dünya bozulması şüphesi: Sunucuyu kapatıp yedekten geri dönün; sorunlu modu tek tek devre dışı bırakarak bulun.

Modları tek seferde onlarca eklemek yerine küçük gruplar hâlinde ekleyip her adımda sunucuyu test edin. Yeni eşya ekleyen bir modu sonradan kaldırmak, o eşyaların dünyadan silinmesine neden olabilir; bu yüzden düzenli oyun sunucusu yedekleme modlu sunucularda daha da önemlidir.