# CyberM.elevators — 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.

## all

```lua
CyberM.elevators.all()
```

`GAME` — Requires a live game instance.

Lists every replicated elevator state visible to the client.

Requires `elevators.read`; returns an empty array when the capability or backend is unavailable.

Returns: `array of elevator snapshots`

Registered in `ResourceHost.cpp` (line 6724) as `LuaElevatorsAll`.

## get

```lua
CyberM.elevators.get(id)
```

`GAME` — Requires a live game instance.

Reads one replicated elevator by CyberM ID.

Requires `elevators.read`. Elevator IDs are server-assigned and should be kept unchanged.

| Parameter | Type | Required | Default |
|---|---|---|---|
| `id` | `integer` | required | — |

Returns: `table { id, revision, bucket, engineEntity, activeFloor, originFloor, targetFloor, floorCount, travelMs, remainingMs, flags, phase, position, streamed, applied }, or nil`

Registered in `ResourceHost.cpp` (line 6723) as `LuaElevatorGet`.

## nearby

```lua
CyberM.elevators.nearby([radius])
```

`GAME` — Requires a live game instance.

Discovers streamed native elevators around the local player.

Requires `elevators.read`. Radius must be between 1 and 300 metres. Results distinguish unmanaged engine lifts from elevators already adopted by CyberM.

| Parameter | Type | Required | Default |
|---|---|---|---|
| `radius` | `number` | optional | `100` |

Returns: `array of { engineEntity, controllerEntity, position, distance, managed, floorCount, activeFloor, id }`

Registered in `ResourceHost.cpp` (line 6725) as `LuaElevatorsNearby`.

## request

```lua
CyberM.elevators.request(id, floor, action)
```

`GAME` — Requires a live game instance.

Submits a floor request to the authoritative server.

Requires `elevators.request`. `action` is normally `call` or `goto`; the server validates the ID, floor, player bucket, range, state and policy.

| Parameter | Type | Required | Default |
|---|---|---|---|
| `id` | `integer` | required | — |
| `floor` | `integer` | required | — |
| `action` | `string` | required | — |

Returns: `true when submitted, otherwise false`, `reason`

Registered in `ResourceHost.cpp` (line 6726) as `LuaElevatorRequest`.