Come installare le mod di Valheim su Mac, native su Apple Silicon senza Rosetta

Valheim funziona nativamente sui Mac Apple Silicon, e anche le sue mod possono farlo. I gestori usati su Windows non funzionano su macOS: su Mac, quindi, installi manualmente il caricatore di mod una sola volta, assegni a Valheim un’opzione di avvio in Steam e metti ogni mod in una cartella. Da quel momento Valheim parte da Steam come al solito, con tutte le mod aggiunte.

Quali gestori di mod funzionano su Mac?

Nessuno di quelli abituali.

Le mod sono gli stessi file su tutti i sistemi, quindi un Mac usa gli stessi download dei giocatori Windows. Thunderstore, dove viene pubblicata la maggior parte delle mod di Valheim, offre un pulsante Download su ogni pagina che fornisce lo stesso ZIP installato da un gestore. Anche Nexus Mods e CurseForge ospitano mod di Valheim, i cui file vanno nelle stesse cartelle.

Perché il normale BepInEx non funziona su Apple Silicon?

Le mod di Valheim usano il caricatore BepInEx. BepInEx Pack Valheim, la copia installata da ogni gestore, contiene una libreria Mac solo per processori Intel. La versione ufficiale BepInEx 5.4.23.5 si carica sui Mac con chip M, ma si ferma prima di caricare qualsiasi mod: macOS non consente di modificare il codice del gioco in memoria come su Windows. Eseguire Valheim con Rosetta aggira il problema, ma riduce la velocità.

BepInEx ha corretto il problema nel codice sorgente, insieme alla libreria di caricamento da cui si avvia, ma nessuna delle due correzioni è ancora inclusa in una versione ordinaria. Il pacchetto qui sotto è BepInEx compilato da quel codice, con la libreria corretta e configurato per Valheim. Funziona su Apple Silicon senza Rosetta.

Come installo BepInEx per Valheim su Mac?

1. Chiudi Valheim.
2. Scarica BepInEx_macos_valheim_5.4.23.5-01fd4aa.zip. La somma SHA-256 è in SHA256SUMS.txt.
3. Apri Terminale ed estrai il pacchetto nella cartella di Valheim:

cd "$HOME/Library/Application Support/Steam/steamapps/common/Valheim"
unzip -o ~/Downloads/BepInEx_macos_valheim_5.4.23.5-01fd4aa.zip

4. Nella stessa finestra di Terminale, stampa l’opzione di avvio per il tuo Mac e copia la riga visualizzata:

echo "\"$PWD/run_bepinex.sh\" %command%"

5. Nella libreria Steam, fai clic destro su Valheim, scegli Proprietà e incolla la riga nelle Opzioni di avvio, nella pagina Generali.
6. Avvia Valheim da Steam. Il menu principale mostra «Stai giocando con una versione modificata di Valheim.» in basso a destra e la cartella di Valheim contiene ora BepInEx/LogOutput.log, il registro del caricatore.

Se la libreria Steam è su un’altra unità, apri invece la cartella di Valheim da Steam: clic destro su Valheim, Gestisci, poi Sfoglia i file locali. In quella finestra del Finder premi ⌘↑ per salire di un livello, quindi trascina la cartella Valheim sull’icona di Terminale nel Dock. Si apre una finestra di Terminale in quella cartella; continua con la riga unzip, senza la riga cd.

Senza Terminale: apri lo ZIP, che crea una cartella con lo stesso nome, e sposta il suo contenuto nella cartella di Valheim, accanto a valheim.app. Digita poi l’opzione di avvio: il percorso completo di run_bepinex.sh tra virgolette doppie, seguito da %command%. Nella libreria Steam predefinita il percorso inizia con /Users/ e il tuo nome utente; ~ non funziona in quel campo.

Dopo l’installazione, la cartella di Valheim contiene:

Come aggiungo una mod?

