Modding:Basic Block

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\

Advanced Properties

Properties Overview

A complete list of all available properties:

• Json File
  • code (string)
  • maxstacksize (number): default: 64
  • enabled (boolean): default: true; If the block will be added to game or not.
  • randomdrawoffset (boolean): default: false; If the block has a random draw offset.
  • renderpass
    • opaque (default)
    • opaquenocull
    • transparent
    • liquid
    • topsoil
  • variantgroups (array)
    • loadFromProperties
  • creativeinventory
    • default
  • shapeinventory
  • shape
    • base
  • shapebytype
  • ambientocclusion (boolean): default: true; If ambient occlusion will be applied to the block.
  • blockmaterial
  • drawtype
    • blockLayer_1
    • blockLayer_2
    • blockLayer_3
    • blockLayer_4
    • blockLayer_5
    • blockLayer_6
    • blockLayer_7
    • json
    • empty
    • cube
    • cross
    • transparent
    • liquid
    • crossandsnowlayer
  • textures
  • texturesinventory
  • texturesbytype
  • texturesinventorybytype
  • resistance
  • sounds
    • place
    • walk
    • break
    • hit
    • inside