Como instalar o qbCore em um servidor FiveM

Como instalar o qbCore em um servidor FiveM

Quando estiver pronto para dar vida ao seu servidor de roleplay FiveM, escolher a estrutura certa é essencial. O qbCore se tornou um favorito na comunidade porque simplifica a configuração, é atualizado continuamente e oferece uma rica biblioteca de scripts gratuitos para aumentar a imersão. Neste guia, você encontrará um caminho claro e passo a passo para uma instalação tranquila do qbcore.

Visão geral do qbCore

qbCore é uma estrutura simplificada e de código aberto, desenvolvida especificamente para FiveM. Ela amplia os recursos básicos do servidor com scripts RP fáceis de implementar, uma arquitetura modular e ferramentas de administração robustas. Seja você um operador iniciante ou experiente, o qbCore reduz as dores de cabeça com configuração e permite que você se concentre na diversão da jogabilidade.

Instalação do qbcore: guia passo a passo

1. Pré-requisitos

Antes de começar, certifique-se de ter:
– Um servidor FiveM funcional – use nosso tutorial de início rápido caso esteja faltando algum.
– Conhecimento básico de administração de servidor – capacidade de editar arquivos de configuração e reiniciar serviços.
– Acesso à pasta `resources/` do seu servidor – geralmente localizado no diretório principal do servidor.
– Um editor de texto simples como o Notepad++ para editar arquivos Lua.

Essas são as únicas condições necessárias; o qbCore em si não requer nenhum software especial.

2. Baixe o qbCore

Acesse o repositório oficial no GitHub: `https://github.com/qbcore-framework`.
Clique Código → Baixar ZIP para obter o último lançamento.
Quando o download terminar, descompacte a pasta em um local temporário no seu computador.
Não é necessária uma conta GitHub, mas fazer login pode ajudar você a se manter atualizado sobre novos lançamentos.

3. Transferir qbCore para Recursos

Abra sua pasta de recursos do FiveM.
Arraste a pasta `qb-core` extraída para este diretório e deixe-a intacta – você nunca mais abrirá o ZIP compactado.

4. Configurar qbCore

Navegue até `qb-core/qb-core/config.lua`.
Clique com o botão direito e abra-o com seu editor favorito.
Aqui você vai:
– Defina o banco de dados: cole sua string de conexão em `Config.Database`.
– Ajustar identidade do servidor: altere os valores `Config.ServerName` e `Config.Webhook` para corresponder à sua marca.
– Escolha os módulos: alterne seções para habilitar ou desabilitar recursos como sistemas de trabalho ou lojas de veículos.
Tome nota dos comentários no arquivo para orientação.
Após terminar, salve e feche o arquivo.

5. Habilite o qbCore na configuração do servidor

Abra `server.cfg` localizado próximo a `resources/`.
Adicione a seguinte linha na parte inferior:
“`
garantir qb-core
“`
Isso informa ao FiveM para carregar o recurso qb-core durante a inicialização.
Salve e feche o arquivo.

6. Reinicie o servidor

Reinicie seu serviço FiveM normalmente – pelo painel de controle de hospedagem ou executando `exit` no prompt de comando.
Uma reinicialização limpa fecha conexões abertas, limpa a memória e garante que o recurso qb-core recém-adicionado seja totalmente inicializado.

7. Verifique a instalação

Conectar a seu servidor com o cliente FiveM.
Abra o console (F8) e digite os comandos `qb_`; a lista de comandos que aparece prova que o qbCore está ativo.
Você também deve ver uma mensagem “qbCore boot” no log do servidor.

Se tudo carregar sem erros, você concluiu com sucesso a instalação do qbcore.

Adicionando mais scripts

A natureza modular do qbCore significa que você pode colocar pastas de script adicionais em `resources/` e simplesmente `ensure` elas em `server.cfg`.
As escolhas populares incluem:

– empregos – roteiros de trabalho pré-elaborados para carreiras policiais, de emergência médica ou criminais.
– lojas – lojas dentro da cidade para armas, carros e cosméticos.
– veículos – listas de veículos personalizadas e sistemas de garagem.
Todos os scripts estão disponíveis gratuitamente no qbCore GitHub ou fóruns da comunidade.

Exemplo: Adicionando um Trabalho Simples

Baixe um script de trabalho zip, descompacte-o e mova a pasta para `resources/`.
Adicione `ensure myjob` ao `server.cfg`.
Reinicie e use `setplayerjob myjob` para testar.

Perguntas frequentes

P: O qbcore é melhor que o ESX?
R: Ambas as estruturas possuem comunidades fortes. O qbCore se destaca com seu estilo de codificação Lua moderno e uso mais leve de recursos, enquanto o ESX oferece uma base estável com décadas de existência. A decisão geralmente se resume à preferência pessoal e aos recursos necessários.

P: Onde posso encontrar scripts qbcore gratuitos?
R: Visite portais populares como Cfx.re, HiFiveM e Tebex. Pesquise por "qbcore" para encontrar complementos compatíveis.

P: O qbCore é gratuito?
R: Com certeza. Todo o framework é de código aberto sob a licença MIT, então você pode modificá-lo e hospedá-lo sem custo.

Considerações finais – Sua jornada de instalação do qbcore

Concluir a instalação do qbcore abre portas para infinitas possibilidades de roleplay. A configuração simples do framework, aliada ao suporte ativo da comunidade, permite que você se concentre em criar experiências únicas em vez de se preocupar com código de servidor de baixo nível.

Seguindo esses passos, você estabeleceu uma base sólida que evoluirá junto com o seu servidor. À medida que novos scripts e atualizações surgirem, será fácil aprimorar seu ambiente, manter os jogadores engajados e gerenciar sua comunidade com eficiência.

Agora é hora de mergulhar, explorar os recursos do qbCore e criar um servidor FiveM que dê vida à sua visão. Boa sorte e aproveite cada momento do processo de criação.