Mutators

All 22. A mutator rewrites what the effect sees, before it runs.

mutator	what it changes	args
translate_location	Shift the location by x,y,z	add_x, add_y, add_z
random_location	Shift the location randomly within a radius	radius
location_to_player	Use the player's location	-
location_to_victim	Use the victim's location	-
location_to_eyes	Use the player's eye location	-
location_ahead	A point N blocks ahead of the player	distance
location_to_block	Use the block's location (centred)	-
block_above	Use the block above the context block	-
block_below	Use the block below the context block	-
block_under_player	Use the block under the player's feet	-
block_targeted	Use the block the player is looking at	range
victim_to_player	Treat the player as the victim (self-target)	-
player_to_victim	Swap: the victim becomes the acting player, if a player	-
nearest_entity_as_victim	Pick the nearest living entity within a radius as the victim	radius
random_nearby_player_as_victim	Pick a random other player within a radius as the victim	radius
item_from_hand	Use the main-hand item as the context item	-
item_from_offhand	Use the off-hand item as the context item	-
value_multiply	Multiply the trigger value	by
value_add	Add to the trigger value	amount
value_set	Set the trigger value	value
value_clamp	Clamp the trigger value between min and max	min, max
set_data	Store a value in the context	key, value

- id: spawn_particle
  args: { particle: soul, amount: 10 }
  triggers: [mine_block]
  mutators:
    - id: translate_location
      args: { add_y: 0.5 }