> For the complete documentation index, see [llms.txt](https://fehdead.gitbook.io/npc-kit/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://fehdead.gitbook.io/npc-kit/vm-reference/calls/charcommoneffectplay.md).

# npc.charcommoneffectplay

```lua
npc.charcommoneffectplay(effect)
```

|                         |                                                                                     |
| ----------------------- | ----------------------------------------------------------------------------------- |
| id                      | `0x0465`                                                                            |
| arguments               | 1: Int                                                                              |
| result                  | Int: goes to the very next call, or to `npc.lua(npc.charcommoneffectplay(...), fn)` |
| in NPC Kit              | yes                                                                                 |
| measured from a kit NPC | returns                                                                             |
| vanilla scripts         | 76 calls in 21 of 1114 scripts                                                      |

## What it does

Plays one of the game's common effects on the NPC itself and keeps it as the NPC's effect: a new one stops the last. Vanilla follows it with [charcommoneffecttrigger](https://fehdead.gitbook.io/npc-kit/vm-reference/calls/charcommoneffecttrigger.md) `(1)` every time, and stops it with [charcommoneffectstop](https://fehdead.gitbook.io/npc-kit/vm-reference/calls/charcommoneffectstop.md).

## Arguments

### `effect` (Int)

Which common effect, **0 to 13**, the same 14 as [common2effectplay](https://fehdead.gitbook.io/npc-kit/vm-reference/calls/common2effectplay.md). The game reads its table with no bound check: 14 or more crashes the game. Every vanilla call passes `13`, the sparkle on a point to examine.

## Timing

Returns at once; the effect plays on its own.

## In NPC Kit

Keep the vanilla pair: whether the effect shows without the trigger is not confirmed. Not tested on a kit NPC.

## Used with

* [charcommoneffecttrigger](https://fehdead.gitbook.io/npc-kit/vm-reference/calls/charcommoneffecttrigger.md): right after it.
* [charcommoneffectstop](https://fehdead.gitbook.io/npc-kit/vm-reference/calls/charcommoneffectstop.md): stop it.
* [common2effectplay](https://fehdead.gitbook.io/npc-kit/vm-reference/calls/common2effectplay.md): a common effect aimed at someone else.

## Example

The vanilla shape: the sparkle on, held a while, then off.

```lua
sparkle = function()
    npc.charcommoneffectplay(13);
    npc.charcommoneffecttrigger(1);
    npc.wait(120);
    npc.charcommoneffectstop();
end,
```

## Pitfalls

* Never above 13.
