> ## 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ções Compartilhadas

> Idioma, categorias, compartilhar, miniaturas e as opções que valem para client e server

Arquivo: `config/shared/config.lua`

> [!WARNING]
>
> **Este arquivo é enviado ao jogador.** Nunca ponha nele webhook, token, senha ou qualquer segredo. Isso vale também para `config/client`. O que precisa ficar escondido vai em `config/server`.

## Visão geral

| Opção | Padrão | O que faz |
| - | - | - |
| `locale` | `"pt-br"` | Idioma dos textos: `"pt-br"` ou `"en"` |
| `remote` | — | Carregamento remoto das danças exclusivas e sincronia. Veja [Carregamento remoto e sincronia](https://docs.dkscripts.com.br/scripts/dances/configs/remote-sync.md) |
| `share` | — | Liga e desliga o compartilhar |
| `thumbnails` | — | Pasta e extensão das miniaturas. Veja [Catálogo](https://docs.dkscripts.com.br/scripts/dances/configs/catalog.md#miniaturas) |
| `gta` | — | O pacote de danças do jogo base. Veja [Danças do jogo base](https://docs.dkscripts.com.br/scripts/dances/configs/gta-pack.md) |
| `categories` | `party`, `solo` | Categorias exibidas como filtro |
| `dances` | uma dança de exemplo | O catálogo. Veja [Catálogo](https://docs.dkscripts.com.br/scripts/dances/configs/catalog.md) |

Mudanças aqui só valem **depois de reiniciar o recurso**.

## Idioma

```lua theme={null}
locale = "pt-br",
```

`"pt-br"` ou `"en"`. O `pt-br` é **sempre carregado primeiro como reserva** e o idioma escolhido é mesclado por cima: uma chave que faltar no idioma escolhido aparece em português, nunca como texto cru.

Os textos ficam em `locales/<idioma>/`:

| Arquivo | Conteúdo |
| - | - |
| `game.lua` | Avisos e mensagens vistos no jogo (bloqueios, cooldown, compartilhar) |
| `ui.lua` | Textos da interface (menu, filtros, botões, categorias do GTA) |
| `shared.lua` | Textos usados nos dois lados |

O `label` das **suas** categorias e das suas danças é o texto que você escreve no config, sem tradução automática. Os rótulos das categorias do pacote do GTA seguem o idioma.

## Compartilhar

```lua theme={null}
share = {
    enabled = true,
},
```

`false` esconde o botão de compartilhar e o servidor recusa o pedido. A distância, o tempo do convite e a espera ficam em `config/server`.

Veja também [Compartilhar uma Dança](https://docs.dkscripts.com.br/scripts/dances/usage/sharing.md): como o convite funciona e as opções do servidor.

## Categorias

```lua theme={null}
categories = {
    {
        id = "party",
        label = "Festa",
    },
    {
        id = "solo",
        label = "Solo",
    },
},
```

| Campo | Função |
| - | - |
| `id` | Identificador usado pela dança em `category` |
| `label` | Texto mostrado no filtro |

* Deixe a lista **vazia** (e as danças sem `category`) para esconder o filtro de categorias
* As categorias do pacote do GTA são **somadas às suas** automaticamente, depois delas
* Uma categoria inválida ou com `id` repetido é ignorada, e o console avisa
* Uma dança que aponta para uma categoria que não existe é **recusada**

## Carregamento remoto, miniaturas, GTA e catálogo

> **[Carregamento remoto e sincronia](https://docs.dkscripts.com.br/scripts/dances/configs/remote-sync.md)**
>
> De onde vêm os `.ycd` e como os jogadores veem a dança uns dos outros.

> **[Catálogo](https://docs.dkscripts.com.br/scripts/dances/configs/catalog.md)**
>
> Os campos de cada dança, as regras dos ids e as miniaturas.

> **[Danças do jogo base](https://docs.dkscripts.com.br/scripts/dances/configs/gta-pack.md)**
>
> Ligar, desligar e esconder categorias do pacote do GTA.

> **[Injetar animações](https://docs.dkscripts.com.br/scripts/dances/dev/inject.md)**
>
> Animações de outros recursos entram no menu sem editar `dances`.


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