Convierte un script de ESX a QBCore (y al revés)
La tabla de equivalencias completa. Con esto, casi cualquier script del otro framework se adapta en media hora.
12 min de lectura · 11 pasos
Antes de empezar
- El script que quieres adaptar, con acceso a su código (no ofuscado)
- Saber leer Lua a nivel básico: reconocer una función y una variable
- Un servidor de pruebas — esto no se hace sobre el servidor bueno
Primero comprueba que se pueda
Si el script viene ofuscado o cifrado con escrow de Cfx.re, no hay nada que hacer: pídele la versión del otro framework al creador, que casi siempre la tiene. Esta guía sirve para scripts con el código abierto, que son la mayoría de los gratuitos y buena parte de los de pago.
Entiende qué vas a cambiar de verdad
Un script típico toca el framework en cinco sitios y nada más: cómo pide el objeto del core, cómo obtiene al jugador, cómo mueve dinero, cómo da y quita objetos, y cómo notifica. Todo lo demás —los bucles, las coordenadas, los menús, la lógica— es FiveM puro y no se toca.
El objeto del core
Es la primera línea de casi todos los archivos. Cámbiala y ya llevas el 20% del trabajo.
ESX Legacy QBCore Obtener el core local ESX = exports["es_extended"]:getSharedObject() local QBCore = exports['qb-core']:GetCoreObject() Datos del jugador (cliente) ESX.GetPlayerData() QBCore.Functions.GetPlayerData() Jugador (servidor) local xPlayer = ESX.GetPlayerFromId(src) local Player = QBCore.Functions.GetPlayer(src) Identificador único xPlayer.identifier Player.PlayerData.citizenid Evento al cargar esx:playerLoaded QBCore:Client:OnPlayerLoaded Evento al descargar esx:onPlayerLogout QBCore:Client:OnPlayerUnload Dinero
ESX habla de «cuentas» y QBCore de «tipos de dinero», pero significan lo mismo. Ojo con el orden de los argumentos: están al revés.
Acción ESX Legacy QBCore Dar efectivo xPlayer.addMoney(500) Player.Functions.AddMoney('cash', 500) Quitar efectivo xPlayer.removeMoney(500) Player.Functions.RemoveMoney('cash', 500) Consultar efectivo xPlayer.getMoney() Player.PlayerData.money['cash'] Dar al banco xPlayer.addAccountMoney('bank', 500) Player.Functions.AddMoney('bank', 500) Quitar del banco xPlayer.removeAccountMoney('bank', 500) Player.Functions.RemoveMoney('bank', 500) Consultar banco xPlayer.getAccount('bank').money Player.PlayerData.money['bank'] En QBCore conviene pasar un tercer argumento con el motivo: AddMoney('bank', 500, 'venta-de-pescado'). Sale en los registros y te salva la vida cuando alguien duplica dinero.
Inventario
Aquí hay tres mundos: el de ESX, el de QBCore y el de ox_inventory, que funciona con los dos. Si tu servidor usa ox_inventory, adaptar es más fácil todavía porque las llamadas son idénticas vengas de donde vengas.
Acción ESX Legacy QBCore ox_inventory (ambos) Dar objeto xPlayer.addInventoryItem('pan', 1) Player.Functions.AddItem('pan', 1) exports.ox_inventory:AddItem(src, 'pan', 1) Quitar objeto xPlayer.removeInventoryItem('pan', 1) Player.Functions.RemoveItem('pan', 1) exports.ox_inventory:RemoveItem(src, 'pan', 1) Cuántos tiene xPlayer.getInventoryItem('pan').count Player.Functions.GetItemByName('pan') exports.ox_inventory:GetItemCount(src, 'pan') Objeto usable ESX.RegisterUsableItem('pan', fn) QBCore.Functions.CreateUseableItem('pan', fn) Se declara en el propio ox_inventory Declarar el objeto Fila en la tabla items de MySQL shared/items.lua data/items.lua Trabajos
Es la fuente número uno de errores silenciosos al convertir: en ESX el grado es un número directo, en QBCore está anidado.
Acción ESX Legacy QBCore Nombre del trabajo xPlayer.job.name Player.PlayerData.job.name Grado xPlayer.job.grade Player.PlayerData.job.grade.level Etiqueta del grado xPlayer.job.grade_label Player.PlayerData.job.grade.name ¿Es jefe? xPlayer.job.grade_name == 'boss' Player.PlayerData.job.isboss ¿De servicio? No existe de fábrica Player.PlayerData.job.onduty Cambiar de trabajo xPlayer.setJob('policia', 2) Player.Functions.SetJob('policia', 2) Si conviertes xPlayer.job.grade a Player.PlayerData.job.grade sin el .level, obtienes una tabla en vez de un número. La comparación no falla, simplemente nunca es verdadera — y el script «no hace nada» sin dar error.
Callbacks y notificaciones
Los callbacks son la comunicación cliente-servidor con respuesta. Cambian de nombre pero no de idea.
Acción ESX Legacy QBCore Registrar (servidor) ESX.RegisterServerCallback('nombre', fn) QBCore.Functions.CreateCallback('nombre', fn) Llamar (cliente) ESX.TriggerServerCallback('nombre', cb) QBCore.Functions.TriggerCallback('nombre', cb) Notificación (cliente) ESX.ShowNotification('texto') QBCore.Functions.Notify('texto', 'success') Aviso de ayuda ESX.ShowHelpNotification('texto') exports['qb-core']:DrawText('texto') Menú ESX.UI.Menu.Open(…) exports['qb-menu']:openMenu(…) Barra de progreso Depende del recurso exports['progressbar']:Progress(…) Método de conversión, paso a paso
Con la tabla delante, el procedimiento que funciona es mecánico:
- Copia el script a un servidor de pruebas y ábrelo en un editor decente
- Busca en todos los archivos «ESX» o «QBCore» y anota cada aparición
- Cambia primero la línea del core, en cada archivo
- Sustituye una categoría entera de golpe: primero todo el dinero, luego todos los objetos, luego los trabajos
- Ajusta el fxmanifest: cambia la dependencia de es_extended a qb-core o al revés
- Arranca, entra y prueba la función principal del script
- Repite con lo que salga en la consola: los errores van saliendo de uno en uno
Cambia también el fxmanifest
Se olvida siempre y provoca que el script arranque antes que su framework:
fxmanifest.lua
-- Antes (ESX) dependencies { 'es_extended' } -- Después (QBCore) dependencies { 'qb-core' }El atajo: usar puentes
Antes de convertir a mano, mira si existe un puente. Son recursos que traducen las llamadas de un framework al otro en tiempo real, y para scripts sencillos ahorran la tarde entera. Los hay para ESX sobre QBCore y viceversa, y ox_inventory trae los suyos de fábrica.
Un puente añade una capa más que puede fallar y ralentiza un poco. Para dos o tres scripts va perfecto; para veinte, conviene convertir de verdad.
Escribe para los dos desde el principio
Si el script es tuyo, aíslas el framework en un solo archivo y el resto del código no se entera. Cuando cambies de framework, cambias ese archivo y ya:
bridge.lua
local Framework = {} if GetResourceState('qb-core') == 'started' then local QB = exports['qb-core']:GetCoreObject() function Framework.AddMoney(src, cantidad) QB.Functions.GetPlayer(src).Functions.AddMoney('cash', cantidad) end elseif GetResourceState('es_extended') == 'started' then local ESX = exports['es_extended']:getSharedObject() function Framework.AddMoney(src, cantidad) ESX.GetPlayerFromId(src).addMoney(cantidad) end end return Framework
Lo que nos preguntan después
¿Y si el script es de vRP?
Ahí la conversión es mucho más profunda: vRP tiene su propia estructura de base de datos y su propio sistema de identidades. Suele salir más a cuenta buscar un equivalente que convertirlo.
¿Puedo revender el script convertido?
No. Adaptar un script comprado para tu propio servidor es normal; redistribuirlo es una infracción de licencia, y en Cfx.re es motivo de cierre.
¿Se te atoró algo?
Escríbenos y lo vemos contigo. Si la duda se repite, la agregamos a esta guía.
Pedir ayudaGuías relacionadas
BásicoFiveMESX, QBCore, Qbox o vRP: cuál elegir y en qué se diferencian
La decisión que condiciona todos los scripts que vas a comprar los próximos dos años.
8 min9 pasos
IntermedioFiveMox_lib, ox_inventory y oxmysql: la base moderna de FiveM
Las tres piezas que hoy usan casi todos los scripts nuevos, funcionen sobre ESX o sobre QBCore.
9 min10 pasos
BásicoFiveMInstala cualquier recurso en FiveM sin romper el arranque
resources, fxmanifest, orden de carga en server.cfg y cómo leer los errores de la consola.
9 min9 pasos

