Dialogue (client). Client-only NUI dialogue system. Access via bridge.dialogue (lazy) or exports.Newb_Bridge:Dialogue(). Accessing this module on the server throws.

Dialogue (client)

Client-only NUI dialogue system. Access via bridge.dialogue (lazy) or exports.Newb_Bridge:Dialogue(). Accessing this module on the server throws.

`RegisterMenu(menu)`

RegisterMenu(menu)

Param	Type
`menu`	DialogueMenu

| Returns | string — menu id |

Usage Example

local id = bridge.dialogue.RegisterMenu({
    id = 'beekeeper',
    title = 'Beekeeper',
    text = 'Need supplies?',
    options = {
        { title = 'Buy jar', onSelect = function() end },
        { title = 'Sell honey', onSelect = function() end },
    },
})

`UnregisterMenu(id)`

bridge.dialogue.UnregisterMenu('beekeeper')

Param	Type
`id`	`string`

| Returns | boolean |

`UpdateMenu(id, updates)`

bridge.dialogue.UpdateMenu('beekeeper', { text = 'Welcome back!' })

Param	Type
`id`	`string`
`updates`	`DialogueMenu` \| `table`

| Returns | boolean |

`SetMenuOption(id, optionKey, updates)`

bridge.dialogue.SetMenuOption('beekeeper', 1, { title = 'Buy premium jar', disabled = false })

Param	Type
`id`	`string`
`optionKey`	`string` \| `number`
`updates`	DialogueOption

| Returns | boolean |

`RemoveMenuOption(id, optionKey)`

bridge.dialogue.RemoveMenuOption('beekeeper', 2)

Param	Type
`id`	`string`
`optionKey`	`string` \| `number`

| Returns | boolean |

`RefreshMenu(id)`

bridge.dialogue.RefreshMenu('beekeeper')

Param	Type
`id`	`string`

| Returns | boolean — re-renders the menu if it is open |

`GetMenu(id)`

local menu = bridge.dialogue.GetMenu('beekeeper')

Param	Type
`id`	`string`

| Returns | DialogueMenu? |

`OpenMenu(id, target?)`

OpenMenu(id, target)

Param	Type	Description
`id`	`string`	Registered menu id
`target`	`number` \| `vector3` \| `vector4` \| DialogueTargetOptions?	Ped entity or world position

Fails silently if the player is too far from the target.

Usage Example

bridge.dialogue.OpenMenu('beekeeper', shopPed)

bridge.dialogue.OpenMenu('beekeeper', {
    ped = shopPed,
    maxDistance = 3.0,
    camFov = 40.0,
})

`GetNavigationArgs()`

local args = bridge.dialogue.GetNavigationArgs()

| Returns | Args from the last menu-navigation select, or nil |

`Close(sessionId)`

bridge.dialogue.Close('beekeeper')

Param	Type	Description
`sessionId`	`string`	Same as the registered menu `id` (`OpenMenu` does not return a separate session id)

`PlayPedSpeech(ped, speech, param?)`

bridge.dialogue.PlayPedSpeech(ped, 'GENERIC_HI', 'SPEECH_PARAMS_FORCE')

Param	Type
`ped`	`number`
`speech`	`string` \| `DialogueSpeechOptions`
`param`	`string?`

| Returns | boolean |

`PlayPedAnim(ped, anim, animId?)`

bridge.dialogue.PlayPedAnim(ped, { dict = 'gestures@m@standing@casual', clip = 'gesture_hello' })

Param	Type
`ped`	`number`
`anim`	DialogueAnimOptions
`animId`	`string?`

| Returns | boolean |

Types

`DialogueMenu`

Field	Type
`id`	`string?`
`title`	`string`
`description`	`string?`
`text`	`string?`
`typewriter`	`boolean?`
`menu`	`string?`
`options`	`DialogueOption[]`
`onEnter`	`fun()?`
`onExit`	`fun()?`

`DialogueOption`

Field	Type
`title`	`string?`
`description`	`string?`
`input`	`DialogueInputField?`
`disabled`	`boolean?`
`readOnly`	`boolean?`
`item`	`string` \| `{ item, count?, metadata? }?`
`menu`	`string?`
`onSelect`	`fun(args: any)?`
`event`	`string?`
`serverEvent`	`string?`
`type`	`'info'` \| `'error'` \| `'success'` \| `'warning'`

`DialogueTargetOptions`

Field	Type
`ped`	`number?`
`entity`	`number?`
`coords`	`vector3` \| `vector4?`
`maxDistance`	`number?`
`camFov`	`number?`

`DialogueInputField`

Inline input on a DialogueOption (option.input).

Field	Type
`type`	`'input'` \| `'number'` \| `'checkbox'` \| `'select'` \| `'multi-select'` \| `'slider'` \| `'textarea'`
`label`	`string`
`description`	`string?`
`placeholder`	`string?`
`icon`	`string?`
`required`	`boolean?`
`disabled`	`boolean?`
`default`	`any?`
`password`	`boolean?` — `input` only
`min` / `max`	`number?` — numeric types, or textarea row count
`options`	`{ value, label?, description? }[]?` — `select` / `multi-select`

`DialogueAnimOptions`

Field	Type
`dict`	`string`
`clip`	`string`
`flag`	`number?`
`duration`	`number?`

Client

On this page