minecraft:use_modifiers

Modifies use behavior, including how long the item takes to use and the player's movement speed.

Properties

PropertyTypeDefaultWhat it does
use_durationDecimalmin 00Time, in seconds, that the item takes to use.
emit_vibrationsBooleantrueWhether vibrations are emitted when the item starts or stops being used.
start_soundText—Sound played when the item starts being used. Accepts the name of any sound event defined in `sound_definitions.json`, including the built-in vanilla sound events.
movement_modifierDecimal0 to 1—Multiplier applied to the player's movement speed while the item is in use.
start_usingTextif_first, always"if_first"Controls how using the item triggers start using behavior. "if_first" only starts if no other component has started using yet; "always" always restarts using. Defaults to "if_first".

Example from the game files

This is how vanilla netherite_spear uses it in Minecraft Bedrock 1.26.60.5:

{
  "minecraft:use_modifiers": {
    "use_duration": 72000,
    "emit_vibrations": false,
    "start_sound": "item.netherite_spear.use",
    "movement_modifier": 1.0
  }
}

Used by 8

Vanilla items with minecraft:use_modifiers in their definition:

applecopper_speardiamond_speargolden_speariron_spearnetherite_spearstone_spearwooden_spear

Related components