ItemsAdder Wiki
English
Addons (old)Addons (new)🔌 More Plugins❤️ Donate
Search
⌃K
Links

Actions

Use the official files editor to read all the properties

What are actions?

Actions are what will happen when an event is triggered.

List of actions:

  • play_sound
  • stop_sound
  • execute_commands
  • play_particle
  • shoot_particle
  • play_effect
  • increment_durability
  • decrement_durability
  • decrement_usages
  • increment_amount
  • decrement_amount
  • drop_exp
  • feed
  • replace_properties
  • give_item
  • replace_near_blocks
  • replace_block
  • glow_near_blocks
  • multiple_break
  • potion_effect
  • remove_potion_effect
  • explosion
  • damage_near_entities
  • damage_entity_in_sight
  • damage_entity
  • increment_player_stat
  • decrement_player_stat
  • cancel
  • target_potion_effect
  • target_remove_potion_effect
  • play_totem_animation
  • set_block
  • place_furniture
  • drop_item

Delay

Every action has a special attribute delay. It's the delay in ticks before starting the action. For example:
items:
chain_events:
display_name: "%#FE5A00%chain_events"
permission: test.chain_events
resource:
material: COAL
generate: true
textures:
- "minecraft:item/diamond.png"
events:
interact:
right:
execute_commands:
cmd1:
command: 'tellraw {player} {"text":"Action 1","color":"gold"}'
as_console: true
delay: 0
cmd2:
command: 'tellraw {player} {"text":"Action 2","color":"gold"}'
as_console: true
delay: 20
cmd3:
command: 'tellraw {player} {"text":"Action 3","color":"gold"}'
as_console: true
delay: 40
play_sound_1:
name: minecraft:block.note_block.banjo
delay: 0
play_sound_2:
name: minecraft:block.note_block.banjo
pitch: 1.2
delay: 20
play_sound_3:
name: minecraft:block.note_block.banjo
pitch: 1.5
delay: 40

Multiple actions of the same type

You can set the same action multiple times. You just have to add _anything at the end. For example if you want to play two sounds you have to write this:
play_sound_first:
name: itemsadder:ambient.creepy
volume: 1
pitch: 1
play_sound_second:
name: minecraft:ambient.cave
volume: 1
pitch: 1
play_sound_3:
name: minecraft:ambient.cave
volume: 1
pitch: 1

Actions permission

Every action has a special attribute permission. It's the permission the player must have before starting the action. For example the player must have myitems.usage.secret_items_dispenser permission to play the sound. In this example you will notice an "issue". The sound is played even if the user has no permission for the give event. That's because... well, permission check is only on the give_item.
test_block:
display_name: display-name-test_block
permission: test_block
resource:
material: PAPER
generate: true
textures:
- block/test_block.png
specific_properties:
block:
placed_model:
type: REAL_NOTE
break_particles_material: SMITHING_TABLE
events:
placed_block:
interact:
give_item:
permission: "myitems.usage.secret_items_dispenser"
item: DIAMOND
play_sound:
name: itemsadder:ambient.creepy
volume: 1
pitch: 1
Setting the same permission to every action
If you want to set the same permission to every action without copy and paste you can! Use this special attribute all_actions_permission. For example:
test_block:
display_name: display-name-test_block
permission: test_block
resource:
material: PAPER
generate: true
textures:
- block/test_block.png
specific_properties:
block:
placed_model:
type: REAL_NOTE
break_particles_material: SMITHING_TABLE
all_actions_permission: "myitems.usage.secret_items_dispenser"
events:
placed_block:
interact:
give_item:
item: DIAMOND
play_sound:
name: itemsadder:ambient.creepy
volume: 1
pitch: 1

Properties

Use the official files editor to get the complete list while working on your configurations.

Flow customization

Available on ItemsAdder 3.6.0+
ItemsAdder allows you to further customize your actions by avoiding their execution in some specific cases explained in the next lines. This allows further customization of your items logic.
For example you can create a wand which plays specific sound only if a mob was successfully attacked and which plays another sound in case of failed attack.
Example code (click to expand)
info:
namespace: actions_flow_test
items:
magic_wand:
display_name: Test Magic Wand
resource:
generate: false
model_path: minecraft:item/stick
material: STONE_SWORD
events:
interact_mainhand:
left:
# Damage the entity in sight
damage_entity_in_sight:
damage: 1
distance: 8
# Decrement durability only if the attack is successful
decrement_durability:
amount: 1
flow:
skip_if_fail: damage_entity_in_sight
# Play sound only if the attack is successful
play_sound:
name: block.amethyst_cluster.step
volume: 1.5
pitch: 1
flow:
skip_if_fail: damage_entity_in_sight
# Play sound only if the attack is successful
shoot_particle:
name: CRIT_MAGIC
distance: 7
flow:
skip_if_fail: damage_entity_in_sight
# Play sound only if the attack is failed
play_sound_fail:
name: minecraft:block.wool.break
volume: 1
pitch: 2
flow:
skip_if_success: damage_entity_in_sight
# Play sound only if the attack is failed
shoot_particle_fail:
name: CRIT
distance: 7
flow:
skip_if_success: damage_entity_in_sight

stop_if_last_success

Doesn't execute this and the next actions if the previous action succeeded.

stop_if_last_fail

Doesn't execute this and the next actions if the previous action failed.

skip_if_last_success

Doesn't execute this action if the previous action succeeded.

skip_if_last_fail

Doesn't execute this action if the previous action failed.

stop_if_any_success

Doesn't execute this and the next actions if ANY of the previous actions succeeded.

stop_if_any_fail

Doesn't execute this and the next actions if ANY of the previous actions failed.

skip_if_any_success

Doesn't execute this action if ANY of the previous actions succeeded.

skip_if_any_fail

Doesn't execute this action if ANY of the previous actions failed.

stop_if_success

Doesn't execute this and the next actions if a specific previous action succeeded.

stop_if_fail

Doesn't execute this and the next actions if a specific previous action failed.

skip_if_success

Doesn't execute this action if a specific previous action succeeded.

skip_if_fail

Doesn't execute this action if a specific previous action failed.
​
Last modified 2d ago