Valheim-Mods auf dem Mac installieren: nativ auf Apple Silicon, ohne Rosetta

Valheim läuft nativ auf Macs mit Apple Silicon, und seine Mods können das ebenfalls. Die Mod-Manager der Windows-Spieler laufen nicht unter macOS. Auf dem Mac installierst du deshalb den Mod-Loader einmal manuell, trägst eine Startoption für Valheim in Steam ein und legst jede Mod in einen Ordner. Danach startet Valheim wie gewohnt über Steam, mit allen hinzugefügten Mods.

Welche Mod-Manager funktionieren auf dem Mac?

Keiner der üblichen.

Die Mods selbst bestehen auf allen Systemen aus denselben Dateien. Auf dem Mac verwendest du deshalb dieselben Downloads wie Windows-Spieler. Thunderstore, wo die meisten Valheim-Mods veröffentlicht werden, hat auf jeder Mod-Seite eine Schaltfläche Download. Sie liefert dieselbe ZIP-Datei, die ein Manager installieren würde. Auch Nexus Mods und CurseForge bieten Valheim-Mods; ihre Dateien kommen in dieselben Ordner.

Warum funktioniert das übliche BepInEx nicht auf Apple Silicon?

Valheim-Mods laufen mit dem Mod-Loader BepInEx. BepInEx Pack Valheim, die von jedem Mod-Manager installierte Variante, enthält eine Mac-Bibliothek nur für Intel-Prozessoren. Die offizielle Version BepInEx 5.4.23.5 startet auf einem Mac der M-Serie, stoppt aber vor dem Laden der ersten Mod: macOS erlaubt ihr nicht, den Spielcode im Arbeitsspeicher wie unter Windows zu verändern. Valheim unter Rosetta zu starten umgeht das, kostet aber Geschwindigkeit.

BepInEx hat das inzwischen im Quellcode behoben, ebenso in der Loader-Bibliothek, mit der es startet. Beide Korrekturen fehlen jedoch noch in einer regulären Veröffentlichung. Das Paket unten enthält BepInEx aus diesem Quellcode mit der korrigierten Loader-Bibliothek, für Valheim eingerichtet. Es läuft auf Apple Silicon ohne Rosetta.

Wie installiere ich BepInEx für Valheim auf dem Mac?

1. Beende Valheim.
2. Lade BepInEx_macos_valheim_5.4.23.5-01fd4aa.zip herunter. Die SHA-256-Prüfsumme steht in SHA256SUMS.txt.
3. Öffne Terminal und entpacke das Paket in den Valheim-Ordner:

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

4. Lass im selben Terminalfenster die Startoption für deinen Mac ausgeben und kopiere die ausgegebene Zeile:

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

5. Klicke in deiner Steam-Bibliothek mit der rechten Maustaste auf Valheim, wähle Eigenschaften und füge die Zeile auf der Seite „Allgemein“ unter Startoptionen ein.
6. Starte Valheim über Steam. Im Hauptmenü steht unten rechts „Du spielst eine modifizierte Version von Valheim.“, und im Valheim-Ordner liegt jetzt BepInEx/LogOutput.log, das Protokoll des Loaders.

Liegt deine Steam-Bibliothek auf einem anderen Laufwerk, öffne den Valheim-Ordner stattdessen über Steam: Rechtsklick auf Valheim, Verwalten, dann Lokale Dateien durchsuchen. Drücke in diesem Finderfenster ⌘↑, um eine Ebene nach oben zu gehen, und ziehe den Valheim-Ordner auf das Terminalsymbol im Dock. Ein Terminalfenster öffnet sich in diesem Ordner. Fahre dort mit der unzip-Zeile fort, ohne die cd-Zeile.

Ohne Terminal: Öffne die ZIP-Datei. Sie erzeugt einen gleichnamigen Ordner; verschiebe dessen Inhalt in den Valheim-Ordner, neben valheim.app. Trage die Startoption dann selbst ein: den vollständigen Pfad zu run_bepinex.sh in doppelten Anführungszeichen, gefolgt von %command%. In der Standardbibliothek von Steam beginnt der Pfad mit /Users/ und deinem Benutzernamen; ~ funktioniert dort nicht.

Nach der Installation enthält der Valheim-Ordner:

Wie füge ich eine Mod hinzu?

