SMX logo

SMX Documentation

Production-grade Script Knowledge Base

Build 2026.04 Live Docs



License

Free Scripts · FiveM Ready

Overview Installation Configuration Exports & Events Usage / Examples Troubleshooting

Installation Blueprint

Step 1: Place Resource

Extract to resources/[smx]/smx-license. Keep the folder name exactly smx-license.

Step 2: Check Dependencies

Start your framework resource and mysql-async before this script.

Step 3: Configure Framework Mode

Set Config.Framework in config.lua to "esx" or "qb".

Step 4: First Boot

Start the server once so the script can auto-create its tables and default ID license data path.

Step 5: Validation

Test /docmenu, showing an ID, and one authority action from a configured management job.

Recommended server.cfg Order

Use this order to avoid callback/event failures during startup:

ensure mysql-async
ensure es_extended      # or ensure qb-core
ensure smx-license

The script explicitly loads @mysql-async/lib/MySQL.lua from fxmanifest.lua, so database startup order matters.

fxmanifest Snapshot

This is the runtime manifest footprint used by the resource:

fx_version 'cerulean'
game 'gta5'
lua54 'yes'

shared_script 'config.lua'
ui_page 'html/index.html'

client_scripts {
    'client/main.lua'
}

server_scripts {
    '@mysql-async/lib/MySQL.lua',
    'server/main.lua'
}

If one of these files is missing or renamed, the script will not initialize correctly.

Important: If document UI does not open, verify the resource name and NUI page path first.