Skip to content

Developer: Ensuring Mods are Compatible with the Mod Update Check utility

Ryan Walpole edited this page Apr 13, 2022 · 3 revisions

Ensuring Mods are Compatible with the Mod Update Check utility

Pre-Requisites

In order for your mod to be compatible with the mod update check utility, please ensure that your mod meets the following criteria:

  • Your mod must contain a manifest.json file that is stored in the root directory.
  • Your mod must be hosted on NexusMods and have an Update Key (the digits in the URL to your mod listing).
  • The manifest.json file must contain a NexusMods Update Key (configured as: "UpdateKeys": [ "Nexus:####" ] where the # includes your numerical update key for NexusMods.)
  • The manifest.json file must contain a version number that is formatted in the same format as your Nexus website listing.
  • The manifest.json file must not contain multiple update keys or update keys for other services.

Manifest JSON Examples

The following is an example of a good manifest.json that is located at the root directory. It is a good manifest.json file as it contains a version number and a properly formatted NexusMods UpdateKey.

{
    "Name": "My Awesome Mod",
    "Author": "RWE Labs",
    "Version": "1.24.8",
    "MinimumApiVersion": "3.14.0",
    "Description": "A really cool mod for demonstration purposes.",
    "UniqueID": "RWELabs.AwesomeMod",
    "EntryDll": "AwesomeMod.dll",
    "UpdateKeys": [ "Nexus:1234" ]
}

The following is an example of a bad manifest.json that is located at the root directory. It is a bad manifest.json file as it contains multiple update keys for different services. Please note when we say this manifest is bad, we only mean in context of being compatible with the Stardew Valley Mod Manager. Otherwise, this Manifest is completely functional and good.

{
    "Name": "My Awesome Mod",
    "Author": "RWE Labs",
    "Version": "1.24.8",
    "MinimumApiVersion": "3.14.0",
    "Description": "A really cool mod for demonstration purposes.",
    "UniqueID": "RWELabs.AwesomeMod",
    "EntryDll": "AwesomeMod.dll",
    "UpdateKeys": [ "Nexus:1234","GitHub:MyUser\Repo2" ]
}