Modding:Asset System

From Vintage Story Wiki


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

Creating your own domain

Overwriting game assets

Resourcepacks

The idea behind it

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

Install a resourcepack