# Comandos

Todos os comandos de barra que o bot da cidade registra no Discord, com opções, quem pode usar e onde ligar cada um.

Source: https://fivedash.fivex.gg/docs/pt/discord/commands

O bot da cidade registra comandos de barra (`/`) no servidor do Discord escolhido na configuração. Alguns são para todo mundo, como `/status` e `/ip`; os outros são da equipe e só funcionam para os cargos que você libera no painel. Esta página lista todos, com cada opção, quem pode usar e em que página do painel eles são ajustados.

## Antes de começar

* O bot precisa estar conectado e com a configuração concluída. Veja [Bot](https://fivedash.fivex.gg/docs/pt/discord/bot).
* Os comandos são registrados só no servidor do Discord ligado ao bot. Em outro servidor, o bot responde "Este bot ainda não foi configurado para este servidor."
* Os nomes dos comandos e das opções são fixos e ficam sempre em português (é o que os membros digitam). As descrições aparecem no idioma da cidade.
* Nenhum nome de comando pode ser trocado no painel. O que você ajusta é se o comando está ligado e quais cargos podem usar.

## Resumo

| Comando              | Para que serve                                                        | Quem pode usar                                                       | Módulo                                                             | Plano |
| -------------------- | --------------------------------------------------------------------- | -------------------------------------------------------------------- | ------------------------------------------------------------------ | ----- |
| `/status`            | Mostra se o servidor está online e quantos jogadores estão conectados | Todos                                                                | —                                                                  | Todos |
| `/ip`                | Mostra como se conectar ao servidor                                   | Todos                                                                | —                                                                  | Todos |
| `/ban`               | Bane um membro do servidor                                            | Cargos de `/ban` ou Administrador                                    | [Moderação](https://fivedash.fivex.gg/docs/pt/discord/moderation)  | Todos |
| `/unban`             | Tira o banimento de alguém                                            | Os mesmos de `/ban`                                                  | [Moderação](https://fivedash.fivex.gg/docs/pt/discord/moderation)  | Todos |
| `/kick`              | Expulsa um membro do servidor (ele pode voltar pelo convite)          | Cargos de `/kick` ou Administrador                                   | [Moderação](https://fivedash.fivex.gg/docs/pt/discord/moderation)  | Todos |
| `/mute`              | Coloca um membro de castigo (não fala, não reage, não entra em call)  | Cargos de `/mute` ou Administrador                                   | [Moderação](https://fivedash.fivex.gg/docs/pt/discord/moderation)  | Todos |
| `/unmute`            | Tira um membro do castigo                                             | Os mesmos de `/mute`                                                 | [Moderação](https://fivedash.fivex.gg/docs/pt/discord/moderation)  | Todos |
| `/liberar`           | Libera um ID na cidade (equipe da whitelist)                          | Cargos do comando /liberar, Administrador ou Gerenciar servidor      | [Whitelist](https://fivedash.fivex.gg/docs/pt/discord/whitelist)   | Todos |
| `/remover`           | Tira a whitelist de um ID ou membro (equipe da whitelist)             | Os mesmos de `/liberar`                                              | [Whitelist](https://fivedash.fivex.gg/docs/pt/discord/whitelist)   | Todos |
| `/alinhar`           | Chama um membro para um alinhamento com a equipe                      | Cargos do alinhamento, Administrador ou Gerenciar servidor           | [Alinhamento](https://fivedash.fivex.gg/docs/pt/discord/alignment) | Pro   |
| `/alinhado`          | Marca o alinhamento de um membro como feito                           | Os mesmos de `/alinhar`                                              | [Alinhamento](https://fivedash.fivex.gg/docs/pt/discord/alignment) | Pro   |
| `/creator adicionar` | Coloca um streamer ou criador de vídeo no programa                    | Cargos de **Quem usa /creator**, Administrador ou Gerenciar servidor | [Creators](https://fivedash.fivex.gg/docs/pt/discord/creators)     | Pro   |
| `/creator remover`   | Tira o acesso de creator de um membro                                 | Os mesmos                                                            | [Creators](https://fivedash.fivex.gg/docs/pt/discord/creators)     | Pro   |
| `/creator nivel`     | Muda o nível de um creator                                            | Os mesmos                                                            | [Creators](https://fivedash.fivex.gg/docs/pt/discord/creators)     | Pro   |

> Todas as respostas dos comandos da equipe são privadas: só quem usou o comando vê. `/status` e `/ip` respondem no canal, para todo mundo ver.

## Comandos públicos

### /status

Mostra se o servidor FiveM está online, quantos jogadores estão conectados e o máximo de vagas. Quando o servidor tem código de conexão (cfx.re), a resposta traz um botão para entrar na cidade. Sem opções.

### /ip

Mostra como se conectar ao servidor, com o endereço e o botão de conexão quando há código cfx.re. Sem opções.

Os dois usam o endereço do servidor cadastrado no painel e a **Cor principal** e o **Pacote de emojis** da página [Bot](https://fivedash.fivex.gg/docs/pt/discord/bot).

## Moderação

Ligados por padrão. Cada um tem a chave **Ligar /ban** (e assim para cada comando) e o campo **Cargos que podem usar /ban** em **Discord → Moderação → Configurações**, no grupo **Comandos**. Quando você desliga `/ban`, o `/unban` sai junto; o mesmo vale para `/mute` e `/unmute`. Ao salvar, o painel atualiza os comandos no Discord ("Comandos atualizados no Discord").

**Quem pode usar:** quem tem um dos cargos escolhidos ou a permissão Administrador no servidor. Sem cargos escolhidos, só quem tem Administrador. Depois disso, o bot ainda confere:

* ninguém pune a si mesmo, o próprio bot nem o dono do servidor;
* membros em **Cargos protegidos** (ou na lista de protegidos) não podem ser punidos;
* o cargo mais alto de quem usa precisa estar acima do cargo mais alto do alvo (o dono do servidor passa sempre);
* o cargo do bot precisa estar acima do alvo;
* `/mute` não funciona em quem tem Administrador.

### /ban

| Opção              | Tipo            | Obrigatória | O que é                                                                                                                                                                 |
| ------------------ | --------------- | ----------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `membro`           | Membro          | Sim         | Quem vai ser banido (também aceita o ID).                                                                                                                               |
| `motivo`           | Texto (até 500) | Sim         | Por que (fica no registro e vai na DM).                                                                                                                                 |
| `prova`            | Anexo           | Não         | Print ou vídeo que comprova.                                                                                                                                            |
| `prova_2`          | Anexo           | Não         | Outra prova (opcional).                                                                                                                                                 |
| `prova_3`          | Anexo           | Não         | Outra prova (opcional).                                                                                                                                                 |
| `apagar_mensagens` | Escolha         | Não         | Apagar as mensagens recentes do membro: **Não apagar**, **Da última hora**, **Das últimas 6 horas**, **Do último dia**, **Dos últimos 3 dias**, **Dos últimos 7 dias**. |

### /unban

| Opção     | Tipo            | Obrigatória | O que é                             |
| --------- | --------------- | ----------- | ----------------------------------- |
| `usuario` | Membro          | Sim         | Quem vai ser desbanido (cole o ID). |
| `motivo`  | Texto (até 500) | Não         | Por que (fica no registro).         |

### /kick

| Opção                         | Tipo            | Obrigatória | O que é                                 |
| ----------------------------- | --------------- | ----------- | --------------------------------------- |
| `membro`                      | Membro          | Sim         | Quem vai ser expulso.                   |
| `motivo`                      | Texto (até 500) | Sim         | Por que (fica no registro e vai na DM). |
| `prova`, `prova_2`, `prova_3` | Anexo           | Não         | Até 3 provas.                           |

### /mute

| Opção                         | Tipo            | Obrigatória | O que é                                                                                                                                           |
| ----------------------------- | --------------- | ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------- |
| `membro`                      | Membro          | Sim         | Quem vai ficar de castigo.                                                                                                                        |
| `duracao`                     | Escolha         | Sim         | Por quanto tempo: 1 minuto, 5 minutos, 10 minutos, 30 minutos, 1 hora, 3 horas, 6 horas, 12 horas, 1 dia, 3 dias, 1 semana, 2 semanas ou 28 dias. |
| `motivo`                      | Texto (até 500) | Sim         | Por que (fica no registro e vai na DM).                                                                                                           |
| `prova`, `prova_2`, `prova_3` | Anexo           | Não         | Até 3 provas.                                                                                                                                     |

### /unmute

| Opção    | Tipo            | Obrigatória | O que é                     |
| -------- | --------------- | ----------- | --------------------------- |
| `membro` | Membro          | Sim         | Quem sai do castigo.        |
| `motivo` | Texto (até 500) | Não         | Por que (fica no registro). |

## Whitelist

`/liberar` e `/remover` ficam sempre registrados, mas só funcionam depois que a whitelist estiver configurada. Os cargos ficam em **Discord → Whitelist**, no bloco **Comando /liberar**, campo **Cargos que podem usar /liberar**.

**Quem pode usar:** quem tem um desses cargos, Administrador ou a permissão Gerenciar servidor. Sem cargos escolhidos, só administradores e quem gerencia o servidor.

### /liberar

| Opção    | Tipo           | Obrigatória | O que é                                                                   |
| -------- | -------------- | ----------- | ------------------------------------------------------------------------- |
| `id`     | Texto (até 12) | Não         | O ID (ou token) do jogo; onde a liberação é pelo Discord, basta o membro. |
| `membro` | Membro         | Não         | Quem recebe o cargo de liberado.                                          |

Com `membro`, o bot também dá o cargo de liberado e passa a tirar a whitelist se a pessoa sair do Discord.

### /remover

| Opção    | Tipo           | Obrigatória | O que é                                       |
| -------- | -------------- | ----------- | --------------------------------------------- |
| `id`     | Texto (até 12) | Não         | O ID (ou token) do jogo.                      |
| `membro` | Membro         | Não         | Quem perde a whitelist e o cargo de liberado. |

Informe pelo menos um dos dois.

## Alinhamento

Disponível a partir do plano **Pro**. O alinhamento começa desligado: ligue em **Discord → Alinhamento** (**Ligar o alinhamento**). Com ele desligado, o bot responde "O alinhamento está desligado no painel." Os cargos ficam em **Cargos que podem usar /alinhar**; o prazo padrão, em **Prazo padrão** (2 horas, se você não mudar).

**Quem pode usar:** quem tem um desses cargos, Administrador ou Gerenciar servidor. Sem cargos escolhidos, só administradores e quem gerencia o servidor. Membros em **Cargos protegidos do alinhamento** não podem ser chamados.

### /alinhar

| Opção    | Tipo            | Obrigatória | O que é                                                                                                                                                                                         |
| -------- | --------------- | ----------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `membro` | Membro          | Sim         | Quem vai ser chamado.                                                                                                                                                                           |
| `motivo` | Texto (até 500) | Não         | Por que (opcional, vai no aviso e na DM).                                                                                                                                                       |
| `prazo`  | Escolha         | Não         | Quanto tempo o membro tem para aparecer: 15 minutos, 30 minutos, 1 hora, 2 horas, 3 horas, 6 horas, 12 horas, 1 dia, 2 dias, 3 dias ou 7 dias. Sem escolher, vale o **Prazo padrão** do painel. |

### /alinhado

| Opção    | Tipo   | Obrigatória | O que é               |
| -------- | ------ | ----------- | --------------------- |
| `membro` | Membro | Sim         | Quem já foi alinhado. |

## Creators

Disponível a partir do plano **Pro**. Com o programa desligado, o bot responde "O programa de creators está desligado no painel." Os cargos ficam em **Discord → Creators**, campo **Quem usa /creator**.

**Quem pode usar:** quem tem um desses cargos, Administrador ou Gerenciar servidor. Sem cargos escolhidos, só administradores e quem gerencia o servidor.

`/creator` tem três subcomandos. A opção `nivel` sugere os níveis criados no painel enquanto você digita.

### /creator adicionar

| Opção    | Tipo                  | Obrigatória | O que é                                        |
| -------- | --------------------- | ----------- | ---------------------------------------------- |
| `membro` | Membro                | Sim         | Quem entra no programa.                        |
| `nivel`  | Texto (com sugestões) | Não         | O nível do creator (sem escolher, o primeiro). |
| `canal`  | Texto (até 300)       | Não         | Link do canal (Twitch, YouTube, TikTok…).      |

### /creator remover

| Opção    | Tipo            | Obrigatória | O que é               |
| -------- | --------------- | ----------- | --------------------- |
| `membro` | Membro          | Sim         | Quem sai do programa. |
| `motivo` | Texto (até 500) | Não         | Por que (vai na DM).  |

### /creator nivel

| Opção    | Tipo                  | Obrigatória | O que é             |
| -------- | --------------------- | ----------- | ------------------- |
| `membro` | Membro                | Sim         | O creator.          |
| `nivel`  | Texto (com sugestões) | Sim         | O nível do creator. |

## Quando os comandos mudam

* O bot registra os comandos ao concluir a configuração e confere de novo a cada **Verificar conexão** na visão geral.
* Ligar ou desligar `/ban`, `/kick` ou `/mute` em **Moderação** registra ou tira os comandos no Discord ao salvar. Se o Discord não responder, o painel mostra "Salvo, mas os comandos não mudaram no Discord"; abra a visão geral do bot e clique em **Verificar conexão**.
* Quando o FiveDash atualiza os comandos, todos os bots recebem a versão nova sozinhos.
* Se aparecer "Esse comando não existe mais. Ele some do Discord em instantes.", o Discord ainda mostra um comando antigo. Ele some sozinho em instantes.

## Perguntas frequentes

**Um moderador usou /ban e recebeu "Você não tem um dos cargos que podem usar /ban". O que fazer?**
Adicione o cargo dele em **Discord → Moderação → Configurações**, no campo **Cargos que podem usar /ban**, e salve.

**Os comandos não aparecem no Discord.**
Abra **Discord → Visão geral** e clique em **Verificar conexão**. Se a linha de comandos falhar, use **Adicionar de novo** para autorizar o bot outra vez com a permissão de comandos.

**Por que `/alinhar` e `/creator` aparecem se meu plano é Plus?**
Eles ficam registrados em todos os bots, mas só funcionam com o módulo ligado, e Alinhamento e Creators abrem a partir do plano Pro.

## Próximos passos

[Moderação](https://fivedash.fivex.gg/docs/pt/discord/moderation)Ligue /ban, /kick e /mute e escolha os cargos.
[Whitelist](https://fivedash.fivex.gg/docs/pt/discord/whitelist)Configure a liberação e o /liberar.
[Alinhamento](https://fivedash.fivex.gg/docs/pt/discord/alignment)Chame membros para conversar com prazo.
[Creators](https://fivedash.fivex.gg/docs/pt/discord/creators)Monte o programa de creators da cidade.
