Mod Version Compatibility

Versioning

Mods built for Noble Fates have a series of special folders that can be used to supply content that is compatible with specific Noble Fates releases. This can be done to ensure continued compatibility with ongoing games while leveraging new features within the same Mod.

Versions

Each Major release of Noble Fates has a new Major Version associated with it. The Adventures Update, for example, is v0.27. The Wedding & Elves Update was v0.26.

Compatibility Tags

Each new Major Version of Noble Fates will receive a new compatibility tag on the Steam Workshop that corresponds with the new version number. Uploading a mod using a given version of the game will add the appropriate version tag to your mod on the workshop.

NOTE: The game does not prevent loading of an incompatible MOD at this time, we will likely revisit this in the future.

Already Compatible

If your mod already loads up okay in the new version, all you need to do is upload it from within the new version of the game to get the appropriate Compatibility Tag. Your mod does not need Version folders if it doesn't require changes to be compatible with that version.

Version Specific Content

If your mod requires changes to be compatible with a new version of the game, place these in a folder in the root of the mod named after the corresponding Version. The contents of this folder will be loaded by any Version equal to or greater than the name of the folder. For example, the contents of a v0.26 folder will load in versions v0.26, v0.27, v0.28... and so on. A v0.27 folder would be ignored by v0.26, but loaded by v0.27 and on.

Any file that exists within a Version folder will replace any file with the same name and path from a lesser version or the root of the mod. All other files are inherited from prior versions and the root. It's okay to include other files that are only needed from that version on in the Version folder even if they don't override an existing file.

For example, v0.26 of the Abandoned Supplies Mod looked like this:

• DropMod.dll
• DroppedSupplies.fbx
• Drops.octdat
• OctMod.info

We compiled a new DLL for v0.27 compatibility that we wanted to override the existing DLL, so we placed it at the root of a v0.27 folder like so:

• DropMod.dll
• DroppedSupplies.fbx
• Drops.octdat
• OctMod.info
• v0.27
  • DropMod.dll

This causes the dll to be replaced in v0.27 (and onward) with the one contained in that folder. In Versions prior to v0.27, the one at the root of the mod is used instead.

NOTE: Make sure you include any files you want to override at the same path within the Version folder.

So if you want to override:

• octdats
  • special.octdat

You'd put the replacement in an octdats folder inside of the v0.27 folder like so:

• octdats
  • special.octdat
• v0.27
  • octdats
    • special.octdat

Don't hesitate to ask on Discord if you have any questions.

Happy Modding!