MelonLoader или BepInEx
Оба загрузчика решают одну задачу, но моды для них пишутся по-разному и между собой не совместимы: мод для MelonLoader не запустится в BepInEx, и наоборот. Какой загрузчик нужен, выбирает не игрок, а сообщество игры — смотрите, что указано в зависимостях у модов. Если у мода в зависимостях MelonLoader, вам сюда; если BepInExPack — в гайд по BepInEx.
Способ 1. Через менеджер модов
- Установите r2modman или Gale, выберите игру и создайте профиль.
- Установите нужный мод из каталога менеджера. MelonLoader указан у модов в зависимостях и скачается сам.
- Запустите игру кнопкой запуска с модами в менеджере.
Менеджер держит MelonLoader и моды в профиле, поэтому чистая игра остаётся нетронутой.
Способ 2. Официальный установщик
- Закройте игру.
- Скачайте
MelonLoader.Installer.exeсо страницы Releases репозитория LavaGang/MelonLoader на GitHub. Для Linux и macOS там же лежат свои установщики. - Запустите установщик. Он покажет найденные игры на Unity; если вашей нет в списке — добавьте её вручную, указав .exe игры.
- Выберите игру и версию MelonLoader. Если автор мода не требует конкретную версию, оставляйте предложенную последнюю.
- Нажмите кнопку установки и дождитесь окончания.
- Запустите игру. Первый запуск идёт заметно дольше обычного: MelonLoader подготавливает файлы под игру, для игр на IL2CPP ему нужен доступ в интернет. Вместе с игрой откроется окно консоли.
- Закройте игру. В её папке появились папки
Mods,PluginsиUserData. Положите .dll мода вModsи запустите игру снова.
Для игр на IL2CPP MelonLoader нужна среда .NET 6.0 Desktop Runtime. В Windows установщик ставит её сам; если первый запуск завершается ошибкой о .NET — установите среду вручную с сайта Microsoft.
Что лежит в папке игры после установки
| Папка или файл | Для чего |
|---|---|
Mods | Моды — файлы .dll |
Plugins | Плагины — загружаются раньше модов; класть сюда только то, что автор назвал плагином |
UserData | Настройки MelonLoader и модов |
UserLibs | Дополнительные библиотеки, которые нужны отдельным модам |
MelonLoader | Файлы самого загрузчика и журналы |
version.dll | Файл, через который загрузчик запускается вместе с игрой |
Мод скачан архивом? Смотрите, что внутри: если там папки Mods, Plugins, UserLibs — распакуйте архив прямо в папку игры, содержимое разложится само. Если внутри просто .dll — положите её в Mods.
Где лог и как его читать
Журнал последнего запуска — файл Latest.log в папке MelonLoader; предыдущие запуски хранятся там же в подпапке Logs. В начале журнала указаны версия загрузчика и игры, дальше — список загруженных модов. Строки с ошибками помечены и обычно называют мод, который их вызвал. Как искать по логу проблемный мод — в гайде про вылеты.
Как запустить игру без модов и как удалить MelonLoader
Разово запустить игру без модов можно параметром запуска --no-mods (в Steam: свойства игры → параметры запуска). Чтобы удалить загрузчик совсем, закройте игру и удалите из её папки файл version.dll и папку MelonLoader; для полной очистки — ещё и папки Mods, Plugins, UserData, UserLibs. В старых версиях рядом лежал ещё файл dobby.dll — его тоже можно удалить.
Частые ошибки
MelonLoader не загрузился: проверьте, что version.dll лежит рядом с .exe игры. Если ставили через менеджер — запускайте игру из него, а не из Steam.
Проверьте интернет и дайте загрузчику несколько минут. Если ошибка упоминает .NET — установите .NET 6.0 Desktop Runtime и запустите игру ещё раз.
Откройте Latest.log. Частые причины: мод собран под другую версию MelonLoader или игры, не хватает библиотеки, либо в папку попал мод для BepInEx.
Обновление игры часто ломает моды для игр на IL2CPP. Обновите MelonLoader и моды; если новых версий ещё нет — придётся подождать авторов.
