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

# @playersRadius

> Targets every player within N blocks of the mob.

Targets every **player** within `N` blocks of the mob. The radius goes in square brackets:

```yaml theme={null}
- damage{amount=8} @playersRadius[5]
```

## When to use it

This is the bread and butter of boss design: AoE attacks, warnings to nearby players, greetings, area buffs and debuffs.

```yaml theme={null}
toast_king:
  model: toast
  base: zombie
  display: "&6&lToast King"
  effects:
  - narrate "&6The Toast King notices you."  #onSpawn @playersRadius[30]
  - run smash                                #onHurt  @self
  smash:
  - particlering{particle=flame;radius=5;points=48} @self
  - delay 0.5s
  - damage{amount=8}   @playersRadius[5]
  - push{velocity=1.2} @playersRadius[5]
```

Note the pattern in `smash`: the warning ring is drawn at the mob (`@self`), then the blast hits everyone in range half a second later. Telegraph wide, hit narrow.

## Details

* The radius is measured from the **mob's position** at the moment the line runs.
* It resolves to zero, one or many players. The mechanic runs once per player. No players in range means the line does nothing.
* Pick the radius per line, not per mob. A warning can reach 30 blocks while the damage only reaches 5, like the example above.

To include non-player entities, use [`@entitiesRadius`](targeter-entities-radius). To target only non-players, use [`@mobsRadius`](targeter-mobs-radius).