Solução de problemas

Os problemas que as pessoas realmente enfrentam, aproximadamente na ordem em que acontecem.

Uma alteração em um arquivo não surtiu efeito

O comando restart não relê o fxmanifest.lua. Se você adicionou um arquivo — um novo idioma, por exemplo — digite refresh no console do servidor primeiro e depois restart mic_shopcreator.

Erros sobre `es_extended` ou `qb-core` ao iniciar

O Config.Framework não é detectado automaticamente. Defina 'esx' ou 'qbcore' para corresponder ao seu servidor e inicie o mic_shopcreator depois do seu framework no server.cfg.

No QBox, o valor é 'qbcore' — o QBox executa recursos QBCore através da sua camada de compatibilidade — e o qbx_core deve iniciar antes do mic_shopcreator.

/shopcreator diz que não tenho permissão

A permissão ACE é mic_shop.open — e não mic_shopcreator.open. Verifique a grafia na sua linha add_ace e certifique-se de que ela usa um identificador com o qual você realmente se conecta, ou um grupo do qual você realmente faz parte.

Tudo aparece como “Translation not found”

O Config.Locale indica um arquivo que não está em locales/, ou que não foi incluído em shared_scripts no fxmanifest.lua. O console exibe Locale file not found for … quando isso acontece.

O vendedor não está lá

Você está muito longe. Os vendedores só existem dentro da distância Config.PedSpawnDistance (20 metros por padrão).
O local foi assaltado. Um local assaltado fecha durante o seu tempo de recarga: o vendedor e o blip desaparecem para todos até que o tempo termine. Veja abaixo.
Config.SpawnNPC está desativado. Nesse caso, não há vendedor por padrão, apenas um marcador ou um ponto de target.
O modelo é inválido. Se o modelo de um local não puder ser carregado, ele será substituído por Config.DefaultPed, e o console exibirá Using default. Se o modelo padrão também não carregar, você verá CRITICAL: Could not load default ped model e nenhum vendedor aparecerá — coloque um modelo válido em Config.DefaultPed.

Consigo ver o vendedor, mas não consigo abrir a loja

O Config.Interaction não corresponde ao que você usa. Ele vem configurado como 'ox_target'. Defina 'qb-target' para qb-target, ou 'default' para caminhar até lá e pressionar E dentro da distância Config.RadiusInteract.

No QBCore com 'default', o aviso na tela não é exibido — a função ShowHelpNotification em bridge/client.lua vem vazia para o QBCore. A tecla E ainda funciona; preencha essa função com a sua própria chamada de texto de ajuda para mostrar o aviso.

“This shop is currently on cooldown” / uma loja assaltada fica fechada por horas

Um local assaltado permanece fechado pelo tempo definido em Cooldown (minutes) da loja. Se uma loja não tiver nenhum tempo de recarga salvo, o valor padrão usado é Config.RobberyCooldown — que também é lido em minutos, portanto o valor 300 que vem por padrão equivale a cinco horas. Defina um tempo de recarga em cada loja assaltável no painel, ou diminua o valor padrão.

As imagens dos produtos não aparecem

A janela da loja procura por <item name>.png em cada pasta listada em Config.InventoryImagePath, na ordem. Por padrão, ele aponta para a pasta do ox_inventory. Em outro inventário, coloque o caminho da pasta de imagens desse inventário no formato nui://. Se o nome do item e o nome do arquivo de imagem forem diferentes, nenhuma imagem será exibida.

Comprar com dinheiro sujo falha no QBCore

O dinheiro sujo é pago a partir de uma conta chamada black_money. O QBCore não possui essa conta por padrão, portanto use Cash, Bank ou All (Cash + Bank) para os produtos no QBCore — ou adicione a conta e ajuste a função GetAccount em bridge/server.lua para a forma como o seu servidor lida com dinheiro sujo.

Um dono abre a loja e o botão de engrenagem não aparece

A lista de donos deve conter o identificador que o Config.IdentifierType utiliza:

`Config.IdentifierType`	O que digitar como dono
`'discord'`	Apenas o número do ID do Discord, sem `discord:`
`'license'`	A licença completa, incluindo `license:`
`'esx'`	O identificador ESX exatamente como salvo na tabela `users`, incluindo prefixos como `char1:`
`'citizenid'`	O citizen ID do QBCore

Se você alterou o Config.IdentifierType depois que os donos já haviam sido adicionados, adicione-os novamente.

Os jogadores não conseguem ser contratados

Com 'discord', o jogador precisa ter o Discord vinculado; caso contrário, ele receberá um aviso pedindo para vinculá-lo.
Eles devem estar a até 10 metros do dono no momento em que o dono abre a lista.
Eles devem pressionar Y quando solicitados. No QBCore, a pergunta é exibida através de ShowHelpNotification em bridge/client.lua, que vem vazia para o QBCore — preencha-a ou avise o jogador para pressionar Y.

O assalto não começa

O assalto precisa estar ativado naquela loja, e o jogador deve estar apontando uma arma — não mãos vazias — para o vendedor a até 5 metros de distância. Um local que já esteja sendo assaltado, ou que ainda esteja em tempo de recarga, recusará o início do assalto.

Os logs do Discord nunca chegam

A opção Webhooks deve estar ativada para aquela loja, com uma URL de webhook do Discord válida.
Config.Screenshot está ativado, mas o screenshot-basic não está em execução. O log é enviado junto com a captura de tela, portanto, sem esse recurso, nada é enviado. Inicie o screenshot-basic antes deste recurso ou defina Config.Screenshot = false.

A polícia não recebe alerta

Config.PoliceAlert = "default" notifica os jogadores cujo emprego esteja listado em Config.RobberyNotifyJobs, pelo nome do emprego. Com "custom", nada é enviado até que você escreva a chamada do seu sistema de dispatch dentro de TriggerPoliceAlert em bridge/server.lua — que vem vazia por padrão.