Timers & Auras

To run an effect on a timer, use repeat: say what to run, how often, and for how long. This is how auras, pulsing attacks and phase timers are built.

- repeat{effect=shockwave;every=2s;for=30s} #onSpawn @self
- repeat{effect=heal_aura;every=1s;for=forever}

repeat

Runs a named or local effect on each target repeatedly. Alias: every

Attribute	Default	Description
`effect`	required	The named or local effect to run.
`every`	`1s`	How often it runs.
`for`	`5s`	How long it keeps going, or `forever`.
`name`		A name so you can stop it later.
`onStart`		Optional effect to run once when the repeat starts.
`onEnd`		Optional effect to run once when it ends.

The repeating effect runs with the ticking entity as @self, so radius targeters inside it resolve around that entity. Repeats stop automatically when the entity dies or despawns.

stoprepeat

Stops repeats and pulses on the targets, running their onEnd if they have one. Aliases: removepulse, removeaura

Attribute	Description
`name`	Which repeat to stop. Omit to stop them all.

- stoprepeat{name=quake} #onDeath @self

pulse

The full-lifecycle form of repeat. Same engine, all three hooks explicit. Alias: aura

Attribute	Description
`onStart`	Effect to run when the pulse begins.
`onTick`	Effect to run every interval.
`onEnd`	Effect to run when it ends.
`interval`	Time between ticks.
`duration`	Total lifetime.
`name`	Name for stopping it.

The name pattern

Give a repeat a name when anything might need to stop it early: phase changes, death, a cleanse mechanic.

toast_king:
  model: toast
  base: zombie
  effects:
  - repeat{effect=shockwave;every=2s;for=forever;name=quake} #onSpawn @self
  - stoprepeat{name=quake}                                   #onDeath @self
  shockwave:
  - particlering{particle=flame;radius=5;points=48} @self
  - delay 0.5s
  - damage{amount=8} @playersRadius[5]

A forever repeat with no stoprepeat still ends when the mob dies, but stopping it explicitly also fires its onEnd, which matters once you use one.

Getting Started

Commands

Effects

repeat

stoprepeat

pulse

The name pattern

​repeat

​stoprepeat

​pulse

​The name pattern

repeat

stoprepeat

pulse

The name pattern