Troubleshooting
Share the exact server/F8 error and selected framework/target with support. Do not share server license keys, API tokens or database passwords.
Common issues
| Symptom | Check |
|---|---|
| Missing resource/fxmanifest | Match the selected integration to installed folder names. target=false skips targeting; auto detects supported installed targets. |
| Could not write/verify a file | Add selected filesystem permissions before ensures, fully restart, then retry fuiinstall in the server console. Check host access and supported file layout. |
| Old design remains | Confirm installer success and full restart; check selected target mode and duplicate UI resources. |
| Target provider rejected | Use matching releases/correct finals_UI name; complete target integration and reload it after first installation. |
| Missing chat addMessage export | Start Finals before callers and remove competing chat providers, then fully restart. |
| Stuck cursor | Check third-party NUI focus and duplicate providers/keybinds. The world interaction renderer never owns mouse focus. |
| Missing player/money/job info | Check Framework mode/resource names and loaded state. Standalone has no economy/job database. |
| Fuel/belt reading wrong | Match the actual export/event/statebag contract; distinguish state events from no-state toggles. |
| Frozen holographic speed | Check fuihologramdebug sent/browser speed and age, matching build/world files, duplicate old versions and vehicle repair/switch behavior. |
| Map border misaligned | Reset minimap layout, check resolution/safe zone and competing radar overrides; run fuimapdebug. |
| Dashboard unavailable | Check command, adminOnly, ACE and UI visibility masks. |
| Settings missing/reverting | Check playerPermissions, config-only rules and global admin profile. |
| Missing news image | Validate JSON/URL, use build/assets/news for local files and restart after adding a packaged image. |
| Blank UI | Check build/index.html, build/world/index.html, compiled assets and resource name/download completeness. |
| Escrow entitlement error | Use the purchasing account's processed download and entitled server; retain .fxap/protected files. Contact Cfx/Tebex for entitlement issues. |
Commands
| Command | Where | Purpose |
|---|---|---|
| fuiinstall | Server console | Retry selected integration after fixing failure |
| hudedit / configured aliases | In game | Open permitted dashboard |
| fuitargetsync | F8 | Resync/report ox world imports |
| fuihologramdebug | F8 | Native plane telemetry/browser status |
| fuimapdebug | F8 | Radar/NUI viewport bounds |
| fui / fuiinteract | In game, demos enabled | Demo hub / temporary point |
Preset recording and graphics/FPS-booster commands are not included. Default key changes may require resetting the player's saved FiveM binding.
Clean test procedure
Back up configuration/dependencies; keep one correctly named Finals copy; use current purchased files and required libraries; select config/permissions; complete installation and full restart; then test one real menu, world action, chat, pause, dashboard and vehicle. Re-enable other UI integrations one at a time to identify conflicts.
Do not rename resource authors or weaken the sandbox to bypass denied writes. If the host blocks installation, request the host-side/manual integration procedure from support. The compiled customer package does not require frontend build tools.