Solução de problemas

Antes de tudo: /sfdiagnostico#

Rode /sfdiagnostico no console do servidor (ou dentro do jogo, se você estiver no grupo de Config.Diagnostico.Grupo). Ele confere dependência parada, tabela ausente, item citado na configuração que não existe na sua base, permissões, licença, bancada sem local, cofre de facção sem facção cadastrada e rota que sorteia denúncia sem ninguém para receber — cada achado com o próximo passo.

/craftconfig diz "Sem permissão"#

Você não está no grupo de Config.CraftConfig.Grupo (padrão "Admin"), ou ele está vazio. Vazio = ninguém pode, de propósito.

A bancada não aparece depois de salvar#

Confira o raio (zero faz sumir) e se ela tem ao menos um local. Se você usa ox_target ou qb-target, confira também Bridge.AddZone e Bridge.RemoveZone na bridge client.

A bancada abre vazia#

O jogador não tem a permissão da bancada, ou as receitas usam item que não existe na sua base. Rode /sfdiagnostico.

A bancada não abre para ninguém#

Se o modo é Organização, só abre para quem está em uma das facções cadastradas — e a bancada precisa ter ao menos uma. Confira a lista de facções no /craftconfig e se Functions.Grupos (bridge) devolve os grupos do jogador.

"Guardei tudo" e sobrou coisa na mochila#

O armazém encheu no meio. O botão guarda o que cabe, item por item, em vez de recusar o lote inteiro — e avisa que sobrou. Aumente a capacidade pela trilha de melhoria de armazém, ou retire algo antes.

O jogador não achou o armazém da facção#

O cofre é decidido pela primeira facção da lista da bancada de que o jogador faz parte. Se ele está em duas, muda a ordem no /craftconfig para escolher qual vence.

A encomenda foi paga e o dinheiro não voltou#

Encomenda vencida ou cancelada devolve na varredura seguinte (a cada 5 minutos por padrão, Config.Encomendas.IntervaloVarreduraMs). O /sfdiagnostico mostra quantos estornos estão por devolver; se o número não cai, procure no console por erro de pagamento — normalmente é Functions.Reward na bridge.

"Entregar" recusa com destino cheio#

O armazém do comprador encheu. Nada é tirado da mochila de quem ia entregar nesse caso — combine no chat da encomenda antes de produzir.

O craft desconta errado ou não entrega#

Teste ItemAmount, RemoveItem, GiveItem e CanCarry na bridge. RemoveItem deve devolver sucesso somente quando a remoção inteira ocorrer.

A rota não paga#

Confira o pagamento no /craftconfig e a função Reward em bridge/server.lua. Pagamento que falha aparece no console e a coleta continua valendo — o item é entregue, o dinheiro não.

"Deslocamento muito rápido entre os pontos"#

É o anti-teleporte. Se os pontos da sua rota são muito distantes, ou se a coleta foi logo depois de um teleporte de staff, ajuste ou desligue Config.Rotas.VelocidadeMaxMs. A rota não é encerrada: a próxima coleta passa.

"Indisponível fora da cidade"#

O jogador está num routing bucket diferente de Config.AntiAbuso.BucketCidade, ou com uma das state bags de StateBagsIsolamento.

A fila some ao reiniciar#

Confirme oxmysql, as tabelas com o prefixo configurado e o relógio da máquina. A fila usa horários absolutos e deve continuar mesmo com o jogador offline.

Os ícones dos itens não aparecem#

Config.UI.ItemImageBase precisa apontar para a pasta de imagens do seu inventário — o caminho final é <base><item>.png.