> 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/motiontrigger.md).

# npc.motiontrigger

```lua
npc.motiontrigger()
```

|                         |                                 |
| ----------------------- | ------------------------------- |
| id                      | `0x014E`                        |
| arguments               | 0                               |
| in NPC Kit              | yes                             |
| measured from a kit NPC | returns                         |
| vanilla scripts         | 497 calls in 31 of 1114 scripts |

## What it does

Sends a cue to the motion playing on the NPC's model: on the next frame the game sets a flag on the model's motion player (and on the players of the pieces attached to it). What a motion does with the cue is not confirmed; vanilla sends it to a motion authored to hold until then.

## Timing

Returns at once.

## In NPC Kit

Which standard motions wait for such a cue is not confirmed here; not tested on a kit NPC.

## Used with

* [stdmotionplay\_2c2](https://fehdead.gitbook.io/npc-kit/vm-reference/calls/stdmotionplay_2c2.md).

## Example

The vanilla shape: a motion holds until the cue, then goes on. Which standard motions hold for it is not confirmed; check it in the game before relying on it.

```lua
release = function()
    npc.motiontrigger();
    npc.motionsync_282(1);
end,
```
