Difference between revisions of "Modding:Item Json Properties"

From Vintage Story Wiki
Jump to navigation Jump to search
Line 20: Line 20:
 
   </tr>
 
   </tr>
 
   <tr>
 
   <tr>
     <td scope="row"><div class="tt" data-tt-id="p_code" data-tt-parent="root">Code</div></td>
+
     <td scope="row"><div class="tt" data-tt-id="p_code" data-tt-parent="root">code</div></td>
 
     <td>string</td>
 
     <td>string</td>
 
     <td>required</td>
 
     <td>required</td>
Line 37: Line 37:
 
   </tr>
 
   </tr>
 
   <tr>
 
   <tr>
     <td scope="row"><div class="tt" data-tt-id="p_enabled" data-tt-parent="root">Enabled</div></td>
+
     <td scope="row"><div class="tt" data-tt-id="p_enabled" data-tt-parent="root">enabled</div></td>
 
     <td>boolean</td>
 
     <td>boolean</td>
 
     <td>true</td>
 
     <td>true</td>
Line 43: Line 43:
 
   </tr>
 
   </tr>
 
   <tr>
 
   <tr>
     <td scope="row"><div class="tt" data-tt-id="p_variantgroups" data-tt-parent="root">VariantGroups</div></td>
+
     <td scope="row"><div class="tt" data-tt-id="p_variantgroups" data-tt-parent="root">variantGroups</div></td>
 
     <td>array of object</td>
 
     <td>array of object</td>
 
     <td>-</td>
 
     <td>-</td>
Line 118: Line 118:
 
   </tr>
 
   </tr>
 
   <tr>
 
   <tr>
     <td scope="row"><div class="tt" data-tt-id="p_byType" data-tt-parent="root">(any) byType</div></td>
+
     <td scope="row"><div class="tt" data-tt-id="p_byType" data-tt-parent="root">(any) bytype</div></td>
 
     <td>key: string; value: object</td>
 
     <td>key: string; value: object</td>
 
     <td>-</td>
 
     <td>-</td>
Line 192: Line 192:
 
   </tr>
 
   </tr>
 
   <tr>
 
   <tr>
     <td scope="row"><div class="tt" data-tt-id="p_class" data-tt-parent="root">Class</div></td>
+
     <td scope="row"><div class="tt" data-tt-id="p_class" data-tt-parent="root">class</div></td>
 
     <td>string</td>
 
     <td>string</td>
 
     <td>&quot;item&quot;</td>
 
     <td>&quot;item&quot;</td>
Line 204: Line 204:
 
   </tr>
 
   </tr>
 
   <tr>
 
   <tr>
     <td scope="row"><div class="tt" data-tt-id="p_durability" data-tt-parent="root">Durability</div></td>
+
     <td scope="row"><div class="tt" data-tt-id="p_durability" data-tt-parent="root">durability</div></td>
 
     <td>integer</td>
 
     <td>integer</td>
 
     <td>0</td>
 
     <td>0</td>
Line 210: Line 210:
 
   </tr>
 
   </tr>
 
   <tr>
 
   <tr>
     <td scope="row"><div class="tt" data-tt-id="p_damagedby" data-tt-parent="root">DamagedBy</div></td>
+
     <td scope="row"><div class="tt" data-tt-id="p_damagedby" data-tt-parent="root">damagedby</div></td>
 
     <td>array of string</td>
 
     <td>array of string</td>
 
     <td>-</td>
 
     <td>-</td>
Line 216: Line 216:
 
   </tr>
 
   </tr>
 
   <tr>
 
   <tr>
     <td scope="row"><div class="tt" data-tt-id="p_damagedby_blockbreaking" data-tt-parent="p_damagedby">BlockBreaking</div></td>
+
     <td scope="row"><div class="tt" data-tt-id="p_damagedby_blockbreaking" data-tt-parent="p_damagedby">blockbreaking</div></td>
 
     <td></td>
 
     <td></td>
 
     <td>0</td>
 
     <td>0</td>
