
Valheim 1.0.16
Как установить моды Valheim на Mac: нативно на Apple Silicon без Rosetta
Valheim работает нативно на Mac с Apple Silicon, и моды тоже могут работать так же. Менеджеры модов, которыми пользуются игроки Windows, не работают в macOS. Поэтому на Mac нужно один раз вручную установить загрузчик, добавить Valheim один параметр запуска в Steam и поместить каждый мод в папку. После этого Valheim запускается из Steam как обычно, со всеми добавленными модами.

Какие менеджеры модов работают на Mac?
Ни один из обычных.
| Менеджер модов | Где работает |
|---|---|
| r2modman | Windows, Linux |
| Gale | Windows, Linux |
| Thunderstore Mod Manager | Windows |
| Vortex (Nexus Mods) | Windows |
Сами моды — одинаковые файлы на всех системах, поэтому 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?
- Закройте Valheim.
- Загрузите BepInEx_macos_valheim_5.4.23.5-01fd4aa.zip. Его контрольная сумма SHA-256 находится в SHA256SUMS.txt.
- Откройте Терминал и распакуйте архив в папку Valheim:
cd "$HOME/ Library/ Application Support/ Steam/ steamapps/ common/ Valheim"
unzip -o ~/ Downloads/ BepInEx_macos_valheim_5.4.23.5-01fd4aa.zip- В том же окне Терминала выведите параметр запуска для своего Mac и скопируйте получившуюся строку:
echo "\ "$PWD/ run_bepinex.sh\ " %command%"- В библиотеке Steam нажмите правой кнопкой на Valheim, выберите Свойства и вставьте строку в Параметры запуска на странице «Общие».
- Запустите 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
путь начинается с / и вашего имени пользователя; ~ здесь не работает.
После установки папка Valheim содержит:
| Файл или папка | Назначение |
|---|---|
valheim.app | Игра без изменений |
run_bepinex.sh | Запускает Valheim с загрузчиком; Steam вызывает его через параметр запуска |
libdoorstop.dylib | Библиотека загрузчика, которую скрипт передаёт игре |
BepInEx/ | Сам BepInEx |
BepInEx/ | Ваши моды |
BepInEx/ | Настройки BepInEx и каждого мода, создаваемые при первом запуске |
Как добавить мод?
- Загрузите мод. На Thunderstore нажмите Download на странице мода.
- Откройте zip. Архив Thunderstore содержит
manifest.json,README.md,icon.pngи файлы самого мода. - В
BepInEx/создайте папку для мода, напримерplugins BepInEx/, и переместите туда содержимое архива. Если в zip есть папкаplugins/ ValheimModding-Jotunn plugins, переносите содержимое этой папки. Папкаconfigиз архива помещается вBepInEx/.config - Установите зависимости мода. На его странице Thunderstore перечислены нужные ему моды; добавьте каждый таким же способом. Пропустите BepInEx Pack Valheim: пакет выше заменяет его.
- Запустите 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 и Realtime Map from seed.
После первого запуска Valheim с модом его настройки находятся в
BepInEx/, в файле .cfg, названном по имени мода.
Как играть без модов?
Очистите параметр запуска в Steam, и Valheim запустится без BepInEx; файлы
останутся на месте для следующего раза. Чтобы удалить один мод, удалите его
папку из BepInEx/.
Пример: установка мода Realtime Map from seed
Realtime Map from seed показывает запущенную игру на карте сида: ваше положение, существ поблизости, метки и порталы, а также может отметить любое место с карты в игре.
- Загрузите LiveSeedMap-1.5.3.zip.
- Распакуйте его в папку Valheim. Этот zip уже подготовлен для BepInEx,
поэтому мод попадёт в
BepInEx/:plugins/ LiveSeedMap
cd "$HOME/ Library/ Application Support/ Steam/ steamapps/ common/ Valheim"
unzip -o ~/ Downloads/ LiveSeedMap-1.5.3.zip- Запустите Valheim из Steam. Теперь
BepInEx/содержит строкиLogOutput.log Loading [Realtime Map from seed 1.5.0]иListening on http:/./ 127.0.0.1:45892 - Загрузите свой мир или подключитесь к серверу.
- Откройте карту сида в Chrome или Edge и нажмите Подключить игру. Когда браузер спросит, разрешён ли странице доступ к приложениям на этом устройстве, разрешите его.
- Если карта показывает другой сид, нажмите Открыть его карту.

Все возможности мода и его настройки описаны в руководстве Realtime Map from seed.
Что делать, если моды не загружаются?
- В главном меню нет сообщения о модификациях и нет
LogOutput.log: проверьте параметр запуска. Это полный путь кrun_bepinex.shв двойных кавычках, затем%command%. - Файл с именем
preloader_и датой, заканчивающийся на.log, рядом сrun_bepinex.shили внутриvalheim.app/: BepInEx остановился до загрузки модов. Так на Apple Silicon ведут себя официальный выпуск 5.4.23.5 и файлы BepInEx из BepInEx Pack Valheim. Снова распакуйте пакет выше поверх них и удалите журнал внутриContents/ MacOS valheim.app: приложение подписано, а добавленный внутрь файл нарушает подпись. Could not load [...] because it has missing dependenciesвLogOutput.log: установите моды, названные в этой строке.- Мод ведёт себя неправильно в игре: его сообщения находятся в
BepInEx/, а сообщения игры — вLogOutput.log ~/.Library/ Logs/ IronGate/ Valheim/ Player.log
Если играете с другими, серверу и остальным игрокам нужны одинаковые версии любого мода, изменяющего мир, независимо от компьютеров, на которых они играют.
Инструменты и моды
- Мод Realtime Map from seed для Valheim: установка, подключение и отслеживание мест в игре
- Живая карта Valheim: запущенная игра на карте вашего сида
- Где лежат сохранения миров и персонажей Valheim в Windows, macOS и Linux
- Карта сида Valheim: где находятся боссы и торговцы вашего мира
- Планировщик еды и снаряжения Valheim: проверьте броню и здоровье перед боссом
- Калькулятор строительства Valheim: все материалы для целой постройки
- Рыбалка в Valheim: наживка для каждой рыбы, места появления и вываживание