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

# npc.partyusemapid

```lua
npc.partyusemapid(state)
```

|                         |                                  |
| ----------------------- | -------------------------------- |
| id                      | `0x040D`                         |
| arguments               | 1: Int                           |
| in NPC Kit              | yes                              |
| measured from a kit NPC | returns                          |
| vanilla scripts         | 459 calls in 281 of 1114 scripts |

## What it does

[usemapid](https://fehdead.gitbook.io/npc-kit/vm-reference/calls/usemapid.md) for every party member and guest at once: `1` puts them on the map's floor, `0` lets them stand and move freely in three dimensions. Each is placed again at its own position right away.

## Arguments

### `state` (Int)

`1` on the floor, `0` free. Vanilla: `1` 448 times, `0` 11.

## Timing

Returns at once.

## In NPC Kit

Before [setposparty](https://fehdead.gitbook.io/npc-kit/vm-reference/calls/setposparty.md) in a scene, so the party lands on the floor at the spot it is moved to.

## Used with

* [usemapid](https://fehdead.gitbook.io/npc-kit/vm-reference/calls/usemapid.md): one actor.
* [setposparty](https://fehdead.gitbook.io/npc-kit/vm-reference/calls/setposparty.md).

## Example

A scene that brings the party in front of the NPC.

```lua
open = function()
    npc.fadeout(15);
    npc.fadesync();
    npc.partyusemapid(1);
    npc.setposparty(39.5, -9.0, 64.5, 3.14159274);
    npc.wait(1);
    npc.fadein(15);
    npc.fadesync();
end,
```
