Effects

Effects visualize zones using particles or entities. Each zone can have multiple effects.

Common Effect Parameters

Parameter	Default	Description
type	hollow	Effect type (see below).
particle	FLAME	Particle type (any from Particle).
colors	FF0000,00FF00,0000FF	HEX colors for REDSTONE/DUST.
team-colors	false	If true, uses color from the particle-colors setting in teams.
repeat-interval	20	Repeat interval in ticks. 0 = one-time.
spawn	instant	instant or delayed.
spawn-delay	40	Delay for delayed (in ticks).
offset-position	0,0,0	Effect center offset: "x,y,z".
particle-offset-x/y/z	0.01	Random particle offset.
particle-radius	0.0	Additional radius around the base shape.

Effect Types

1

hollow

• For circle — renders a ring.

• For cube — renders only the cube’s surface.

• Parameters: effect-radius, particle-count.

2

line

• Radial lines from min-radius to max-radius.

• Parameters: min/max-radius, angle-interval, zigzag.

3

vertical-line

• Vertical lines along the perimeter of a circle.

• Parameters: effect-radius, height-step.

4

perimeter

• Zone perimeter based on position-type.

• For multi-chunk — outlines the outer edge of the chunk group.

• Parameters: y-lines, perimeter-min/max-y.

5

cube

• Wireframe cube with rotation support.

6

circle

• Tilted circle with tilt-x and tilt-z settings.

7

sphere

• Uniformly distributed particle sphere.

• Supports rotation and pulsing.

8

block

• Without single-entity: fills the cube with particles.

• With single-entity: true: spawns an invisible ArmorStand wearing a block on its head.

block Parameters with single-entity

Parameter	Description
material	Block type (e.g., DIAMOND_BLOCK).
nbt-name	Custom display name (supports & color codes).
nbt-lore	List of lore lines.
glow	Glow effect via scoreboard.
glow-color	Glow color (e.g., RED).
scale	Entity scale (via reflection, not supported in all versions).
animate-mode	static, loop, or custom.

Animations

animate:
  axis: y 
  speed: 1.0

• axis: x, y, or z

• speed: degrees per tick

pulse: true 
pulse-min: 20 
pulse-max: 30 
pulse-speed: 0.05

• Radius oscillates sinusoidally between min and max.

breathe: true 
breathe-speed: 0.1

• Particle density pulses from 0% to 100%, reducing performance load.

color-cycle: true

• Cycles through colors defined in colors.

Particle Colors

• Only supported for REDSTONE and DUST particles.

• Format: colors: "FF0000,00FF00" (HEX without #).

• If team-colors: true, uses the color from teams.yml. Requires: use-teams: true

Performance Tips

• Decrease particle-count and increase repeat-interval.

• Avoid multiple block effects without single-entity.