Desenvolvedores
Frameworks
Todas as frameworks que o recurso fivedash reconhece, como cada uma é detectada e o que funciona em cada uma (whitelist, loja e logs).
Todas as frameworks que o recurso fivedash reconhece, como cada uma é detectada e o que funciona em cada uma (whitelist, loja e logs).
O recurso fivedash não depende de nenhuma framework: ele descobre sozinho qual base a cidade usa e conversa com ela pelos exports, eventos e tabelas que ela já tem. Esta página mostra cada framework suportada, como ela é reconhecida e o que o FiveDash consegue fazer nela. É para quem administra o servidor e para quem desenvolve scripts.
fivedash instalado e conectado. Veja Recurso FiveM.oxmysql, ghmattimysql ou mysql-async). A detecção olha as tabelas do banco, e a whitelist e a loja escrevem nele.ensure fivedash no server.cfg depois do banco e da framework. Se algum deles iniciar depois, o recurso detecta de novo sozinho.| Framework | Framework no config.lua | Whitelist pelo FiveDash | O jogador digita na liberação | ID da loja |
|---|---|---|---|---|
| Creative Network Enchanted | creative-enchanted | Sim | O token mostrado ao conectar (ou o número da conta) | Passaporte |
| Qbox | qbox | Sim, pela whitelist do Qbox | Nada: vale o Discord | Citizen ID |
| QBCore | qbcore | Sim, pela whitelist da QBCore | Nada: vale o Discord | Citizen ID |
| ESX | esx | Sim, com o esx_whitelist | Nada: vale o Discord | ID |
| ox_core | ox-core | Não (fica só no Discord) | State ID | |
| vRP / vRPex | vrp | Sim, se vrp_users tem a coluna whitelisted | O número da conta | ID |
Em todas, a loja entrega grupo, veículo, dinheiro (banco e carteira), item e comando. Comandos de console funcionam em qualquer framework, até sem nenhuma.
oxmysql primeiro, depois ghmattimysql, depois mysql-async).Framework = "auto", ganha a nota mais alta, se for pelo menos 50. Abaixo disso, nenhuma é usada e o console mostra “Nenhuma framework reconhecida”.Framework forçada (por exemplo "qbox"), vale essa, desde que ela seja encontrada. Se não for, o console mostra um erro com a lista de IDs válidos.fivedash, a detecção roda de novo: vrp, qbx_core, qb-core, es_extended, ox_core, oxmysql, mysql-async, ghmattimysql, ox_inventory e qb-inventory.Para ver o que levou à escolha, rode no console do servidor:
fivedash detect
O console mostra Framework detectada: QBCore, a nota (92% de certeza), cada evidência (por exemplo recurso qb-core iniciado e tabela players com citizenid) e o driver (banco via oxmysql). Com Debug = true (ou set fivedash_debug 1), isso aparece em todo boot.
No painel, o resultado aparece no cartão Conexão com o jogo (Servidor → Visão geral): Framework e Whitelist pelo FiveDash (Ativa, Indisponível ou Sem suporte ainda). Problemas de configuração aparecem embaixo, em amarelo.
Na QBCore, no Qbox e no ESX, a whitelist da própria base não mostra um ID para o jogador quando ele é barrado. Por isso a liberação vale para o Discord: o recurso guarda os identificadores de quem tenta entrar (playerConnecting) na tabela fivedash_identities e, na liberação, encontra as licenses ligadas àquele Discord.
Na QBCore, no Qbox e no ESX, um grupo da loja que não é um emprego (ou gangue) da base vira um grupo ACE na license do comprador: group.<nome> no ESX e no Qbox, qbcore.<nome> na QBCore. O FXServer guarda ACEs só na memória, então o recurso grava em fivedash_ace_groups e reaplica a cada boot. Dê as permissões ao grupo no server.cfg:
add_ace group.vip vip allow
E confira nos scripts com IsPlayerAceAllowed(source, "vip").
Creative Network Enchanted (vRP reescrito pela Creative Network). ID: creative-enchanted.
Detecção
| Evidência | Nota |
|---|---|
Recurso vrp iniciado com creative_network no fxmanifest.lua | 50 (obrigatório) |
Liberation definido em vrp/config/Global.lua | +10 |
vrp/modules/base.lua contém Account[Liberation] | +15 |
Tabela accounts com Whitelist, Discord, License e Token | +25 (−20 se faltar alguma) |
Whitelist
Liberation no vrp/config/Global.lua (padrão da base: Token, 7 dígitos mostrados ao conectar). Se Liberation aponta para id (ou para uma coluna que não existe), vale o número da conta.accounts.Whitelist = 1 e, quando o membro vem junto, accounts.Discord.Whitelist = 0 nas contas com aquele ID ou aquele Discord e, se o painel pedir, derruba o jogador.0).Loja (ID: Passaporte, o characters.id)
| Tipo | Como entrega | Precisa estar online? |
|---|---|---|
| Grupo | vRP.SetPermission. O grupo precisa existir em vrp/config/Groups.lua | Não |
| Veículo | Grava na tabela vehicles pela query da base. O modelo precisa existir em vrp/config/Vehicle.lua. Recusa se o passaporte já tem esse veículo | Não |
| Dinheiro (banco) | vRP.GiveBank | Não |
| Dinheiro (carteira) | Item dollar no inventário | Sim |
| Item | vRP.GenerateItem. O item precisa existir em vrp/config/Item.lua. Mochila cheia: espera. Sem espaço livre, a base solta o item no chão, aos pés do jogador | Sim |
accounts.Discord e pega o personagem mais recente da conta (ignora personagens com Deleted = 1).CharacterChosen.Notify.Passport do jogador.Avisos que podem aparecer
Liberation = "X" não é uma coluna da tabela accounts: o FiveDash usa o número da conta (id).Whitelisted = false em vrp/config/Global.lua).oxmysql precisa iniciar antes do fivedash.A conexão com o painel funciona normalmente. A whitelist fica só no Discord e a loja entrega só por comandos de console. Se a sua base é uma das acima, mas não foi reconhecida, rode fivedash detect, confira se ela iniciou antes do fivedash e, se precisar, force com Framework no config.lua.
Uso Qbox, mas o painel mostra QBCore.
Confira se o qbx_core está iniciado antes do fivedash. O Qbox ganha da QBCore sempre que o qbx_core está rodando. Se precisar, use Framework = "qbox".
A liberação volta “não encontrado” na QBCore / Qbox / ESX. O FiveDash ainda não viu esse Discord tentando entrar na cidade. Peça para o jogador tentar conectar uma vez, com o Discord aberto, e libere de novo.
Por que o item da loja fica “Aguardando o jogador entrar na cidade”?
Itens e dinheiro na carteira precisam do jogador online em todas as frameworks. A entrega roda sozinha quando ele escolhe o personagem (depois do SpawnDelay do loja.lua).
Minha framework é um fork. Funciona?
Forks do vRP caem no adaptador vrp, e cada passo confere o que a base respondeu. Forks que mantêm os mesmos recursos e tabelas da QBCore ou do ESX também são reconhecidos.