> ## 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.

# Comandos e Teclas

> Referência rápida de todos os comandos de chat, teclas e atalhos do dk_dances

Tudo que o jogador pode digitar ou apertar, em uma página só.

## Comandos do jogador

| Comando | O que faz | Config |
| - | - | - |
| `/dancas` | Abre o **menu de danças** | `commands.open` |
| `/danca <id>` | Toca a dança do **id** informado, sem abrir o menu | `commands.play` |
| `/parardanca` | **Para** a dança atual | `commands.stop` |
| `/atalhosdanca` | Abre a **barra de atalhos** | `commands.shortcuts` |

```text theme={null}
/danca passinho_i_love_u_funk
/danca gta-shuffle-high-left-up
```

O `id` é o mesmo que a busca do menu aceita. Sem o id, o comando responde com o modo de uso (`Use: /danca <id da dança>`).

Os nomes ficam em `commands` no `config/client/config.lua`. Para renomear um, troque o valor; para desativar só o comando, use `""`. O `shortcuts` vazio desliga o comando mas **não** a tecla nem a barra: para isso use `shortcuts.enabled = false`.

## Teclas

| Ação | Padrão | Config |
| - | - | - |
| Abrir o menu | <kbd>F5</kbd> | `openKey` |
| Parar a dança | <kbd>X</kbd> | `stopKey` |
| Abrir a barra de atalhos | <kbd>F4</kbd> | `shortcutsKey` |

As três são registradas via `RegisterKeyMapping` e podem ser remapeadas pelo jogador em **Configurações → Atalhos** do FiveM.

> [!NOTE]
>
> O FiveM salva a tecla escolhida **no perfil do jogador**. Mudar o padrão no config afeta principalmente quem ainda não tem um bind salvo — quem já jogou mantém o antigo até remapear.

Para criar um bind manual, os comandos por trás das teclas são:

```text theme={null}
/dk_dances_open        Abre o menu
/dk_dances_stop        Para a dança
/dk_dances_shortcuts   Abre a barra de atalhos
```

## Controles dentro do menu

| Ação | Como |
| - | - |
| Tocar a dança | **Duplo clique**, <kbd>Enter</kbd> ou o botão **Dançar** |
| Focar a busca | <kbd>/</kbd> |
| Mover a seleção | <kbd>↑</kbd> <kbd>↓</kbd> |
| Ir ao primeiro ou ao último | <kbd>Home</kbd> / <kbd>End</kbd> |
| Ligar e desligar a prévia | <kbd>P</kbd> ou o botão **Prévia** |
| Favoritar | A **estrela** da dança |
| Compartilhar | A **seta saindo da caixa**, ao lado da estrela |
| Fechar | <kbd>Esc</kbd> |

Veja também [Menu de Danças](https://docs.dkscripts.com.br/scripts/dances/usage/menu.md): busca, filtros, favoritas, números das danças e sons.

## Controles na barra de atalhos

| Ação | Como |
| - | - |
| Dançar | **Clicar** no espaço ou apertar <kbd>1</kbd> a <kbd>9</kbd> (até o número de espaços configurado) |
| Fechar sem dançar | <kbd>Esc</kbd> |
| Abrir o menu completo | Botão **Todas as danças** |
| Pôr uma dança num espaço | **Arrastar** da lista (com o menu aberto) |
| Trocar dois espaços | **Arrastar** de um espaço para outro |
| Limpar um espaço | O **✕** do espaço |

Veja também [Barra de Atalhos](https://docs.dkscripts.com.br/scripts/dances/usage/shortcuts.md): como montar e usar as suas danças a um toque.

## Comando de ajuste (desenvolvedor)

| Comando | O que faz | Config |
| - | - | - |
| `/dancaprop <objeto> x y z rx ry rz` | Reposiciona ao vivo o objeto da dança atual e imprime no **F8** a linha para colar em `config/client/props.lua` | `tuningCommand` |

Só existe com `debugMode = true` em `config/client/config.lua`. Para desligar de vez, deixe `tuningCommand = ""`.

Veja também [Objetos nas Danças](https://docs.dkscripts.com.br/scripts/dances/configs/props.md): como definir os objetos que cada dança segura e acertar a posição.


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