Jak zainstalować mody Valheim na Macu: natywnie na Apple Silicon bez Rosetty

Valheim działa natywnie na Macach z Apple Silicon, a jego mody też mogą. Menedżery modów używane przez graczy Windows nie działają w macOS. Na Macu instalujesz więc program ładujący mody ręcznie tylko raz, dodajesz jedną opcję uruchamiania Valheim w Steam i umieszczasz każdy mod w folderze. Potem Valheim uruchamia się ze Steam jak zwykle, ze wszystkimi dodanymi modami.

Które menedżery modów działają na Macu?

Żaden z popularnych.

Same mody to identyczne pliki na wszystkich systemach, więc Mac korzysta z tych samych plików do pobrania co Windows. Thunderstore, gdzie publikowana jest większość modów Valheim, ma na stronie każdego moda przycisk Download, który pobiera ten sam zip, jaki zainstalowałby menedżer. Nexus Mods i CurseForge również oferują mody Valheim; ich pliki trafiają do tych samych folderów.

Dlaczego zwykły BepInEx nie działa na Apple Silicon?

Mody Valheim działają na BepInEx, programie ładującym mody. BepInEx Pack Valheim, kopia instalowana przez każdy menedżer modów, zawiera bibliotekę Mac tylko dla procesorów Intel. Oficjalne wydanie BepInEx 5.4.23.5 ładuje się na Macu serii M, ale zatrzymuje się przed załadowaniem modów: macOS nie pozwala mu zmieniać kodu gry w pamięci tak jak Windows. Uruchomienie Valheim przez Rosettę omija ten problem kosztem wydajności.

Od tego czasu BepInEx naprawił problem w kodzie źródłowym wraz z biblioteką startową, ale żadna poprawka nie trafiła jeszcze do zwykłego wydania. Poniższy pakiet to BepInEx zbudowany z tego kodu, z poprawioną biblioteką ładującą i konfiguracją dla Valheim. Działa na Apple Silicon bez Rosetty.

Jak zainstalować BepInEx dla Valheim na Macu?

1. Zamknij Valheim.
2. Pobierz BepInEx_macos_valheim_5.4.23.5-01fd4aa.zip. Jego suma SHA-256 jest w SHA256SUMS.txt.
3. Otwórz Terminal i rozpakuj archiwum do folderu Valheim:

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

4. W tym samym oknie Terminala wyświetl opcję uruchamiania dla swojego Maca i skopiuj otrzymany wiersz:

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

5. W bibliotece Steam kliknij Valheim prawym przyciskiem, wybierz Właściwości i wklej wiersz do Opcje uruchamiania na stronie Ogólne.
6. Uruchom Valheim ze Steam. W prawym dolnym rogu menu głównego pojawi się „Grasz w zmodyfikowaną wersję Valheim.”, a folder Valheim będzie zawierać dziennik programu ładującego BepInEx/LogOutput.log.

Jeżeli biblioteka Steam jest na innym dysku, otwórz folder Valheim przez Steam: kliknij Valheim prawym przyciskiem, potem Zarządzaj i Przeglądaj pliki lokalne. W tym oknie Findera naciśnij ⌘↑, aby przejść o poziom wyżej, następnie przeciągnij folder Valheim na ikonę Terminala w Docku. Otworzy się okno Terminala w tym folderze; kontynuuj wierszem unzip, pomijając wiersz cd.

Bez Terminala: otwórz zip, aby otrzymać folder o tej samej nazwie, i przenieś jego zawartość do folderu Valheim obok valheim.app. Następnie wpisz opcję uruchamiania samodzielnie: pełną ścieżkę do run_bepinex.sh w podwójnych cudzysłowach, a po niej %command%. W domyślnej bibliotece Steam ścieżka zaczyna się od /Users/ i twojej nazwy użytkownika; ~ tam nie działa.

Po instalacji folder Valheim zawiera:

Jak dodać mod?

