Con BepInEx puoi estendere i server Valheim con mod, se file del server, mod del client e versioni combaciano correttamente. Il punto decisivo non è solo copiare una DLL, ma seguire una procedura controllata: installare il framework, avviare il server una volta, aggiungere le mod in modo mirato, allineare i client e circoscrivere gli errori tramite log o disattivazione graduale.
Cosa fa BepInEx in Valheim
BepInEx è un framework per mod per giochi Unity. Per Valheim si usa spesso BepInExPack Valheim, disponibile su Thunderstore: documentazione su thunderstore.io. Questa pagina di progetto è la fonte primaria per il pacchetto Valheim-BepInEx citato in modo specifico.
BepInEx prepara le cartelle in cui le mod di Valheim vengono caricate e configurate. Molte mod sono composte da uno o più file DLL che devono trovarsi in BepInEx/plugins/. Dopo il primo avvio del server, di solito vengono creati file di configurazione aggiuntivi in BepInEx/config/. Modifica questi file solo dopo che il server è stato avviato almeno una volta con il framework installato.
Se oltre alle mod vuoi pianificare bene anche basi del server, configurazione e progressione dei boss, può esserti utile anche la guida interna Noleggiare un server Valheim: mod, configurazione e ordine dei boss 2026. Per altri setup Unity o con framework di mod, è utile anche il confronto con Installare mod server di V Rising con BepInEx.
Prerequisiti
Prima di iniziare, ti servono accesso alla directory del server Valheim, la possibilità di riavviare il server e una lista chiara delle mod. Con un hosting multi-game a pagamento come game-serverhosting è particolarmente importante applicare le modifiche in modo tracciabile: prima backup, poi framework, poi singole mod, quindi verifica. Così mantieni controllo tecnico, supportabilità e procedure operative trasparenti.
Stabilisci inoltre quali mod funzionano solo lato server e quali ogni giocatore deve installare localmente. Molte mod di Valheim richiedono componenti corrispondenti su server e client; fa fede l’indicazione sulla relativa pagina della mod. Controlla quindi la descrizione Thunderstore di ogni mod prima di inserirla in un modpack condiviso.
Installare BepInEx sul server
- Scarica BepInEx da Thunderstore.
- Estrai il contenuto nella directory del server Valheim.
- Riavvia il server. BepInEx crea automaticamente le cartelle di configurazione.
La struttura di destinazione dovrebbe poi apparire così:
/valheim/
├── BepInEx/
│ ├── config/ # Configurazioni delle mod
│ ├── plugins/ # Inserisci qui le mod
│ └── patchers/
├── valheim_server.x86_64
└── start_server.sh
È importante il livello della cartella: BepInEx/ va direttamente nella directory del server Valheim, non in una sottocartella aggiuntiva proveniente dall’archivio ZIP. Se dopo il riavvio non compare alcuna struttura config o plugins, spesso l’errore è proprio lì.
Installare le mod
- Scarica le mod da Thunderstore.
- Estrai il file DLL nella cartella
BepInEx/plugins/. - Riavvia il server.
Non installare nuove mod alla cieca in pacchetti grandi. È più sensato procedere in modo controllato: aggiungi una mod, avvia il server, controlla il log, testa la connessione, poi installa la mod successiva. Con più giocatori dovresti documentare la lista delle mod con i numeri di versione, così tutti usano la stessa base.
Se una mod include file aggiuntivi o cartelle proprie, segui le istruzioni della relativa mod. Non tutte le mod sono composte solo da una singola DLL. Non spostare arbitrariamente file di configurazione tra plugins e config; BepInEx e la mod stessa si aspettano percorsi specifici.
Allineare le mod del client
La maggior parte delle mod di Valheim deve essere installata sia sul server sia sul client. Usa il Thunderstore Mod Manager per un’installazione semplice sul client.
In alternativa puoi usare r2modman:
- Installa r2modman.
- Seleziona "Valheim" come gioco.
- Cerca e installa le mod con un clic.
- Esporta il tuo modpack come codice → Condividilo con gli amici.
Il vantaggio pratico di un mod manager sta nell’allineamento: tutti i giocatori possono usare lo stesso profilo invece di cercare DLL manualmente. Tuttavia, dopo gli aggiornamenti dovresti restare prudente. Una mod client aggiornata può essere incompatibile con una mod server più vecchia. Annota quindi quando hai modificato il modpack e quali versioni sono attive.
Mod consigliate
La tabella seguente mostra esempi diffusi; prima dell’installazione controlla ogni mod per attualità e dipendenze. Non è una garanzia di prestazioni e non sostituisce la verifica della relativa pagina della mod per compatibilità, aggiornamento e dipendenze richieste.
| Mod | Descrizione | Client necessario? |
|---|---|---|
| ValheimPlus | Ampie personalizzazioni | Sì |
| Better UI | Interfaccia utente migliorata | Sì |
| Plant Everything | Piantare ovunque | Sì |
| Epic Loot | Oggetti rari con proprietà | Sì |
| Better Wards | Pietre di protezione migliorate | Sì |
Verificare il risultato
Dopo l’installazione, il server dovrebbe avviarsi senza crash. Controlla prima se BepInEx viene caricato nel log e se compaiono messaggi di errore su dipendenze mancanti, versioni errate o DLL non trovate. Poi esegui un test con un client che usa la stessa selezione di mod.
Nel gioco dovresti verificare in modo mirato una funzione di ogni mod installata: modifica dell’interfaccia visibile, nuova opzione di configurazione attiva, nuovo oggetto presente o comportamento previsto funzionante. Se tutto funziona, salva la lista delle mod funzionante e i file di configurazione più importanti. Così potrai ricostruire modifiche successive o tornare indietro in caso di problemi.
Troubleshooting
La mod non funziona
Controlla prima versione di BepInEx, versione della mod e compatibilità della mod. Verifica inoltre che la DLL si trovi davvero in BepInEx/plugins/ e non per sbaglio in una sottocartella estratta due volte. Leggi la pagina della mod su Thunderstore, perché molte mod richiedono dipendenze aggiuntive.
Il server è crashato
Rimuovi le mod una alla volta per trovare la causa. Inizia dall’ultima mod installata o aggiornata. Riavvia il server dopo ogni modifica e controlla il log. Se il server parte senza mod, ma crasha con una mod specifica, di solito la causa è una dipendenza, una versione o una configurazione.
Desync o problemi di connessione
Assicurati che tutti i giocatori abbiano le stesse mod in versioni compatibili. Soprattutto con mod obbligatorie lato client, non basta modificare solo il server. Un profilo r2modman o Thunderstore esportato riduce le differenze e rende i casi di supporto più facili da ricostruire.
La configurazione non viene creata
Avvia il server una volta con BepInEx installato e con la relativa mod. Molte mod scrivono la propria configurazione solo al primo caricamento riuscito. Se dopo non compare alcun file, la mod potrebbe non essere stata caricata, trovarsi nella cartella sbagliata o non essere compatibile con l’ambiente attuale.
Verifica, limiti e ritorno sicuro
La guida “Installare mod di Valheim con BepInEx – passo dopo passo” vale per il tipo di server descritto nell’articolo e per lo stato delle versioni visibile al momento della verifica. Nomi dei menu, versioni disponibili, compatibilità di mod o plugin e risorse richieste possono cambiare dopo gli aggiornamenti. Non trasferire quindi valori a un’altra versione di gioco, loader o server senza verificarli.
Prima di modificare mondo, salvataggio, configurazione o estensioni, crea un backup dei file interessati. Poi modifica solo un passaggio coerente alla volta e verificalo con la stessa versione di client e server con cui vuoi giocare in seguito.
| Punto di verifica | Risultato atteso | Interruzione e ritorno |
|---|---|---|
| Avvio del server | Il server raggiunge lo stato operativo senza nuovi messaggi di errore. | In caso di errori di avvio, annulla la modifica e ripristina l’ultimo backup. |
| Test di connessione | Un account di test può connettersi tramite l’indirizzo mostrato nel pannello. | In caso di errori di versione o connessione, riallinea versione, porta e autorizzazioni. |
| Test funzionale | La funzione modificata nello specifico lavora senza danneggiare dati esistenti del mondo o del gioco. | In caso di effetti collaterali, ferma il server e ripristina i file salvati. |
Un singolo test riuscito non è una garanzia di prestazioni o disponibilità. Dimensione del mondo, mod, plugin, numero di giocatori, percorso di rete e carico simultaneo possono modificare il risultato. Documenta versione, modifica e risultato del test, così potrai ricostruire eventuali differenze successive.
FAQ
BepInEx deve essere installato su server e client?
Per molte mod di Valheim sì. Se una mod è obbligatoria lato client, server e giocatori hanno bisogno della stessa versione o di una compatibile. Controllalo sempre sulla relativa pagina della mod.
Posso installare le mod di Valheim solo tramite Thunderstore?
No, puoi anche inserire manualmente le DLL in BepInEx/plugins/. Thunderstore Mod Manager e r2modman però semplificano l’allineamento delle versioni e la distribuzione ai compagni di gioco.
Perché il mio server non parte più dopo una mod?
Cause frequenti sono versioni errate di BepInEx, dipendenze mancanti, versioni di mod incompatibili o file nella cartella sbagliata. Rimuovi le mod gradualmente e controlla il log dopo ogni riavvio.
Dove si trovano le configurazioni delle mod?
Molte mod BepInEx creano la propria configurazione in BepInEx/config/. I file spesso compaiono solo dopo il primo avvio riuscito del server con la mod installata.
Dovrei installare tutte le mod contemporaneamente?
Meglio di no. Installa le mod una dopo l’altra o in piccoli gruppi, così puoi associare gli errori in modo chiaro. Questo fa risparmiare tempo se il server crasha o i client non riescono a connettersi.