Skip to main content

Documentation Index

Fetch the complete documentation index at: https://fxscripts.dev/docs/llms.txt

Use this file to discover all available pages before exploring further.

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.