Руководство о том, как скачивать и устанавливать моды в R.E.P.O. на ПК, используя Thunderstore, Vortex или вообще без менеджера модов.
R.E.P.O. — это игра на Unity, и её моды представляют собой плагины BepInEx. Почти всё находится на Thunderstore, а на Nexus Mods есть гораздо меньший выбор, которым может управлять Vortex, если это уже привычный вам процесс.
В качестве примера мы установим SharedHostUpgrades, который распределяет улучшения на всю команду, а не только на игрока, который их купил.
Требования
- ПК с Windows 10 или новее, либо Linux.
- R.E.P.O. в Steam.
- Около 500 МБ свободного места для типичного набора модов.
- 7-Zip или аналог, если пойдёте по ручному пути.
В R.E.P.O. нет античита, поэтому риска бана за моддинг нет.
Откуда берутся моды для R.E.P.O.
Есть два источника, и по размеру они несопоставимы.
Thunderstore — место, где сосредоточена практически вся сцена. Моды там упакованы со списком зависимостей в машиночитаемом виде, поэтому менеджеры модов могут установить мод и всё, что ему нужно, в один клик.
Nexus Mods имеет раздел R.E.P.O., и Vortex его поддерживает. Каталог там гораздо меньше, и большинство авторов не дублируют там свои моды, но если вы уже используете Vortex для других игр, это вполне разумное место для управления тем, что там всё же найдётся.
В любом случае, загрузчик под капотом один и тот же: BepInExPack подключается к игре при запуске и загружает плагины .dll из BepInEx/plugins.
Поиск папки с игрой
Она понадобится для каждого из описанных здесь способов, включая менеджеры модов — хотя бы для устранения неполадок.
Щёлкните правой кнопкой мыши по R.E.P.O. в вашей библиотеке Steam, затем выберите Управление, а после — Просмотреть локальные файлы. При стандартной установке на Windows папка находится по пути:
C:\Program Files (x86)\Steam\steamapps\common\REPO
Вы должны увидеть REPO.exe и REPO_Data. Именно в эту папку устанавливается BepInEx.
Способ 1 — Thunderstore Mod Manager
Самая распространённая рекомендация, и именно на неё ведёт кнопка Install with Mod Manager на страницах модов Thunderstore.
- Установите Thunderstore Mod Manager. Он работает на базе Overwolf, так что вы получите и его тоже.
- Откройте его и выберите R.E.P.O. из списка игр.
- Выберите профиль. Default вполне подойдёт; отдельный именованный профиль для каждой группы друзей будет лучше, если у вас появится больше одного важного для вас набора модов.
- Нажмите Get mods и найдите SharedHostUpgrades.
- Нажмите Download, затем подтвердите диалог зависимостей. BepInExPack будет установлен вместе с ним.
- Нажмите Start modded.
ВНИМАНИЕ — Start modded — единственный способ запуска, при котором применяются ваши моды. Запуск R.E.P.O. из Steam запускает игру без модов, и на этом попадаются почти все хотя бы раз.
Способ 2 — Gale
Gale выполняет ту же задачу в более компактном и быстром приложении без необходимости в Overwolf, и у него есть полноценная сборка под Linux.
- Скачайте Gale с Thunderstore или с GitHub.
- Запустите его и выберите R.E.P.O.
- Откройте Browse mods, найдите SharedHostUpgrades и нажмите Install.
- Нажмите Launch game (modded).
Gale читает и записывает те же коды профилей, что и Thunderstore Mod Manager и r2modman, поэтому смешивать менеджеры внутри одной группы друзей вполне допустимо.
Способ 3 — Vortex
Имеет смысл, если Vortex уже является вашим основным инструментом для Skyrim, Fallout или чего-то ещё. Учтите, что Vortex берёт моды с Nexus Mods, а не с Thunderstore, поэтому выбор модов другой, и SharedHostUpgrades там может не оказаться.
- Установите Vortex и войдите в свою учётную запись Nexus Mods.
- Откройте вкладку Games, найдите R.E.P.O., наведите на плитку и нажмите Manage.
- Vortex может предложить установить расширение для R.E.P.O. Согласитесь, а затем перезапустите Vortex, когда он попросит.
- Сначала установите BepInEx. Vortex не сделает это за вас, поэтому выполните ручные шаги по установке BepInEx ниже, прежде чем устанавливать плагины через Vortex.
- Найдите мод на Nexus Mods и нажмите Mod Manager Download, затем Install и Enable в Vortex.
- Запустите игру из Vortex или из Steam. Vortex размещает файлы прямо в папке игры, а не внедряет их при запуске, поэтому после установки BepInEx обычный запуск через Steam будет работать.
ПРИМЕЧАНИЕ — Этот последний пункт и есть настоящее отличие Vortex от менеджеров Thunderstore. Vortex размещает файлы на диске постоянно; менеджеры Thunderstore хранят профиль вне папки игры и применяют его при каждом запуске. Ни один из подходов не является неправильным, но не запускайте оба одновременно против одной и той же установки, поскольку они будут конфликтовать за BepInEx/plugins.
Способ 4 — Вручную
Два этапа, и первый из них выполняется один раз.
Установка BepInEx:
- Откройте страницу BepInExPack и нажмите Manual Download.
- Распакуйте архив куда-нибудь вне папки игры.
- Откройте распакованную папку, а затем папку
BepInExPackвнутри неё. - Скопируйте содержимое папки
BepInExPackв вашу папку R.E.P.O., чтобыBepInEx,doorstop_config.iniиwinhttp.dllоказались рядом сREPO.exe. - Запустите игру один раз и закройте её — это заставит BepInEx создать
BepInEx/pluginsиBepInEx/config.
Установка мода:
- Откройте страницу SharedHostUpgrades и нажмите Manual Download.
- Распакуйте архив.
- Скопируйте
.dllвREPO\BepInEx\plugins.
Файлы manifest.json, icon.png и README.md в архиве относятся к упаковке Thunderstore, и их можно оставить без внимания.
Если вы устанавливаете вручную, обработка зависимостей — на вас. Проверьте раздел Dependencies на странице мода на Thunderstore и установите каждую зависимость указанной версии.
Способ 5 — Приложение TMC
Стоит знать о нём, с честной оговоркой. Приложение TMC — наш собственный менеджер модов и браузер серверов. Оно умеет устанавливать в один клик, работает с песочницами (именованными профилями модов для каждой игры, у каждого свой порядок загрузки и способ развёртывания, переключаемый без повторной загрузки чего-либо), имеет браузер серверов с графиками задержки в реальном времени и поддержку RCON.
R.E.P.O. пока нет в списке поддерживаемых игр. Добавление игры — это четыре JSON-файла и никакого кода, так что задача небольшая, а не переписывание приложения, и она у нас в планах.
Оговорка в том, что приложение находится на очень ранней стадии разработки. В собственном README оно названо частично протестированным, и мы не будем его здесь перехваливать. Пока что оно стоит рядом со способами 1–4, а не заменяет ни один из них. Если вы всё же готовы его попробовать, это очень поможет нам, а отчёт о том, что сломалось, поможет ещё больше.
Оно с открытым исходным кодом под лицензией GPL-3.0, доступно по адресу github.com/modcommunity/tmc-app. Баги и предложения по функциям — в трекере задач, pull request'ы приветствуются, а формат для каждой игры описан в репозитории, если захотите добавить поддержку R.E.P.O. самостоятельно.
Установка:
- Linux: одна строка, без root и без пакетного менеджера.
curl -fsSL https://raw.githubusercontent.com/modcommunity/tmc-app/main/scripts/install.sh | sh
- Windows:
setup.exeилиsetup.msiсо страницы релизов. Есть и portable-сборка, хотя она не регистрирует запись в лаунчере и обработчик ссылокtmc://. - macOS:
.dmgс той же страницы релизов.
Моды для хоста и клиентов
R.E.P.O. — кооперативная игра, и это имеет значение.
Моды делятся примерно на три категории:
| Тип | Кому нужен | Пример |
|---|---|---|
| Только хосту | Только тому, кто хостит лобби | Многие правки правил и экономики |
| Всем | Каждому игроку в лобби | Моды, добавляющие предметы, врагов или UI, которые видят все |
| Только клиенту | Только вам | Косметика, настройки камеры, личные удобства |
SharedHostUpgrades меняет то, как улучшения распределяются между всей командой — это изменение общего состояния, так что мод нужен всему лобби.
Описание мода на Thunderstore обычно указывает, к какой категории он относится. Если нет — считайте, что он нужен всем, и экспортируйте профиль для своей группы. Любой менеджер Thunderstore умеет экспортировать профиль в виде кода или файла, который остальные импортируют в один клик.
Проверка установки
BepInEx открывает окно консоли рядом с игрой. Наблюдайте за ним при запуске — вы увидите, как каждый плагин загружается по имени и версии.
Если консоль вообще не открывается, значит BepInEx не загружается. Это либо неправильная структура папок, либо запуск не через мод-менеджер.
Для SharedHostUpgrades захостите лобби с кем-нибудь ещё, купите улучшение и проверьте, применилось ли оно у обоих игроков.
Поддержание модов в актуальном состоянии
Менеджеры Thunderstore помечают устаревшие моды и обновляют их в один клик. Vortex делает то же самое для модов с Nexus, показывая индикатор обновления в списке модов.
Обновляться стоит после патча игры, а вот в середине прохождения лучше этого избегать, так как смена версии может испортить сохранение или рассинхронизировать лобби. Если хотите протестировать обновление, не рискуя рабочей сборкой, клонируйте профиль и обновляйте клон.
Удаление
- Менеджеры Thunderstore: удалите мод в списке Installed, либо просто отключите его, чтобы сохранить файлы на будущее.
- Vortex: отключите или удалите мод, затем нажмите Purge Mods в разделе Mods, чтобы убрать его файлы из папки игры.
- Вручную: удалите
.dllили папку изBepInEx/plugins.
Чтобы вернуться к чистой игре, удалите BepInEx, doorstop_config.ini и winhttp.dll из папки игры. Функция Steam Проверить целостность файлов игры этого не сделает, поскольку ни один из этих файлов не был установлен через Steam.
Устранение неполадок
Игра запускается, моды не работают. Запущена через Steam, а не через менеджер модов.
Нет окна консоли BepInEx. BepInEx установлен не там, где нужно. winhttp.dll должен находиться прямо рядом с REPO.exe.
Мод работает у хоста, но ничего не происходит у остальных игроков. Вероятно, его нужно установить каждому клиенту. Проверьте страницу мода.
Краш сразу после обновления игры. Патчи R.E.P.O. регулярно ломают моды на BepInEx. Опустошите BepInEx/plugins, чтобы это подтвердить, и подождите, пока авторы обновят свои моды.
Vortex и менеджер Thunderstore конфликтуют. Выберите что-то одно. Очистите развёртывание Vortex или профиль Thunderstore, но не запускайте оба против одной и той же установки.
Linux и Proton. Установите параметры запуска R.E.P.O. в Steam на WINEDLLOVERRIDES="winhttp=n,b" %command%, чтобы BepInEx мог загрузиться. Gale и r2modman делают это за вас при запуске через них.
Заключение
Почти для всех ответ один — менеджер Thunderstore: установите его, выберите R.E.P.O., скачайте мод вместе с зависимостями и запустите в моддинг-режиме. Vortex — разумный выбор, если вы уже им пользуетесь, при условии что сначала вы сами установите BepInEx и не будете смешивать оба подхода.
Кооперативная часть — то, где немного внимания окупается. Определите, является ли мод только для хоста, только клиентским или нужен всем, и делитесь профилем со своей группой, а не сравнивайте списки.
Если хотите помочь с чем-то, приложение TMC с открытым исходным кодом и находится на ранней стадии разработки, и обратная связь по нему очень ценна для нас.
Смотрите также
Мы стараемся поддерживать это руководство в актуальном состоянии, но игра, BepInEx и мод-менеджеры обновляются каждый по своему графику. Если что-то здесь больше не соответствует тому, что вы видите, сообщите нам об этом или откройте pull request в GitHub-репозитории этого руководства.
Присоединяйтесь к нашему Discord-серверу, если у вас есть вопросы или нужна помощь с чем-либо, связанным с моддингом!