Skip to main content

Item Modifiers

Introduction​

Sandstone features fully-typed item modifiers. Like for all resources, you need to provide a name, which can include a namespace and folders. You then provide the definition of the item modifier.

The minimal syntax for damage types is the following:

import { ItemModifier } from 'sandstone'

ItemModifier('item_modifier_name', {
  function: 'set_name',

  name: { text: 'Funny item' }
})

Modifier functions​

All modifier functions can be directly found via autocompletion/jsdoc, or by looking at the Minecraft wiki article on Item Modifiers.

Usage​

Directly modify​

const myItemModifier = ItemModifier(...)

// Modifies the item in the first slot of the current block
myItemModifier.modify.block('~ ~ ~', 'container.0')

// Modifies the item in the first hotbar slot of the current player
myItemModifier.modify.entity('@s', 'hotbar.0')