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 = 1
      • BlockLayer_2 = 2
      • BlockLayer_3 = 3
      • BlockLayer_4 = 4
      • BlockLayer_5 = 5
      • BlockLayer_6 = 6
      • BlockLayer_7 = 7
      • JSON = 8
      • Empty = 9
      • Cube = 10
      • Cross = 11
      • Transparent = 12
      • Liquid = 13
      • CrossAndSnowlayer = 14
    • textures
    • resistance
    • sounds
      • place
      • walk