Modding:Block Json Properties: Difference between revisions

An incomplete list of all available properties

   <tr style='background-color: gray;'>

     <td colspan="4" style='font-size: 14pt; border-bottom: 2pt solid black; padding-left: 100px;'><b>Core (no byType available)</b></td>

A '''domain prefix''' will be added dynamically depending on the location of the file. Every mod and the VintageStory itself have a unique prefix.

For example the code '''<code>stone</code>''' would turn into '''<code>game:stone</code>'''.  

The code identifier has to be unique, at least inside his domain, so in theory there can be equal identifiers with different domain prefixes.

The variantgroups property allows you to define multiple variants of this block. All of them will have their unique code, which will added to the code.

Additionally it is possible to refer to external lists that are found in the worldproperties folder, such as <code>block/rock</code>, which contains all states of all rock types. This used for <code>gravel</code>, <code>sand</code> and <code>rock</code>:

Futhermore there are two ways of combining together groups. So far we covered the default combination mode, which is <code>multiplicative</code> (the total count of variants is the product of all states).

Things might get clearer if we look at another example:

     <td colspan="4" style='font-size: 14pt; border-bottom: 2pt solid black; padding-left: 100px;'><b>Specific</b></td>

A complete tutorial of how to create your own class can be found [[Advanced Blocks|here]].

A complete tutorial of creating your own entityclass can be found [[Block Entity|here]].

     <td>A behavior adds custom abilities such as falling block..</td>

Here is an overview of all exisiting behaviors, if you want to create your own custom behavior you can read [[Adding Block Behavior]].

     <td>Basic glow level for all the blocks model elements.</td>

<td>If true and the quantity dropped is >=1 any subsequent drop will be ignored.</td>

Futhermore you can also switch between different distribution modes using the '''''dist''''' property.

     <td colspan="4" style='font-size: 14pt; border-bottom: 2pt solid black; padding-left: 100px;'><b>Common</b></td>

     <td>Custom Attributes that's always assiociated with this item.</td>

Extra attributes added to a block. Those are final and cannot be modified. It's a good way to keep things oragnized and and modifiable. The '''oreblastingbomb''' for example has attributes, which define its radius and type. These can be used by behaviors and blockentities:

        "blastRadius": { type: "Int", value: 4 },

        "blastType": { type: "Int", value: 0 },

    },

     <td>The temperature at which it burns.</td>

     <td>For how long it burns.</td>

     <td>How many degrees celsius it can resists before it ignites.</td>

     <td>How many degrees celsius it takes to smelt/transform this into another. Only used when put in a stove and Melted is set.</td>

     <td>If set, the block/item is smeltable in a furnace and this is the resulting itemstack once the MeltingPoint has been reached for the supplied duration.</td>

Futhermore it can be used to define smelting processes. An example would be an '''ingotmold''' which turns into an ingotmold-burned:

     <td colspan="4" style='font-size: 14pt; border-bottom: 2pt solid black; padding-left: 100px;'><b>Rendering</b></td>

     <td>The texture definitions for the block as seen in the world, when dropped on the ground or held in the hand.</td>

     <td>Culls all faces that are adjacent to opaque faces and faces adjacent to blocks of the same id.</td>

     <td>Culls all faces that are adjacent to opaque faces and the bottom, east or south faces adjacent to blocks of the same id. This causes to still leave one single face inbetween instead of 2, eliminating any z-fighting.</td>

     <td>Same as Merge but checks for equal material.</td>

     <td>Same as Collapse but checks for equal material.</td>

     <td>array of 0 ... 255</td>