Troubleshooting - SMX Docs
SMX logo

SMX Documentation

Production-grade Script Knowledge Base

Build 2026.04 Live Docs


Global Troubleshooting

Recommended Diagnosis Flow

  1. Capture the issue exactly (what, where, when)
  2. Check first critical console/server error line
  3. Validate dependencies and start order
  4. Verify database access and table integrity
  5. Restart the script in isolation and compare behavior
  6. Reproduce with debug mode only if needed

Base Checks

  • ox_lib and oxmysql/mysql-async start without errors
  • Framework starts correctly (es_extended or qb-core)
  • Resource names match exactly in server.cfg
  • No duplicate script versions in multiple folders
# Quick checks
refresh
ensure ox_lib
ensure smx-ownedshops

Common Quick Fixes

  • Script won't start: verify dependency order and naming
  • UI does not open: check resource name and NUI errors
  • Data not saved: validate DB connection and table creation
  • Only some players affected: check permissions, roles and cached state