> ## Documentation Index
> Fetch the complete documentation index at: https://entities.lodemc.net/llms.txt
> Use this file to discover all available pages before exploring further.

# Timers & Auras

> Run effects on a timer with repeat, pulse and stoprepeat, or with +onTimer.

There are three ways to run something on a clock:

* **`+onTimer:N`** on a line runs it every `N` ticks for as long as the mob is alive. The simplest; nothing to start or stop. See [Triggers](https://entities.lodemc.net/triggers.md).
* **`repeat`** runs a skill on a timer you start and stop: how often, for how long, with a name to stop it early. This page.
* **`aura`** places a timed effect on another entity, MythicMobs-style. See [Auras](https://entities.lodemc.net/mechanics-auras.md).

```yaml theme={null}
- particlering{p=flame;radius=3} +onTimer:40 @self   # every 2 seconds, forever
```

With `repeat`, say what to run, how often, and for how long. This is how pulsing attacks and phase timers are built.

```yaml theme={null}
- repeat{effect=shockwave;every=2s;for=30s} +onSpawn @self
- repeat{effect=heal_aura;every=1s;for=forever}
```

## repeat

Runs a [named or local effect](https://entities.lodemc.net/named-effects.md) 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`, `pulseremove`

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

```yaml theme={null}
- stoprepeat{name=quake} +onDeath @self
```

## pulse

The full-lifecycle form of `repeat`. Same engine, all three hooks explicit.

> [!NOTE]
>
> `aura` used to be an alias of `pulse`. It is now MythicMobs' `aura`, where the **caster** stays `@self` and the entity wearing it is the inherited target. In `repeat` and `pulse`, the entity it runs on is `@self`. See [Auras](https://entities.lodemc.net/mechanics-auras.md#aura-or-repeat).

| 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.

```yaml theme={null}
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.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.