Wiki / Reference / Comandos de texto e o prefixo

Comandos de texto e o prefixo

Atualizado por Maxime_48 · há 3 horas · Visualizações: 116

Idiomas: English Français Deutsch Español Português (Brasil) Italiano Nederlands Polski Türkçe Русский 日本語 한국어 中文

Por padrão, o YAWBDB responde apenas a comandos de barra. Se os seus membros preferem digitar !rank em vez de /rank, defina um prefixo e parte do bot passa a ser acessível a partir de uma mensagem normal.

Esta página é a lista completa do que o prefixo alcança e do que não alcança, e, para cada exclusão, o motivo pelo qual ela não pode ser removida.


⚙️ Definindo o prefixo

Painel → seu servidor → Recursos, no cartão Comandos de texto no topo da página.

Onde fica No próprio servidor, e não em um recurso: assim você o encontra esteja ou não ativado o recurso de Comandos personalizados.
O que aceita De 1 a 5 caracteres, sem espaços. ! ? . - $ ; % funcionam, e também !!, uma palavra curta como yb ou um emoji.
O que recusa / (o Discord é dono dele), @ e # e < (uma mensagem que começa com eles é uma menção ou um link de canal), > (abre um bloco de citação), ` (abre um bloco de código).
Para desativar Esvazie o campo e salve. Os comandos de texto param imediatamente.
Padrão Vazio. Nada muda no seu servidor até você definir um.

As mudanças chegam ao bot na hora: não há espera nem reinicialização.

Um prefixo em forma de palavra pega mais do que você imagina. Com o prefixo yb, toda mensagem que começa com essas duas letras é examinada. Ele continua em silêncio a menos que o restante nomeie um comando real, mas um prefixo de pontuação é o hábito mais seguro.


✅ O que funciona com o prefixo

Supondo o prefixo !:

Os seus próprios comandos personalizados

Digitado Equivale a
!rules /rules
qualquer comando que você criou na página Comandos personalizados a versão de barra dele

Tanto os comandos personalizados simples quanto os em modo gráfico funcionam. Esse é o principal motivo de o prefixo existir.

Jogos

Digitado Observações
!hangman As letras continuam sendo escolhidas no menu suspenso.
!trivia Os botões funcionam exatamente como a partir de um comando de barra.
!rps [choice] [opponent] !rps rock, !rps @someone, ou os dois em qualquer ordem.
!love <member> [other] O segundo membro é você por padrão.
!8ball <question> Tudo o que vem depois do comando é a pergunta.
!bingo start / !bingo stop

Níveis e estatísticas

Digitado Observações
!rank [@user]
!leaderboard [page]
!top
!boosters A resposta é excluída depois de 30 segundos (veja abaixo).
!trends <type> messages, members ou activity.

Aniversários, sugestões e o seu próprio histórico de moderação

Digitado Observações
!birthday set <day> <month> [year] !birthday set 14 7 ou !birthday set 14 July 1990. O dia vai de 1 a 31, o mês é de 1 a 12 ou o nome dele em inglês, e o ano é opcional.
!birthday get [@user] Por padrão, você.
!birthday next [count] De 1 a 25 próximos aniversários, 10 por padrão.
!birthday remove / !birthday forget Para de anunciar aqui, ou exclui em todo lugar.
!suggest <suggestion> Tudo o que vem depois do comando é a sugestão, até 2000 caracteres.
!my-history Os seus próprios registros de moderação neste servidor.

Eles seguem as mesmas configurações das versões de barra: os recursos Aniversários e Sugestões precisam estar ativados no servidor, o canal de sugestões precisa estar definido, e o bloqueio e o tempo de espera de alteração do aniversário valem sem mudança.

Qualquer outra coisa só é tentada como um dos seus comandos personalizados. Uma mensagem que começa com o prefixo e não nomeia nada não recebe nenhuma resposta: sem erro, sem barulho.

Se você errar uma opção, o bot responde com a linha que você deveria ter digitado, por exemplo Usage: !bingo <start|stop>.


🚫 O que o prefixo não alcança, e por quê

Quatorze dos trinta e dois comandos do bot respondem a texto. Os outros dezoito estão agrupados abaixo pelo motivo de não responderem.

As configurações de permissão do Discord decidem quem pode executá-los

/ban, /unban, /mute, /unmute, /kick, /warn, /softban, /history, /clear-history, /reason, /info.

Eles continuam somente de barra de propósito. Um comando de barra traz uma exigência de permissão que o próprio Discord aplica, e um servidor pode restringi-la ainda mais em Server Settings → Integrations → YAWBDB, por comando, por cargo e por canal. Uma mensagem de texto não passa por nada disso. Expor !ban entregaria a todos, em silêncio, um jeito de contornar as restrições que você definiu no Discord, então ele não é exposto.

Use as versões de barra; as próprias páginas de moderação do painel também continuam disponíveis.

Eles abrem uma janela pop-up, o que uma mensagem não consegue

/form, /wordle play.

O Discord só deixa um bot abrir um formulário em resposta a uma interação (um comando de barra, um botão, um menu). Uma mensagem não é uma interação, então não há formulário para abrir. Isso é uma limitação do Discord, não uma configuração do YAWBDB.

Eles devem permanecer discretos

/report, /ticket.

Uma mensagem é lida pelo canal inteiro. Denunciar alguém, ou abrir um ticket, na frente de todo mundo não é o mesmo ato de fazê-lo em privado, então eles ficam onde a resposta pode ser privada.

Eles precisam de um contexto de voz ou de opções que uma mensagem não consegue transportar

/voice, /voice-chat, /record, /record-storage.

Eles agem sobre o canal de voz em que você está conectado, e alguns respondem com listas ou gravações privadas. Uma mensagem digitada não tem nem o seu contexto de voz nem essas opções, então eles continuam somente de barra por projeto. Se você digitar um com o prefixo, por exemplo !voice, o bot responde com o motivo e indica a versão de barra em vez de ficar em silêncio.

Mais um, fora da lista

A ação de clique direito Save Message também é somente de barra: uma ação de menu de contexto não tem equivalente em texto por construção.


📌 Duas diferenças a esperar

As respostas são públicas. Um comando de barra pode responder em privado, de modo que só você a veja. A resposta a uma mensagem não pode. Onde um comando normalmente responderia em privado (!boosters, !birthday, !suggest, !my-history, um comando personalizado que você definiu como efêmero, um aviso de tempo de espera), o bot responde no canal e exclui a resposta depois de 30 segundos. Isso mantém o canal limpo; não torna a resposta secreta. Essas respostas privadas nunca mencionam ninguém, então listar membros com !birthday next não menciona ninguém. A mensagem que você digitou continua no canal, então evite colocar um ano de nascimento nela se preferir não mostrá-lo.

Mensagens de comando não rendem XP. Uma mensagem que executa um comando é um comando, não conversa, então não conta para os níveis. Ela continua sendo verificada pelo Automod e pelo Honeypot, exatamente como qualquer outra mensagem.


🔗 Veja também