> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dkscripts.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Apresentação

> Menu de danças com prévia, favoritas e atalhos, mais de 3.000 animações do GTA e danças exclusivas baixadas sob demanda

O **dk\_dances** é um menu de danças para FiveM. O jogador **acha, vê e toca** uma dança em poucos segundos.

Ele já vem com o **pacote de danças do GTA V / GTA Online**, traz as **danças exclusivas da DK** e aceita as animações que o seu servidor já tem. Tudo no mesmo menu.

Os arquivos das exclusivas ficam nos servidores da DK e são baixados sob demanda. O recurso que você instala tem **só o código**.

## Demonstração

[Demonstração do dk\_dances](https://www.youtube.com/embed/RPo7chDetV0)

## Destaques

> **[Menu rápido e buscável](https://docs.dkscripts.com.br/scripts/dances/usage/menu.md)**
>
> Busca por **nome ou id**, filtros de categoria e origem, favoritas e navegação inteira pelo **teclado**. Tocar uma dança é um duplo clique ou um `Enter`.

> **[Prévia no seu personagem](https://docs.dkscripts.com.br/scripts/dances/usage/preview.md)**
>
> Um **clone seu**, visível só para você, dança a animação antes de você escolher. Trocar de dança troca a prévia junto.

> **[Barra de atalhos](https://docs.dkscripts.com.br/scripts/dances/usage/shortcuts.md)**
>
> As suas danças favoritas em **espaços de 1 a 9**, a um toque. <kbd>F4</kbd>, clique ou número, e o personagem já está dançando.

> **[Compartilhar uma dança](https://docs.dkscripts.com.br/scripts/dances/usage/sharing.md)**
>
> Envie a dança ao **jogador mais próximo**. Se ele aceitar, o menu dele abre na dança escolhida.

## Em detalhe

> **Menu de danças**
>
> * Busca por **nome ou id** (o mesmo id do comando `/danca <id>`)
> * Abas **Todas** e **Favoritas**
> * Filtros de **categoria** e de **origem** (GTA ou Exclusivas)
> * Selo **Exclusiva** nas danças feitas pela DK
> * Miniatura de cada dança, com as iniciais do nome quando não há imagem
> * Navegação por teclado: <kbd>↑</kbd> <kbd>↓</kbd> <kbd>Home</kbd> <kbd>End</kbd> <kbd>Enter</kbd> <kbd>P</kbd> <kbd>Esc</kbd>
> * Sons curtos e suaves só nas ações principais

> **Prévia**
>
> * Clone do seu personagem dançando **à esquerda da câmera**, longe do painel
> * Câmera própria, que funciona igual em primeira e terceira pessoa
> * Acompanha a seleção: a barrinha enche e o clone troca de dança
> * Fecha sozinha ao se afastar, ao fechar o menu ou se algo impedir a dança

> **Barra de atalhos**
>
> * De **1 a 9 espaços**, configurável (padrão 5)
> * <kbd>F4</kbd> abre a barra com o cursor ativo e o personagem parado
> * **Arraste** uma dança da lista para um espaço, ou entre espaços para trocar
> * Os atalhos ficam salvos **em cada jogador**

> **Pacote do jogo base**
>
> * Mais de **3.000 danças** do GTA V / GTA Online, **sem download**
> * 12 categorias que podem ser escondidas uma a uma
> * Ids estáveis (todos começam com `gta-`) e que não mudam entre versões
> * Dicionários que a build do servidor não tem somem do menu sozinhos
>
> Veja [Danças do jogo base](https://docs.dkscripts.com.br/scripts/dances/configs/gta-pack.md).

> **Danças exclusivas e sincronia**
>
> * Arquivos `.ycd` baixados **sob demanda** dos servidores da DK
> * Quem chega perto de um dançarino baixa a dança dele na hora, e **ninguém baixa o que não está vendo**
> * Reparo automático quando o dançarino aparece parado
> * Dá para trocar tudo por arquivos locais na `stream/`
>
> Veja [Carregamento remoto e sincronia](https://docs.dkscripts.com.br/scripts/dances/configs/remote-sync.md).

> **Integração com o servidor**
>
> * **Injete** as animações que o seu servidor já tem, por arquivo ou por export
> * Danças que **chamam outro script**: um evento ou export ao dançar e ao parar
> * **Hooks** de client e server (VIP, bloqueios, logs próprios)
> * **Exports** para abrir o menu, tocar e parar por script
> * **Objetos na mão** (bebida, celular, glowsticks) nas danças que pedem
> * Logs no console e no Discord
>
> Veja [Hooks](https://docs.dkscripts.com.br/scripts/dances/dev/hooks.md), [Exports](https://docs.dkscripts.com.br/scripts/dances/dev/exports.md) e [Injetar animações](https://docs.dkscripts.com.br/scripts/dances/dev/inject.md).

## Compatibilidade

**Dependências**

* **dk\_snippets** (obrigatório) — [Download](https://github.com/potter7k/dk_snippets/releases/latest). Os avisos e o convite de compartilhar passam por ele
* Uma **licença ativa** da DK, com o IP do servidor autorizado
* FiveM atualizado, com Lua 5.4
* **OneSync** para a sincronia entre jogadores e para os objetos visíveis aos outros

O pacote **não traz nenhum SQL** para importar.

**Animações**

| Origem | Onde fica o arquivo | Precisa de download |
| - | - | - |
| **GTA** | No próprio jogo | Não |
| **Exclusivas** | Servidores da DK | Sim, sob demanda |
| **Suas** | `stream/` de algum recurso do servidor | Não |

**Idiomas**

`pt-br` e `en`, escolhidos em `locale` no `config/shared/config.lua`. O `pt-br` é sempre carregado primeiro como reserva: uma chave que faltar no idioma escolhido aparece em português.

## Estrutura do script

> [!WARNING]
>
> A pasta instalada precisa se chamar exatamente **`dk_dances`**. Esse nome aparece nos `require`, exports, eventos e caminhos da interface.

> **Ver a estrutura de arquivos**
>
> ```
> dk_dances/
> ├── config/
> │   ├── client/
> │   │   ├── config.lua          # Teclas, comandos, bloqueios, atalhos, sons, prévia e sincronia
> │   │   ├── hooks.lua           # Hooks do jogador
> │   │   └── props.lua           # Objetos que as danças seguram
> │   ├── server/
> │   │   ├── config.lua          # Cooldowns, compartilhar e sincronia
> │   │   ├── logs.lua            # O que registrar e o webhook do Discord
> │   │   ├── hooks.lua           # Hooks do servidor
> │   │   └── inject.lua          # Suas animações no menu
> │   └── shared/
> │       ├── config.lua          # Idioma, categorias, miniaturas e o catálogo
> │       └── gta_data.lua        # Pacote do GTA (gerado, não edite)
> ├── locales/
> │   ├── pt-br/                  # game.lua, shared.lua, ui.lua
> │   └── en/
> ├── modules/                    # Lógica interna (modules/client/props.lua é editável)
> ├── web/
> │   ├── build/
> │   │   └── theme.css           # Cores da interface (editável sem recompilar)
> │   └── public/
> │       └── previews/           # Miniaturas das danças
> ├── types.lua                   # Tipagem dos exports para o Lua LSP
> ├── license.lua                 # Licença do produto (não remova)
> └── fxmanifest.lua
> ```

## Segurança

> [!WARNING]
>
> O script é **ofuscado e protegido por licença**. Cada licença dá acesso a **1 endereço de IP**, que pode ser alterado quando desejado.

* O **webhook do Discord fica só no servidor**: nada de `config/server` chega ao jogador
* Quem recebe um convite de compartilhar é **sempre escolha do servidor**
* Só o **servidor** injeta danças: nenhum jogador consegue colocar uma no catálogo
* Os hooks rodam protegidos: um erro neles nunca derruba o recurso

## Próximos passos

> **[Primeiros Passos](https://docs.dkscripts.com.br/scripts/dances/get-started.md)**
>
> Instale o script e toque a primeira dança.

> **[Comandos e Teclas](https://docs.dkscripts.com.br/scripts/dances/commands.md)**
>
> A referência rápida de tudo que o jogador pode digitar.

## Adquira agora

> **[Comprar dk\_dances](https://shop.dkscripts.com.br)**
>
> Acesse nossa loja e adquira o script com suporte completo e atualizações gratuitas. A instalação é gratuita para todos os compradores: confira os [termos e condições](https://docs.dkscripts.com.br/terms-of-service.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.