@playersRadius

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

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

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. To target only non-players, use @mobsRadius.

Getting Started

Commands

Effects

When to use it

Details

​When to use it

​Details

When to use it

Details