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

Property	Type	Default	Usage
Json
code	string	empty	Usage
maxstacksize	number	64	determines the maximum amount you can stack the block in one slot
enabled	boolean	true	if the block will be added to game or not
renderpass	enum	opaque
opaque		0	default blocks
opaquenocull		1
transparent		2
liquid		3
topsoil		4
variantgroups	arrays