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

# Danças do Jogo Base

> O pacote de danças do GTA V e GTA Online que já vem no recurso: como esconder categorias, restringir por permissão e o que ele não traz

O recurso já traz as danças do **GTA V / GTA Online**, prontas para usar e **sem download**: boate, cassino, Cayo Perico, celebrações, DJs, Lazlow, pole dance e outras. São **mais de 3.000 danças**.

Elas entram **antes das suas** no catálogo, com a origem `gta`, e o filtro **Origem** do menu separa as duas.

## Configuração

```lua theme={null}
-- config/shared/config.lua
gta = {
    enabled = true,
    hide = {},
},
```

| Opção | Padrão | O que faz |
| - | - | - |
| `enabled` | `true` | `false` volta a mostrar só as danças de `dances` |
| `hide` | `{}` | Lista de categorias do pacote que ficam de fora |

## Categorias

| Id | Categoria no menu |
| - | - |
| `gta-club` | Boate |
| `gta-casino` | Cassino |
| `gta-pair` | Dupla |
| `gta-celebration` | Celebração |
| `gta-character` | Personagens |
| `gta-crowd` | Multidão |
| `gta-cayo` | Cayo Perico |
| `gta-lazlow` | Lazlow |
| `gta-dj` | DJ |
| `gta-pole` | Pole dance |
| `gta-lap` | Lap dance |
| `gta-party` | Ambiente |

### Esconder categorias

`hide` esconde categorias **inteiras** do pacote:

```lua theme={null}
gta = {
    enabled = true,
    hide = { "gta-pole", "gta-lap" },
},
```

> [!WARNING]
>
> Não edite `config/shared/gta_data.lua`. Ele é o arquivo do pacote e é gerado pela DK. Para esconder categorias use `gta.hide`.

## Ids e números das danças

* Os ids das danças começam com `gta-` (ex.: `gta-shuffle-high-left-up`) e valem em `/danca <id>`, nas favoritas e no `onBeforePlay`
* Eles **não mudam entre versões** do recurso, então favoritas e regras de VIP que usam um id do pacote continuam valendo depois de uma atualização
* O número de cada dança no menu (`0001`, `0002`...) é a posição dela no catálogo: o pacote vem primeiro e as suas danças depois. Esconder categorias do pacote muda esses números

## Restringindo por categoria

Como `dance.category` vem preenchida, dá para restringir o pacote por categoria no hook do servidor. Por exemplo, a Cayo Perico só para VIPs:

```lua theme={null}
-- config/server/hooks.lua
onBeforePlay = function(src, dance)
    if dance.category == "gta-cayo" then
        return exports["meu_script"]:isVip(src)
    end

    return true
end,
```

Veja também [Hooks](https://docs.dkscripts.com.br/scripts/dances/dev/hooks.md#server): libere ou negue danças por jogador, categoria ou situação.

## O que o pacote traz e o que não traz

> **Dicionários que a build não tem**
>
> Dicionários que a build do servidor não tem (DLCs novas, com `sv_enforceGameBuild` antigo) **somem do menu sozinhos**. Nenhuma configuração é necessária.

> **Fora do pacote**
>
> O pacote **não traz** transições entre intensidades, intros e saídas, versões em primeira pessoa nem as danças de dentro de veículo (o menu bloqueia dançar dentro de veículo).

> **Objetos na mão**
>
> As danças com objeto na mão (bebida, celular, luz, cavalinho) **já saem com ele**. Veja [Objetos nas Danças](https://docs.dkscripts.com.br/scripts/dances/configs/props.md).

> **Uma dança sua com o mesmo id**
>
> Uma dança sua em `dances` com o mesmo `id` de uma do pacote **vence** a do pacote.

> **Miniaturas**
>
> As danças do pacote **não usam miniatura**: aparecem com as iniciais do nome.

Veja também [Catálogo de Danças](https://docs.dkscripts.com.br/scripts/dances/configs/catalog.md): cadastre as suas danças junto com as do pacote.


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