# CyberM.clipboard — client runtime

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

1 function.

## setText

```lua
CyberM.clipboard.setText(text)
```

`GAME` — Requires a live game instance.

Writes UTF-8 text to the operating-system clipboard.

Client-only and requires `clipboard.write` on the resource whose VM performs the call. Text is limited to 256 KiB, must be valid UTF-8 and cannot contain an embedded NUL. The operation is write-only: resources cannot inspect the user's existing clipboard. A temporarily owned clipboard returns `false, clipboard_busy`; callers should let the player retry instead of polling every frame.

| Parameter | Type | Required | Default |
|---|---|---|---|
| `text` | `string` | required | — |

Returns: `true on success, otherwise false`, `reason for the refusal`

```lua
local ok, reason = CyberM.clipboard.setText("position = { x = 1, y = 2, z = 3 }")
```

Registered in `ResourceHost.cpp` (line 6607) as `LuaClipboardSetText`.