Actions

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
List of actions properties
play_sound:
  name: itemsadder:ambient.creepy
  volume: 1
  pitch: 1
  
  
stop_sound:
  name: "itemsadder:music_disc.cdk_sunday"
  
  
execute_commands:
  first_example:
    command: 'tellraw {player} {"text":"wow you did something!","color":"gold"}'
    as_console: true
  second:
    command: 'help'
    as_console: false
  third:
    command: 'give {player} diamond'
    as_console: true
    
    
play_particle:
  name: "ENCHANTMENT_TABLE"
​
# Shoots particle (useful for wands and weapons)
shoot_particle:
  name: FLAME
  distance: 7
  
play_effect:
  name: SMOKE
  
increment_durability:
  amount: 10
  
  
decrement_durability:
  amount: 10
  
  
decrement_usages:
  amount: 1
​
​
increment_amount:
  amount: 1
          
          
decrement_amount:
  amount: 1    
​
​
drop_exp:
  chance: 50
  min_amount: 1
  max_amount: 3
    
# Vanilla saturation values: 
# https://minecraft.gamepedia.com/Hunger#Food_level_and_saturation_level_restoration
feed:
  amount: 6
  saturation: 2 # <--- this is optional, default is 0
    
# Replaced properties of the current item copying them from another.
# For now you can only do that with custom_model_data. More will be added.
replace_properties:
  custom_model_data:
    copy_from_item: "itemsadder:closed_lightsaber"
    restorable: true
​
​
give_item:
  item: empty_cup
  amount: 1
  
# Replaces blocks around the block you interacted with or break
replace_near_blocks:
  radius:
    x: 2
    y: 2
    z: 2
  from: LAVA
  to: OBSIDIAN
  decrement_durability: 8
  no_physics: false #default is false
  
# Glows blocks around the block you interacted with or break
glow_near_blocks:
  decrement_durability:
    amount: 1
  radius:
    x: 50
    y: 50
    z: 50
  material: DIAMOND_ORE
  
# Breaks multiple blocks around the block you interacted with or break
multiple_break:
  keep_ores: true
  drop_all_blocks:
    enabled: true
    need_silk_touch: true
  size: 3
  depth: 3
  
  
potion_effect:
  type: UNLUCK
  duration: 100
  amplifier: 0
​
​
remove_potion_effect:
  type: GLOWING
  
  
explosion:
  power: 2
  fire: true
  break_blocks: true
  
# Allows you to damage entities around you
damage_near_entities:
  entity_groups:
   - HOSTILE
   - PLAYERS
   - PASSIVE
  damage: 4
  range: 7
  
# Allows you to damage the entity you're looking at
damage_entity_in_sight:
  damage: 4
  distance: 7
  
# Allows you to damage the entity of this event. For example on interact or attack
# or on event item_hit_entity
damage_entity:
  damage: 4
  
# Special action that allows you to increment player stat linked to an hud
#in this case hud named: "itemsadder:mana_bar"
increment_player_stat:
  name: "itemsadder:mana_bar"
  amount: 1
  
# Special action that allows you to decrement player stat linked to an hud
#in this case hud named: "itemsadder:mana_bar"
decrement_player_stat:
  name: "itemsadder:mana_bar"
  amount: 1
  
# Special action to make the event cancelled (the event that called this action)
cancel: true
​
# Adds potion effect to target entity (attack, interact...)
target_potion_effect:
  type: GLOWING
  duration: 70
  amplifier: 15
  
# Removes potion effect to target entity (attack, interact...)
target_remove_potion_effect:
  type: GLOWING
  
play_totem_animation: animatedtitles:bruh
​
set_block:
  block: rocks
  target: RELATIVE
  decrement_amount: true
  
place_furniture:
  furniture: furniture
  decrement_amount: true
​
drop_item:
  item: 2d_furniture
  chance: 99.9
  max_amount: 3
  min_amount: 1
Use the official files editor to read all the properties
📄
Files editor
Last modified 22d ago