Данное руководство предназначено для активных игроков в Restoration Mod. Если вы ещё с ним незнакомы, рекомендуется просмотреть гайды для новичков:
https://steamhost.cn/steamcommunity_com/sharedfiles/filedetails/?id=1923528592
https://www.youtube.com/watch?v=fglmBFZ2R1A


Restoration Mod обладает двумя версиями. gold - это стабильная версия, которая выходит примерно раз в месяц (или когда очередной апдейт ваниллы ломает мод). Она является стандартной и именно на неё размещена ссылка в Modworkshop.

Но не все знают, что авторы мода предоставляют возможность тестировать самые последние изменения мода - для этого существует dev версия. В неё изменения заносятся сразу по мере их добавления в мод.

Restoration Mod получает изменения каждые сутки. Как игрок будет настолько часто обновлять мод, который весит почти 2ГБ? Перекачивать его при каждом мелком изменении? Разумеется нет, в этом нам поможет программа Github Desktop, которая является клиентом сервиса Github.

Это руководство подскажет, как установить и обновлять dev версию Restoration Mod и расскажет про некоторые особенности, связанные с ней.

Github Desktop - это клиент сервиса Github, который используется для совместной разработки проектов (программ, игр, модов и т.п.) Именно его используют разработчики Restoration Mod.
Скачать клиент можно с официального сайта Github: https://desktop.github.com/

Интерфейс Github Desktop может изначально показаться нагромождённым, но это не беда: Нам понадобятся лишь некоторые функции. На верхней панели выберите File > Clone repository... (или нажмите Crtl + Shift + O)


В открывшемся меню сверху выберите меню URL.
В графу Repository URL скопируйте репозиторий Restoration Mod (см. картинку снизу):
https://github.com/payday-restoration/restoration-mod.git

В графе Local Path укажите пустую папку, в которую будет качаться dev версия. Учтите, что при каждом обновлении вам нужно будет перемещать её в вашу папку mods: Поэтому поместите её близко к вашей папке mods. (например, на картинке я создал пустую папку прямо в mods)


Если вы всё сделали правильно, вы увидите такое меню.

Так как Github прежде всего предназначен для кода и плохо обращается с большими файлами (Restoration Mod весит 2ГБ), скачивание будет не очень быстрым. На слабых системах рекомендуется закрыть все остальные программы, так как если процесс повиснет/остановится, качать придётся заново.


Нажмите на кнопку Current branch и выберите там dev. После этого нажмите на кнопку Fetch origin и Pull origin - dev-версия обновится до последней (подробнее об этом смотрите в следующем разделе)

Этот шаг рекомендуется для любого игрока с модами: Прямо в папке mods создайте папку, название которой начинается на "_" (чтобы она было выше всех остальных). В эту папку вы будете помещать моды, которые вам не нужны сейчас, но могут понадобиться потом. Так у вас всё будет под рукой и вы не потеряете свои моды. В данном случае, вам нужно перенести туда gold версию (restoration-mod-gold), на случай, если вы захотите вернуться на неё:


После конца установки, в вашей указанной папке появится папка restoration-mod. Именно в ней и содержится dev версия! Перетащите её в папку mods и можете играть.

Как вы уже знаете, dev версия нужна, чтобы играть с самыми актуальными изменениями, которые заносятся в Restoration Mod почти каждые сутки.

К счастью, проверять изменения и обновлять dev версию при помощи Github Desktop очень легко.


Кнопка Fetch origin проверяет, совпадает ли ваша версия с версией на сайте. Если в моде произошли какие-то изменения, это отобразится.


Крутяк! С последнего обновления произошло одно изменение. Нажмите кнопку Pull Origin и дождитесь конца загрузки.

Теперь последнюю версию снова придётся поставить в папку mods. Самый эффективный способ такой:
-Удалите содержимое папки mods/restoration-mod
-Из папки, куда скачалась последняя dev-версия скопируйте всё, кроме папки .git (это системная папка, необходимая для работы Github Desktop - но не для работы мода)
-Вставьте в папку mods/restoration-mod

Всё, ваша dev версия обновлена! Не забывайте регулярно проверять обновления кнопкой Fetch origin.

Стоит помнить, что dev используется прежде всего для теста новых фич игроками. Поэтому, стабильность не гарантируется - ваша игра может и будет вылетать! Однако, разработчики активно работают над фиксами любых проблем. Если вы встретили какую-либо проблему/краш в моде, сообщите о нём в нашем дискорде, в канале #access-violation:
https://discord.gg/5vjbS3V
Мы обязательно передадим вашу проблему западным коллегам!

Как правило, gold и dev версии несовместимы. Тем не менее, они используют одинаковый ключ матчмейкинга, поэтому вы будете видеть лобби с другой версии (но не сможете присоединиться - вам сразу выдаст "невозможно подключиться к игре"). Однако, есть исключительный случай, когда gold и dev совпадают: Как правило, некоторое время после выхода новой gold-версии.
Несмотря на это, играть на dev с игроками в gold и наоборот не рекомендуется: Краши практически гарантированы.

Rich Presence - это фича в Discord и Steam, которая отображает под вашим ником, чем вы конкретно занимаетесь в игре в данный момент. Вы можете использовать её, чтобы дать понять другим игрокам в Restoration Mod, какую версию вы используете. Для этого нам понадобится мод Rich Presence Updated, который позволяет менять текст Rich Presence в Steam:
https://modworkshop.net/mod/30885
1. Скачайте и установите мод.
2. В папке с модом откройте файл RichPresence.lua (при помощи Notepad++ или другого текстового редактора по вкусу)
3. На строке 129 найдите графу
["#raw_status"] = "[RES MOD] {#State_%game:state%}",
4. Измените текст в кавычках справа. Например, на картинке снизу он был изменён на "ResMod dev: {#State_%game:state%}"

Теперь все друзья увидят, что вы играете именно в dev! Не забудьте менять текст на gold, если переключитесь на эту версию.

Изменения в dev-версии можно проверить в официальном дискорде Restoration Mod, в канале #dev-branch:

Если вы не знаете английский, за последние изменения в dev всегда можно спросить в русскоязычном дискорде Restoration Mod.

Если вы установили dev версию, не удаляйте gold: Возможно, вы захотите на неё вернуться. Помимо этого, есть игроки, которые предпочитают играть только на gold.

Не забывайте вступать в западный и русскоязычный дискорды Restoration Mod'а, техпомощь и регулярные встречи в Ресмоде ждут вас!:
Официальный дискорд (англ.)
https://discord.gg/YmQkDyY
Дискорд русскоязычного сообщества (укр.)
https://discord.gg/5vjbS3V

Спасибо за прочтение гайда, и увидимся в Restoration Mod!
Если у вас остались вопросы, задайте их в дискорде или комментариях.