Line 222: Line 222:
 
   </tr>
 
   </tr>
 
   <tr>
 
   <tr>
     <td scope="row"><div class="tt" data-tt-id="p_damagedby_attacking" data-tt-parent="p_damagedby">Attacking</div></td>
+
     <td scope="row"><div class="tt" data-tt-id="p_damagedby_attacking" data-tt-parent="p_damagedby">attacking</div></td>
 
     <td></td>
 
     <td></td>
 
     <td>1</td>
 
     <td>1</td>
Line 228: Line 228:
 
   </tr>
 
   </tr>
 
   <tr>
 
   <tr>
     <td scope="row"><div class="tt" data-tt-id="p_damagedby_fire" data-tt-parent="p_damagedby">Fire</div></td>
+
     <td scope="row"><div class="tt" data-tt-id="p_damagedby_fire" data-tt-parent="p_damagedby">fire</div></td>
 
     <td></td>
 
     <td></td>
 
     <td>2</td>
 
     <td>2</td>
Line 234: Line 234:
 
   </tr>
 
   </tr>
 
   <tr>
 
   <tr>
     <td scope="row"><div class="tt" data-tt-id="p_tool" data-tt-parent="root">Tool</div></td>
+
     <td scope="row"><div class="tt" data-tt-id="p_tool" data-tt-parent="root">tool</div></td>
 
     <td>string</td>
 
     <td>string</td>
 
     <td>-</td>
 
     <td>-</td>
Line 315: Line 315:
 
   </tr>
 
   </tr>
 
   <tr>
 
   <tr>
     <td scope="row"><div class="tt" data-tt-id="p_creativeinventory" data-tt-parent="root">CreativeInventory</div></td>
+
     <td scope="row"><div class="tt" data-tt-id="p_creativeinventory" data-tt-parent="root">creativeinventory</div></td>
 
     <td>key: string, value: string[]</td>
 
     <td>key: string, value: string[]</td>
 
     <td>-</td>
 
     <td>-</td>
Line 346: Line 346:
 
   </tr>
 
   </tr>
 
   <tr>
 
   <tr>
     <td scope="row"><div class="tt" data-tt-id="p_maxstacksize" data-tt-parent="root">MaxStackSize</div></td>
+
     <td scope="row"><div class="tt" data-tt-id="p_maxstacksize" data-tt-parent="root">maxstacksize</div></td>
 
     <td>integer</td>
 
     <td>integer</td>
 
     <td>64</td>
 
     <td>64</td>
Line 352: Line 352:
 
   </tr>
 
   </tr>
 
   <tr>
 
   <tr>
     <td scope="row"><div class="tt" data-tt-id="p_attackpower" data-tt-parent="root">AttackPower</div></td>
+
     <td scope="row"><div class="tt" data-tt-id="p_attackpower" data-tt-parent="root">attackpower</div></td>
 
     <td>decimal number</td>
 
     <td>decimal number</td>
 
     <td>0.5</td>
 
     <td>0.5</td>
Line 358: Line 358:
 
   </tr>
 
   </tr>
 
   <tr>
 
   <tr>
     <td scope="row"><div class="tt" data-tt-id="p_attackrange" data-tt-parent="root">AttackRange</div></td>
+
     <td scope="row"><div class="tt" data-tt-id="p_attackrange" data-tt-parent="root">attackrange</div></td>
 
     <td>decimal number</td>
 
     <td>decimal number</td>
 
     <td>1.5</td>
 
     <td>1.5</td>
Line 364: Line 364:
 
   </tr>
 
   </tr>
 
   <tr>
 
   <tr>
     <td scope="row"><div class="tt" data-tt-id="p_materialdensity" data-tt-parent="root">MaterialDensity</div></td>
+
     <td scope="row"><div class="tt" data-tt-id="p_materialdensity" data-tt-parent="root">materialdensity</div></td>
 
     <td>integer</td>
 
     <td>integer</td>
 
     <td>9999</td>
 
     <td>9999</td>
Line 376: Line 376:
 
   </tr>
 
   </tr>
 
   <tr>
 
   <tr>
     <td scope="row"><div class="tt" data-tt-id="p_liquidselectable" data-tt-parent="root">LiquidSelectable</div></td>
