Как установить моды 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.

Если играете с другими, серверу и остальным игрокам нужны одинаковые версии любого мода, изменяющего мир, независимо от компьютеров, на которых они играют.