# .add-particles (client command)

Source: https://ref.dm-lang.org/skin/commands/dotadd-particles
Added in BYOND 516.

### Format
> `.add-particles *object* *count*`

Immediately spawns a batch of particles for a known particle set.

The object parameter is a [reference string](https://ref.dm-lang.org/proc/ref.md) for the object that holds the particles.

A negative count is allowed, which will absorb some ordinary particle spawns.

```
.add-particles [0x200004f] 50
```

If the object isn't known to the client, nothing will happen.

### See also
- [Particle effects](https://ref.dm-lang.org/notes/particles.md)
- [Client commands](https://ref.dm-lang.org/skin/commands/index.md)