> ## 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.

# FAQs

> Common questions and fixes for fxChat.

For questions about purchases, refunds and licensing, see
[General FAQs](/docs/general-faqs).

## Setup

<AccordionGroup>
  <Accordion title="Press T does nothing">
    Either the resource didn't start or another resource is grabbing `T`
    first. Check `txAdmin` console for `[fxChat]` lines on startup.
  </Accordion>

  <Accordion title="Native chat shows instead of fxChat">
    Don't `ensure 'chat'` in `server.cfg` — fxChat declares
    `provide 'chat'`. Order matters: `ox_lib` first, then `fxChat`.
  </Accordion>

  <Accordion title="Resource won't start — escrow error">
    See [Escrow & Cfx.re Portal](/docs/escrow-errors). TL;DR: add your
    `sv_licenseKey` at portal.cfx.re → Granted assets.
  </Accordion>

  <Accordion title="ox_lib not found">
    Start `ox_lib` before `fxChat` in `server.cfg`.
  </Accordion>

  <Accordion title="Framework not detected">
    Make sure your framework starts before fxChat. For non-standard forks
    see [Integrations](/docs/fxchat/integrations#frameworks).
  </Accordion>
</AccordionGroup>

## Commands

<AccordionGroup>
  <Accordion title="Commands don't autocomplete">
    `ox_lib` must start before `fxChat`. Then `restart fxChat`.
  </Accordion>

  <Accordion title="`/pm` says player not found">
    Use the **server ID** (the number in `/scoreboard`), not the
    character ID.
  </Accordion>

  <Accordion title="How do I disable a command?">
    `enabled = false` in `configs/commands.lua`, then `restart fxChat`.
  </Accordion>

  <Accordion title="Can I add my own command?">
    Yes — drop it under `src/handlers/custom/commands.lua` using
    `lib.addCommand`. See [Commands](/docs/fxchat/commands#adding-your-own-command).
  </Accordion>
</AccordionGroup>

## Themes

<AccordionGroup>
  <Accordion title="A theme looks broken / blank">
    Likely a JSON parse error — run the file through a JSON validator.
    Common issues: trailing commas, unquoted keys.
  </Accordion>

  <Accordion title="Colors render gray / wrong">
    Use full hex (`#RRGGBB`) or `rgba()`. CSS color names aren't parsed.
  </Accordion>

  <Accordion title="Hot-reload didn't apply">
    Run `/reloadthemes` and reselect the theme in chat settings.
  </Accordion>

  <Accordion title="Where do I save admin-panel changes?">
    Edits made via `/chatadmin` are session-only. Hit **Export JSON** and
    save the output to `themes/<your-name>.json` to persist.
  </Accordion>
</AccordionGroup>

## Webhooks

<AccordionGroup>
  <Accordion title="Webhook isn't sending" id="webhook-isnt-sending">
    Test the URL with `curl`:

    ```bash theme={null}
    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.
  </Accordion>

  <Accordion title="Can I send to multiple webhooks?">
    Not natively. Listen on `fxChat:messageReceived` server-side and call
    `PerformHttpRequest` to your second URL.
  </Accordion>
</AccordionGroup>

## UI quirks

<AccordionGroup>
  <Accordion title="Chat is hidden after switching theme">
    Drag it to a different position and back — re-anchors the saved
    position.
  </Accordion>

  <Accordion title="Emoji picker shows boxes">
    The picker uses the system emoji font. On bare Linux servers without
    one installed, players see boxes. Known limitation.
  </Accordion>
</AccordionGroup>

## Build

<AccordionGroup>
  <Accordion title="Do I need to build the NUI?">
    No — the compiled bundle ships with the resource. Only rebuild if you
    customize `src/ui/nui/`.
  </Accordion>

  <Accordion title="How do I rebuild?">
    ```bash theme={null}
    cd src/ui/nui
    bun install
    bun run build
    ```

    Restart the resource.
  </Accordion>
</AccordionGroup>

## Still stuck?

[Discord](https://discord.gg/HCcpPmNrHH). Bring fxChat version, framework,
console output, and a short repro.