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

# Combat & Summons

> Summons, fireballs, stuns, freezes, taunts and item rewards.

The fight-shaping mechanics: reinforcements, projectiles, crowd control and loot.

## summon

Summons registered mobs (or vanilla entities) around each target.

**Alias:** `spawnmob`

| Attribute | Description                                  |
| --------- | -------------------------------------------- |
| `mob`     | A registered mob id, or a vanilla entity id. |
| `amount`  | How many to summon.                          |
| `radius`  | Spread around the target.                    |

```yaml theme={null}
- summon{mob=toast_minion;amount=3;radius=4} #onHurt @self
```

## shootfireball

Shoots a fireball at each target.

**Alias:** `fireball`

| Attribute    | Description                                |
| ------------ | ------------------------------------------ |
| `yield`      | Explosion strength on impact.              |
| `incendiary` | Whether it starts fires.                   |
| `velocity`   | Fireball speed.                            |
| `small`      | `true` for the small blaze-style fireball. |

```yaml theme={null}
- shootfireball{yield=2;incendiary=false;velocity=1.5} #onAttack @target
```

## fakeexplosion

Explosion particles and sound with zero damage. Perfect for telegraphed attacks. No attributes.

**Alias:** `fakeexplode`

```yaml theme={null}
- fakeexplosion @self
```

## stun

Roots targets in place. Mobs get their AI paused; players get extreme slowness and can't jump.

| Attribute | Description                               |
| --------- | ----------------------------------------- |
| `ticks`   | Stun duration. Accepts time units (`1s`). |

```yaml theme={null}
- stun{ticks=2s} #onAttack @target
```

## freeze

Applies the powder-snow freeze overlay and shake.

| Attribute | Description      |
| --------- | ---------------- |
| `ticks`   | Freeze duration. |

```yaml theme={null}
- freeze{ticks=3s} #onAttack @target
```

## settarget

Sets the mob's AI attack target to the first target. Use it to make the mob turn on whoever poked it.

**Alias:** `taunt`

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

## dropitem

Drops an item on the ground at each target.

**Alias:** `drop`

| Attribute | Description                  |
| --------- | ---------------------------- |
| `item`    | The item id, e.g. `diamond`. |
| `amount`  | How many.                    |

```yaml theme={null}
- dropitem{item=golden_apple;amount=1} #onDeath @self
```

## giveitem

Puts an item directly in each player target's inventory.

**Alias:** `give`

| Attribute | Description  |
| --------- | ------------ |
| `item`    | The item id. |
| `amount`  | How many.    |

```yaml theme={null}
- giveitem{item=diamond;amount=3} #onDeath @target
```

`dropitem` drops on the ground for anyone to grab; `giveitem` goes straight to the killer. Pick based on whether the reward should be contested.
