> ## Documentation Index
> Fetch the complete documentation index at: https://rust-co.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Slots por cargo do Discord

> Associe cargos do Discord a totais de character slots no RCO Creator.

Use isso quando VIP/supporter/staff deve receber um total diferente de slots.

## Você precisa de

* servidor Discord;
* bot/application no Developer Portal;
* Guild ID;
* IDs dos cargos;
* bot token guardado só no `config/server.lua`.

## 1. Developer Mode

Ative Developer Mode no Discord para copiar Server ID e Role IDs.

## 2. Bot

Crie uma application/bot no Discord Developer Portal, copie o token e convide o bot para seu servidor.

<Warning>
  Bot token é senha. Nunca coloque em client config, GitHub, screenshot ou ticket. Vazou? Reset Token imediatamente.
</Warning>

## 3. Config

```lua theme={"dark"}
CreatorServerConfig.Discord = {
    enabled = true,
    guildId = '123456789012345678',
    botToken = 'YOUR_BOT_TOKEN',
    defaultSlots = 1,
    cacheSeconds = 600,
    timeoutMs = 8000,
    roleSlots = {
        ['987654321098765432'] = 3,
        ['876543210987654321'] = 5,
    },
}
```

Os números são **slots totais**. Cargos não devem ser somados como bônus; o maior total aplicável vence.

## 4. Teste

Dê a si mesmo um cargo mapeado, reinicie o Creator e confirme o número de slots. Depois teste troca de cargo considerando cache/reconnect.

## Problemas comuns

| Sintoma                  | Verifique                                  |
| ------------------------ | ------------------------------------------ |
| resource não inicia      | guildId/token vazio ou inválido            |
| todos recebem default    | bot/guild ID/lookup                        |
| um player recebe default | Discord não vinculado ou não está no guild |
| cargo não muda           | Role ID errado ou cache                    |