Modding:Asset System

Asset System

Vintage Story loads most of its game content from so called assets. Those can be found inside your Vintagestory folder. Things such as blocks, items, world generation, recipes, etc. are all loaded from assets during startup.

These assets are easily modifiable and using the integrated mod system you can add your own stuff without having to mess with coding.

Categories

Here is an overview of categories:

Name	Affects Gameplay	Side Type	Usage
AssetCategory
blocktypes	true	universal	Blocks
itemtypes	true	universal	Items
lang	false	universal	Translation
worldproperties	true	universal
abstract	true	universal
block	true	universal
sounds	false	universal	Sounds
shapes	false	universal	Blocks
block	false	universal	Shapes for blocks
entity	false	universal	Shapes for entities
item	false	universal	Shapes for items
recipes	true	server only	Recipes for all kinds of machinery
alloy	true	server only
grid	true	server only	Recipes for Workbench
smithing	true	server only
worldgen	true	server only
terrain	true	server only
tree	true	server only
entities	true	server only	Entities
shaders	false	client only
shaderincludes	false	client only
textures	false	client only
blocks	false	client only	Block textures
decal	false	client only	Item textures
entities	false	client only	Entities textures
environment	false	client only	Environment textures (Sky, Moon, Sun, etc.)
gui	false	client only	Gui textures
hud	false	client only	Hud textures
particle	false	client only	Particle textures
music	false	client only
dialog	false	client only

Domains

In order to tell whether a block (can also be an item or entity) is added bythe game or a mod, VintageStory uses Domains. Those are prefixes for any path. For example any assets added by VintageStory it will have the prefix game. Meaning the textures inside assets/textures/blocks/randomtexture.png will have an AssetLocation (domain and path combined) of game:assets/textures/blocks/randomtexture.png.

Mods

Resourcepacks

The idea behind it

Resourcepacks should be able to overwrite assets of Vintagestory and mods, but shouldn't have a gameplay affect.