On Block Break

Description

Applies an aura component to the target that triggers a skill when they break a block

Attributes

Attribute Aliases Description Default
onBreakSkill onBreak, oB Skill to execute if the target breaks a block
cancelEvent cancel, cE Whether or not to cancel the event that triggered the aura false
dropitem drop, allowDrop If the broken item should be dropped or not true
blocktypes bt, t, material, materials, m, blocks, block, b What blocks should trigger this aura
You can add a * at the front of the type to indicate that the one specified is not a block type, but a block tag (example: blocktype=*sculk_replaceable )

Examples

Simple:

Apply an onBlockBreak aura to yourself that makes particles happen at the location of the broken block

ApplyAura:
  Skills:
  - aura{d=300;i=1;components=[
    - onBlockBreak{oB=FlameParticlesAtBlock;cE=false;auraname=Fire}
    ]} @self
FlameParticlesAtBlock:
  Skills:
  - particles{particle=flame;a=2;hs=0.25;vs=0.25;y=0.5;s=0.1125} @targetlocation

  Skills:
  - aura{d=99999;i=1;components=[
    - onBlockBreak{bt=#TORCH,#LIGHT;oB=[ addVar{var=caster.lightsBroken;a=1} ]}
    ]} @self

Intermediate: (because you can crash / lag you server if you don't read this!)

Apply an onBlockBreak aura to yourself, then when you break blocks it'll mine in a 5x5 area (3 radius in each direction from center block) based on the targetlocation of the block you broke. The cooldown here is REQUIRED. Without the cooldown the breakblock mechanic will retrigger the onblockbreak aura infinitely. You need MINIMUM cooldown of 0.1 seconds (2 ticks).

We need the 2 meta-skills here so that we can force the blockinradius to work at the block you broke. Without using 2 meta-skills, the blocksInRadius will target the blocks around the player who broke the blocks instead of the location the blocks were broken.

ApplyAura:
  Skills:
  - aura{d=300;i=1;components=[
    - onBlockBreak{oB=AreaMining1;cE=false;auraname=TotalDestruction;auraname=Fire}
    ]} @self
AreaMining1:
  Cooldown: 0.1
  Skills:
  - skill{s=AreaMining2} @targetLocation
AreaMining2:
  Skills:
  - breakblock{doDrops=true;doEffect=true;useTool=false;forcesync=true} @BlocksInRadius{r=3;ry=3}

Aliases

  • onbreakblock
Updated Aug 19, 2026