Modding:Content Tutorial Further Recipes: Difference between revisions

From Vintage Story Wiki
mNo edit summary
m (First changes...)
Line 7: Line 7:


=== Objective ===  
=== Objective ===  
Page in progress! Recipes in Vintage Story are very versatile, and the grid recipe system has a number of features that have not yet been talked about. In this tutorial, you will find out how to create more complex recipes, including those with variants, different itemstack quantities, returned itemstacks, and some other smaller features.
Vintage Story doesn't just use the grid for recipes. In this tutorial, you will learn how to create items or blocks by using barrels, clayforming, knapping and smithing. This tutorial will also give some information on alloy and cooking recipes, however these work in a somewhat more complex way to the others.


=== Assets ===
=== Assets ===
Before starting, it is recommended you [https://github.com/Nateonus/vsmodexamples/releases/tag/ComplexGridRecipesTutorial download the workspace and assets] for this tutorial. The completed files can also be found here.  
Before starting, it is recommended you [https://github.com/Nateonus/vsmodexamples/releases/tag/FurtherRecipesTutorial download the workspace and assets] for this tutorial. The completed files can also be found here.  


This tutorial starts with the following assets:
This tutorial starts with the following assets:


* Mod Setup & Folder Structure
* Mod Setup & Folder Structure
* Simple 'Sleek Door' recipe
* Incomplete 'agedlog' Barrel Recipe
* Incomplete 'bricks' Clayforming Recipe
* Incomplete 'stone-brick' Knapping Recipe
* Incomplete 'metalsheets' Smithing Recipe


=== Prerequisites ===
=== Prerequisites ===
Line 22: Line 25:
* [[Modding:Developing a Content Mod|Setting up a content mod and using an IDE.]]
* [[Modding:Developing a Content Mod|Setting up a content mod and using an IDE.]]


It is recommended to have completed the following tutorial:
It is recommended to understand the following concept:


* [[Modding:Content Tutorial Simple Recipe|4. Simple Recipes]] - This tutorial begins with a basic recipe.
* [[Modding:Variants|Variants]]


It is recommended, but not necessary, to understand the following concept:
== Navigating Assets ==


* [[Modding:Variants|Variants]]
This tutorial only contains recipe assets. You will be creating recipes for a number of objects that are already in game. Take a look at the following files:


== Navigating Assets ==
* ''assets/recipes/barrel/agedlog.json''
* ''assets/recipes/clayforming/bricks.json''
* ''assets/recipes/knapping/stone-brick.json''
* ''assets/recipes/smithing/metalsheets.json''


This tutorial is simply to create new recipes - The only file is ''recipes/grid/sleekdoor.json''. This is a simple recipe, which inputs an oak solid door and outputs an oak sleek door.
== Barrel Recipes ==
Upon opening the barrel recipe (''agedlog.json),'' you will see the following unfinished code:<syntaxhighlight lang="json">
{
  "output": {
    "type": "block",
    "code": "game:log-placed-aged-ud",
    "quantity": 1
  }
}
</syntaxhighlight>


== Conclusion ==
== Conclusion ==

Revision as of 14:22, 18 April 2024

This page was last verified for Vintage Story version 1.19.7.


Introduction

Objective

Vintage Story doesn't just use the grid for recipes. In this tutorial, you will learn how to create items or blocks by using barrels, clayforming, knapping and smithing. This tutorial will also give some information on alloy and cooking recipes, however these work in a somewhat more complex way to the others.

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
  • Incomplete 'agedlog' Barrel Recipe
  • Incomplete 'bricks' Clayforming Recipe
  • Incomplete 'stone-brick' Knapping Recipe
  • Incomplete 'metalsheets' Smithing Recipe

Prerequisites

This tutorial will assume you understand the following topics:

It is recommended to understand the following concept:

Navigating Assets

This tutorial only contains recipe assets. You will be creating recipes for a number of objects that are already in game. Take a look at the following files:

  • assets/recipes/barrel/agedlog.json
  • assets/recipes/clayforming/bricks.json
  • assets/recipes/knapping/stone-brick.json
  • assets/recipes/smithing/metalsheets.json

Barrel Recipes

Upon opening the barrel recipe (agedlog.json), you will see the following unfinished code:

{
  "output": {
    "type": "block",
    "code": "game:log-placed-aged-ud",
    "quantity": 1
  }
}

Conclusion

Congratulations, you now have an advanced recipe for every type of sleek door, all within one file! After this tutorial, you should have more of an understanding of how variants can be used within grid recipes, and how grid recipes have a lot more functionality.

Next Steps...

If you want to test your knowledge, consider doing the tasks under the Going Further section below.

Grid recipes are only one type of recipe in Vintage Story. Move on to the next tutorial, Further Recipes, for information on barrel, clayforming, cooking, knapping, and smithing recipes!

Going Further

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


Content Modding
Basics Content Mods Developing a Content Mod
Tutorials
Concepts Modding Concepts Variants Domains Patching Remapping World Properties
Uncategorized
Icon Sign.png

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.

Modding
Modding Introduction Getting Started Theme Pack
Content Modding Content Mods Developing a Content Mod Basic Tutorials Intermediate Tutorials Advanced Tutorials Content Mod Concepts
Code Modding Code Mods Setting up your Development Environment
Property Overview ItemEntityBlockBlock BehaviorsBlock ClassesBlock EntitiesBlock Entity BehaviorsWorld properties
Workflows & Infrastructure Modding Efficiency TipsMod-engine compatibilityMod ExtensibilityVS Engine
Additional Resources Community Resources Modding API Updates Programming Languages List of server commandsList of client commandsClient startup parametersServer startup parameters
Example ModsAPI DocsGitHub Repository