Configurações do Client

Arquivo: config/client/config.lua. Mudanças só valem depois de reiniciar o recurso.

Este arquivo é enviado ao jogador. Nunca ponha nele webhook, token ou senha.

Visão geral

Opção	Padrão	O que faz
`debugMode`	`false`	Mensagens de diagnóstico no console F8. Deixe desligado em produção
`openKey` / `stopKey` / `shortcutsKey`	`"F5"` / `"X"` / `"F4"`	Teclas padrão
`notifyDuration`	`5000`	Quanto tempo (ms) os avisos ficam na tela
`commands`	—	Nomes dos comandos de chat
`forceReplay`	`false`	O que fazer quando outra coisa cancela a animação
`blockWhen`	—	Situações em que não se pode começar uma dança
`shortcuts`	—	A barra de atalhos
`sounds`	—	Os sons da interface
`preview`	—	A prévia no personagem
`sync`	—	A sincronia entre jogadores
`hooks`	—	Os hooks do jogador (`config/client/hooks.lua`)

Teclas e comandos

openKey = "F5",
stopKey = "X",
shortcutsKey = "F4",

commands = {
    open = "dancas",
    play = "danca",
    stop = "parardanca",
    shortcuts = "atalhosdanca",
},

As teclas são o padrão: o jogador pode remapear em Configurações → Atalhos do FiveM, e o FiveM guarda a escolha no perfil dele. Nos commands, "" desativa o comando. A tecla continua funcionando. Veja também Comandos e Teclas: A referência rápida do que o jogador pode digitar e apertar.

Avisos

notifyDuration = 5000,

Quanto tempo, em milissegundos, os avisos do script ficam na tela: dança bloqueada, em espera ou comando sem argumento. Um valor inválido vira 5000.

Bloqueios

blockWhen = {
    inVehicle = true,
    dead = true,
    ragdoll = true,
    falling = true,
    swimming = true,
},

Situações em que o jogador não pode começar uma dança. Cada uma ligada devolve um aviso.

Opção	Bloqueia quando o jogador está…
`inVehicle`	dentro de um veículo
`dead`	morto
`ragdoll`	em ragdoll
`falling`	caindo
`swimming`	nadando

Os mesmos bloqueios encerram uma dança em andamento: morrer, cair, nadar ou entrar num veículo para a dança, mesmo com forceReplay = true. Para uma regra mais fina (algemado, em combate, dentro de uma área), use o hook onBeforePlay do client ou do server.

Quando outra coisa cancela a animação

forceReplay = false,

Valor	Comportamento
`false`	Se outra coisa cancelar a animação (a tecla de cancelar ações do servidor, `F6`, outro script), a dança termina de verdade: some para o jogador, para o servidor e para quem está perto, e não volta sozinha
`true`	Força a dança: a animação cancelada de fora é tocada de novo e só termina pela tecla ou comando de parar do dk_dances. Só vale para dança em loop

Veja também Menu de Danças: O comportamento do ponto de vista do jogador.

Barra de atalhos, sons e prévia

Atalhos

shortcuts.enabled e shortcuts.slots.

Sons

sounds.enabled e sounds.volume.

Prévia

O bloco preview completo.

Sincronia

sync = {
    watchInterval = 500,
    watchGrace = 1000,
},

Opção	Padrão	O que faz
`watchInterval`	`500`	De quanto em quanto tempo (ms) o jogador confere os dançarinos por perto. Aceita `250` ou mais
`watchGrace`	`1000`	Quanto tempo (ms) um dançarino com o arquivo já baixado pode ficar sem aparecer dançando antes de o jogador pedir a repetição. Aceita `500` ou mais

Veja também Carregamento Remoto e Sincronia: como a sincronia funciona e o que cada valor muda.

Hooks

O config/client/config.lua carrega os hooks do jogador de config/client/hooks.lua. Veja também Hooks: bloqueie a abertura, a prévia e o início de uma dança, e reaja a cada início e fim.

Informações Gerais

Scripts

Visão geral

Teclas e comandos

Avisos

Bloqueios

Quando outra coisa cancela a animação

Barra de atalhos, sons e prévia

Atalhos

Sons

Prévia

Sincronia

Hooks

​Visão geral

​Teclas e comandos

​Avisos

​Bloqueios

​Quando outra coisa cancela a animação

​Barra de atalhos, sons e prévia

Atalhos

Sons

Prévia

​Sincronia

​Hooks

Visão geral

Teclas e comandos

Avisos

Bloqueios

Quando outra coisa cancela a animação

Barra de atalhos, sons e prévia

Sincronia

Hooks