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

# npc.hide

```lua
npc.hide()
```

|                         |                                   |
| ----------------------- | --------------------------------- |
| id                      | `0x0033`                          |
| arguments               | 0                                 |
| in NPC Kit              | yes                               |
| measured from a kit NPC | returns                           |
| vanilla scripts         | 3654 calls in 361 of 1114 scripts |

## What it does

Hides the NPC's model. The NPC stays where it is and its script keeps running; only the drawing stops. [show](https://fehdead.gitbook.io/npc-kit/vm-reference/calls/show.md) is the way back.

## Timing

Returns at once.

## In NPC Kit

* An NPC that enters a scene later starts hidden: end `init` with `npc.hide(); npc.hideshadow();`.
* The shadow stays unless [hideshadow](https://fehdead.gitbook.io/npc-kit/vm-reference/calls/hideshadow.md) too.
* Whether a hidden NPC still blocks the player is not confirmed: keep it off the path, or `usecharhit(0)` while it is hidden.

## Used with

* [show](https://fehdead.gitbook.io/npc-kit/vm-reference/calls/show.md), [hideshadow](https://fehdead.gitbook.io/npc-kit/vm-reference/calls/hideshadow.md), [hidecomplete](https://fehdead.gitbook.io/npc-kit/vm-reference/calls/hidecomplete.md).
* [rgbatrans](https://fehdead.gitbook.io/npc-kit/vm-reference/calls/rgbatrans.md)`(1, 1, 1, 0, n)`: fade out instead of a cut.

## Example

A guest that waits hidden and appears on cue in the owner's talk.

```lua
-- the guest's init ends hidden
init = function()
    placeNpc(0x006E0019, 316.2, 2.02, 42.8, 1.675);   -- the vanilla init, without show/showshadow
    npc.hide();
    npc.hideshadow();
end,

-- a beat of the owner's talk shows it, and a later one takes it away
guestIn = function()
    local guest = npc.on("npckit_0022")
    guest.show();
    guest.showshadow();
end,
guestOut = function()
    local guest = npc.on("npckit_0022")
    guest.hide();
    guest.hideshadow();
end,
```

## Pitfalls

* `hide` alone leaves the shadow on the ground.
