Modding:Content Tutorial Simple Item

This page was last verified for Vintage Story version 1.19.4.

Introduction

Objective

In this tutorial, you will create an item - A simple wand! Although this item will have no real functionality, it will demonstrate how to create assets in json, as well as how to use shapes, textures, and lang files.

Assets

Before starting, it is recommended you download the workspace and assets for this tutorial. The completed files can also be found here.

This tutorial starts with the following assets:

• Mod Setup & Folder Structure
• Empty item file
• Template lang file
• Item shape file
• Item texture file

Prerequisites

This tutorial will assume you understand the following topics:

• Setting up a content mod.
• The functions of shape, texture and lang files.

Navigating Assets

Using the downloaded workspace, have a look at the files that currently exist.

• modinfo.json - The mod info file, which registers your mod with the ID 'simpleitem'.
• modicon.png - The mod icon file, which will be displayed on the mod manager menu.
• assets/simpleitem/itemtypes/simplewand.json - An empty file, this is where you shall put the code for your item.
• assets/simpleitem/lang/en.json - A sample language file, which is where you will add your translation values.
• assets/simpleitem/shapes/item/simplewand.json - A shape file for the wand.
• assets/simpleitem/textures/item/simplewand.png - A texture file for the wand.

Going Further...

Want to make some additional changes to this mod? Try and achieve the following things!

• Change the color of the wand.

To achieve this...
Modify the simplewand.png texture to a different color!

• Change your modid and domain to something else.

To achieve this...
Modify both the modid entry in modinfo.json, and change the name of the 'simpleitem' folder in 'assets'.

Conclusion

Congratulations, you have now (created your first item...)! This tutorial should have given you some understanding of (blah blah blah).

Next Steps...

Try out the next tutorial, (link). This will show you how to create a (...)!

Content Modding
Basics	Content Mods • Developing a Content Mod
Tutorials	Basic Basic Tutorials • 1. Content Essentials • 2. Simple Item • 3. Simple Block • 4. Simple Recipes Intermediate Intermediate Tutorials • 5. Item Variants • 6. Block Variants • 7. Complex Grid Recipes • 8. Further Recipes • 9. Simple World Generation Advanced Advanced Tutorials Other Debugging Content
Concepts	Modding Concepts • Variants • Domains • Patching • Remapping • World Properties
Uncategorized	Basics Basic Examples • Asset System • Textures • Items • Recipes • Blocks • Entities • Model Creator • Animation • VTML & Icons • Packaging & Release • Modinfo Advanced Advanced JSON Item • Compatibility with other mods Worldgen WorldGen Concepts • Terrain • Ores • Trees • Json Random Generator

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.