ESX, QBCore e Qbox: Configure seu Framework e Crie Empregos

Um framework funcional é a base do seu servidor FiveM. Antes de adicionar garagens, tablets ou empresas, faça a criação de personagem, o banco de dados e a atribuição de empregos funcionarem. Este guia cobre uma instalação limpa e um pequeno exemplo de emprego em ESX Legacy, QBCore ou Qbox. Siga a seção para o seu framework; instalar os três juntos não faz parte da configuração.

Comece com uma instalação limpa

Prepare uma conta Cfx.re, uma chave de registro do servidor, um artefato FXServer adequado e um serviço MariaDB em execução. Use a versão do banco de dados suportada pelo framework escolhido; o Qbox exige explicitamente o MariaDB e não suporta MySQL ou XAMPP. Em hospedagem gerenciada, use os controles do servidor e txAdmin do provedor. Consulte o guia oficial de configuração de servidor FiveM e os requisitos do Qbox.

1. Abra o txAdmin e escolha uma implantação de receita nova em um novo diretório de dados do servidor.
2. Selecione a receita oficial do seu framework: ESX Legacy, QBCore ou Qbox.
3. Insira a chave do servidor e os detalhes de conexão corretos do MariaDB. Use uma conta de banco de dados dedicada com acesso ao banco de dados deste servidor.
4. Execute a receita, revise a configuração gerada e inicie o servidor. Mantenha as dependências e a ordem de recursos da receita.
5. Entre, crie um personagem, reconecte e confirme se o personagem ainda carrega antes de adicionar outros recursos.

As Receitas baixam os recursos e executam sua instalação SQL. Não importe um segundo esquema de framework completo depois ou implante uma receita nova sobre um servidor existente. Faça backup tanto dos arquivos quanto do banco de dados antes de alterações posteriores. Para etapas de instalação específicas de framework, siga o guia de instalação do ESX, o guia de Windows do QBCore ou o guia de instalação do Qbox.

Entenda o que um emprego realmente contém

Cada emprego possui uma chave interna, um rótulo de exibição e níveis numerados. Usamos sky_example, com níveis 0 e 1, em todo o processo. Mantenha essa chave idêntica no framework, no script do emprego e em quaisquer integrações. Um rótulo como “Empresa Exemplo” é apenas o nome que os jogadores veem.

Registrar um emprego cria sua identidade no framework. Gameplay, garagens, armazenamento, menus de chefes e contas comerciais precisam de seus próprios recursos e configurações compatíveis. Um emprego de framework não é um negócio finalizado. Os locais acima seguem o esquema ESX, o arquivo de empregos QBCore e o arquivo de empregos Qbox.

ESX Legacy: crie o emprego no MariaDB

Abra o banco de dados configurado para este servidor, não o banco de dados de outro servidor. Primeiro, verifique se a chave de exemplo já existe:

SELECT name FROM jobs WHERE name = 'sky_example';
SELECT grade FROM job_grades WHERE job_name = 'sky_example';

Execute os seguintes inserts apenas quando ambas as verificações não retornarem nenhuma linha. Se o emprego existir, inspecione e edite seus registros existentes em vez de inserir duplicatas.

INSERT INTO jobs (name, label)
VALUES ('sky_example', 'Example Company');

INSERT INTO job_grades
    (job_name, grade, name, label, salary, skin_male, skin_female)
VALUES
    ('sky_example', 0, 'employee', 'Employee', 100, '{}', '{}'),
    ('sky_example', 1, 'boss', 'Manager', 200, '{}', '{}');

job_name vincula cada cargo ao emprego. A coluna grade é o nível usado para atribuição; o id automático da linha não é o nível. Um emprego sem cargos é ignorado. Recarregue o catálogo de empregos através do console do servidor:

refreshjobs

O ESX Legacy atual começa com oxmysql, depois esx_lib, depois es_extended; tutoriais antigos podem omitir esx_lib. Mantenha as dependências fornecidas pela sua receita. Consulte a configuração de receita atual e a implementação de carregamento de emprego.

Para uma integração esx_society, o nome interno do cargo boss é reconhecido por sua configuração de chefe padrão. O rótulo visível “Manager” sozinho não concede nada. Registro de sociedade, contas e ordem de dependência permanecem como etapas de configuração separadas. Siga a documentação de sociedade se o seu recurso de emprego a utilizar.

QBCore: adicione uma entrada na tabela de empregos

