VoxelEngine/doc/en/item-properties.md

Item properties

Visual

icon-type and icon itself

Icon type defines a source of an item image displayed in inventory.

• none - invisible type, used for core:empty only (empty item, like the air block). May be removed in future updates.
• sprite - default type. 2D image. Requires icon set to atlas_name:texture_name. Example: blocks:notfound. There's two atlases available:
  • blocks (generated from png files in res/textures/blocks/)
  • items (generated from png files in res/textures/items/)
• block - block preview. Block ID must be specified in icon property. Example: base:wood.

Item model - model-name

Name of the item model. The model will be loaded automatically. Default value is packid:itemname.model. If the model is not specified, an automatic one will be generated.

Caption and Description

caption - name of item in inventory description - item description in inventory

this props allow to use md

see Text Styles

Behaviour

placing-block

Specifies what block will be placed on RMB click. Automatically specified in generated items.

Example: an items that places bazalt blocks:

"placing-block": "base:bazalt"

emission

Light emitted when player holds the item in hand.

An array of 3 integers - R, G, B of light in range [0, 15]

Examples:

• [15, 15, 15] - white with maximal intensity
• [7, 0, 0] - dim red light
• [0, 0, 0] - no emission (default value)

stack-size

Maximal number of an item units in one slot. Default - 64.

Number of uses (durability) - uses

Property used via inventory.use.

Property status is displayed in the inventory interface. Display method is defined via uses-display.

Display of uses - uses-display

• none - display disabled
• number - number
• relation - current value to initial value (x/y)
• vbar - vertical scale (used by default)

Tags

Tags allow you to designate general properties of items. Names should be formatted as prefix:tag_name. The prefix is ​​optional, but helps avoid unwanted logical collisions. Example:

{
    "tags": [
        "core:fuel",
        "base_survival:poison",
    ]
}

Tags can also be added to items from other packs using the your_pack:tags.toml file. Example

"prefix:tag_name" = [
    "random_pack:item",
    "another_pack:some_block",
]
"other_prefix:other_tag_name" = [
    # ...
]