VoxelEngine/doc/en/item-properties.md
MihailRis b1e854a73c
Update 0.27 docs (#484)
* update doc/*/scripting/builtins/libinventory.md

* add doc/*/scripting/builtins/libgfx-weather.md

* update doc/*/scripting/builtins/libfile.md

* update doc/*/item-properties & update doc/*/scripting/builtins/libinventory.md

* add inventory.decrement docs

* update doc/*/scripting/builtins/libinventory.md
2025-03-16 20:10:41 +03:00

1.8 KiB

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.

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)