+
     <td scope="row"><div class="tt" data-tt-id="p_liquidselectable" data-tt-parent="root">liquidselectable</div></td>
 
     <td>boolean</td>
 
     <td>boolean</td>
 
     <td>false</td>
 
     <td>false</td>
Line 388: Line 388:
 
   </tr>
 
   </tr>
 
   <tr>
 
   <tr>
     <td scope="row"><div class="tt" data-tt-id="p_miningspeed" data-tt-parent="root">MiningSpeed</div></td>
+
     <td scope="row"><div class="tt" data-tt-id="p_miningspeed" data-tt-parent="root">miningspeed</div></td>
 
     <td>key: string, value: decimal number</td>
 
     <td>key: string, value: decimal number</td>
 
     <td>-</td>
 
     <td>-</td>
Line 394: Line 394:
 
   </tr>
 
   </tr>
 
   <tr>
 
   <tr>
     <td scope="row"><div class="tt" data-tt-id="p_miningspeed" data-tt-parent="root">MiningTier</div></td>
+
     <td scope="row"><div class="tt" data-tt-id="p_miningspeed" data-tt-parent="root">miningtier</div></td>
 
     <td>integer</td>
 
     <td>integer</td>
 
     <td>0</td>
 
     <td>0</td>
Line 400: Line 400:
 
   </tr>
 
   </tr>
 
   <tr>
 
   <tr>
     <td scope="row"><div class="tt" data-tt-id="p_attributes" data-tt-parent="root">Attributes</div></td>
+
     <td scope="row"><div class="tt" data-tt-id="p_attributes" data-tt-parent="root">attributes</div></td>
 
     <td>key: string, value: object</td>
 
     <td>key: string, value: object</td>
 
     <td>-</td>
 
     <td>-</td>
Line 418: Line 418:
 
   </tr>
 
   </tr>
 
   <tr>
 
   <tr>
     <td scope="row"><div class="tt" data-tt-id="p_combustibleprops" data-tt-parent="root">CombustibleProps</div></td>
+
     <td scope="row"><div class="tt" data-tt-id="p_combustibleprops" data-tt-parent="root">combustibleprops</div></td>
 
     <td>object</td>
 
     <td>object</td>
 
     <td>-</td>
 
     <td>-</td>
Line 424: Line 424:
 
   </tr>
 
   </tr>
 
   <tr>
 
   <tr>
     <td scope="row"><div class="tt" data-tt-id="p_burntemperature" data-tt-parent="p_combustibleprops">BurnTemperature</div></td>
+
     <td scope="row"><div class="tt" data-tt-id="p_burntemperature" data-tt-parent="p_combustibleprops">burntemperature</div></td>
 
     <td>integer</td>
 
     <td>integer</td>
 
     <td>-</td>
 
     <td>-</td>
Line 430: Line 430:
 
   </tr>
 
   </tr>
 
   <tr>
 
   <tr>
     <td scope="row"><div class="tt" data-tt-id="p_burnduration" data-tt-parent="p_combustibleprops">BurnDuration</div></td>
+
     <td scope="row"><div class="tt" data-tt-id="p_burnduration" data-tt-parent="p_combustibleprops">burnduration</div></td>
 
     <td>decimal number</td>
 
     <td>decimal number</td>
 
     <td>-</td>
 
     <td>-</td>
Line 436: Line 436:
 
   </tr>
 
   </tr>
 
   <tr>
 
   <tr>
     <td scope="row"><div class="tt" data-tt-id="p_heatresistance" data-tt-parent="p_combustibleprops">HeatResistance</div></td>
+
     <td scope="row"><div class="tt" data-tt-id="p_heatresistance" data-tt-parent="p_combustibleprops">heatresistance</div></td>
 
     <td>integer</td>
 
     <td>integer</td>
 
     <td>500</td>
 
     <td>500</td>
Line 442: Line 442:
 
   </tr>
 
   </tr>
 
   <tr>
 
   <tr>
     <td scope="row"><div class="tt" data-tt-id="p_meltingpoint" data-tt-parent="p_combustibleprops">MeltingPoint</div></td>
