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

# npc.modelread

```lua
npc.modelread(model)
```

|                         |                                   |
| ----------------------- | --------------------------------- |
| id                      | `0x00BF`                          |
| arguments               | 1: Int                            |
| in NPC Kit              | yes                               |
| measured from a kit NPC | returns                           |
| vanilla scripts         | 4539 calls in 699 of 1114 scripts |

## What it does

Asks for one of the map script's models to be loaded ahead of time; [modelreadsync](https://fehdead.gitbook.io/npc-kit/vm-reference/calls/modelreadsync.md) waits for it.

## Arguments

### `model` (Int)

`0x03000000 + n`, entry `n` of the map script's own model list.

## Timing

Returns at once.

## In NPC Kit

**Not for kit NPCs.** It takes an entry of the script's model list, which a kit NPC has none of. `bindp2_d4` with the absolute key loads the model and waits for it itself.

## Used with

* [modelreadsync](https://fehdead.gitbook.io/npc-kit/vm-reference/calls/modelreadsync.md), then `bindp2` in vanilla.

## Example

Vanilla's `modelread(0x03000001); modelreadsync(0x03000001); bindp2(0x03000001);` is, in the kit, one call with the absolute key:

```lua
init = function()
    npc.bindp2_d4(0x006E0019, 4, 3);   -- loads and waits for the model itself
    npc.stdmotionread(16);
    npc.stdmotionreadsync();
end,
```

## Pitfalls

* A `0x03000000 + n` key in a kit NPC names no model: its `init` holds for good.
