minecraft:use_modifiers
Modifies use behavior, including how long the item takes to use and the player's movement speed.
Properties
| Property | Type | Default | What it does |
|---|---|---|---|
use_duration | Decimalmin 0 | 0 | Time, in seconds, that the item takes to use. |
emit_vibrations | Boolean | true | Whether vibrations are emitted when the item starts or stops being used. |
start_sound | Text | — | 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_modifier | Decimal0 to 1 | — | Multiplier applied to the player's movement speed while the item is in use. |
start_using | Textif_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