RexHost — Hosting y VPS
Todas las guías
FiveMAvanzado

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
  1. 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.

  2. 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.

  3. El objeto del core

    Es la primera línea de casi todos los archivos. Cámbiala y ya llevas el 20% del trabajo.

    ESX LegacyQBCore
    Obtener el corelocal 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 únicoxPlayer.identifierPlayer.PlayerData.citizenid
    Evento al cargaresx:playerLoadedQBCore:Client:OnPlayerLoaded
    Evento al descargaresx:onPlayerLogoutQBCore:Client:OnPlayerUnload
  4. 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ónESX LegacyQBCore
    Dar efectivoxPlayer.addMoney(500)Player.Functions.AddMoney('cash', 500)
    Quitar efectivoxPlayer.removeMoney(500)Player.Functions.RemoveMoney('cash', 500)
    Consultar efectivoxPlayer.getMoney()Player.PlayerData.money['cash']
    Dar al bancoxPlayer.addAccountMoney('bank', 500)Player.Functions.AddMoney('bank', 500)
    Quitar del bancoxPlayer.removeAccountMoney('bank', 500)Player.Functions.RemoveMoney('bank', 500)
    Consultar bancoxPlayer.getAccount('bank').moneyPlayer.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.

  5. 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ónESX LegacyQBCoreox_inventory (ambos)
    Dar objetoxPlayer.addInventoryItem('pan', 1)Player.Functions.AddItem('pan', 1)exports.ox_inventory:AddItem(src, 'pan', 1)
    Quitar objetoxPlayer.removeInventoryItem('pan', 1)Player.Functions.RemoveItem('pan', 1)exports.ox_inventory:RemoveItem(src, 'pan', 1)
    Cuántos tienexPlayer.getInventoryItem('pan').countPlayer.Functions.GetItemByName('pan')exports.ox_inventory:GetItemCount(src, 'pan')
    Objeto usableESX.RegisterUsableItem('pan', fn)QBCore.Functions.CreateUseableItem('pan', fn)Se declara en el propio ox_inventory
    Declarar el objetoFila en la tabla items de MySQLshared/items.luadata/items.lua
  6. 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ónESX LegacyQBCore
    Nombre del trabajoxPlayer.job.namePlayer.PlayerData.job.name
    GradoxPlayer.job.gradePlayer.PlayerData.job.grade.level
    Etiqueta del gradoxPlayer.job.grade_labelPlayer.PlayerData.job.grade.name
    ¿Es jefe?xPlayer.job.grade_name == 'boss'Player.PlayerData.job.isboss
    ¿De servicio?No existe de fábricaPlayer.PlayerData.job.onduty
    Cambiar de trabajoxPlayer.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.

  7. Callbacks y notificaciones

    Los callbacks son la comunicación cliente-servidor con respuesta. Cambian de nombre pero no de idea.

    AcciónESX LegacyQBCore
    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 ayudaESX.ShowHelpNotification('texto')exports['qb-core']:DrawText('texto')
    MenúESX.UI.Menu.Open(…)exports['qb-menu']:openMenu(…)
    Barra de progresoDepende del recursoexports['progressbar']:Progress(…)
  8. 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
  9. 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' }
  10. 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.

  11. 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 ayuda

¿Todavía no tienes servidor?

QBCore · ESX · vRP · qbox, desde $547 al mes.

Ver planes de FiveM