License

Free Scripts · FiveM Ready

Overview Installation Configuration Exports & Events Usage / Examples Troubleshooting

Common Problems and Fixes

Menu does not open

Check Config.EnableMenu and confirm NUI files exist under html/.

SQL errors at startup

mysql-async is missing or started after this script. Fix ensure order in server.cfg.

Authority actions blocked

Verify job is in Config.ManagementJobs and action is enabled in Config.JobActionPermissions.

Issue/confiscate wrong document list

Check Config.JobDocumentPermissions and whether wildcard/list/map syntax is valid.

Mugshot not saving

Invalid data URL or payload too large. The server rejects malformed or oversized mugshot strings.

Document says missing

License may not exist in user_licenses or document is currently marked confiscated.

Quick Verification Checklist

Run through this list before deep debugging:

# 1) Resource order
ensure mysql-async
ensure es_extended   # or qb-core
ensure smx-license

# 2) Commands in-game
/docmenu
/docmugshot
/addlicense 1 id

# 3) Data tables exist
smx_license_business_cards
smx_license_confiscations
smx_license_mugshots

If issues continue, capture server logs around the exact event name and timestamp for faster root-cause analysis.

Tip: Most runtime issues are configuration mismatches (framework mode, permission config, or startup order) and can be fixed without code changes.