Skip to main content
For questions about purchases, refunds and licensing, see General FAQs.

Setup

Either the resource didn’t start or another resource is grabbing T first. Check txAdmin console for [fxChat] lines on startup.
Don’t ensure 'chat' in server.cfg — fxChat declares provide 'chat'. Order matters: ox_lib first, then fxChat.
See Escrow & Cfx.re Portal. TL;DR: add your sv_licenseKey at portal.cfx.re → Granted assets.
Start ox_lib before fxChat in server.cfg.
Make sure your framework starts before fxChat. For non-standard forks see Integrations.

Commands

ox_lib must start before fxChat. Then restart fxChat.
Use the server ID (the number in /scoreboard), not the character ID.
enabled = false in configs/commands.lua, then restart fxChat.
Yes — drop it under src/handlers/custom/commands.lua using lib.addCommand. See Commands.

Themes

Likely a JSON parse error — run the file through a JSON validator. Common issues: trailing commas, unquoted keys.
Use full hex (#RRGGBB) or rgba(). CSS color names aren’t parsed.
Run /reloadthemes and reselect the theme in chat settings.
Edits made via /chatadmin are session-only. Hit Export JSON and save the output to themes/<your-name>.json to persist.

Webhooks

Test the URL with curl:
curl -X POST "$WEBHOOK_URL" \
  -H "Content-Type: application/json" \
  -d '{"content":"test"}'
If curl works and fxChat doesn’t, check server.cfg for set_var sv_disableHTTP true — that disables outbound HTTP entirely.
Not natively. Listen on fxChat:messageReceived server-side and call PerformHttpRequest to your second URL.

UI quirks

Drag it to a different position and back — re-anchors the saved position.
The picker uses the system emoji font. On bare Linux servers without one installed, players see boxes. Known limitation.

Build

No — the compiled bundle ships with the resource. Only rebuild if you customize src/ui/nui/.
cd src/ui/nui
bun install
bun run build
Restart the resource.

Still stuck?

Discord. Bring fxChat version, framework, console output, and a short repro.