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 (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