1. Scarica la mod. Su Thunderstore, premi Download nella sua pagina.
2. Apri lo ZIP. Uno ZIP di Thunderstore contiene manifest.json, README.md, icon.png e i file della mod.
3. In BepInEx/plugins, crea una cartella per la mod, per esempio BepInEx/plugins/ValheimModding-Jotunn, e sposta lì il contenuto dello ZIP. Se lo ZIP contiene una cartella plugins, sposta invece il contenuto di quella cartella. Una cartella config nello ZIP va in BepInEx/config.
4. Installa le dipendenze della mod. La pagina Thunderstore elenca le mod richieste: aggiungile nello stesso modo. Salta BepInEx Pack Valheim: il pacchetto sopra ne prende il posto.
5. Avvia Valheim. BepInEx/LogOutput.log elenca ogni mod caricata, con una riga Loading [...] per ciascuna.

Queste mod si sono caricate nativamente su un Mac Apple Silicon con questo pacchetto: Jotunn, VNEI, YamlDotNet, Zen.ModLib, ZenSign, PlantEasily, Valheim Configuration Manager, Runic Clock, Auto Stash, LiveExperienceTracker, Remember Server Password, Craft Me Once, Live Seed Map.

Le impostazioni di una mod sono in BepInEx/config, in un file .cfg che porta il nome della mod, dopo che Valheim è stato avviato con essa.

Come gioco senza mod?

Cancella l’opzione di avvio in Steam e Valheim partirà senza BepInEx; i file restano al loro posto per la prossima volta. Per rimuovere una sola mod, elimina la sua cartella da BepInEx/plugins.

Esempio: installare la mod Live Seed Map

Live Seed Map mostra la partita in corso sulla mappa del seme: dove ti trovi, le creature vicine, i segnaposto e i portali. Può anche segnalare nel gioco qualsiasi luogo della mappa.

1. Scarica LiveSeedMap-1.4.0.zip.
2. Estrailo nella cartella di Valheim. Questo ZIP è già organizzato per BepInEx, quindi la mod finisce in BepInEx/plugins/LiveSeedMap:

cd "$HOME/Library/Application Support/Steam/steamapps/common/Valheim"
unzip -o ~/Downloads/LiveSeedMap-1.4.0.zip

3. Avvia Valheim da Steam. BepInEx/LogOutput.log contiene ora le righe Loading [Live Seed Map 1.4.0] e Listening on http://127.0.0.1:45892.
4. Carica il tuo mondo oppure entra nel server.
5. Apri la mappa del seme in Chrome o Edge e premi Collega il gioco. Quando il browser chiede se la pagina può accedere alle app su questo dispositivo, consenti l’accesso.
6. Se la mappa mostra un seme diverso, premi Apri la sua mappa.

Tutto ciò che la mod mostra e fa, insieme alle impostazioni, si trova nella guida Live Seed Map.

E se le mod non si caricano?

• Nessun avviso di versione modificata nel menu principale e nessun LogOutput.log: controlla l’opzione di avvio. Deve contenere il percorso completo di run_bepinex.sh tra virgolette doppie, seguito da %command%.
• Un file chiamato preloader_ seguito da una data e terminante in .log, accanto a run_bepinex.sh o dentro valheim.app/Contents/MacOS: BepInEx si è fermato prima di caricare le mod. È ciò che fanno su Apple Silicon la versione ufficiale 5.4.23.5 e i file BepInEx di BepInEx Pack Valheim. Estrai di nuovo il pacchetto sopra sovrascrivendoli ed elimina il registro dentro valheim.app: l’app è firmata e aggiungere un file al suo interno invalida la firma.
• Could not load [...] because it has missing dependencies in LogOutput.log: installa le mod indicate nella riga.
• Una mod funziona male nel gioco: i suoi messaggi sono in BepInEx/LogOutput.log; quelli del gioco in ~/Library/Logs/IronGate/Valheim/Player.log.

Se giochi con altri, il server e gli altri giocatori devono avere le stesse versioni di tutte le mod che modificano il mondo, indipendentemente dal computer usato.