Modding:Basic Block

From Vintage Story Wiki


This tutorial should introduce you into the basic of adding a block to the game using JSON files. Down below you can find a complete list of all existing properties. If your block requires more than just a JSON file there is a tutorial for Advanced Blocks.

A Simple Block

Let's add a simple block to the game. In our example we will add a new wooden planks type.

The Texture

First of all we need a texture. We will add a spruce wood plank to the game using this texture: File:Spruce1.png.

Now we need to copy the texture to the game assets. Therefore navigate to the Vintagestory folder and place it in assets\textures\blocks\wood\planks\

The JSON file

Testing

Export a mod

Advanced Properties

Properties Overview

A complete list of all available properties:

  • Json File
    • code
    • variantgroups (array)
      • loadFromProperties
    • creativeinventory
      • default
    • shape
      • base
    • blockmaterial
    • drawtype
      • BlockLayer_1
      • BlockLayer_2
      • BlockLayer_3
      • BlockLayer_4
      • BlockLayer_5
      • BlockLayer_6
      • BlockLayer_7
      • JSON
      • Empty
      • Cube
      • Cross
      • Transparent
      • Liquid
      • CrossAndSnowlayer
    • textures
    • resistance
    • sounds
      • place
      • walk