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

# npc.fieldsignicon

```lua
npc.fieldsignicon(kind)
```

|                         |                                   |
| ----------------------- | --------------------------------- |
| id                      | `0x0177`                          |
| arguments               | 1: Int                            |
| in NPC Kit              | yes                               |
| measured from a kit NPC | returns                           |
| vanilla scripts         | 2125 calls in 338 of 1114 scripts |

## What it does

Sets the icon of the field sign label: the label the game draws over the **player** (not over the NPC) when the player is near the actor and faces it. Talking to it with the button runs its `talk`.

## Arguments

### `kind` (Int)

| `kind` | over the player                            |
| ------ | ------------------------------------------ |
| `1`    | "!", no button                             |
| `2`    | "!!" with the button (1,220 vanilla calls) |
| `3`    | a magnifier with the button (905)          |

Above `3` nothing is drawn.

## Timing

Returns at once.

## In NPC Kit

Only an actor with trigger 13 on asks for the label: `npc.reqenable(13)` is enough, as in the vanilla sign actors. The NPC's `talk` still runs on the button.

## Used with

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

## Example

The vanilla shape, in `init` of a sign actor: the magnifier over the player near it.

```lua
init = function()
    -- ...
    npc.reqenable(13);
    npc.fieldsignicon(3);
    npc.showfieldsign();
end,
```

## Pitfalls

* It does nothing without trigger 13 (`npc.reqenable(13)`).
* The label is over the player, and only while the player faces the actor.
* The NPC's own tag (its balloon, "Space" and its name) still shows beside it; `npc.setnavimapdrawstatus(0)` takes it off (and the map dot), so only the label over the player is left, with the name once.
* Don't use `fieldsignmes` on a kit NPC: it replaces the name pointer at `actor+0xF8`, which NPC Kit uses to find the NPC's record. Its `name` is the label's text, beside the button.
