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

# npc.motionread

```lua
npc.motionread(slot)
```

|                         |                                   |
| ----------------------- | --------------------------------- |
| id                      | `0x00A2`                          |
| arguments               | 1: Int                            |
| in NPC Kit              | yes                               |
| measured from a kit NPC | returns                           |
| vanilla scripts         | 1511 calls in 479 of 1114 scripts |

## What it does

Asks for one of the script set's map motions to be loaded into slot `n`, for [motionplay\_bb](https://fehdead.gitbook.io/npc-kit/vm-reference/calls/motionplay_bb.md) to play.

## Arguments

### `slot` (Int)

The slot, 0 to 15. Vanilla: `1`, `0`, `2`, `3`, `4`.

## Timing

Returns at once; [motionreadsync](https://fehdead.gitbook.io/npc-kit/vm-reference/calls/motionreadsync.md) waits for the load.

## In NPC Kit

**It loads nothing for a kit NPC.** The game never loads map motions for the kit's script set (set 4 or above), so `motionplay_bb` has nothing to play. Use the standard motions.

## Used with

* [motionreadsync](https://fehdead.gitbook.io/npc-kit/vm-reference/calls/motionreadsync.md), [motionplay\_bb](https://fehdead.gitbook.io/npc-kit/vm-reference/calls/motionplay_bb.md).

## Example

The kit loads motions with `stdmotionread`, the package of the model's standard motions.

```lua
-- vanilla map script:  motionread(1); motionreadsync(1);   (loads nothing for a kit NPC)
init = function()
    npc.bindp2_d4(0x006E0019, 4, 3);
    npc.stdmotionread(16);          -- the town package
    npc.stdmotionreadsync();
    npc.stdmotionplay_2c2(0x01000000, 0);
end,
```