1. Pobierz mod. Na Thunderstore naciśnij Download na stronie moda.
2. Otwórz zip. Archiwum Thunderstore zawiera manifest.json, README.md, icon.png i pliki samego moda.
3. W BepInEx/plugins utwórz folder moda, na przykład BepInEx/plugins/ValheimModding-Jotunn, i przenieś do niego zawartość archiwum. Jeżeli zip zawiera folder plugins, przenieś jego zawartość. Folder config z archiwum trafia do BepInEx/config.
4. Zainstaluj zależności moda. Jego strona Thunderstore wymienia mody, których wymaga; dodaj każdy tak samo. Pomiń BepInEx Pack Valheim: powyższy pakiet go zastępuje.
5. Uruchom Valheim. BepInEx/LogOutput.log wymienia każdy załadowany mod, po jednym wierszu Loading [...] na mod.

Z tym pakietem na Macu z Apple Silicon natywnie załadowano następujące mody: Jotunn, VNEI, YamlDotNet, Zen.ModLib, ZenSign, PlantEasily, Valheim Configuration Manager, Runic Clock, Auto Stash, LiveExperienceTracker, Remember Server Password, Craft Me Once i Live Seed Map.

Po pierwszym uruchomieniu Valheim z modem jego ustawienia znajdują się w BepInEx/config, w pliku .cfg nazwanym od moda.

Jak grać bez modów?

Wyczyść opcję uruchamiania w Steam, a Valheim wystartuje bez BepInEx; pliki pozostaną na miejscu na następny raz. Aby usunąć jeden mod, usuń jego folder z BepInEx/plugins.

Przykład: instalacja moda Live Seed Map

Live Seed Map pokazuje uruchomioną grę na mapie ziarna: twoje położenie, stworzenia w pobliżu, pinezki i portale. Może też oznaczyć w grze dowolne miejsce z mapy.

1. Pobierz LiveSeedMap-1.4.0.zip.
2. Rozpakuj archiwum do folderu Valheim. Ten zip ma już strukturę BepInEx, więc mod trafi do BepInEx/plugins/LiveSeedMap:

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

3. Uruchom Valheim ze Steam. BepInEx/LogOutput.log zawiera teraz wiersze Loading [Live Seed Map 1.4.0] i Listening on http://127.0.0.1:45892.
4. Wczytaj swój świat lub dołącz do serwera.
5. Otwórz mapę ziarna w Chrome lub Edge i naciśnij Połącz grę. Gdy przeglądarka zapyta, czy strona może uzyskiwać dostęp do aplikacji na tym urządzeniu, zezwól na to.
6. Jeżeli mapa pokazuje inne ziarno, naciśnij Otwórz jego mapę.

Wszystkie funkcje moda i jego ustawienia opisuje poradnik Live Seed Map.

Co zrobić, gdy mody się nie ładują?

• Brak informacji o zmodyfikowanej wersji w menu głównym i brak LogOutput.log: sprawdź opcję uruchamiania. To pełna ścieżka do run_bepinex.sh w podwójnych cudzysłowach, a następnie %command%.
• Plik o nazwie preloader_ z datą, zakończony .log, obok run_bepinex.sh lub wewnątrz valheim.app/Contents/MacOS: BepInEx zatrzymał się przed załadowaniem modów. Tak na Apple Silicon zachowuje się oficjalne wydanie 5.4.23.5 i pliki BepInEx z BepInEx Pack Valheim. Ponownie rozpakuj powyższy pakiet na te pliki i usuń dziennik wewnątrz valheim.app: aplikacja jest podpisana, a dodanie pliku w jej wnętrzu narusza podpis.
• Could not load [...] because it has missing dependencies w LogOutput.log: zainstaluj mody wymienione w tym wierszu.
• Mod działa nieprawidłowo w grze: jego komunikaty znajdują się w BepInEx/LogOutput.log, a komunikaty gry w ~/Library/Logs/IronGate/Valheim/Player.log.

Jeśli grasz z innymi, serwer i pozostali gracze potrzebują tych samych wersji każdego moda zmieniającego świat, niezależnie od używanych komputerów.