Skip to content

Troubleshooting

Symptom-first fixes for tRadar: No such export, /tradar doing nothing, a blank HUD, an empty layout picker, a missing plate reader or remote, and blank windows.

Most of these are load order, an access setting, or a feature that ships off. tRadar has no database, so a database error belongs to another resource.

No such export, or tRadar fails to start

No such export naming a tLib function, or SCRIPT ERROR @tRadar/... at startup: tLib started after tRadar, or is older than v1.0.

  1. Put tLib first.

    cfg
    ensure tLib
    ensure tRadar
  2. Check the version — tRadar declares tlib_min_version '1.0'.

  3. Restart the server, not refresh + restart tRadar — the load order is what changed.

F5 does nothing

Run /tradar_deploy in chat; it is the command the key is bound to.

  • The command works, the key does not. Something else has claimed F5. Settings → Key Bindings → FiveM → tRadar: Radar: deploy, then remote, and rebind.
  • Neither works. It is a refusal — see the next section.

F5 never stows: a third press closes the remote and leaves the radar up. Stowing is the remote's STOW key, or Stow Radar in /tradar. With Config.remoteEnabled = false the second press stows.

/tradar does nothing

One of three access checks, answered by the server.

Chat messageSetting
"You don't have permission to use this."Config.access
"The unit is dash-mounted — get in a vehicle first."Config.requireVehicle
"This vehicle is not fitted with a radar unit."Config.vehicleClasses

No message at all means mode = "job" on a framework outside the six resolved, or "item" on an inventory outside the nine. tradar_diag prints what was detected.

Access is re-checked on every /tradar, so a grant needs no reconnect.

Other things that are missing

SymptomCauseFix
HUD blank, nothing drawnYou installed the source zip, which has no built filesInstall the release zip
Layout picker empty, or a skin missingThe skin's device class, not its folder namedata-radar-device-class on the root element must be radar, plate or remote
No plate readerIt ships offConfig.plateReaderEnabled = true, restart, then place the window with the HUD editor
No remoteIt is drawn only in keypad modeF5 with the radar already up. Place it with Reposition Remote in /tradar
A key on a custom skin is deaddata-hud-btn names an action the engine does not answerCheck the action list. Exact strings: lock:front:fast, not lockFrontFast

Plates read but never show a flag

Nothing is answering the read. Any or all of:

  • CAD bridge: Config.integrations.cad.enabled = true. No API key to set, see CAD and ALPR.
  • The BOLO tab of /tradar, which needs Config.plateReaderEnabled.
  • Your own handler on tradar:plateRead, answering with setPlateFlag.

No flag means nothing answered, which is not the same as clean. tRadar never prints CLEAR.

The bridge is on and still nothing? Run tradar_diag; the CAD page maps each line of its integration section to what to change. Commonly provider names a CAD that is not running, which turns the bridge off rather than falling through, or the NPC filter is doing its job. Fixed when asked climbs.

Every plate reads NO ANSWER? The CAD is being asked and is not answering. A few are normal — SonoranCAD allows 30 requests a minute for a whole community. If it is every read, check timed out: a slow CAD wants a higher timeoutMs, a throttled one wants the NPC filter left on.

Every window is blank but the unit is powered

What the glass showsCauseFix
HOLD where XMIT should beStationary mode above Config.stationaryMaxSpeedStop, or press MODE
TEST lit redA latched self-test failure, only possible where Config.selfTestFailChance was raisedPress TEST. A faulted unit stays off the air until a check passes
RFI lit amber, patrol speed still shownInterference inhibiting the target windowsMove, or wait Config.rfiHoldMs after the source stops

RFI ships on; its default source is another tRadar on the same band within Config.rfiRange. The patrol window keeps running under it and a locked window survives, so a glass blank apart from patrol speed is almost always this. The CHX-800 carries no RFI legend, so there that pattern is the only tell.

Targets read but the numbers look wrong

Usually tRadar working as designed.

Still stuck

Get in touch with the exact console error as text, your tLib and tRadar versions, the relevant lines of config.lua, and what you did.

Still stuck? Support can answer it directly.

Was this page helpful?