Automatic Updates
The Payday 2 BLT has a feature that allows some mods to automatically update themselves from within Payday 2 itself. Any mod that is setup on the Payday Mods Manager will automatically be checked for updates when the game loads.
In order for the automatic updates system to work for a mod, it must first have its identifier created in the mod manager. If you do not have an account for the Mod Manager, contact one of us and we'll set you up an account and get you started.
Once an identifier has been created, the mod definition file itself needs to have the identifier data itself put into it, so that the game knows which mods to check for updates, and to download. Never put any other identifier other than your own mods in the mod definition file, or your mod will be un-installed and another mod installed instead during an update.
There are also some special considerations which should be made when creating your mod if you will want to incorporate automatic updates. Read these carefully, or you may cause users to lose their save data for your mod, damage your modifications installation, or damage a users Payday installation.
Your mod will require it's mod definition file updating before your automatic updates will work. This is done via adding an updates key to your mod definition file.
The updates key is an array of objects with specific keys to tell the mod manager how to handle updating your mod.
identifier A string key containing the identifier of your mod. This is used to check the correct mods on the PaydayMods API, and to download and update the correct mod when required.
install_dir A string key containing the path of the location to install your mod. This is only required if you need your mod to be installed in a path other than the mods folder.
For installing and updating the accompanying mod_overrides of your mod, this value should be set to assets/mod_overrides/.
install_folder A string key containing the name of your mod_overrides folder. This folder will be removed, so that the updated version may be installed in its place.
display_name A string key used for the display name of any extra downloads and updates that may be required alongside your mod. If this value is not set, the name of your mod will be used instead.
"updates" : [
{
"identifier" : "goonmod"
},
{
"identifier" : "goonmodwepcust",
"install_dir" : "assets/mod_overrides/",
"install_folder" : "GoonModWeaponCustomizer",
"display_name" : "GoonMod Weapon Customizer"
}
]
Once you've added your updates key to your mod definition, and setup your mod on the Mod Manager, you can prepare your mod for upload to the server, and to put an update out.
Step 1 - Archive
To upload your mod you will need to archive the mod folder, and the mod_overrides folder if necessary, correctly.
This is done by simply creating a zip file of the mod folder from within the mods directory, or of the overrides folder from within the mod_overrides directory.
Step 2 - Mod Manager
The next step is done on the Mod Manager, so you'll want to open it up and select the mod you intend to update.
Click on the New Version tab if it isn't already open, this is the page you'll use to put out your update.
First thing, is to fill in the Patch Notes for your mod. These will be displayed to the user when they select that they want to view the patch notes of an update.
Finally, select your archived mod to be uploaded in the Release field. This it the file that will be downloaded and installed by all users of your mod.
Step 3 - Publish
Once you've filled in your update information, simply click the Publish New Version button. Your archive will be uploaded, and once complete will start to automatically update all mod users.