+
     <td scope="row"><div class="tt" data-tt-id="p_meltingpoint" data-tt-parent="p_combustibleprops">meltingpoint</div></td>
 
     <td>integer</td>
 
     <td>integer</td>
 
     <td>-</td>
 
     <td>-</td>
Line 448: Line 448:
 
   </tr>
 
   </tr>
 
   <tr>
 
   <tr>
     <td scope="row"><div class="tt" data-tt-id="p_meltingduration" data-tt-parent="p_combustibleprops">MeltingDuration</div></td>
+
     <td scope="row"><div class="tt" data-tt-id="p_meltingduration" data-tt-parent="p_combustibleprops">meltingduration</div></td>
 
     <td>decimal number</td>
 
     <td>decimal number</td>
 
     <td>-</td>
 
     <td>-</td>
Line 454: Line 454:
 
   </tr>
 
   </tr>
 
   <tr>
 
   <tr>
     <td scope="row"><div class="tt" data-tt-id="p_smokelevel" data-tt-parent="p_combustibleprops">SmokeLevel</div></td>
+
     <td scope="row"><div class="tt" data-tt-id="p_smokelevel" data-tt-parent="p_combustibleprops">smokelevel</div></td>
 
     <td>decimal number</td>
 
     <td>decimal number</td>
 
     <td>1</td>
 
     <td>1</td>
Line 460: Line 460:
 
   </tr>
 
   </tr>
 
   <tr>
 
   <tr>
     <td scope="row"><div class="tt" data-tt-id="p_smeltedratio" data-tt-parent="p_combustibleprops">SmeltedRatio</div></td>
+
     <td scope="row"><div class="tt" data-tt-id="p_smeltedratio" data-tt-parent="p_combustibleprops">smeltedratio</div></td>
 
     <td>integer</td>
 
     <td>integer</td>
 
     <td>1</td>
 
     <td>1</td>
Line 466: Line 466:
 
   </tr>
 
   </tr>
 
   <tr>
 
   <tr>
     <td scope="row"><div class="tt" data-tt-id="p_liquidlevel" data-tt-parent="p_combustibleprops">SmeltedStack</div></td>
+
     <td scope="row"><div class="tt" data-tt-id="p_liquidlevel" data-tt-parent="p_combustibleprops">smeltedstack</div></td>
 
     <td>object</td>
 
     <td>object</td>
 
     <td>-</td>
 
     <td>-</td>
Line 472: Line 472:
 
   </tr>
 
   </tr>
 
   <tr>
 
   <tr>
     <td scope="row"><div class="tt" data-tt-id="p_requirescontainer" data-tt-parent="p_combustibleprops">RequiresContainer</div></td>
+
     <td scope="row"><div class="tt" data-tt-id="p_requirescontainer" data-tt-parent="p_combustibleprops">requirescontainer</div></td>
 
     <td>boolean</td>
 
     <td>boolean</td>
 
     <td>true</td>
 
     <td>true</td>
Line 503: Line 503:
 
   </tr>
 
   </tr>
 
   <tr>
 
   <tr>
     <td scope="row"><div class="tt" data-tt-id="p_nutritionprops" data-tt-parent="root">NutritionProps</div></td>
+
     <td scope="row"><div class="tt" data-tt-id="p_nutritionprops" data-tt-parent="root">nutritionprops</div></td>
 
     <td>object</td>
 
     <td>object</td>
 
     <td>-</td>
 
     <td>-</td>
Line 509: Line 509:
 
   </tr>
 
   </tr>
 
   <tr>
 
   <tr>
     <td scope="row"><div class="tt" data-tt-id="p_nutritionprops_foodcategory" data-tt-parent="p_nutritionprops">FoodCategory</div></td>
+
     <td scope="row"><div class="tt" data-tt-id="p_nutritionprops_foodcategory" data-tt-parent="p_nutritionprops">foodcategory</div></td>
 
     <td>string</td>
 
     <td>string</td>
 
     <td>-</td>
 
     <td>-</td>
