PAYDAY 2

PAYDAY 2

Not enough ratings
Restoration Mod: dev-branch: How to play with the latest changes
By Marshie
This guide is intended for Restoration Mod players. It describes the difference between dev and gold versions of Restoration Mod.
   
Award
Favorite
Favorited
Unfavorite
What is the dev-branch of Restoration Mod?
This guide is intended for advanced players of Restoration Mod. If you're unfamiliar with it, it's recommended to check out new player guide first:
https://steamhost.cn/steamcommunity_com/sharedfiles/filedetails/?id=1366254667

Restoration Mod features two versions. gold is the stable version, which releases about every month (or whenever Overkill breaks the mods). It is considered the definitive version and can be downloaded off the Modworkshop.

However, the ResMod team allows us to test the newest changes in almost real time. The dev version exists for this very purpose.

Restoration Mod gets new changes almost daily. How can you update a mod which is almost 2GB in size so often? Do you re-download it after every small tweak? Of course not - we will use Github Desktop, which is a desktop client of the Github web-service.

This guide will show you how to install and update dev branch of ResMod and detail some of its features.
How to install the dev branch
1. Install Github Desktop
Github Desktop is a desktop client of the Github web-service which is used for collaborative work on projects (such as software, games, mods etc). It is used by the ResMod team.
Download it from Github's official site: https://desktop.github.com/

2. Link the repository
Github Desktop interface might be overwhelming at first, but thankfully we're only going to need a few functions. On the upper panel click File > Clone repository... (or press Crtl + Shift + O)


Choose the URL menu.
In Repository URL paste the link to Restoration Mod repository (see pic below):
https://github.com/payday-restoration/restoration-mod.git

In Local Path choose an empty folder, to which dev branch will be downloaded. Keep in mind that you will have to move it to your PAYDAY 2 'mods' folder every update, so keep it close to your 'mods' folder (for example, in the picture I have created an empty folder right in my 'mods' directory)



3. Wait for the download to finish
If everything is done correctly, you will see this.

Since Github is intended for code first and foremost, it doesn't work well with huge files (ResMod is almost 2GB), so the download won't be very fast. If you have a weak PC, it is recommended to close every other program, as the download will be reset if it's stuck or interrupted.

4. Switch to the dev branch

Press the Current branch button and choose dev. Then, press Fetch origin and then Pull origin. Dev-version will be updated with all the latest changes (see the next section for more info on that)

5. Create a folder for unused mods
This step is recommended for any Payday 2 mod user. In the mods folder create a folder which starts with "_" (so it's higher than everything else). There you will put mods which you currently don't need, but might need later. That way, everything will be neatly organized and you won't lose any of your mods. In this case, you need to put gold version of ResMod in there (restoration-mod-gold). This is needed in case you want to switch back to gold.

6. Install the dev version
After Github Desktop is done, you will see restoration-mod folder in the directory you've chosen on step 2. This folder has the dev version. Move it to your mods folder and you can start playing!
How to update the dev branch
As you know, dev version is needed so you can play with all the latest changes, which are done to ResMod almost daily.

Fortunately, checking and downloading updates is very easy with Github Desktop

1. Open Github Desktop and press Fetch origin

Fetch origin button checks if anything has been done to the dev branch. If there's something new, it will show you.

2. Download the latest changes

Neat! Looks like there's been one change since we last checked. Press Pull origin and wait for the download to finish.

3. Install the latest version
Now you will have to install the latest dev branch once again. The quickest way is this:
-Delete everything in mods/restoration-mod
-From your dev branch folder copy everything apart from .git folder.
-Paste into mods/restoration-mod

That's it, your dev version has been updated! Don't forget to regularly check for changes using the Fetch origin button.
Some important notes regarding the dev branch
1. Stability
Keep in mind that dev branch is considered experimental and unstable. You may and will crash. Fortunately, the devs are quick at work to fix any problems that arise. Post your changelog in #troubleshooting channel of Restoration Mod discord and you will be contacted by a dev quickly!
https://discord.gg/YmQkDyY

2. dev and gold compatibility
dev and gold are generally incompatible. However, they use the same matchmaking key, so you will see the lobbies from the other branch of the mod (but you won't be able to join - you will immediately see "Failed joining game"). There's an exception when dev and gold branches are the same or very similar, in a short time window after a new gold release.
In any case, it is not recommended to play on dev with gold players and vice versa: You will crash.

3. Rich Presence - show all your friends which branch you use!
Rich Presence is a feature on Discord on Steam which displays under your name what exactly you do in the game. You may use it to show other ResMod players, which branch you use. For that, download Rich Presence Updated mod, which allows you to change the text of the feature on Steam:
https://modworkshop.net/mod/30885
1. Download and install the mod.
2. Find the RichPresence.lua file and open it (using Notepad++ or other text editor you prefer)
3. Find line 129:
["#raw_status"] = "[RES MOD] {#State_%game:state%}",
4.Change the text in the quotes on the right. For example, on the picture you can see that is was changed to "ResMod dev: {#State_%game:state%}"

That's it, now all your friends see that you play on dev! If you swtich to gold, don't forget to also switch the text accordingly to avoid any confusion.

4. dev branch changelog
You can find all the changes in Restoration Mod discord, #dev-branch channel:
Closing words
If you've installed the dev branch, don't delete the gold one: You might want to return to it, and most players play on gold branch.

Thanks for reading the guide, and if you have any questions, ask in the comments, or in the Restoration Mod discord! See you in the game!

Restoration Mod discord:
https://discord.gg/YmQkDyY
9 Comments
Marshie  [author] 1 Feb, 2023 @ 6:52am 
It uses the same save.
CPL Hatch 1 Feb, 2023 @ 6:41am 
will saves from resmod gold work on the dev branch or it makes a clean save instead?
Marshie  [author] 13 Mar, 2021 @ 11:53pm 
It's a total overhaul of pretty much all game mechanics, to bring them in line to what PAYDAY used to play like in 2014-2015, while adding more content on top of it.
I suggest looking at this guide if you want to know what it does in detail:

https://steamhost.cn/steamcommunity_com/sharedfiles/filedetails/?id=1366254667
[=QSU=] flankedyou42 13 Mar, 2021 @ 5:07pm 
What is Restoration mod?
Marshie  [author] 11 Mar, 2021 @ 6:22pm 
Because you have to constantly update the branch, which is where Github Desktop becones useful.
powware 11 Mar, 2021 @ 12:35pm 
why do you let them download github desktop and not just download the source of the dev branch straight from github itself
Marshie  [author] 10 Mar, 2021 @ 6:22pm 
agreed
Skeley 10 Mar, 2021 @ 6:10pm 
Nah its a boring mod that makes the game to easy so no thanks.
uHCneKToP 7 Mar, 2021 @ 2:55am 
Thanks