mine_radius
Categories: world
Required arguments
| Key(s) | Description | Type |
|---|
radius | The radius of blocks to break around the triggered block. Supports expressions. | EXPRESSION |
Optional arguments
| Key(s) | Description | Type | Default |
|---|
depth | | EXPRESSION | |
prevent_trigger |
Choices: false, true, keep_events | STRING | false |
disable_on_sneak | Whether the effect should be disabled while the player is sneaking. | BOOLEAN | false |
no_corners | Whether corner blocks at the edge of the radius should be excluded. | BOOLEAN | false |
whitelist | A list of blocks that are allowed to be broken. If omitted, all blocks are eligible. | BLOCK_LIST | [] |
blacklisted_blocks | A list of blocks that should never be broken by this effect. | BLOCK_LIST | [] |
check_hardness | Whether blocks harder than the triggered block should be skipped. | BOOLEAN | true |
use_blockface | | BOOLEAN | false |
Trigger parameters required
Example
effects:
- id: mine_radius
args:
radius: 2 + %level% / 20
depth: 1 # ← Optional
prevent_trigger: false|true|keep_events # ← Optional
disable_on_sneak: true # ← Optional
no_corners: true # ← Optional
whitelist: <value> # ← Optional
blacklisted_blocks: <value> # ← Optional
check_hardness: true # ← Optional
use_blockface: true # ← Optional
Behaviour
| Setting | Value |
|---|
| Run order | NORMAL |
| Supports delay | true |
| Reloads on plugin reload | true |