Зачем нужен BepInEx
Игры на Unity не умеют загружать сторонний код. BepInEx решает это: рядом с игрой кладётся небольшой файл winhttp.dll, игра подхватывает его при запуске, а он уже загружает BepInEx и все моды из папки BepInEx/plugins. Файлы самой игры при этом не переписываются — поэтому моды легко убрать.
Почти у каждой игры на Thunderstore есть своя готовая сборка — пакет BepInExPack. Она уже настроена под конкретную игру, и именно её указывают в зависимостях авторы модов. Брать «голый» BepInEx с GitHub имеет смысл, только если для вашей игры такой сборки нет.
Способ 1. Через менеджер модов
Это рекомендуемый путь: менеджер ставит BepInEx в отдельный профиль и не трогает чистую игру.
Способ 2. Вручную
- Скачайте архив BepInExPack для своей игры со страницы в каталоге или на Thunderstore. Если сборки под игру нет — возьмите BepInEx на GitHub в разделе Releases: для 64-битных игр нужен архив с пометкой x64.
- Откройте папку игры: в Steam — правой кнопкой по игре → «Управление» → «Просмотреть локальные файлы».
- Распакуйте архив. В архиве с Thunderstore нужные файлы лежат во вложенной папке
BepInExPack— копировать надо её содержимое, а не саму папку. - Проверьте результат: рядом с .exe игры должны лежать папка
BepInEx, файлыwinhttp.dllиdoorstop_config.ini. - Запустите игру один раз и закройте. BepInEx создаст внутри своей папки подпапки
pluginsиconfigи файлLogOutput.log— это признак, что он заработал. - Моды распаковывайте в
BepInEx/plugins. Если автор мода пишет другое (например,BepInEx/patchers), следуйте его инструкции.
Если после первого запуска папки plugins и config не появились, BepInEx не загрузился. Почти всегда причина в том, что файлы лежат не рядом с .exe игры, а на уровень глубже.
Что лежит в папке BepInEx
| Папка или файл | Для чего |
|---|---|
plugins | Сами моды — файлы .dll, обычно в отдельных папках |
config | Настройки модов (.cfg) и самого BepInEx — BepInEx.cfg |
patchers | Моды, которые правят игру до её загрузки; нужны редко |
core | Файлы самого BepInEx, трогать не нужно |
LogOutput.log | Журнал последнего запуска: какие моды загрузились и какие упали с ошибкой |
Настройки мода появляются в config после первого запуска игры с этим модом. Файлы .cfg — обычный текст: их можно править в Блокноте или во встроенном редакторе менеджера модов.
Какая версия нужна: 5 или 6
Стабильная ветка — BepInEx 5, она подходит большинству игр на Unity. Для игр, собранных по технологии IL2CPP, используется BepInEx 6, который пока выходит в предварительных сборках. Выбирать самому обычно не приходится: в BepInExPack для конкретной игры уже лежит правильная версия. А вот моды, написанные под 5-ю версию, на 6-й не работают, и наоборот.
Linux и Steam Deck
Если игра запускается через Proton, файл winhttp.dll сам не подхватится. В свойствах игры в Steam добавьте в параметры запуска строку WINEDLLOVERRIDES="winhttp=n,b" %command%. Менеджеры модов при запуске через них обычно делают это сами.
Как удалить BepInEx
Удалите из папки игры папку BepInEx, файлы winhttp.dll и doorstop_config.ini. Если ставили через менеджер — в папке игры ничего чистить не нужно: достаточно удалить профиль. Подробнее — в гайде как удалить моды и вернуть чистую игру.
Частые ошибки
Проверьте, что winhttp.dll лежит в одной папке с .exe игры и что вы запускаете игру из этой же папки. Если пользуетесь менеджером — запускайте игру его кнопкой, а не из Steam.
Откройте LogOutput.log и найдите название мода. Чаще всего не хватает библиотеки, от которой он зависит, или мод сделан для другой версии игры.
Файл подменяет системную библиотеку, чтобы загрузиться вместе с игрой, — на это и реагируют антивирусы. Если архив скачан с Thunderstore или официального GitHub, срабатывание ложное.
Перенесите её содержимое на уровень выше, прямо в папку игры, а пустую папку удалите.