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

# Configuração de Animações

# Personalizando as Animações do Script

Através do arquivo de configuração `config.lua`, localizado em:

<Note>
  📁 dk\_animations > config > shared > config.lua
</Note>

você pode ativar, desativar, editar comandos, descrições e definir as condições de ativação de **todas** as animações do script **dk\_animations**.

***

## Estrutura da Tabela `Config.animsList`

Cada animação é representada por um objeto individual com opções que controlam seu comportamento.

### Exemplo de uma animação configurada:

```lua theme={null}
[1] = {
  actived = true,
  command = "segurar",
  description = "Segurar",
  request = true,
  source = {
    forceAnim = true,
    blockVeh = true,
    blockFalling = false,
    blockButtons = true
  },
  target = {
    forceAnim = true,
    blockVeh = true
  }
}
```

***

## Parâmetros Disponíveis

### 🔘 `actived`

Habilita ou desabilita a animação.

```lua theme={null}
actived = true
```

### 💬 `command`

Comando que o jogador deve digitar para executar a animação.

```lua theme={null}
command = "segurar"
```

### 📝 `description`

Descrição da animação — exibida para o player no sistema de request.

```lua theme={null}
description = "Segurar"
```

### 🤝 `request`

Define se a animação exigirá aprovação do outro jogador.

```lua theme={null}
request = true
```

***

## Parâmetros `source` e `target`

Esses objetos representam as configurações individuais para quem **inicia** e quem **recebe** a animação, respectivamente.

### ⚙️ `source` ou `target`

Você pode definir os seguintes parâmetros dentro de ambos:

| Propriedade       | Função                                                               |
| ----------------- | -------------------------------------------------------------------- |
| `forceAnim`       | Impede o cancelamento da animação por ESC, movimentação etc.         |
| `blockVeh`        | Impede a animação se o player estiver dentro de um veículo           |
| `blockFalling`    | Impede a animação se o player estiver caindo (somente em `source`)   |
| `blockButtons`    | Desativa botões enquanto a animação estiver ativa                    |
| `blockedToRun`    | Impede que o player corra durante a animação                         |
| `blockedToStop`   | Impede que o target pare a animação por conta própria                |
| `requiredAnim`    | Define uma animação obrigatória para o target estar executando       |
| `customVariation` | Define uma variação personalizada da animação (ex: diferentes poses) |

***

## 🎛️ Condições Customizadas (Avançado)

Você pode adicionar funções personalizadas para limitar quando uma animação pode ser executada ou se um request pode ser feito:

```lua theme={null}
condition = function(source, target)
  return GetEntityHealth(GetPlayerPed(source)) > 101 and GetEntityHealth(GetPlayerPed(target)) > 101
end
```

<Warning>
  A função `condition` precisa retornar `true` para permitir a execução da animação.
</Warning>

***

## 🔐 Animações Exclusivas

As animações de `lapdance` só estarão disponíveis para quem possui o script de lapdance instalado. Essas animações estão sinalizadas com:

```lua theme={null}
command = "lapdance",
description = "Lapdance 1 (com toque)",
```