Abra o qb-core/shared/jobs.lua. Insira este dentro da tabela de empregos existente, junto com as outras entradas de emprego e antes de sua chave de fechamento. Mantenha a declaração de tabela existente e todos os empregos existentes; esta é uma entrada, não um arquivo de substituição.

['sky_example'] = {
    label = 'Example Company',
    defaultDuty = false,
    offDutyPay = false,
    grades = {
        ['0'] = { name = 'Employee', payment = 100 },
        ['1'] = { name = 'Manager', payment = 200, isboss = true },
    },
},

Mantenha as chaves de cargo como strings, incluindo o cargo zero. Verifique vírgulas e chaves ao redor das entradas vizinhas, salve e, em seguida, realize uma reinicialização completa planejada do servidor para que os recursos dependentes carreguem as mesmas definições. O comando refresh de FiveM reanalisa recursos e manifestos; ele não recarrega uma tabela de empregos Lua em execução. Não crie linhas SQL jobs no estilo ESX para QBCore. Suas definições de emprego residem em Lua, enquanto os dados de personagens ainda utilizam o banco de dados.

isboss marca o nível de gerente; não concede permissões de comando de admin do framework. Um recurso de gerenciamento compatível ainda deve fornecer e configurar o menu real e sua localização.

Qbox: use seu próprio arquivo de empregos e níveis numéricos

Abra qbx_core/shared/jobs.lua e insira este dentro da tabela retornada por return { ... }, antes da chave de fechamento final. Preserve suas outras entradas. Qbox usa chaves de nível numérico aqui; não cole as chaves de string do QBCore sem alterações.

['sky_example'] = {
    label = 'Example Company',
    defaultDuty = false,
    offDutyPay = false,
    grades = {
        [0] = { name = 'Employee', payment = 100 },
        [1] = { name = 'Manager', payment = 200, isboss = true, bankAuth = true },
    },
},

Salve e realize uma reinicialização completa planejada do servidor. bankAuth é separado do isboss e é usado por integrações bancárias compatíveis; nenhuma das flags cria uma conta ou menu. Ajuste sua configuração às definições de emprego oficiais do Qbox.

Qbox inclui suporte a multijob. Seu limite de empregos e se o /setjob substitui ou adiciona a filiação são configuráveis. Use os comandos de filiação suportados ao gerenciar vários empregos; não assuma que um recurso de multijob externo QBCore seja compatível. Veja os comandos e a configuração de multijob.

Atribuir, testar e reconectar

Entre com um personagem de teste e use uma conta com as permissões de comando de framework/ACE necessárias. Apenas um login no txAdmin não estabelece essas permissões. Se o Qbox tiver o requireOptIn ativado, use /optin antes dos comandos de admin. Substitua 1 abaixo pelo ID atual do seu personagem de teste conectado no servidor; /job informa o emprego do jogador ao inseri-lo:

/setjob 1 sky_example 0
/job
/setjob 1 sky_example 1
/job

Verifique se ambos os níveis mostram o emprego e o cargo esperados. A sintaxe de atribuição está documentada para ESX, QBCore e Qbox; a verificação condicional de adesão do Qbox está na implementação de seu comando.

Para QBCore e Qbox, este exemplo começa fora de serviço e desativa o pagamento fora de serviço. Use a ação de serviço do seu recurso de emprego instalado; não presuma que exista um comando /duty universal. As configurações de login também afetam se o status de serviço salvo ou defaultDuty prevalece. Em seguida, reconecte e verifique o emprego salvo, o cargo e o comportamento de serviço pretendido.

Antes de abrir o emprego para os jogadores, teste suas permissões com ambos os cargos. Um funcionário não deve acessar recursos reservados para a gerência. Aguarde o seu intervalo de pagamento configurado em vez de esperar o pagamento imediatamente após a atribuição; os valores de exemplo são espaços reservados para sua economia. Se uma verificação falhar, leia o primeiro erro de console relevante e resolva-o antes de adicionar outro recurso.

Conecte seu emprego Sky depois

Assim que a atribuição do framework funcionar, siga o guia de instalação Sky e configure seu recurso de emprego instalado com a mesma chave de framework e cargos. Use os recursos compartilhados da Base de Empregos para as configurações compartilhadas relevantes. Configure um par de empregos fora de serviço apenas quando sua configuração Sky escolhida utilizar um, e crie ambos os empregos com todos os cargos necessários.

Última verificação: 25 de outubro de 2026. As fontes acima são a documentação oficial do framework, receitas mantidas e implementações do GitHub. Verifique a versão instalada antes de aplicar exemplos de uma versão mais recente.