Jak nainstalovat mody pro Valheim na Macu: nativně na Apple Silicon bez Rosetty

Valheim běží na Macích s Apple Silicon nativně a jeho mody mohou také. Správci modů používaní hráči Windows na macOS nefungují. Na Macu proto jednou ručně nainstaluješ zavaděč modů, nastavíš Valheimu jednu volbu spuštění ve Steamu a každý mod vložíš do složky. Potom se Valheim spouští ze Steamu jako obvykle, se všemi přidanými mody.

Kteří správci modů fungují na Macu?

Žádný z běžných.

Samotné mody jsou na všech systémech stejné soubory, takže Mac používá stejné balíčky jako Windows. Thunderstore, kde vychází většina modů pro Valheim, má na stránce každého modu tlačítko Download, které stáhne stejný zip, jaký by nainstaloval správce. Mody pro Valheim nabízí také Nexus Mods a CurseForge; jejich soubory patří do stejných složek.

Proč běžný BepInEx nefunguje na Apple Silicon?

Mody pro Valheim běží na zavaděči BepInEx. BepInEx Pack Valheim, kopie instalovaná každým správcem modů, obsahuje knihovnu pro Mac pouze pro procesory Intel. Oficiální vydání BepInEx 5.4.23.5 se na Macu řady M načte, ale zastaví se před načtením modů: macOS mu nedovoluje měnit kód hry v paměti stejným způsobem jako Windows. Spuštění Valheimu přes Rosettu problém obejde za cenu nižší rychlosti.

BepInEx od té doby problém opravil ve zdrojovém kódu spolu s knihovnou zavaděče, ze které startuje, ale ani jedna oprava zatím není v běžném vydání. Níže uvedený balíček je BepInEx sestavený z tohoto kódu, s opravenou knihovnou zavaděče a nastavením pro Valheim. Na Apple Silicon běží bez Rosetty.

Jak nainstalovat BepInEx pro Valheim na Macu?

1. Ukonči Valheim.
2. Stáhni BepInEx_macos_valheim_5.4.23.5-01fd4aa.zip. Jeho kontrolní součet SHA-256 je v SHA256SUMS.txt.
3. Otevři Terminál a rozbal jej do složky Valheim:

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

4. Ve stejném okně Terminálu vypiš volbu spuštění pro svůj Mac a zkopíruj vypsaný řádek:

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

5. Ve Steamu klikni pravým tlačítkem na Valheim v knihovně, vyber Vlastnosti a vlož řádek do Možnosti spuštění na stránce Obecné.
6. Spusť Valheim ze Steamu. Hlavní nabídka vpravo dole hlásí „Hrajete modifikovanou verzi Valheimu.“ a ve složce Valheim nyní najdeš protokol zavaděče BepInEx/LogOutput.log.

Pokud je knihovna Steamu na jiném disku, otevři složku Valheim ze Steamu: klikni pravým tlačítkem na Valheim, pak Spravovat a Procházet místní soubory. V tomto okně Finderu stiskni ⌘↑ pro přechod o úroveň výš a potom přetáhni složku Valheim na ikonu Terminálu v Docku. Terminál se otevře v této složce; pokračuj řádkem unzip, bez řádku cd.

Bez Terminálu: otevři zip, čímž získáš stejnojmennou složku, a přesuň její obsah do složky Valheim vedle valheim.app. Volbu spuštění potom napiš ručně: celou cestu k run_bepinex.sh v dvojitých uvozovkách následovanou %command%. Ve výchozí knihovně Steamu začíná cesta /Users/ a tvým uživatelským jménem; ~ tam nefunguje.

Po instalaci složka Valheim obsahuje:

Jak přidat mod?

1. Stáhni mod. Na Thunderstore stiskni Download na stránce modu.
2. Otevři zip. Archiv z Thunderstore obsahuje manifest.json, README.md, icon.png a vlastní soubory modu.
3. V BepInEx/plugins vytvoř složku pro mod, například BepInEx/plugins/ValheimModding-Jotunn, a přesuň do ní obsah archivu. Pokud zip obsahuje složku plugins, přesuň místo toho její obsah. Složka config z archivu patří do BepInEx/config.
4. Nainstaluj závislosti modu. Jeho stránka Thunderstore uvádí mody, které potřebuje; každý přidej stejně. BepInEx Pack Valheim vynech: nahrazuje jej balíček výše.
5. Spusť Valheim. BepInEx/LogOutput.log uvádí každý načtený mod na samostatném řádku Loading [...].

S tímto balíčkem se na Macu s Apple Silicon nativně načetly tyto mody: Jotunn, VNEI, YamlDotNet, Zen.ModLib, ZenSign, PlantEasily, Valheim Configuration Manager, Runic Clock, Auto Stash, LiveExperienceTracker, Remember Server Password, Craft Me Once a Live Seed Map.

Po prvním spuštění Valheimu s modem najdeš jeho nastavení v BepInEx/config, v souboru .cfg pojmenovaném podle modu.

Jak hrát bez modů?

Vymaž volbu spuštění ve Steamu a Valheim se spustí bez BepInEx; soubory zůstanou na místě pro příště. Chceš-li odebrat jeden mod, smaž jeho složku z BepInEx/plugins.

Příklad: instalace modu Live Seed Map

Live Seed Map ukazuje spuštěnou hru na mapě seedu: tvoji polohu, tvory v okolí, značky a portály a může ve hře označit libovolné místo z mapy.

1. Stáhni LiveSeedMap-1.4.0.zip.
2. Rozbal jej do složky Valheim. Tento zip má již strukturu pro BepInEx, takže mod skončí v BepInEx/plugins/LiveSeedMap:

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

3. Spusť Valheim ze Steamu. BepInEx/LogOutput.log nyní obsahuje řádky Loading [Live Seed Map 1.4.0] a Listening on http://127.0.0.1:45892.
4. Načti svůj svět nebo se připoj k serveru.
5. Otevři mapu seedu v Chrome nebo Edge a stiskni Připojit hru. Až se prohlížeč zeptá, zda stránka smí přistupovat k aplikacím na tomto zařízení, povol to.
6. Pokud mapa ukazuje jiný seed, stiskni Otevřít jeho mapu.

Všechny funkce modu a jeho nastavení jsou v návodu k Live Seed Map.

Co když se mody nenačítají?

• V hlavní nabídce není hlášení o modifikované verzi a chybí LogOutput.log: zkontroluj volbu spuštění. Je to úplná cesta k run_bepinex.sh v dvojitých uvozovkách a potom %command%.
• Soubor pojmenovaný preloader_ a datem, končící na .log, vedle run_bepinex.sh nebo uvnitř valheim.app/Contents/MacOS: BepInEx se zastavil před načtením modů. To na Apple Silicon dělá oficiální vydání 5.4.23.5 i soubory BepInEx z BepInEx Pack Valheim. Znovu přes ně rozbal balíček výše a smaž protokol uvnitř valheim.app: aplikace je podepsaná a soubor přidaný dovnitř poruší podpis.
• Could not load [...] because it has missing dependencies v LogOutput.log: nainstaluj mody uvedené na tomto řádku.
• Mod se ve hře chová nesprávně: jeho zprávy jsou v BepInEx/LogOutput.log a zprávy hry v ~/Library/Logs/IronGate/Valheim/Player.log.

Pokud hraješ s ostatními, server i ostatní hráči potřebují stejné verze každého modu, který mění svět, bez ohledu na počítač, na kterém hrají.