Modding:Theme Pack: Difference between revisions

From Vintage Story Wiki
m
no edit summary
(Created page with "== Packing == == Info file == Every zip-file mod requires a <code>modinfo.json</code> inside the root directory of the archive. Otherwise the entire mod will be ignored. Thi...")
 
mNo edit summary
 
(14 intermediate revisions by 6 users not shown)
Line 1: Line 1:
== Packing ==
<languages/><translate>
{{GameVersion|1.19}}
__TOC__


== Info file ==
<!--T:1-->
'''Theme Packs''' are mods that do not change the game mechanics, only visuals, sounds, etc. They are [[Mod_Packaging|packed like any other mod]], using the type <code>"theme"</code>.


Every zip-file mod requires a <code>modinfo.json</code> 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.
<!--T:2-->
Due to the way they work, theme packs never add new content, only replace existing content. These mods only affect the player who has them installed (the client), not the server.


An example of a theme pack info file (<code>modinfo.json</code>):
== Overriding Game Files == <!--T:3-->
<syntaxhighlight lang=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"
}
</syntaxhighlight>


----
<!--T:4-->
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 (<code>assets/survival/textures/block/soil/fertlow.png</code>) you would place your replacement at <code>assets/game/textures/block/soil/fertlow.png</code> inside your zip file. Note that the original file is stored in the 'survival' folder, however the overwritten folder is stored within the 'game' folder. This is because all base-game blocks use the 'game' prefix in their ID.
Check out [[Media:ExampleTexPack.zip|the example theme pack]] for a simple demo of overriding game assets.


The <code>type</code> '''theme''' will define this mod being a ThemePack. So it cannot override gameplay affecting assets categories (such as blocktypes, itemtypes and so on) and no scripts or mod classes will be loaded.
== Overriding Mod Files == <!--T:3-->


<syntaxhighlight lang=json>
<!--T:5-->
  "gameversions": [ "1.5.0.3+" ],
Overriding assets from other mods is also possible, see [[The_Asset_System#Overwriting assets|the asset system]] page for more details.  
</syntaxhighlight>


Means this ThemePack requires 1.5.0.3 or a newer version.


== Icon ==
<!--T:6-->
 
{{Navbox/modding|Vintage Story}}
 
</translate>
 
== Distribution ==
Confirmedusers
637

edits