# CyberM.nameplates — client runtime

Runs inside the game process. Reads and presentation are local; anything that changes shared state has to go through the server.

4 functions.

## clear

```lua
CyberM.nameplates.clear()
```

`GAME` — Requires a live game instance.

Removes every nameplate override owned by the calling resource.

Requires `ui.nameplates`; other owners are unaffected.

Returns: `true on success`

Registered in `ResourceHost.cpp` (line 6771) as `LuaNameplateClear`.

## remove

```lua
CyberM.nameplates.remove(playerId)
```

`GAME` — Requires a live game instance.

Removes the calling resource's nameplate override for one player.

Requires `ui.nameplates`.

| Parameter | Type | Required | Default |
|---|---|---|---|
| `playerId` | `integer|string` | required | — |

Returns: `true on success, otherwise false`, `reason`

Registered in `ResourceHost.cpp` (line 6770) as `LuaNameplateRemove`.

## set

```lua
CyberM.nameplates.set(playerId, options)
```

`GAME` — Requires a live game instance.

Creates or updates the calling resource's nameplate override for a remote player.

Requires `ui.nameplates`. Options accept `label`, `color`, `maxDistance`, and `visible`. Overrides are owner-scoped and cleaned up with the resource.

| Parameter | Type | Required | Default |
|---|---|---|---|
| `playerId` | `integer|string` | required | — |
| `options` | `table` | required | — |

Returns: `true on success, otherwise false`, `reason`

Registered in `ResourceHost.cpp` (line 6769) as `LuaNameplateSet`.

## snapshot

```lua
CyberM.nameplates.snapshot()
```

`GAME` — Requires a live game instance.

Returns the currently rendered remote-player nameplates.

Requires `ui.nameplates`. Screen coordinates and distance describe the most recent presentation snapshot.

Returns: `array of { id, label, color, x, y, distance }, or nil`, `reason`

Registered in `ResourceHost.cpp` (line 6772) as `LuaNameplateSnapshot`.