Common Errors

Common Errors — Text UI for FiveM | Quasar Store | Quasar Store

A 3D prompt never shows

Go through these in order:

It has no displayDist. Without it the prompt is skipped — with debug on, the console prints No displayDist.
Its job is not your character's job, or its canInteract returns false.
The id was already used. A second create3DTextUI with the same id is ignored, so the first one's coordinates and settings stay.
The coordinate is under the floor or inside a wall, so it is never on screen. Raise z by half a metre.
Another script has the mouse cursor open — an inventory or a menu. Prompts hide until it closes, by design.

Pressing the key does nothing

The prompt has a key but no keyNum. key is only the label; keyNum is the control that is listened to.
Another option is selected. With several prompts in reach only the highlighted one responds — use the arrow keys.
On a prompt on a player, enableKeyClick is missing. It must be true there.

"attempt to concatenate a nil value (field 'key')", and every prompt stops

A 3D prompt was created without a key. Every prompt needs a key label — also a display-only one — so pass key = 'E' or any label, then restart qs-textui. If it comes from an old script through DrawText3D, use the wrapper, which fills in a key.

Prompts disappeared after restarting qs-textui

Prompts created through exports live in Text UI's memory, and a restart clears them. Restart the scripts that create them too, or have them recreate their prompts when Text UI starts — see When qs-textui Restarts.

Prompts vanish while an inventory, phone or menu is open

Correct behaviour. Whenever another script has the mouse cursor, Text UI hides itself so it never covers that window, and comes back when it closes. The same happens in the pause menu and during screen fades.

DrawText3D labels stay on screen after walking away

The script calls drawText3D directly and never deletes the label. Use the full wrapper, which removes the label a few frames after the script stops drawing it, or call DeleteDrawText3D yourself.

Two labels jump between places, or one replaces the other

They share an id. Every prompt needs its own — add the door number, the shop name or the entity to it: 'door_' .. doorId.

The text shows ~g~ or ~r~ instead of colours

GTA colour codes are supported from version 1.2.27. Check the version in fxmanifest.lua and download the latest one from the CFX Portal.

The on-screen prompt is in the wrong place

A position that is not one of the nine names falls back to Config.DefaultAlign — left or right from QBCore, for example. Use the names listed in Screen Position, or the mapping in Integrations. In the Cyberpunk style, the dialogue sits at Config.CyberpunkTextUI.align unless the script chooses.

Config changes do nothing

shared/config.lua is read when qs-textui starts. Restart it after every edit — and then restart the scripts that create prompts through exports, because the restart clears them.

Installation#

Common Errors

Installation#

Prompts#