Como instalar um servidor QBCore: receita txAdmin e passos manuais

Você quer um servidor QBCore e está escolhendo entre a receita e uma instalação manual. Este guia cobre ambas, o server.cfg que você precisa, o que verificar em seu primeiro início, e os erros que aparecem em quase todos os primeiros servidores QBCore.

#Opção 1: a receita txAdmin

A receita é a forma recomendada. Na configuração do txAdmin, escolha o template QBCore das receitas populares, conforme descrito em configuração txAdmin e receitas. Você insere sua chave de licença e detalhes de banco de dados, txAdmin faz download de tudo, cria o banco de dados e escreve server.cfg. Revise esse arquivo, inicie o servidor e passe para as verificações de primeira abaixo.

#Opção 2: instalação manual

Use isso se você já tem um servidor e quer adicionar QBCore. Você precisa de FXServer, um banco de dados MySQL ou MariaDB e uma chave de licença.

#1. Obtenha os recursos

QBCore não é um recurso único. Você precisa de:

• qb-core, o framework em si.
• Os recursos qb ao redor: inventário, multitamanho, seletor de desova, trabalhos, telefone e assim por diante. Eles são normalmente agrupados em uma pasta como [qb].
• oxmysql para o banco de dados e ox_lib, que muitos recursos atuais dependem.
• Recursos autônomos como um recurso de voz (veja pma-voice não funciona) e qualquer pacote de mapa ou veículo.

Copie-os para sua pasta resources, por exemplo resources/[qb] e resources/[standalone].

#2. Crie o banco de dados e importe o SQL

CREATE DATABASE qbcore CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

Importe o arquivo SQL que vem com a instalação do QBCore (o repositório de receita envia um com as tabelas de base) e depois o SQL de cada recurso que tem seu próprio arquivo. Se um script depois diz que uma tabela está faltando, veja tabela SQL não existe.

#3. Edite server.cfg

set mysql_connection_string "mysql://user:password@localhost/qbcore?charset=utf8mb4"

ensure oxmysql
ensure ox_lib
ensure qb-core
ensure [qb]
ensure [standalone]

add_ace group.admin command allow
add_ace qbcore.god command allow
add_principal group.admin qbcore.god
add_principal identifier.license:YOUR_LICENSE_HERE qbcore.god

Substitua YOUR_LICENSE_HERE pelo seu próprio identificador de licença FiveM. Você o encontra na lista de jogadores do txAdmin ou no console do servidor quando você se junta. As linhas ACE são cobertas em permissões ACE.

Dica: ensure [qb] inicia cada recurso dentro dessa pasta. Mantenha qb-core em si fora dela, como no exemplo, ou é garantido duas vezes. Veja ordem de recurso server.cfg.

#Verificações de primeira

Inicie o servidor e leia o console antes de se juntar:

1. oxmysql se conecta ao banco de dados sem um erro.
2. qb-core inicia. Se não fizer, cada outro recurso qb falha depois.
3. Nenhum erro vermelho dos recursos em [qb]. Alguns avisos são normais; erros repetidos não.
4. Você pode se juntar, obter a seleção de personagem, criar um personagem e desova.
5. Uma linha é criada na tabela players para seu personagem.

Se você não conseguir se juntar ou ficar na tela de carregamento, leia jogadores presos na tela de carregamento.

#Erros comuns de primeira

QBCore é nulo. Um script que usa um método antigo para obter o objeto central falha com:

attempt to index a nil value (global 'QBCore')

Use local QBCore = exports['qb-core']:GetCoreObject() no topo de cada arquivo. A explicação completa está em QBCore nulo: a correção GetCoreObject.

qb-core não iniciou. Outros recursos então relatam:

No such export GetCoreObject in resource qb-core

Procure no topo do console pelo primeiro erro de qb-core em si, que é geralmente o banco de dados. Veja erro de conexão oxmysql.

Recurso falha em iniciar. Problemas de dependência ausente ou nome de pasta: não foi possível encontrar dependência, não foi possível iniciar recurso.

Você não é admin. Seu identificador em server.cfg não corresponde ao seu, ou você não reiniciou após editá-lo.

#Próximos passos

Quando a base é estável, as tarefas de primeira usual são adicionar trabalhos e itens. Veja QBCore adicione trabalho e qb-inventory adicione itens. Se você planeja executar a pilha mais nova mais tarde, leia instale QBox primeiro, porque a pilha difere.

#Checklist