Line 515: Line 515:
 
   </tr>
 
   </tr>
 
   <tr>
 
   <tr>
     <td scope="row"><div class="tt" data-tt-id="p_nutritionprops_saturation" data-tt-parent="p_nutritionprops">Saturation</div></td>
+
     <td scope="row"><div class="tt" data-tt-id="p_nutritionprops_saturation" data-tt-parent="p_nutritionprops">saturation</div></td>
 
     <td>decimal number</td>
 
     <td>decimal number</td>
 
     <td>0</td>
 
     <td>0</td>
Line 521: Line 521:
 
   </tr>
 
   </tr>
 
   <tr>
 
   <tr>
     <td scope="row"><div class="tt" data-tt-id="p_nutritionprops_health" data-tt-parent="p_nutritionprops">Health</div></td>
+
     <td scope="row"><div class="tt" data-tt-id="p_nutritionprops_health" data-tt-parent="p_nutritionprops">health</div></td>
 
     <td>decimal number</td>
 
     <td>decimal number</td>
 
     <td>0</td>
 
     <td>0</td>
Line 530: Line 530:
 
   </tr>
 
   </tr>
 
   <tr>
 
   <tr>
     <td scope="row"><div class="tt" data-tt-id="p_textures" data-tt-parent="root">Textures</div></td>
+
     <td scope="row"><div class="tt" data-tt-id="p_textures" data-tt-parent="root">textures</div></td>
 
     <td>string</td>
 
     <td>string</td>
 
     <td>required</td>
 
     <td>required</td>
Line 536: Line 536:
 
   </tr>
 
   </tr>
 
   <tr>
 
   <tr>
     <td scope="row"><div class="tt" data-tt-id="p_shape" data-tt-parent="root">Shape</div></td>
+
     <td scope="row"><div class="tt" data-tt-id="p_shape" data-tt-parent="root">shape</div></td>
 
     <td>object</td>
 
     <td>object</td>
 
     <td>-</td>
 
     <td>-</td>
Line 542: Line 542:
 
   </tr>
 
   </tr>
 
   <tr>
 
   <tr>
     <td scope="row"><div class="tt" data-tt-id="p_shapeinventory" data-tt-parent="root">ShapeInventory</div></td>
+
     <td scope="row"><div class="tt" data-tt-id="p_shapeinventory" data-tt-parent="root">shapeinventory</div></td>
 
     <td>object</td>
 
     <td>object</td>
 
     <td>-</td>
 
     <td>-</td>
Line 548: Line 548:
 
   </tr>
 
   </tr>
 
   <tr>
 
   <tr>
     <td scope="row"><div class="tt" data-tt-id="p_guitransform" data-tt-parent="root">GuiTransform</div></td>
+
     <td scope="row"><div class="tt" data-tt-id="p_guitransform" data-tt-parent="root">guiTransform</div></td>
 
     <td>object</td>
 
     <td>object</td>
 
     <td>item default</td>
 
     <td>item default</td>
Line 554: Line 554:
 
   </tr>
 
   </tr>
 
   <tr>
 
   <tr>
     <td scope="row"><div class="tt" data-tt-id="p_fphandtransform" data-tt-parent="root">FpHandTransform</div></td>
+
     <td scope="row"><div class="tt" data-tt-id="p_fphandtransform" data-tt-parent="root">fphandtransform</div></td>
 
     <td>object</td>
 
     <td>object</td>
 
     <td>item default</td>
 
     <td>item default</td>
Line 560: Line 560:
 
   </tr>
 
   </tr>
 
   <tr>
 
   <tr>
     <td scope="row"><div class="tt" data-tt-id="p_tphandtransform" data-tt-parent="root">TpHandTransform</div></td>
+
     <td scope="row"><div class="tt" data-tt-id="p_tphandtransform" data-tt-parent="root">tphandtransform</div></td>
 
     <td>object</td>
 
     <td>object</td>
 
     <td>item default</td>
 
     <td>item default</td>
