BlockMask

This is an old version of this page. You can view the most recent version or browse the history.

Description

Creates a mask of blocks around the specified target. The blocks created or changed by this effect will disappear or rather reset to their former state after the specified duration expired. Resetting the blocks at an earlier point in time can be achieved by using the blockunmask-effect (see example below).

Note that the blockmask effect will never actually change any blocks in the world and thus will never grief the environment in any way. The changes made this effect are purely cosmetic, no actual blocks are changed and everything will always return to its original state.

The material attribute accepts as valid values the Bukkit name that is relative to it.

Bukkit material/block names can be acquired in-game. Simply hold the block you want to use for the effect in your hand and then use the command “/itemdb”. This command will output the bukkit-material info along with some other info, including the data value of the block. This command should work on any bukkit/spigot server.

Attributes

Attribute	Aliases	Description	Default
material	mat, m, block, b	The type of block used for the blockmask	GRAVEL
radius	r	The radius of the blockmask effect	0
radiusy	ry	The y component of the radius	`radius`
noise	n	Defines the randomness of the effect	0
duration	d	Duration of the effect in ticks	0
shape	s	The shape of the effect. `Sphere`/`Cube`	SPHERE
noair	na	Mask no air blocks only	true
onlyair	oa	Mask air blocks only	false
audience		The audience of the effect	nearby
occ	o, oc	If onlyair is used, target transparent blocks as well	true

Duration Attribute

there are 20 ticks in 1 second, and setting duration to 0 will have an infinite duration.

Shape Attribute

Sphere and Cube are the only shapes available.

Examples

Creates a netherrack environment around the casting mob. Leaving the duration on 0 ticks will cause the blocks to stay in their new fake form until manual block updates are provided or players relog into the game.

- effect:blockmask{m=netherrack;r=5} @self ~onTimer:1200

Creates a layer of ice underneath the feet of all players within a 50 block radius, causing them to have a constantly slippery walk.

- effect:blockmask{m=ice;r=2;d=20} @PIR{r=50} ~onTimer:5

Will forcibly reverse all effects created by the blockmask effect in the specified radius. The blockunmask effect doesn't have any syntax options except for “radius”.

- effect:blockunmask{r=30}

Aliases

effect:blockMask
e:blockMask