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

# npc.hidecomplete

```lua
npc.hidecomplete()
```

|                         |                                   |
| ----------------------- | --------------------------------- |
| id                      | `0x03E6`                          |
| arguments               | 0                                 |
| in NPC Kit              | yes                               |
| measured from a kit NPC | returns                           |
| vanilla scripts         | 1793 calls in 150 of 1114 scripts |

## What it does

Hides the NPC's model whatever [show](https://fehdead.gitbook.io/npc-kit/vm-reference/calls/show.md) says: the second switch of the model's visibility. It stays hidden until [clearhidecomplete](https://fehdead.gitbook.io/npc-kit/vm-reference/calls/clearhidecomplete.md), even if `show` is called.

## Timing

Returns at once.

## In NPC Kit

* An NPC that must stay hidden while other code may `show` it: `hidecomplete()` in `init`, and `clearhidecomplete(); show();` on cue (the magic-trick example's wolf).
* Vanilla hides its NPCs this way around a map's scenes.

## Used with

* [clearhidecomplete](https://fehdead.gitbook.io/npc-kit/vm-reference/calls/clearhidecomplete.md): the way back.
* [show](https://fehdead.gitbook.io/npc-kit/vm-reference/calls/show.md) / [hide](https://fehdead.gitbook.io/npc-kit/vm-reference/calls/hide.md): the other switch.
* [rgbatrans](https://fehdead.gitbook.io/npc-kit/vm-reference/calls/rgbatrans.md): fade before hiding.

## Example

An NPC that must stay hidden until a beat clears it: `hidecomplete` in `init` keeps a plain `show` from bringing it back, and the beat clears it first.

```lua
init = function()
    placeNpc(0x006E0019, 316.2, 2.02, 42.8, 1.675);
    npc.hidecomplete();
    npc.hide();
    npc.hideshadow();
end,

-- a beat of the talk that brings it in
reveal = function()
    local wolf = npc.on("npckit_0023")
    wolf.clearhidecomplete();
    wolf.show();
    wolf.showshadow();
end,
```

## Pitfalls

* A `show` with the lock still on shows nothing: `clearhidecomplete` comes first.