Line 566: Line 566:
 
   </tr>
 
   </tr>
 
   <tr>
 
   <tr>
     <td scope="row"><div class="tt" data-tt-id="p_groundtransform" data-tt-parent="root">GroundTransform</div></td>
+
     <td scope="row"><div class="tt" data-tt-id="p_groundtransform" data-tt-parent="root">groundtransform</div></td>
 
     <td>object</td>
 
     <td>object</td>
 
     <td>item default</td>
 
     <td>item default</td>

Revision as of 16:11, 5 June 2019

Overview

A complete list of all available properties

Property Type Default Usage
json
Core (no byType available)
code
string required A unique identifier for the item.

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

For example the code stone turns into game:stone.

The code identifier has to be unique inside its domain. In theory there could be equal identifiers with different domain prefixes. Find out more about Domains.

enabled
boolean true If the item will be loaded or not. Can be used to temporarily remove the item.
variantGroups
array of object - Allows you define multiple variants of the same item.

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

An easy example would be a bowl, which can either be raw or burned:

	variantgroups: [
		{ code:"type", states: ["raw", "burned"] },
	],

Meaning there will be two variants bowl-raw and bowl-burned.


It's also possible to define multiple groups.

	variantgroups: [
		{ code:"state", states: ["closed", "opened"] },
		{ code:"contents", states: ["empty", "cabbage"] },
	],

As a result you will have 2x2 groups, which will be added one after each other: barrel-closed-empty, barrel-closed-cabbage, barrel-opened-empty and barrel-opened-cabbage.


Additionally it is possible to refer to external lists (used for blocks) that are found in the worldproperties folder, such as block/rock, which contains all states of all rock types. This used for gravel, sand and rock. It's a good way to keep everything organized:

	variantgroups: [
		{ loadFromProperties: "block/rock" },
	],

Here is a full list of all groups and their variants (you can also find them in the assets/worldproperties folder):

Name States
block/grass -
block/mushroom flyagaric, bolete, fieldmushroom
block/herb basil, chamomile, cilantro, lavender, marjoram, mint, saffron, sage, thyme
block/flower catmint, forgetmenot, edelweiss, heather, horsetail, orangemallow, wilddaisy, westerngorse, cowparsley, californiapoppy
block/metal bismuth, bismuthbronze, blackbronze, brass, chromium, copper, gold, iron, lead, platinum, rhodium, silver, stainlesssteel, steel, tin, tinbronze, titanium, uranium, zinc
block/ore lignite, bituminouscoal, nativecopper, limonite, quartz_nativegold, galena, cassiterite, chromite, platinum, ilmenite, sphalerite, rocksalt_sylvite, quartz_nativesilver, lapislazuli, diamond, emerald, bismuthinite, quartz, rocksalt, sulfur, magnetite
block/tallgrass veryshort, short, mediumshort, medium, tall, verytall, eaten
block/rock andesite, chalk, claystone, granite, sandstone, shale
block/woodwithaged birch, oak, maple, pine, acacia, kapok, aged
block/wood birch, oak, maple, pine, acacia, kapok
block/painting acitasluna, dandelionnight, distantpath, forestpath, night, papiliorumanzovia, stillmomentsbeforesunrise, thedreamprojection, troidesaeacus, winterflowers
abstract/rockgroup -
abstract/alloy -
abstract/fertility verylow, low, medium, high
abstract/grasscoverage none, verysparse, sparse, normal
abstract/horizontalorientation north, east, south, west
abstract/verticalorientation up, down
abstract/coating n, e, s, w, u, d, ud, ns, ew, nd, ed, sd, wd, su, wu, nu, eu, es, sw, nw, ne, nwd, ned, esd, swd, nwu, neu, esu, swu, nsd, ewd, sud, wud, nud, eud, nsu, ewu, nes, esw, nsw, new, newd, nesd, eswd, nswd, eswu, nswu, newu, nesu, nesw, ewud, nsud, neud, esud, swud, nwud, neswd, neswu, newud, nesud, eswud, nswud, neswud

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

