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

# Movement & Force

> Velocity, knockback, pulls, dashes and teleports.

Mechanics that move entities around: knockback, pulls, dashes and teleports. These are what make fights feel physical.

## velocity

Sets or adds velocity on targets, per axis.

| Attribute     | Description                                                     |
| ------------- | --------------------------------------------------------------- |
| `x`, `y`, `z` | Velocity per axis.                                              |
| `mode`        | `set` replaces the current velocity, `add` stacks on top of it. |

```yaml theme={null}
- velocity{y=1.2;mode=add} #onHurt @target
```

## push

Pushes targets **away from the mob**.

| Attribute  | Alias | Description    |
| ---------- | ----- | -------------- |
| `velocity` | `v`   | Push strength. |

```yaml theme={null}
- push{velocity=1.2} @playersRadius[5]
```

## pull

Pulls targets **toward the mob**.

**Alias:** `forcepull`

| Attribute  | Alias | Description    |
| ---------- | ----- | -------------- |
| `velocity` | `v`   | Pull strength. |

```yaml theme={null}
- pull{velocity=1.5} @playersRadius[10]
```

## throw

Launches targets away from the mob, with separate control over the upward arc. Great for smash attacks.

| Attribute   | Description                 |
| ----------- | --------------------------- |
| `velocity`  | Horizontal launch strength. |
| `velocityY` | Upward launch strength.     |

```yaml theme={null}
- throw{velocity=2;velocityY=0.8} @playersRadius[4]
```

## leap

The **mob** leaps in an arc to its first target.

| Attribute  | Description    |
| ---------- | -------------- |
| `velocity` | Leap strength. |

```yaml theme={null}
- leap{velocity=1.6} #onHurt @target
```

## lunge

The **mob** dashes straight at its first target. Flatter and faster than `leap`.

| Attribute   | Description                |
| ----------- | -------------------------- |
| `velocity`  | Dash strength.             |
| `velocityY` | Optional upward component. |

```yaml theme={null}
- lunge{velocity=1.6} #onHurt @target
```

## teleport

Teleports the **mob** to its first target.

**Alias:** `tp`

```yaml theme={null}
- teleport #onHurt @target
```

## Movers vs. moved

Note the split: `velocity`, `push`, `pull` and `throw` move the **targets**. `leap`, `lunge` and `teleport` move the **mob** toward its first target. A gap-closer is `lunge`, a crowd-clearer is `throw`.