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

# npc.setposparty

```lua
npc.setposparty(x, y, z, heading)
```

|                         |                                  |
| ----------------------- | -------------------------------- |
| id                      | `0x03B1`                         |
| arguments               | 4: Float, Float, Float, Float    |
| in NPC Kit              | yes                              |
| measured from a kit NPC | returns                          |
| vanilla scripts         | 788 calls in 403 of 1114 scripts |

## What it does

Places the whole party at a point, facing an angle, and stops their movement.

## Arguments

### `x` (Float)

### `y` (Float)

### `z` (Float)

The point.

### `heading` (Float)

The party's facing, radians.

## Timing

Returns at once.

## In NPC Kit

In a scene's `close`, in the black, to leave the party somewhere chosen. To walk only the leader to a mark, [ucmove](https://fehdead.gitbook.io/npc-kit/vm-reference/calls/ucmove.md). Not tested on a kit NPC.

## Used with

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

## Example

A scene's `close` that leaves the party in front of the NPC, in the black.

```lua
close = function()
    npc.fadeout(15);
    npc.fadesync();
    npc.cameraclear();
    npc.setposparty(320.78, 2.02, 43.14, 2.677);   -- the point, and the heading that faces the NPC
    npc.wait(3);
    npc.fadein(15);
    npc.fadesync();
end,
```

## Pitfalls

* Not tested on a kit NPC; do it in the black, or the party jumps on screen.
