{"id":192928,"date":"2025-08-15T16:20:47","date_gmt":"2025-08-15T14:20:47","guid":{"rendered":"https:\/\/fivemx.com\/?p=192928"},"modified":"2026-06-22T20:39:15","modified_gmt":"2026-06-22T18:39:15","slug":"convertendo-scripts-fivem","status":"publish","type":"post","link":"https:\/\/fivemx.com\/pt\/converting-fivem-scripts\/","title":{"rendered":"Convertendo scripts FiveM \u2013 ESX, QBCore, QBOX (Frame\u2026"},"content":{"rendered":"\n

This is a code\u2011first, no\u2011fluff easy converting FiveM scripts guide that shows you exactly how to Convert FiveM Scripts<\/strong> between ESX, QBCore, QBOX (qbx_core), and framework\u2011agnostic (standalone) setups. You\u2019ll get tri\u2011way API mappings, adapter code, SQL migration steps (mysql\u2011async \u2192 oxmysql), QBOX specifics, testing checklists, and production hardening tips.<\/p>\n\n\n\n

\n\n\n\n

TL;DR \u2014 Migration in 10 Steps<\/h2>\n\n\n\n
    \n
  1. Snapshot & staging:<\/strong> Back up DB\/files<\/a>. Spin up a local test server with the target framework.<\/li>\n\n\n\n
  2. Identify dependencies:<\/strong> inventory, target, menu\/UI, callbacks, DB layer, core<\/a> access.<\/li>\n\n\n\n
  3. Pin versions & order:<\/strong> oxmysql \u2192 ox_lib \u2192 framework (es_extended \/ qb-core \/ qbx_core) \u2192 your resources.<\/li>\n\n\n\n
  4. Read the code path:<\/strong> Find all player, money, job\/duty, inventory, callback\/event, and DB calls.<\/li>\n\n\n\n
  5. Map APIs:<\/strong> Use the Rosetta tables below to map ESX \u2194 QBCore \u2194 QBOX.<\/li>\n\n\n\n
  6. Bridge it:<\/strong> Add a bridge.lua<\/strong> adapter that auto\u2011detects the framework and normalizes calls.<\/li>\n\n\n\n
  7. Convert callbacks:<\/strong> ESX\/QB callbacks \u2192 QBOX\/ox_lib lib.callback.*<\/code> when needed.<\/li>\n\n\n\n
  8. Migrate DB:<\/strong> Move identifiers, accounts, items, vehicles; switch to oxmysql<\/strong> *.await<\/code> style.<\/li>\n\n\n\n
  9. Harden events:<\/strong> Validate source<\/code>, bounds, groups\/jobs, ownership; never trust client.<\/li>\n\n\n\n
  10. QA & release:<\/strong> Run the checklists; tag, changelog, and rollback plan.<\/li>\n<\/ol>\n\n\n\n

    Are you a developer that is looking for an Adapter solution?<\/strong> Check out our free adapter script here<\/a><\/p>\n\n\n\n

    \n\n\n\n

    1) Frameworks 101: ESX vs QBCore vs QBOX vs Standalone<\/h2>\n\n\n\n

    Architectural overview<\/h3>\n\n\n\n
    Category<\/strong><\/th>ESX<\/strong><\/th>QBCore<\/strong><\/th>QBOX<\/strong><\/th><\/tr><\/thead>
    Architecture \/ Core Access<\/strong><\/td>exports['es_extended']:getSharedObject()<\/code> \u2192 ESX<\/code><\/td>exports['qb-core']:GetCoreObject()<\/code> \u2192 QBCore<\/code><\/td>No global core object; use exports.qbx_core:*<\/code> for player, groups, and notifications<\/td><\/tr>
    Player Object<\/strong><\/td>ESX.GetPlayerFromId(src)<\/code> \u2192 xPlayer<\/code><\/td>QBCore.Functions.GetPlayer(src)<\/code> \u2192 Player<\/code><\/td>exports.qbx_core:GetPlayer(src)<\/code> \u2192 Player<\/code> with PlayerData<\/code><\/td><\/tr>
    Identifiers<\/strong><\/td>Historically identifier<\/code> (license\/steam)<\/td>citizenid<\/code> as primary key<\/td>citizenid<\/code> as primary key<\/td><\/tr>
    Money Handling<\/a><\/strong><\/td>xPlayer.addMoney()<\/code> \/ `addAccountMoney(‘bank’<\/td>‘black_money’)`<\/td>`Player.Functions.AddMoney(‘cash’<\/td><\/tr>
    Jobs & Duty<\/strong><\/td>xPlayer.job.name<\/code>, .job.grade<\/code><\/td>Player.PlayerData.job.name<\/code>, .grade.level<\/code>, OnDuty<\/code><\/td>Job\/group helpers via exports.qbx_core:*<\/code> (group checks, duty setters)<\/td><\/tr>
    Inventory<\/strong><\/td>ESX default \/ ox_inventory<\/code> \/ qb-inventory<\/code> (recommended: ox_inventory<\/code>)<\/td>qb-inventory<\/code> \/ ox_inventory<\/code><\/td>ox_inventory<\/code> recommended<\/td><\/tr>
    Callbacks<\/strong><\/td>ESX.RegisterServerCallback<\/code> \/ ESX.TriggerServerCallback<\/code><\/td>QBCore.Functions.CreateCallback<\/code> \/ TriggerCallback<\/code><\/td>Prefer ox_lib<\/code> callbacks (lib.callback.register\/await<\/code>) or QBOX exports<\/td><\/tr>
    Database Layer<\/strong><\/td>Old: mysql-async<\/code> \u2192 Now: oxmysql<\/code> (MySQL.query.await<\/code>, MySQL.update.await<\/code>)<\/td>oxmysql<\/code><\/td>oxmysql<\/code><\/td><\/tr>
    UI \u2013 Notifications<\/strong><\/td>ESX Notify<\/td>QB Notify<\/td>QBOX notify helpers or lib.notify<\/code><\/td><\/tr>
    UI \u2013 Menus<\/strong><\/td>esx_menu_default<\/code> \/ ox_lib:registerContext<\/code><\/td>qb-menu<\/code> \/ ox_lib:registerContext<\/code><\/td>ox_lib:registerContext<\/code> \/ lib.inputDialog<\/code><\/td><\/tr>
    UI \u2013 Target System<\/strong><\/td>esx_target<\/code> \/ ox_target<\/code><\/td>qb-target<\/code> \/ ox_target<\/code><\/td>ox_target<\/code> recommended<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

    Where QBOX differs<\/h3>\n\n\n\n