Integrando Scripts FiveM com ESX e QBCore: Guia Completo

Os scripts foram desenvolvidos para funcionar nativamente com os dois principais frameworks de roleplay — ESX e QBCore. Esta página explica como a integração funciona, o que é configurável e como resolver conflitos quando você usa múltiplos recursos.

Detecção Automática

Com Config.Framework = 'auto', o script identifica na inicialização qual framework está ativo e configura a integração adequada. Você pode verificar qual framework foi detectado ativando o modo debug:

config.lua

Config.Debug = true  -- Exibe no console: '[meu-script] Framework detectado: esx'

Integração com ESX

Confirme a versão do ESX

O script requer ESX 1.9.0 ou superior. Verifique a versão no fxmanifest.lua do es_extended:

-- fxmanifest.lua do es_extended
version '1.9.0'

Configure o framework

No config.lua do script:

Config.Framework = 'esx'  -- ou 'auto'

Configure a ordem no server.cfg

O script deve carregar após o ESX:

ensure es_extended
ensure oxmysql
ensure meu-script   # Sempre depois do framework

Integração com QBCore

Confirme que o qb-core está ativo

Verifique no server.cfg que o qb-core está sendo iniciado antes do script.

Configure o framework

config.lua

Config.Framework = 'qbcore'  -- ou 'auto'

Mapeie os jobs (se necessário)

Se os nomes dos jobs no seu servidor são diferentes dos padrões, mapeie-os:

config.lua

Config.JobMapping = {
    ['police'] = 'policia',     -- Nome no script = Nome no servidor
    ['ambulance'] = 'samu',
}

Integrações Opcionais

Alguns scripts oferecem suporte a recursos populares de terceiros:

Recurso	Configuração	Finalidade
ox_lib	`Config.UseOxLib = true`	Notificações e menus
ox_target	`Config.UseTarget = true`	Interação por target
ox_inventory	`Config.UseOxInventory = true`	Sistema de inventário
qb-target	`Config.UseQBTarget = true`	Target do QBCore

Ative apenas as integrações cujos recursos estão instalados e rodando no seu servidor. Ativar uma integração sem o recurso correspondente causará erros na inicialização.

Resolução de Conflitos

Dois scripts modificam o mesmo dado

Se dois scripts tentam modificar o mesmo dado do jogador (ex: dinheiro), configure um deles como “primário” e desative a função no outro via config.lua. Consulte a documentação de cada script para opções de desativação de módulos específicos.

Events sendo interceptados por outro script

Use nomes de eventos únicos configuráveis no config.lua:

Config.EventPrefix = 'meuscripts'  -- Padrão: nome do recurso

Introdução

Guias

Scripts

Referência

Suporte

Integrando Scripts FiveM com ESX e QBCore: Guia Completo

Detecção Automática

Integração com ESX

Integração com QBCore

Integrações Opcionais

Resolução de Conflitos

​Detecção Automática

​Integração com ESX

​Integração com QBCore

​Integrações Opcionais

​Resolução de Conflitos

Detecção Automática

Integração com ESX

Integração com QBCore

Integrações Opcionais

Resolução de Conflitos