Як встановити моди Valheim на Mac: нативно на Apple Silicon без Rosetta

Valheim працює нативно на Mac з Apple Silicon, і моди теж можуть. Менеджери модів, якими користуються гравці Windows, не працюють у macOS. Тому на Mac потрібно один раз вручну встановити завантажувач, додати Valheim один параметр запуску в Steam і помістити кожен мод у папку. Після цього Valheim запускається зі Steam як завжди, з усіма доданими модами.

Які менеджери модів працюють на Mac?

Жоден зі звичних.

Самі моди — однакові файли на всіх системах, тому Mac використовує ті самі завантаження, що й Windows. На Thunderstore, де опубліковано більшість модів Valheim, кожна сторінка мода має кнопку Download, яка дає той самий zip, що встановив би менеджер. Nexus Mods і CurseForge також пропонують моди Valheim; їхні файли потрапляють до тих самих папок.

Чому звичайний BepInEx не працює на Apple Silicon?

Моди Valheim працюють через завантажувач BepInEx. BepInEx Pack Valheim, копія, яку встановлює кожен менеджер модів, містить бібліотеку Mac лише для процесорів Intel. Офіційний випуск BepInEx 5.4.23.5 завантажується на Mac серії M, але зупиняється до завантаження модів: macOS не дозволяє йому змінювати код гри в пам'яті так, як це відбувається у Windows. Запуск Valheim через Rosetta обходить проблему ціною швидкодії.

Відтоді BepInEx виправив це у вихідному коді разом із бібліотекою завантажувача, з якої він стартує, але жодне виправлення ще не ввійшло до звичайного випуску. Пакет нижче — BepInEx, зібраний із цього коду, з виправленою бібліотекою завантажувача та налаштуванням для Valheim. Він працює на Apple Silicon без Rosetta.

Як встановити BepInEx для Valheim на Mac?

1. Закрийте Valheim.
2. Завантажте BepInEx_macos_valheim_5.4.23.5-01fd4aa.zip. Його контрольна сума SHA-256 міститься в SHA256SUMS.txt.
3. Відкрийте Термінал і розпакуйте архів у папку Valheim:

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

4. У тому самому вікні Термінала виведіть параметр запуску для свого Mac і скопіюйте отриманий рядок:

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

5. У бібліотеці Steam клацніть Valheim правою кнопкою, виберіть Властивості та вставте рядок у Параметри запуску на сторінці «Загальні».
6. Запустіть Valheim зі Steam. Унизу праворуч у головному меню з'явиться «Ви граєте у Valheim зі встановленою модифікацією.», а в папці Valheim — журнал завантажувача BepInEx/LogOutput.log.

Якщо бібліотека Steam на іншому диску, відкрийте папку Valheim зі Steam: клацніть Valheim правою кнопкою, потім Керування та Переглянути локальні файли. У цьому вікні Finder натисніть ⌘↑, щоб піднятися на рівень вище, і перетягніть папку Valheim на значок Термінала в Dock. Вікно Термінала відкриється в цій папці; продовжуйте рядком unzip, пропустивши рядок cd.

Без Термінала: відкрийте zip, щоб отримати папку з тією ж назвою, і перемістіть її вміст до папки Valheim поруч із valheim.app. Потім введіть параметр запуску вручну: повний шлях до run_bepinex.sh у подвійних лапках, за яким іде %command%. У стандартній бібліотеці Steam шлях починається з /Users/ та вашого імені користувача; ~ тут не працює.

Після встановлення папка Valheim містить:

Як додати мод?

1. Завантажте мод. На Thunderstore натисніть Download на сторінці мода.
2. Відкрийте zip. Архів Thunderstore містить manifest.json, README.md, icon.png і файли самого мода.
3. У BepInEx/plugins створіть папку для мода, наприклад BepInEx/plugins/ValheimModding-Jotunn, та перемістіть туди вміст архіву. Якщо zip має папку plugins, переносіть її вміст. Папка config з архіву потрапляє до BepInEx/config.
4. Встановіть залежності мода. Його сторінка Thunderstore перелічує потрібні йому моди; додайте кожен так само. Пропустіть BepInEx Pack Valheim: пакет вище замінює його.
5. Запустіть Valheim. BepInEx/LogOutput.log перелічує кожен завантажений мод окремим рядком Loading [...].

Із цим пакетом на Mac з Apple Silicon нативно завантажилися такі моди: Jotunn, VNEI, YamlDotNet, Zen.ModLib, ZenSign, PlantEasily, Valheim Configuration Manager, Runic Clock, Auto Stash, LiveExperienceTracker, Remember Server Password, Craft Me Once і Live Seed Map.

Після першого запуску Valheim із модом його налаштування містяться в BepInEx/config, у файлі .cfg, названому за модом.

Як грати без модів?

Очистіть параметр запуску в Steam, і Valheim запуститься без BepInEx; файли залишаться на місці для наступного разу. Щоб прибрати один мод, видаліть його папку з BepInEx/plugins.

Приклад: встановлення мода Live Seed Map

Live Seed Map показує запущену гру на мапі сіда: ваше положення, істот поблизу, позначки й портали, а також може позначити будь-яке місце з мапи у грі.

1. Завантажте LiveSeedMap-1.4.0.zip.
2. Розпакуйте його в папку Valheim. Цей zip уже підготовлено для BepInEx, тож мод потрапить до BepInEx/plugins/LiveSeedMap:

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

3. Запустіть Valheim зі Steam. Тепер BepInEx/LogOutput.log містить рядки Loading [Live Seed Map 1.4.0] та Listening on http://127.0.0.1:45892.
4. Завантажте світ або приєднайтеся до сервера.
5. Відкрийте мапу сіда у Chrome чи Edge та натисніть Під'єднати гру. Коли браузер запитає, чи може сторінка звертатися до програм на цьому пристрої, дозвольте це.
6. Якщо мапа показує інший сід, натисніть Відкрити його мапу.

Усі можливості мода та його налаштування описані в посібнику Live Seed Map.

Що робити, якщо моди не завантажуються?

• У головному меню немає повідомлення про модифікації й немає LogOutput.log: перевірте параметр запуску. Це повний шлях до run_bepinex.sh у подвійних лапках, потім %command%.
• Файл з іменем preloader_ і датою, що закінчується на .log, поруч із run_bepinex.sh або всередині valheim.app/Contents/MacOS: BepInEx зупинився до завантаження модів. Так на Apple Silicon поводяться офіційний випуск 5.4.23.5 і файли BepInEx із BepInEx Pack Valheim. Знову розпакуйте пакет вище поверх них і видаліть журнал усередині valheim.app: програму підписано, а доданий усередину файл порушує підпис.
• Could not load [...] because it has missing dependencies у LogOutput.log: встановіть моди, названі в цьому рядку.
• Мод неправильно працює у грі: його повідомлення містяться в BepInEx/LogOutput.log, а повідомлення гри — у ~/Library/Logs/IronGate/Valheim/Player.log.

Якщо граєте з іншими, серверу й решті гравців потрібні однакові версії кожного мода, що змінює світ, незалежно від комп'ютерів, на яких вони грають.