BepInEx ile Valheim sunucunu, sunucu dosyaları, istemci modları ve sürümler düzgün uyuştuğunda modlarla genişletebilirsin. Önemli olan sadece bir DLL kopyalamak değil, kontrollü bir akıştır: Framework'ü kur, sunucuyu bir kez başlat, modları hedefli ekle, istemcileri eşitle ve hataları loglar veya adım adım devre dışı bırakma ile daralt.
Valheim 1.0
Valheim 1.0 yayınlandı ve hâlâ resmi mod desteği sunmuyor. BepInEx ve bazı modlar sürüm atlamasından sonra çalışmayabilir; bir paket listesi 1.0 uyumluluğunu kanıtlamaz. Dünyanı ve mod yapılandırmanı yedekle, hatalarda önce modsuz başla ve yalnızca uyumlu olduğu kanıtlanmış sürümleri sırayla etkinleştir. Konsollar 1.0 çıkışında modları desteklemiyor; karışık crossplay grupları için Vanilla en güvenilir başlangıç noktasıdır.
Valheim 1.0 çıktı: Deep North, dünyalar ve sunucu güncellemesi · Valheim 1.0: Sunucu güncellemesi, eski dünya ve modları güvenle kontrol et
BepInEx Valheim'da Ne Yapar
BepInEx, Unity oyunları için bir mod framework'üdür. Valheim için çoğunlukla Thunderstore'da sunulan BepInExPack Valheim kullanılır: thunderstore.io üzerindeki dokümantasyon. Bu proje sayfası, adı geçen Valheim-BepInEx paketi için birincil kaynaktır.
BepInEx, Valheim modlarının yüklendiği ve yapılandırıldığı klasörleri sağlar. Birçok mod, BepInEx/plugins/ içinde bulunması gereken bir veya birden fazla DLL dosyasından oluşur. İlk sunucu başlatmasından sonra genellikle BepInEx/config/ içinde ek yapılandırma dosyaları oluşturulur. Bu dosyaları ancak sunucu, framework kurulu halde en az bir kez başlatıldıktan sonra değiştir.
Modların yanı sıra sunucu temellerini, yapılandırmayı ve boss ilerlemesini de düzgün planlamak istiyorsan, tamamlayıcı olarak Valheim Sunucusu Kiralama: Modlar, Yapılandırma ve Boss Sırası 2026 rehberi uygundur. Diğer Unity veya mod framework kurulumları için ayrıca V Rising Modlarını BepInEx ile Kurma: Sunucu Modları ile karşılaştırma da faydalıdır.
Gereksinimler
Başlamadan önce Valheim sunucu dizinine erişimin, sunucuyu yeniden başlatma imkânın ve net bir mod listen olmalı. game-serverhosting gibi ücretli bir çoklu oyun hosting'inde özellikle önemli olan, değişiklikleri izlenebilir şekilde uygulamandır: önce yedek, sonra framework, sonra tek tek modlar, ardından kontrol. Böylece teknik kontrol, destek verilebilirlik ve şeffaf işletim süreçleri korunur.
Ayrıca hangi modların yalnızca sunucu tarafında çalıştığını ve hangilerini her oyuncunun yerel olarak kurması gerektiğini belirle. Birçok Valheim modu sunucuda ve istemcide uyumlu bileşenlere ihtiyaç duyar; belirleyici olan ilgili mod sayfasındaki işarettir. Bu yüzden ortak bir modpack'e eklemeden önce her mod için ilgili Thunderstore açıklamasını kontrol et.
BepInEx'i Sunucuya Kurma
- Sunucuyu durdur ve dünyayı, başlatma dosyasını ve mevcut BepInEx yapılandırmasını yedekle.
- BepInExPack Valheim paketini indir ve sunucunun işletim sistemi için olan talimatı seç.
- Paketin asıl içeriğini Valheim sunucu dosyasının bulunduğu seviyeye kopyala. Bir ZIP'i açmak tek başına BepInEx'i her sistemde etkinleştirmez.
- Pakette belgelenen başlatma yolunu kullan ve BepInEx logunda loader'ın yüklenip yüklenmediğini kontrol et. Modları ancak ondan sonra kurarsın.
Hedef yapı bundan sonra şöyle görünmeli:
/valheim/
├── BepInEx/
│ ├── config/ # Mod yapılandırmaları
│ ├── plugins/ # Modları buraya koy
│ └── patchers/
├── valheim_server.x86_64
└── start_server.sh
Önemli olan seviyedir: BepInEx/ klasörü doğrudan Valheim sunucu dizininde olmalı, ZIP arşivinden gelen ek bir alt klasörün içinde değil. Yeniden başlatmadan sonra config veya plugins yapısı oluşmuyorsa, hata çoğunlukla tam olarak buradadır.
Modları Kurma
- Modları Thunderstore'dan indir.
- DLL dosyasını
BepInEx/plugins/klasörüne çıkar. - Sunucuyu yeniden başlat.
Yeni modları körü körüne büyük paketler halinde kurma. Daha mantıklı olan kontrollü ilerlemektir: Bir mod ekle, sunucuyu başlat, logu kontrol et, bağlantıyı test et, ancak sonra bir sonraki modu ekle. Birden fazla oyuncu varsa, mod listesini sürüm numaralarıyla birlikte belgele, böylece herkes aynı temeli kullanır.
Bir mod ek dosyalar veya kendi klasörlerini getiriyorsa, ilgili mod talimatını izle. Her mod yalnızca tek bir DLL'den oluşmaz. Yapılandırma dosyalarını plugins ile config arasında rastgele taşıma; BepInEx ve modun kendisi belirli yollar bekler.
İstemci Modlarını Eşitleme
Her modu yazarın belirttiği şekilde sınıflandır: İstemci tarafında, sunucu tarafında veya her iki tarafta gerekli. Bir arayüz modu çoğunlukla yalnızca istemciye aittir; ortak bir oynanış modu ise tüm katılımcılar için uyumlu bileşenlere ihtiyaç duyar. Bir mod yöneticisi istemci profilini dağıtıyorsa, bu otomatik olarak doğru Dedicated Server bileşimini de aktarmaz.
Alternatif olarak r2modman kullanabilirsin:
- r2modman kur.
- Oyun olarak "Valheim" seç.
- Modlara göz at ve tek tıkla kur.
- Modpack'ini kod olarak dışa aktar → Arkadaşlarınla paylaş.
Bir mod yöneticisinin pratik avantajı eşitlemededir: Tüm oyuncular DLL'leri elle toplamak yerine aynı profili kullanabilir. Yine de güncellemelerden sonra dikkatli olmalısın. Güncellenmiş bir istemci modu, daha eski bir sunucu moduyla uyumsuz olabilir. Bu yüzden modpack'i ne zaman değiştirdiğini ve hangi sürümlerin aktif olduğunu not al.
Önerilen Modlar
Aşağıdaki tablo yaygın örnekleri gösterir; kurulumdan önce her modun güncelliğini ve bağımlılıklarını kontrol et. Bu bir performans taahhüdü değildir ve ilgili mod sayfasında uyumluluk, güncellik ve gerekli bağımlılıkların kontrolünün yerine geçmez.
| Mod | Açıklama | İstemci gerekli mi? |
|---|---|---|
| ValheimPlus | Kapsamlı ayarlamalar | Evet |
| Better UI | Geliştirilmiş kullanıcı arayüzü | Evet |
| Plant Everything | Her yere ekim yap | Evet |
| Epic Loot | Özellikli nadir eşyalar | Evet |
| Better Wards | Geliştirilmiş koruma taşları | Evet |
Sonucu Kontrol Etme
Kurulumdan sonra sunucu çökmeden başlamalı. Önce BepInEx'in logda yüklenip yüklenmediğini ve eksik bağımlılıklar, yanlış sürümler veya bulunamayan DLL'ler hakkında hata mesajları çıkıp çıkmadığını kontrol et. Ardından aynı mod seçimini kullanan bir istemciyle test et.
Oyunda, kurulu her modun bir işlevini hedefli olarak kontrol etmelisin: Arayüz değişikliği görünür, yeni yapılandırma seçeneği etkili, yeni eşya mevcut veya beklenen davranış aktif. Her şey çalışıyorsa, çalışan mod listesini ve en önemli yapılandırma dosyalarını yedekle. Böylece sonraki değişiklikleri izleyebilir veya sorun olduğunda geri alabilirsin.
Sorun Giderme
Mod çalışmıyor
Önce BepInEx sürümünü, mod sürümünü ve mod uyumluluğunu kontrol et. Ayrıca DLL'in gerçekten BepInEx/plugins/ içinde olup olmadığını, yanlışlıkla iki kez çıkarılmış bir alt klasörde olmadığını kontrol et. Thunderstore'daki mod sayfasını oku, çünkü birçok mod ek bağımlılıklara ihtiyaç duyar.
Sunucu çöküyor
Sorumluyu bulmak için modları tek tek kaldır. En son kurulan veya en son güncellenen modla başla. Her değişiklikten sonra sunucuyu yeniden başlat ve logu kontrol et. Sunucu modsuz başlıyor ama belirli bir modla çöküyorsa, neden çoğunlukla bir bağımlılık, sürüm veya yapılandırmadır.
Desync veya bağlantı sorunları
Tüm oyuncuların aynı modlara uygun sürümlerde sahip olduğundan emin ol. Özellikle istemcide zorunlu olan modlarda yalnızca sunucuyu değiştirmek yetmez. Dışa aktarılmış bir r2modman veya Thunderstore profili sapmaları azaltır ve destek vakalarını daha kolay takip edilebilir kılar.
Config oluşturulmuyor
Sunucuyu kurulu BepInEx ve ilgili modla bir kez başlat. Birçok mod yapılandırmasını ancak ilk başarılı yüklemede yazar. Ardından hiçbir dosya görünmüyorsa, mod belki yüklenmedi, yanlış klasörde duruyor ya da mevcut ortamla uyumlu değil.
FAQ
BepInEx hem sunucuya hem istemciye kurulmalı mı?
Birçok Valheim modu için evet. Bir mod istemcide zorunluysa, sunucu ve oyuncular aynı veya uyumlu sürüme ihtiyaç duyar. Bunu her zaman ilgili mod sayfasında kontrol et.
Valheim modlarını sadece Thunderstore üzerinden mi kurabilirim?
Hayır, DLL'leri elle BepInEx/plugins/ içine de koyabilirsin. Thunderstore Mod Manager ve r2modman ise sürüm eşitlemeyi ve oyunculara dağıtımı kolaylaştırır.
Sunucum bir moddan sonra neden artık başlamıyor?
Sık nedenler yanlış BepInEx sürümleri, eksik bağımlılıklar, uyumsuz mod sürümleri veya yanlış klasördeki dosyalardır. Modları adım adım kaldır ve her yeniden başlatmadan sonra logu kontrol et.
Modların yapılandırmaları nerede?
Birçok BepInEx modu yapılandırmasını BepInEx/config/ içinde oluşturur. Dosyalar çoğunlukla ancak modun kurulu olduğu ilk başarılı sunucu başlatmasından sonra görünür.
Tüm modları aynı anda mı kurmalıyım?
Daha iyisi kurma. Modları sırayla veya küçük gruplar halinde kur, böylece hataları net şekilde ilişkilendirebilirsin. Sunucu çöktüğünde veya istemciler bağlanamadığında bu zaman kazandırır.
