Установка

Устанавливаем BepInEx

Если у вас уже установлен BepInEx, пропустите этот шаг.

Скачиваем BepInEx

Перейдите сюда и скачайте версию для вашей ОС:

Windows

Скачайте версию BepInEx для типа исполняемого файла вашей игры:

• BepInEx_x64_5.x.y.z.zip для 64-битных исполняемых файлов.
• BepInEx_x86_5.x.y.z.zip для 32-битных исполняемых файлов.

Вот вам парочка советов:

• Вы можете заметить некоторые файлы в корневой папке игры: Galaxy64.dll, UnityCrashHandler64.exe. Если они у вас есть, то я почти уверен, что исполняемый файл игры тоже 64-битный.
• Запустите игру и откройте Диспетчер задач. Если вы видите "(32 bit)" в названии процесса игры, то исполняемый файл 32-битный, а иначе - 64-битный.

Linux

• Просто скачайте BepInEx_unix_5.x.y.z.zip.

Извлекаем файлы

Я знаю где установлена моя игра!

Откройте библиотеку игр Steam, нажмите правой кнопкой по игре и выберите Свойства...:

Перейдите во вкладку Локальные файлы и нажмите Обзор...:

Steam

Поищите на следующих путях:

Windows

• C:\GOG Games;
• C:\Program Files (x86)\GOG.com;
• C:\Program Files\GOGcom;

Linux

• $HOME/GOG Games;

Извлеките содержимое .zip файла в корневую папку игры.

Windows

Убедитесь что вы извлекли всё правильно. Судя по всему, тут легко ошибиться.

• Убедитесь что папка BepInEx находится в той же папке, что и исполняемый файл вашей игры (StreetsOfRogue.exe);
• Убедитесь что вы извлекли файлы doorstop_config.ini и winhttp.dll тоже;

Linux

Убедитесь что вы извлекли всё правильно. Судя по всему, тут легко ошибиться.

• Убедитесь что папки BepInEx и doorstop_libs находятся в той же папке, что и исполняемый файл вашей игры (StreetsOfRogue.x86 или StreetsOfRogue.x86_64);
• Убедитесь что вы извлекли файл run_bepinex.sh тоже;

macOS

Убедитесь что вы извлекли всё правильно. Судя по всему, тут легко ошибиться.

• Убедитесь что папки BepInEx и doorstop_libs находятся в той же папке, что и исполняемый файл вашей игры (StreetsOfRogue.app);
• Убедитесь что вы извлекли файл run_bepinex.sh тоже;

Запускаем игру

примечание

Необходимо запустить игру хотя бы один раз, чтобы BepInEx сгенерировал файлы настроек и папки!

Windows

Просто запустите игру. Либо через исполняемый файл, либо через любой лаунчер.

Можете закрыть игру, как только увидите логотип или загрузочный экран.

Linux

Откройте приложженый скрипт run_bepinex.sh и измените в выделенной строчке название исполняемого файла игры:

run_bepinex.sh

#!/bin/sh
# BepInEx running script
#
# This script is used to run a Unity game with BepInEx enabled.
#
# Usage: Configure the script below and simply run this script when you want to run your game modded.

# -------- SETTINGS --------
# ---- EDIT AS NEEDED ------

# EDIT THIS: The name of the executable to run
# LINUX: This is the name of the Unity game executable 
# MACOS: This is the name of the game app folder, including the .app suffix
executable_name="StreetsOfRogue"

# The rest is automatically handled by BepInEx
# ...

Откройте терминал в корневой папке игры и дайте скрипту разрешение на выполнение:

chmod u+x run_bepinex.sh

Теперь вы можете запустить BepInEx просто выполнив этот скрипт:

./run_bepinex.sh

macOS

Откройте приложженый скрипт run_bepinex.sh и измените в выделенной строчке название исполняемого файла игры (вместе с .app расширением):

run_bepinex.sh

#!/bin/sh
# BepInEx running script
#
# This script is used to run a Unity game with BepInEx enabled.
#
# Usage: Configure the script below and simply run this script when you want to run your game modded.

# -------- SETTINGS --------
# ---- EDIT AS NEEDED ------

# EDIT THIS: The name of the executable to run
# LINUX: This is the name of the Unity game executable 
# MACOS: This is the name of the game app folder, including the .app suffix
executable_name="StreetsOfRogue.app"

# The rest is automatically handled by BepInEx
# ...

Откройте терминал в корневой папке игры и дайте скрипту разрешение на выполнение:

chmod u+x run_bepinex.sh

Теперь вы можете запустить BepInEx просто выполнив этот скрипт:

./run_bepinex.sh

Запускаем BepInEx через Steam

Windows

На Windows можно запускать BepInEx через Steam тоже. Не о чем беспокоиться.

Linux

Откройте библиотеку игр Steam, нажмите правой кнопкой по игре и выберите Свойства...:

примечание

Нужен скриншот

Выберите Параметры запуска...:

примечание

Нужен скриншот

И введите туда:

./run_bepinex.sh %command%

Нажмите ОК и запустите игру через Steam.

macOS

Откройте библиотеку игр Steam, нажмите правой кнопкой по игре и выберите Свойства...:

примечание

Нужен скриншот

Выберите Параметры запуска...:

примечание

Нужен скриншот

Теперь, откройте терминал в корневой папке игры и выполните:

pwd

Выведется полный путь к корневой папке игры. Скопируйте и вставьте его в поле параметров запуска и добавьте /run_bepinex.sh %command%:

"<PWD>/run_bepinex.sh" %command%

где <PWD> - полный путь к корневой папке игры.

Нажмите ОК и запустите игру через Steam.

Установка RogueLibs

RogueLibs v4.0.0-rc.1

Обратная совместимость

RL v4 совместим с модами сделанными на RL v3!

Скачайте последнюю версию RogueLibs - v4.0.0-rc.1

Вам надо скачать только один файл - RogueLibsCore.dll.

Перейдите к папке BepInEx и положите файл RogueLibsCore.dll в папку plugins:

RogueLibsPatcher.dll

В предыдущих версиях надо было также устанавливать патчер, но теперь он устанавливается ✨автоматически✨!

RogueLibs v3.x.x

предупреждение

RogueLibs v3.x.x уже устарел и может не поддерживать новые моды!

Скачайте последнюю версию RogueLibs

Вам надо скачать только два файла: RogueLibsCore.dll и RogueLibsPatcher.dll.

Перейдите к папке BepInEx и положите файл RogueLibsCore.dll в папку plugins:

И положите файл RogueLibsPatcher.dll в папку patchers:

предупреждение

Папка называется patchers, она отличается от plugins.

RogueLibs v2.x.x

предупреждение

RogueLibs v2.x.x уже устарел и несовместим с новыми модами!

Скачайте последнюю версию RogueLibs

Вам надо скачать только один файл - RogueLibs.dll.

Перейдите к папке BepInEx и положите файл RogueLibs.dll в папку plugins:

Устанавливаем плагины (моды)

Скачайте моды, которые вы хотите установить (файлы с расширением .dll).

И положите эти .dll файлы в папку BepInEx/plugins.

Где я могу найти моды?

SoR ModHub - это коллекция модов, использующих последнюю версию RogueLibs v3, о которых я знаю. Содержит ссылки на другие источники и регулярно обновляется.

GameBanana - официальное место для поста модов на Streets of Rogue.

ModDB и NexusMods практически не используются.