Let's take a look at a different example (flowerpot), which uses the additive combination mode:

	variantgroups: [
		{ code: "type", states: ["raw"] },
		{ code: "empty", states: ["empty"], combine: "additive" },
		{ code: "flower", loadFromProperties: "block/flower", combine: "additive" },
		{ code: "mushroom", loadFromProperties: "block/mushroom", combine: "additive" },
		{ code: "sapling", loadFromProperties: "block/wood", combine: "additive" },
	],

The variants are flowerpot-raw, flowerpot-empty, flowerpot-{all flowers}, flowerpot-{all mushrooms} and flowerpot-{all saplings}.

Additive mode could also be called separate, since it defines a variant separate from all the other groups:

	variantgroups: [
		{ code: "something", states: ["same", "different"] },
		{ code: "type", states: ["raw", "baked"] },
		{ code: "empty", states: ["red", "green"], "combine": "additive" },
	],

In this case, the result would be same-raw, same-baked, different-raw, different-baked, red and green

(any) bytype
key: string; value: object - You can create properties for certain variants of the item.

In order to define properties for specific variants you can add byType to the property name. This allows you to define it depending on the type and always follows the same syntax:

	(property)ByType: {
		"selector": property,
		"selector2": property2,
		...
	}

If the selector matches the name of the variant the given property will be used. Keep in mind that only the first matching one will be used (everything below will be ignored).

A slab for example has two variants (up, down), which have different collision boxes:

	collisionboxByType: {
		"*-down": { x1: 0, y1: 0, z1: 0,   x2: 1, y2: 0.5, z2: 1 },
		"*-up": { x1: 0, y1: 0.5, z1: 0,   x2: 1, y2: 1, z2: 1 }
	},

The char * stands for anything. In this case it ignores the code of the item.

Furthermore this opens up even more possbilities for more advanced selectors like this one for doors: *-north-*-opened-left. This will ignore the second variantgroup. Additionally ByType can also be used for child properties:

	collisionboxnbox: { 
		x1: 0, y1: 0, z1: 0.875, x2: 1, y2: 1, z2: 1,
		rotateYByType: {
			"*-north-*-opened-left": 90,
			"*-north-*-closed-left": 0,
			"*-west-*-opened-left": 180,
			"*-west-*-closed-left": 90,

			"*-east-*-opened-left": 0,
			"*-east-*-closed-left": 270,
			"*-south-*-opened-left": 270,
			"*-south-*-closed-left": 180,

			"*-north-*-opened-right": 270,
			"*-north-*-closed-right": 0,
			"*-west-*-opened-right": 0,
			"*-west-*-closed-right": 90,

			"*-east-*-opened-right": 180,
			"*-east-*-closed-right": 270,
			"*-south-*-opened-right": 90,
			"*-south-*-closed-right": 180
		}
	},

Since Vintagestory v1.8 it is also possible to use the variantgroup as a placeholder:

	variantgroups: [
		{ code: "metal", states: ["copper", "tinbronze", "bismuthbronze", "blackbronze", "gold", "silver", "iron" ] },
	],
	textures: {
		"metal": { base: "block/metal/ingot/{metal}" },
		"wood": { base: "item/tool/material/wood" } 
	},
Specific
class
string "item" The item class can add special functionalities for the item.

It can be used to open guis or adding other extra functionality to the item. A complete tutorial of how to add your own class to the game can be found here.

durability
integer 0 How many uses does this item has when being used. Item disappears at durability 0.
damagedby
array of string - From which damage sources does the item takes durability damage.
blockbreaking
0 Mining a block.
attacking
1 Hitting an entity.
fire
2 Currently not used.
tool
string - If set, this item will be classified as given tool.
Knife
0 USed to break grass.
Pickaxe
1 Can mine rock and other stone materials
Axe
2 Useful for chopping trees.
Sword
3 No special abilities yet.
Shovel
4 Mines dirt, sand and gravel really fast.
Hammer
5 No special abilities yet.
Mallet
6 No special abilities yet.
Spear
7 No special abilities yet.
Bow
8 No special abilities yet.
Sickle
9 No special abilities yet.
Hoe
10 No special abilities yet.
Saw
11 No special abilities yet.
Common
creativeinventory
key: string, value: string[] - In which creative inventory tabs the item should be visible in.

