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

# npc.istouchucsync

```lua
npc.istouchucsync()
```

|                         |                                                                         |
| ----------------------- | ----------------------------------------------------------------------- |
| id                      | `0x0525`                                                                |
| arguments               | 0                                                                       |
| in NPC Kit              | yes                                                                     |
| measured from a kit NPC | returns                                                                 |
| waits                   | it has a wait handler: it can hold the script, and in `talk` the player |
| vanilla scripts         | 2497 calls in 133 of 1114 scripts                                       |

## What it does

Holds the script while the character the player controls is touching the NPC. Vanilla NPCs call it in their fade-in.

## Timing

Waits, once a frame, while the touch lasts; returns at once when the player isn't touching.

## In NPC Kit

A kit NPC's probe returns from it. Vanilla's fade-in of a new NPC:

```lua
npc.istouchucsync();
npc.bonecalcforce(-1);
npc.rgbatrans(1, 1, 1, 0, 0);
npc.istouchucsync();
npc.clearhidecomplete();
npc.rgbatrans(1, 1, 1, 1, 10);
```

## Used with

* [rgbatrans](https://fehdead.gitbook.io/npc-kit/vm-reference/calls/rgbatrans.md), [clearhidecomplete](https://fehdead.gitbook.io/npc-kit/vm-reference/calls/clearhidecomplete.md).

## Example

An NPC that fades in where the player may be standing: it waits for the player to step off before it becomes solid and visible.

```lua
appear = function()
    npc.istouchucsync();
    npc.bonecalcforce(-1);
    npc.rgbatrans(1, 1, 1, 0, 0);       -- fully transparent
    npc.istouchucsync();
    npc.clearhidecomplete();
    npc.show();
    npc.rgbatrans(1, 1, 1, 1, 10);      -- fade in over 10 frames
end,
```
