mine_shape
Breaks blocks in a custom 2D grid shape relative to the block the player mines.
Categories: world
Required arguments
| Key(s) | Description | Type |
|---|
shape | A list of strings forming a grid where 'T' is the trigger block and 'X' marks blocks to break. | STRING_LIST |
Optional arguments
| Key(s) | Description | Type | Default |
|---|
depth | How many layers deep to mine behind the trigger block. Supports expressions. | EXPRESSION | 1 |
whitelist | A list of blocks that are allowed to be broken. Defaults to all blocks. | BLOCK_LIST | [] |
blacklisted_blocks | A list of blocks that will never be broken by this effect. | BLOCK_LIST | [] |
prevent_trigger | Whether to prevent the broken blocks from re-triggering this effect. | BOOLEAN | false |
disable_on_sneak | Whether to disable the shape mining when the player is sneaking. | BOOLEAN | false |
check_hardness | Whether to skip blocks harder than the trigger block. Defaults to true. | BOOLEAN | true |
Trigger parameters required
Example
effects:
- id: mine_shape
args:
shape:
- "XXX"
- "XTX"
- "XXX"
depth: <expression> # ← Optional
whitelist: <value> # ← Optional
blacklisted_blocks: <value> # ← Optional
prevent_trigger: true # ← Optional
disable_on_sneak: true # ← Optional
check_hardness: true # ← Optional
Behaviour
| Setting | Value |
|---|
| Run order | NORMAL |
| Supports delay | true |
| Reloads on plugin reload | true |