There are several tabs to you can add your stuff. Note that general should always be included, since it should contain everything.

  • general
  • terrain
  • flora
  • construction
  • decorative
  • items

Rock adds all of it's variantions to general, terrain and construction:

	creativeinventory: { "general": ["*"], "terrain": ["*"], "construction": ["*"] },

* reprents the variants which will be added. You can specify multiple and separate them with a comma. It follows the same way as the byType property.

A Torch on the other hand only adds the variation up:

	creativeinventory: { "general": ["*-up"], "decorative": ["*-up"] },
maxstacksize
integer 64 Determines the maximum amount you can stack the item in one slot.
attackpower
decimal number 0.5 The damage the deals when hitting an entity.
attackrange
decimal number 1.5 The maximum distance you can hit an entity.
materialdensity
integer 9999 Determines on whether an object floats on liquids or not.

Water has a density of 1000, meaning everything below or equal will float on water. The same goes for lava which has a density of 5000.

liquidselectable
boolean false If the item can select a liquid while holding it in hand.

Used for buckets in order to fill it with water and to place waterlily on top of water.

miningspeed
key: string, value: decimal number - The mining speed for each material.
miningtier
integer 0 Determines which blocks it can break. If the required miningtier is above the defined one there will be no drop from it.
attributes
key: string, value: object - Custom Attributes associated with this item.

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

    attributes: {
		"blastRadius": 4,
		"blastType": 0,
	},
combustibleprops
object - Information about the items burnable states.
burntemperature
integer - The temperature at which it burns in degrees celsius.
burnduration
decimal number - For how long it burns in seconds.
heatresistance
integer 500 How many degrees celsius it can resists before it ignites (not implemented yet).
meltingpoint
integer - How many degrees celsius it takes to smelt/transform this into another. Only used when put in a stove and Melted is set.
meltingduration
decimal number - For how many seconds the temperature has to be above the melting point until the item is smelted.
smokelevel
decimal number 1 How much smoke this item produces when being used as fuel.
smeltedratio
integer 1 How many ores are required to produce one output stack.
smeltedstack
object - 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.
requirescontainer
boolean true If set to true, the block/item requires a smelting/cooking/baking container such as the Crucible. If false, it can be directly baked/melted without smelting/cooking/baking container.

This property can be used to define a burning material. Plank for example can get on fire:

    combustibleProps: {
        burnTemperature: 800,
        burnDuration: 12,
    },

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

    combustiblePropsByType: {
        "ingotmold-raw": {
            meltingPoint: 600,
            meltingDuration: 30,
            smeltedRatio: 1,
            smeltedStack: { type: "block", code: "ingotmold-burned" },
            requiresContainer: false
        }
    },
nutritionprops
object - Information about the items nutrients.
foodcategory
string - Defines the type of food. It can be fruit, vegetable, protein, grain and dairy.
saturation
decimal number 0 How much saturation it can restore.
health
decimal number 0 How much health it can restore.
Rendering
textures
string required The texture definitions for the item held in hand or dropped on the ground.
shape
object - The items shape. Empty for automatic shape based on the texture.
shapeinventory
object - The items shape in inventory.
guiTransform
object item default Used for scaling, rotation or offseting the item when rendered in guis.
fphandtransform
object item default Used for scaling, rotation or offseting the item when rendered in the first person mode hand.
tphandtransform
object item default Used for scaling, rotation or offseting the item when rendered in the third person mode hand.
groundtransform
object item default Used for scaling, rotation or offseting the rendered as a dropped item on the ground.



Vintage Story: Modding
Basics Mod Types | Asset System | Textures | Items | Recipes | Blocks | Model Creator | Release
Advanced Setup(Windows,Linux) | Items (Code, JSON) | Blocks | Item-Block interactions | Block Behaviors | Block Entities | Particles | World Access
Worldgen Terrain | Ores | Trees | WorldGen API
Rendering Shaders and Renderers
Property Overview Item | Block | Block Behaviors | Block Classes | Block Entities | Block Entity Behaviors