Valheimissa ei ole omaa moditukea. Kaikki, mitä yhteisö rakentaa, lepää BepInEx:n päällä. Se on lataaja, joka kiinnittyy peliin ennen sen käynnistymistä, ja vuokratulla palvelimella yksi ainoa asia ratkaisee, toimivatko modisi: kumpaa palvelimen kahdesta kokoonpanosta ajat. Jos valinta on väärä, paneeli listaa moditiedostosi kiltisti samalla kun peli sivuuttaa jokaisen niistä.
Vanilla vai BepInEx: kokoonpano ratkaisee kaiken
Valheim-palvelimesi pyörii jommallakummalla kahdesta kokoonpanosta, ja jokainen uusi palvelin luodaan vanilla-versiona.
- Vanilla on paljas dedicated-palvelin. Ei lataajaa, ei plugineja, ei paikkauksia.
- BepInEx on sama peli, jossa lataaja injektoidaan käynnistyksessä parilla käynnistysmuuttujalla (
DOORSTOP_ENABLEDjaLD_PRELOAD), joita vanilla-kokoonpanossa ei ole.
Moditiedosto vanilla-palvelimella ei tee mitään, ja se epäonnistuu äänettömästi. Kansio BepInEx/plugins on olemassa kummassakin tapauksessa, Files-välilehti listaa kaiken mitä sinne laitat, ja palvelin käynnistyy aivan normaalisti. Ei virhettä, ei varoitusta, ei punaista tekstiä missään. Pluginia ei yksinkertaisesti koskaan ladata, koska mikään ei ole lataamassa sitä. Juuri tämä mekanismi on useimpien Valheim-yhteydenottojen taustalla, joissa modi on asennettu mutta mitään ei tapahdu.
Vaihtoa ei tarvitse hoitaa itse. Mods-välilehti tekee sen osana ensimmäistä asennustasi.
Kaikkeen ei muuten tarvita modia. Esimerkiksi droprateille on oma ohjeensa.
Modin asentaminen Mods-välilehdeltä
Avaa palvelimesi DoomHostingin hallintapaneelissa ja mene kohtaan Mods. Thunderstore-luettelo on rakennettu välilehteen, joten haet pakettia nimellä sen sijaan että lataisit zip-tiedostoja ja siirtäisit niitä SFTP:llä.
Etsi modi ja klikkaa Install. Paneeli hakee paketin suoraan Thunderstoresta omaan kansioonsa polkuun BepInEx/plugins, joten modit eivät koskaan ylikirjoita toisiaan, ja se asentaa mukana paketin ilmoittamat riippuvuudet. Jotunn, kirjasto jota vasten iso osa Valheim-modeista on rakennettu, tulee yleensä mukana tätä kautta ilman että pyydät sitä.
Jos palvelimesi on yhä vanilla-kokoonpanossa, vaihto tapahtuu tässä. Asennus tarjoutuu ensin siirtämään sinut BepInEx:ään:
Vahvista, ja paneeli hoitaa loput. Se muistaa, minkä modin valitsit, asentaa palvelimen uudelleen BepInEx-kokoonpanoon ja tarjoaa asennusta uudelleen heti kun palvelin on takaisin. Vain palvelintiedostot vaihdetaan, joten maailmasi ja asetustiedostosi säilyvät, mutta ota tarjottu varmuuskopio. Uudelleenasennus vie muutaman minuutin.
Yksi asia tarkistettavaksi jälkeenpäin: BepInEx-kokoonpano toimitetaan crossplay pois päältä, vanilla puolestaan crossplay päällä. Jos palvelimellasi pelaa konsolipelaajia, kytke crossplay takaisin päälle vaihdon jälkeen. Se toimii modien rinnalla hyvin, ja alempi osio näyttää todisteen.
Kun asennus on valmis, modi ilmestyy asennettujen modien listalle:
Varmista, että modi todella latautui
Merkintä asennettujen modien listalla tarkoittaa, että tiedostot ovat levyllä, ei sitä että peli olisi ladannut ne. Konsoli on ainoa luotettava vahvistus.
Käynnistä palvelin, avaa Console-välilehti ja etsi BepInEx:n chainloader-lohko. Tämä on aito käynnistys testipalvelimeltamme:
[Message: BepInEx] Chainloader started
[Info : BepInEx] 3 plugins to load
[Info : BepInEx] Loading [MaxPlayerCount 1.2.4]
[Info : BepInEx] Loading [Jotunn 2.28.0]
[Message: BepInEx] Chainloader startup complete
Sieltä luetaan kaksi asiaa. Chainloader started todistaa, että palvelin ylipäätään on BepInEx-kokoonpanossa: jos chainloader-rivejä ei ole, lataajaa ei ole, sanoi asennettujen modien lista mitä tahansa. Sen jälkeen jokainen latautuva plugin saa oman Loading [Nimi versio] -rivinsä. Jos modillasi on rivi, se on käynnissä. Jos riviä ei ole, se ei ole käynnissä, ja syy löytyy yleensä muutamaa riviä alempaa.
Modin asetukset ensimmäisen käynnistyksen jälkeen
Tämä on se vaihe, joka lähettää ihmiset etsimään tiedostoa jota ei vielä ole.
BepInEx kirjoittaa pluginin asetustiedoston ensimmäisellä käynnistyksellä, jossa plugin on ladattuna, ei asennushetkellä. Heti asennuksen jälkeen asetustiedostoa ei ole, eikä paneeli siksi näytä kyseiselle modille Settings-painiketta. Käynnistä palvelin kerran, anna sen nousta kokonaan pystyyn, ja tiedosto ilmestyy tänne:
BepInEx/config/<Author>.<PluginName>.cfg
Siitä eteenpäin modin Settings-painike avaa tuosta tiedostosta rakennetun lomakkeen, ja Files-välilehdellä sitä voi muokata suoraan. Jokaisen asetuksen yläpuolella olevat #-rivit ovat dokumentaatio: tyyppi, oletusarvo, sallitut arvot ja se vaihteluväli jonka plugin hyväksyy. Asetukset luetaan pluginin latautuessa, joten käynnistä palvelin uudelleen muutoksen jälkeen. Pelkkä tallennus ei tee mitään.
Läpikäyty esimerkki on näin nostat Valheim-palvelimen pelaajarajaa. MaxPlayerCount toimii pelkästään palvelimella, joten kukaan liittyvä ei asenna mitään, ja koko työ on yksi luku yhdessä asetustiedostossa.
Crossplay ja modit toimivat yhdessä
Törmäät oppaisiin, joiden mukaan crossplayn kytkeminen päälle sammuttaa BepInEx:n. Se ei sammuta. Tässä on käynnistys omalta testipalvelimeltamme crossplay päällä ja modit ladattuina:
[Info : BepInEx] Loading [MaxPlayerCount 1.2.4]
[Message: BepInEx] Chainloader startup complete
[Info :MaxPlayerCount] Patching for backend: PlayFab
[Info : Unity Log] Logged in PlayFab user via custom ID
Crossplay vaihtaa Valheimin verkkoliikenteen Steamista PlayFabiin. BepInEx latautui sen rinnalla aivan normaalisti, ja MaxPlayerCount tunnisti PlayFab-taustajärjestelmän ja paikkasi sitä varten.
Rehellinen versio: BepInEx:llä itsellään ei ole crossplayn kanssa mitään ongelmaa. Yksittäisen modin, joka koskee verkkokerrokseen, on osattava käsitellä PlayFab-taustajärjestelmä, ja ylläpidetty modi osaa. Tämä ei ole takuu jokaisesta Thunderstoren paketista, mutta se ei ole myöskään syy sammuttaa crossplayta ennen kuin olet testannut oman listasi.
Mitä tapahtuu kun Valheim päivittyy
Modit hajoavat pelin päivityksissä. Se on normaalia eikä vika palvelimessasi, ja ratkaisu on lähes aina modin uudempi versio.
Päivittäminen ei ole erillinen työ: AUTO_UPDATE on oletuksena päällä, joten palvelimen uudelleenkäynnistys päivittää pelin. Yksityiskohdat löytyvät ohjeesta Valheim-palvelimen päivittäminen. Kun modi hajoaa, konsoli nimeää sen, ja paneeli tunnistaa nuo rivit automaattisesti ja tarjoaa korjauksen, mikä käydään läpi ohjeessa yleiset Valheim-palvelinongelmat ja ratkaisut.
Kirjoitushetkellä (syyskuu 2026) kannattaa tietää tämä: Iron Gate ei julkaissut julkista testibranchia ennen Valheim 1.0:aa, joten yksikään modin tekijä ei voinut kääntää modiaan lopullista versiota vasten etukäteen. Rikkoutumisaalto heti tällaisen julkaisun jälkeen on odotettavissa, ja korjaukset saapuvat seuraavien päivien aikana.
Yleisiä ongelmia
Modi on asennettu mutta mitään ei tapahdu, ja konsoli on siisti. Jos chainloader-rivejä ei ole, palvelin on yhä vanilla-kokoonpanossa. Avaa Mods-välilehti ja katso, kumpi kokoonpano kantaa Active-merkintää.
Could not load [X] because it has missing dependencies: ... Kaksoispisteen jälkeen nimettyä pakettia ei ole asennettu. Hae sitä nimeä Mods-välilehdeltä, asenna se ja käynnistä palvelin uudelleen. Palvelin käynnistyy tässä tilassa hyvin, ja juuri siksi modi näyttää kunnossa olevalta eikä tee mitään.
Error loading [X] : ... tai Could not load [X] because it is incompatible with: ... Modi kaatui latauksessa tai kieltäytyy toimimasta toisen listallasi olevan modin rinnalla. Pelin päivityksen jälkeen ensimmäinen tarkoittaa yleensä, ettei modia ole vielä käännetty uudelleen. Katso sen Thunderstore-sivulta uudempi versio ja poista se siihen asti.
Konsoli on täynnä pelottavan näköisiä varoituksia. Modattu palvelin tulostaa runsaasti kohinaa käynnistyessään täysin oikein. Yllä olevat [Error : BepInEx] -rivit ovat ne, joilla on merkitystä.
Out of memory: true. Tämä rivi tulee daemonilta eikä pelistä: palvelin osui muistirajaansa ja prosessi tapettiin. Modit lisäävät muistinkulutusta, osa niistä reilusti. Paneeli tunnistaa juuri tämän automaattisesti ja tarjoaa korjauksen.
Yhdelle modilleni ei ole Settings-painiketta. Palvelin ei ole vielä käynnistynyt kyseinen plugin ladattuna, joten asetustiedostoa ei ole. Käynnistä palvelin kerran.
Modit eivät antaneet minulle huijauskomentoja. Niiden ei ollutkaan tarkoitus. devcommands, spawn ja kaikki niiden takana eivät toimi dedicated-palvelimella, ja admin-oikeudet antavat vain komennot kick, ban, unban, banned, save, setworldmodifier ja setworldpreset, eikä yhdessäkään ole kauttaviivaa edessä. Koko lista on Valheim-komentolistassamme.
Kaikki saavat liittyessään version mismatch -virheen. Yksi modeistasi on client-side, joten jokaisella pelaajalla on oltava sama versio asennettuna. Pelkästään palvelimella toimivat modit, kuten MaxPlayerCount, eivät aiheuta tätä koskaan, ja jokaisen modin Thunderstore-sivu kertoo kumpaa lajia se on.
Suunnitteletko raskaasti modattua maailmaa? Valheim-palvelimemme pyörivät Ryzen 9 -laitteistolla, BepInEx-kokoonpano ja Thunderstore-asennukset ovat valmiina paneelissa, joten koko yllä kuvattu prosessi on muutama klikkaus eikä SFTP-istunto.
