BepInEx ile Valheim sunucularını modlarla genişletebilirsin; bunun için sunucu dosyalarının, istemci modlarının ve sürümlerin temiz şekilde birbiriyle uyumlu olması gerekir. Önemli olan yalnızca bir DLL dosyasını kopyalamak değildir; kontrollü bir akış gerekir: framework'ü kur, sunucuyu bir kez başlat, modları hedefli şekilde ekle, istemcileri eşleştir ve hataları loglar ya da adım adım devre dışı bırakma yoluyla daralt.
BepInEx Valheim'da ne yapar
BepInEx, Unity oyunları için bir mod framework'üdür. Valheim için sıkça Thunderstore'da sunulan BepInExPack Valheim kullanılır: thunderstore.io dokümantasyonu. Bu proje sayfası, burada özellikle 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 kurulu framework ile en az bir kez başlatıldıktan sonra değiştir.
Modların yanında sunucu temellerini, yapılandırmayı ve boss ilerlemesini de temiz şekilde planlamak istiyorsan, ek olarak dahili rehber Valheim Server mieten: Mods, Konfiguration & Boss-Reihenfolge 2026 uygundur. Diğer Unity veya mod framework kurulumları için ayrıca V Rising Mods mit BepInEx Server Mods installieren karşılaştırması yardımcı olur.
Gereksinimler
Başlamadan önce Valheim sunucu dizinine erişime, sunucuyu yeniden başlatma imkanına ve net bir mod listesine ihtiyacın var. game-serverhosting gibi ücretli bir multi-game hosting ortamında değişiklikleri izlenebilir şekilde uygulaman özellikle önemlidir: önce yedek, sonra framework, sonra tek tek modlar, ardından kontrol. Böylece teknik kontrol, desteklenebilirlik ve şeffaf işletim süreçleri korunur.
Ayrıca hangi modların yalnızca sunucu tarafında çalışacağını ve hangilerinin her oyuncu tarafından yerel olarak kurulması gerektiğini belirle. Birçok Valheim modu, sunucu ve istemcide uyumlu bileşenlere ihtiyaç duyar; belirleyici olan ilgili mod sayfasındaki işarettir. Bu yüzden her modu ortak bir modpack'e eklemeden önce ilgili Thunderstore açıklamasını kontrol et.
BepInEx'i sunucuya kurma
- BepInEx'i Thunderstore üzerinden indir.
- İçeriği Valheim sunucu dizinine çıkar.
- Sunucuyu yeniden başlat. BepInEx config klasörlerini otomatik olarak oluşturur.
Hedef yapı sonrasında şöyle görünmelidir:
/valheim/
├── BepInEx/
│ ├── config/ # Mod yapılandırmaları
│ ├── plugins/ # Modları buraya koy
│ └── patchers/
├── valheim_server.x86_64
└── start_server.sh
Önemli olan seviye: BepInEx/ klasörü doğrudan Valheim sunucu dizinine aittir, ZIP arşivinden gelen ek bir alt klasörün içine değil. Yeniden başlatmadan sonra config veya plugins yapısı oluşmuyorsa, hata çoğu zaman tam olarak buradadır.
Modları kurma
- Modları Thunderstore üzerinden indir.
- DLL dosyasını
BepInEx/plugins/klasörüne çıkar. - Sunucuyu yeniden başlat.
Yeni modları büyük paketler halinde körlemesine kurma. Daha mantıklı olan kontrollü ilerlemektir: bir mod ekle, sunucuyu başlat, logu kontrol et, bağlantıyı test et, ardından sonraki modu kur. Birden fazla oyuncu varsa mod listesini sürüm numaralarıyla belgelemelisin, böylece herkes aynı temeli kullanır.
Bir mod ek dosyalar veya kendi klasörleriyle geliyorsa, ilgili mod talimatlarını izle. Her mod yalnızca tek bir DLL'den oluşmaz. Yapılandırma dosyalarını plugins ve config arasında keyfi olarak taşıma; BepInEx ve modun kendisi belirli yollar bekler.
İstemci modlarını eşleştirme
Çoğu Valheim modu hem sunucuda hem de istemcide kurulu olmalıdır. Kolay istemci kurulumu için Thunderstore Mod Manager kullan.
Alternatif olarak r2modman kullanabilirsin:
- r2modman kur.
- Oyun olarak "Valheim" seç.
- Modları tek tıkla ara ve kur.
- Modpack'ini kod olarak dışa aktar → Arkadaşlarınla paylaş.
Bir mod yöneticisinin pratik avantajı eşleştirmededir: Tüm oyuncular DLL'leri manuel olarak aramak yerine aynı profili kullanabilir. Yine de güncellemelerden sonra dikkatli kalmalı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 kaydet.
Önerilen modlar
Aşağıdaki tablo yaygın örnekleri gösterir; kurulumdan önce her modu güncellik ve bağımlılıklar açısından 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 yapma | Evet |
| Epic Loot | Özelliklere sahip nadir eşyalar | Evet |
| Better Wards | Geliştirilmiş koruma taşları | Evet |
Sonucu kontrol etme
Kurulumdan sonra sunucu çökmeden başlamalıdır. Ö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ı olup olmadığını kontrol et. Ardından aynı mod seçimini kullanan bir istemciyle test et.
Oyunda kurulu her modun bir işlevini özellikle kontrol etmelisin: UI değişikliği görünür mü, yeni yapılandırma seçeneği etkili mi, yeni eşya var mı veya beklenen davranış aktif mi. Her şey çalışıyorsa çalışan mod listesini ve en önemli config dosyalarını yedekle. Böylece daha sonraki değişiklikleri izleyebilir veya sorunlarda geri dönebilirsin.
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'nin gerçekten BepInEx/plugins/ içinde olup olmadığını ve yanlışlıkla iki kez çıkarılmış bir alt klasöre konmadığını denetle. Thunderstore'daki mod sayfasını oku, çünkü birçok mod ek bağımlılıklar gerektirir.
Sunucu çöktü
Sebebi 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, sebep çoğunlukla bir bağımlılık, sürüm veya yapılandırmadır.
Desync veya bağlantı sorunları
Tüm oyuncuların uygun sürümlerde aynı modlara sahip olduğundan emin ol. Özellikle istemci gerektiren modlarda yalnızca sunucuyu değiştirmek yeterli değildir. Dışa aktarılmış bir r2modman veya Thunderstore profili sapmaları azaltır ve destek vakalarını daha kolay izlenebilir hale getirir.
Config oluşturulmuyor
Sunucuyu kurulu BepInEx ve ilgili modla bir kez başlat. Birçok mod config dosyasını ancak ilk başarılı yüklemede yazar. Sonrasında dosya görünmüyorsa mod muhtemelen yüklenmemiştir, yanlış klasördedir veya mevcut ortamla uyumlu değildir.
Kontrol, sınırlar ve güvenli geri dönüş
“Valheim Modlarını BepInEx ile kurma – adım adım” rehberi, makalede açıklanan sunucu türü ve kontrol anında görünen sürüm durumu için geçerlidir. Menü adları, kullanılabilir sürümler, mod veya plugin uyumluluğu ve gerekli kaynaklar güncellemelerden sonra değişebilir. Bu yüzden değerleri kontrol etmeden başka bir oyun, loader veya sunucu sürümüne aktarma.
Dünya, kayıt dosyası, yapılandırma veya eklentiler üzerinde değişiklik yapmadan önce etkilenen dosyaların yedeğini oluştur. Ardından yalnızca birbiriyle ilişkili tek bir adımı değiştir ve daha sonra oynamak istediğin aynı istemci ve sunucu sürümüyle kontrol et.
| Kontrol noktası | Beklenen sonuç | İptal ve geri dönüş |
|---|---|---|
| Sunucu başlatma | Sunucu yeni hata mesajı olmadan çalışmaya hazır duruma ulaşır. | Başlatma hatalarında değişikliği geri al ve son yedeği yükle. |
| Bağlantı testi | Bir test hesabı panelde gösterilen adres üzerinden bağlanabilir. | Sürüm veya bağlantı hatalarında sürümü, portu ve izinleri yeniden eşleştir. |
| İşlev testi | Somut olarak değiştirilen işlev, mevcut dünya veya oyun verilerine zarar vermeden çalışır. | Yan etkilerde sunucuyu durdur ve yedeklenmiş dosyaları geri yükle. |
Başarılı bir tekil test performans veya erişilebilirlik garantisi değildir. Dünya boyutu, modlar, pluginler, oyuncu sayısı, ağ rotası ve eşzamanlı yük sonucu değiştirebilir. Sürümü, değişikliği ve test sonucunu belgele ki daha sonraki sapmaları izleyebilesin.
FAQ
BepInEx sunucu ve istemcide kurulu olmak zorunda mı?
Birçok Valheim modu için evet. Bir mod istemci gerektiriyorsa, sunucu ve oyuncular aynı veya uyumlu sürüme ihtiyaç duyar. Bunu her zaman ilgili mod sayfasında kontrol et.
Valheim modlarını yalnızca Thunderstore üzerinden mi kurabilirim?
Hayır, DLL'leri manuel olarak BepInEx/plugins/ içine de koyabilirsin. Ancak Thunderstore Mod Manager ve r2modman sürüm eşleştirmeyi ve takım arkadaşlarına dağıtımı kolaylaştırır.
Bir moddan sonra sunucum neden artık başlamıyor?
Yaygın sebepler 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 bulunur?
Birçok BepInEx modu yapılandırmasını BepInEx/config/ içinde oluşturur. Dosyalar çoğu zaman ancak kurulu modla ilk başarılı sunucu başlatmasından sonra görünür.
Tüm modları aynı anda kurmalı mıyım?
Bunu yapmaman daha iyi. Hataları net şekilde ilişkilendirebilmek için modları tek tek veya küçük gruplar halinde kur. Sunucu çökerse ya da istemciler bağlanamazsa bu zaman kazandırır.