1. Lade die Mod herunter. Drücke auf Thunderstore auf der Mod-Seite Download.
2. Öffne die ZIP-Datei. Eine Thunderstore-ZIP enthält manifest.json, README.md, icon.png und die Dateien der Mod.
3. Lege in BepInEx/plugins einen Ordner für die Mod an, zum Beispiel BepInEx/plugins/ValheimModding-Jotunn, und verschiebe den ZIP-Inhalt dorthin. Enthält die ZIP einen Ordner plugins, verschiebe stattdessen dessen Inhalt. Ein Ordner config aus der ZIP gehört nach BepInEx/config.
4. Installiere die benötigten Abhängigkeiten. Die Thunderstore-Seite nennt die Mods, die diese Mod benötigt; füge jede auf dieselbe Weise hinzu. Überspringe BepInEx Pack Valheim: Das Paket oben ersetzt es.
5. Starte Valheim. BepInEx/LogOutput.log listet jede geladene Mod mit einer eigenen Zeile Loading [...] auf.

Diese Mods wurden mit diesem Paket nativ auf einem Mac mit Apple Silicon geladen: Jotunn, VNEI, YamlDotNet, Zen.ModLib, ZenSign, PlantEasily, Valheim Configuration Manager, Runic Clock, Auto Stash, LiveExperienceTracker, Remember Server Password, Craft Me Once, Live Seed Map.

Die Einstellungen einer Mod liegen nach dem ersten Valheim-Start mit ihr in BepInEx/config, in einer nach der Mod benannten .cfg-Datei.

Wie spiele ich ohne Mods?

Leere die Startoption in Steam, und Valheim startet ohne BepInEx. Die Dateien bleiben für das nächste Mal an Ort und Stelle. Um eine einzelne Mod zu entfernen, lösche ihren Ordner aus BepInEx/plugins.

Beispiel: Live Seed Map installieren

Live Seed Map zeigt dein laufendes Spiel auf der Seed-Karte: deine Position, die Kreaturen um dich herum, deine Markierungen und Portale. Außerdem kann die Mod jeden Kartenort in deinem Spiel markieren.

1. Lade LiveSeedMap-1.4.0.zip herunter.
2. Entpacke die Datei in den Valheim-Ordner. Diese ZIP ist bereits für BepInEx gegliedert, sodass die Mod in BepInEx/plugins/LiveSeedMap landet:

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

3. Starte Valheim über Steam. BepInEx/LogOutput.log enthält jetzt die Zeilen Loading [Live Seed Map 1.4.0] und Listening on http://127.0.0.1:45892.
4. Lade deine Welt oder tritt deinem Server bei.
5. Öffne die Seed-Karte in Chrome oder Edge und drücke Spiel verbinden. Erlaube dem Browser den Zugriff, wenn er fragt, ob die Seite Apps auf diesem Gerät erreichen darf.
6. Zeigt die Karte einen anderen Seed, drücke Seine Karte öffnen.

Alles, was die Mod zeigt und tut, sowie ihre Einstellungen stehen in der Live-Seed-Map-Anleitung.

Was tun, wenn die Mods nicht geladen werden?

• Keine Meldung zur modifizierten Version im Hauptmenü und keine Datei LogOutput.log: Prüfe die Startoption. Sie besteht aus dem vollständigen Pfad zu run_bepinex.sh in doppelten Anführungszeichen, gefolgt von %command%.
• Eine Datei mit preloader_ und einem Datum im Namen, die auf .log endet, neben run_bepinex.sh oder in valheim.app/Contents/MacOS: BepInEx hat vor dem Laden der Mods gestoppt. Das passiert auf Apple Silicon mit der offiziellen Version 5.4.23.5 und den BepInEx-Dateien aus BepInEx Pack Valheim. Entpacke das Paket oben erneut darüber und lösche das Protokoll innerhalb von valheim.app: Die App ist signiert, und eine dort hinzugefügte Datei macht diese Signatur ungültig.
• Could not load [...] because it has missing dependencies in LogOutput.log: Installiere die in der Zeile genannten Mods.
• Eine Mod verhält sich im Spiel falsch: Ihre Meldungen stehen in BepInEx/LogOutput.log, die des Spiels in ~/Library/Logs/IronGate/Valheim/Player.log.

Wenn du mit anderen spielst, brauchen der Server und die anderen Spieler dieselben Versionen jeder Mod, die die Welt verändert, unabhängig von ihrem Computer.