Troubleshooting
Common problems, what causes them, and the fix.
Start with the server console and the in-game F8 console. Most problems print a line there that points at the cause.
The script won't start
What you see: an entitlement or escrow error for the resource in the server console.
Why: escrowed resources only run on servers whose license key belongs to the Cfx.re account that bought them.
Fix: check which account owns your license key at Keymaster, and make sure the purchase went to that same account. Download the resource again from Keymaster's granted assets after fixing it.
ox_lib's own UI still shows up
Why: universal_bridge isn't running, or it starts before ox_lib, so ox_lib's answer wins.
Fix: ensure universal_bridge after ox_lib and ox_target in server.cfg (see Load order). The console prints ox redirect active at boot when it works, and universal_bridge status shows each redirect.
One notification still looks like ox_lib
Why: a server script fires TriggerClientEvent('ox_lib:notify', ...) directly. That event goes straight to ox_lib and can't be redirected.
Fix: universal_bridge status names the script. Change the call to exports.universal_ui:notify(source, data), which takes the same payload. More on this.
Notifications appear twice on QBCore or ESX
Why: Universal UI couldn't take over the framework's notify function on your core version, so both draw. The console prints could not override when this happens.
Fix: turn off your framework's own notification UI, or add setr universal_ui:adapters 0 to keep the framework's style instead.
The theme editor command does nothing
Why: you don't have the universal_ui.theme ace.
Fix: add add_ace group.admin universal_ui.theme allow to server.cfg and make sure your identifier is in group.admin.
Demo or test commands do nothing
Why: they only run while the dev convar is on.
Fix: setr universal_ui:dev 1 for Universal UI and the bridge test, or setr universal_targeting:dev 1 for Universal Targeting. Turn them back off on a live server.
Low frame rates on weaker PCs
Fix: set performanceMode = true in Universal UI's Config.Theme, or switch it on in the theme editor. It freezes the animated borders and turns off background blur.
Nothing here matches
Ask on the Discord. See Getting support for what to include so we can answer on the first reply.