Como instalar um servidor QBox: receita, pilha e primeiros erros

Você quer um servidor QBox e quer saber o que está na pilha, como instalá-lo e como ele difere de QBCore. Este guia fornece a rota de receita, as peças que compõem o QBox, as diferenças a observar, e os primeiros erros que as pessoas atingem.

#Instale com a receita txAdmin

QBox foi feito para ser instalado com uma receita txAdmin. Na configuração do txAdmin, escolha o template QBox nas receitas populares (ou cole a URL da receita da documentação do projeto QBox). Os passos são os mesmos em configuração txAdmin e receitas: chave de licença, credenciais de banco de dados, então revise server.cfg e inicie.

Sempre pegue a receita do próprio projeto QBox. Sua lista de recursos muda conforme o projeto cresce, e a receita permanece atual.

#A pilha QBox

QBox é um conjunto de recursos construídos em torno das bibliotecas do Overextended. As peças de base:

No topo desses, a receita adiciona os recursos qbx_ para trabalhos, veículos, habitação e assim por diante, além de recursos autônomos como voz.

Um server.cfg manual se parece com isto:

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

ensure oxmysql
ensure ox_lib
ensure qbx_core
ensure ox_inventory
ensure ox_target
ensure [qbx]
ensure [standalone]

A receita escreve a lista exata para a versão que instala, portanto trate isto como a forma, não o conteúdo. A ordem é importante: veja ordem de recurso server.cfg.

#O que difere de QBCore

• Nome do core. O framework é qbx_core. Não há pasta qb-core, e você não deve manter uma ao lado dele.
• Inventário. QBox usa ox_inventory. Itens são definidos para ox_inventory, não no arquivo de itens compartilhados qb. Veja ox_inventory adicione itens.
• Bibliotecas em vez de ajudantes. Callbacks, notificações, menus de contexto e barras de progresso vêm de ox_lib. Veja callbacks em ESX, QBCore e ox_lib e notificações e barras de progresso.
• Direcionamento. ox_target é o recurso de alvo: ox_target adicione zona. As diferenças com o alvo QBCore estão em qb-target vs ox-target.
• Exports. QBox tem seus próprios exports, por exemplo no servidor:

local player = exports.qbx_core:GetPlayer(source)
if player then
    print(player.PlayerData.citizenid)
end

A forma QBCore exports['qb-core']:GetCoreObject() ainda responde através da camada de compatibilidade, é por isso que muitos scripts QBCore funcionam. Para uma conversão completa, veja converter um script QBCore para QBox.

#Verificações de primeira

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

1. oxmysql se conecta.
2. ox_lib e qbx_core iniciam sem erros.
3. ox_inventory inicia. Tem suas próprias verificações na inicialização e relata problemas claramente, portanto leia o que ele imprime.
4. Você pode se juntar, criar um personagem e desova.
5. Seu inventário abre com a chave que a receita configurou.

Para direitos de admin, QBox usa principais ACE em server.cfg, da mesma forma que outros frameworks. Veja permissões ACE.

#Erros comuns de primeira

Um script QBCore não consegue encontrar o core. Se a camada de compatibilidade não está ativa, ou qbx_core falhou em iniciar, você obtém:

No such export GetCoreObject in resource qb-core

Verifique se qbx_core iniciou sem erros, e se nenhuma pasta qb-core obsoleta existe. Veja QBCore nulo: a correção GetCoreObject.

ox_lib não carregado. Um script que chama lib antes de ox_lib iniciar falha. Coloque ensure ox_lib perto do topo e adicione @ox_lib/init.lua ao manifest do script. Veja ox_lib init.lua não encontrado.

Erros de banco de dados. String de conexão errada, ou o banco de dados não foi criado. Veja erro de conexão oxmysql.

Dois inventários. Executar qb-inventory ao lado de ox_inventory causa itens duplicados e quebrados. Mantenha apenas ox_inventory.

Recurso não iniciando. Não foi possível encontrar dependência diz o que está faltando.

#Checklist