Modding:Theme Pack

From Vintage Story Wiki
Revision as of 09:52, 4 March 2018 by Milo (talk | contribs) (Added some info about overriding game textures, and added an example mod.)

Info file

Every zip-file mod requires a modinfo.json inside the root directory of the archive. Otherwise the entire mod will be ignored. This info file specifies what kind of me it is, its name, author, etc.

An example of a theme pack info file (modinfo.json):

{
  "type": "theme",
  "name": "My Example Themepack",
  "description" : "This is a themepack and serves as an example.",
  "author": "CreativeMD",
  "version": "1.0",
  "gameversions": [ "1.5.0.3+" ],
  "website": "http://example.com"
}

  "type": "theme",

Defines this mod as being a ThemePack. Therefore it cannot override gameplay affecting assets categories (such as blocktypes, itemtypes and so on) and no scripts or mod classes will be loaded.

  "gameversions": [ "1.5.0.3+" ],

Means it requires at least VintageStory v1.5.0.3 or a newer version.

Icon

The file modicon.png (if it exists) will be used and shown in the mod manager menu.

ThemePack Icon.png

Overriding Files

Replacing game files is fairly easy, just create a directory names "assets" with a directory named "game" inside it, then copy replacements for any asset in the game's "assets" directory here. For example, to overwrite the texture for low fertility soil blocks ("assets/textures/block/soil/fertlow.png") you would place your replacement at "assets/game/textures/block/soil/fertlow.png" inside your zip file.

Overriding assets from other mods is also possible, see the asset system page for more details. Check out the example theme pack for a simple demo of overriding game assets.

Distribution

Feel free to share your creation in our forums. We would love to see what you come up with.