Modding:Content Mods

This page was last verified for Vintage Story version 1.19.4.

Content Mods are mods that add or change existing JSON assets within the game, using the type "content".

Content Mod Usage

As stated in Getting Started, Vintage Story contains an extensive system to add and modify game content by just using JSON files.

If you plan on modifying game content, it is recommended to backup your assets folder before beginning.

Adding Content

Adding content to Vintage Story is easy, and nearly all of the game's assets are built using the modding system. By navigating the Asset System for the game, you can see thousands of examples that can be edited and expanded upon. New blocks, items, entities and more can be added by simply creating new files based on these existing JSON files.

Modifying Game Content

Although content can be modified by overwriting entire JSON files, it is highly recommended to use the patching system that is built in to the game. For an extensive look on how to do this, see the JSON Patching modding page.

First Steps

Create your own Content Mod

For a content mod to work, it needs to be set up correctly. See Developing a Content Mod for information on how to create, navigate, and update a content mod.

Following the Wiki Tutorials

When you are familiar with how to create a content mod, consider taking a look at the basic tutorials. You can create a Basic Block, Basic Item, Recipes, and many more.

In the Modding navigation box below, any non-highlighted links do not require C# code to achieve. Content mods can be quite complex at times, so it is recommended to start with one of the above tutorials.

Wondering where some links have gone?
The modding navbox is going through some changes! Check out Navigation Box Updates for more info and help finding specific pages.