Comandos personalizados

Visão geral

Crie um comando que responde com um texto salvo ou um embed salvo, e que aceita todas as variáveis. Use para tudo que seu servidor repete: as regras, as redes, um abraço ou um dado. O membro escreve !nome e Petto responde no canal respondendo à mensagem.

chu escreve !hug @kira e Petto responde que chu dá um abraço quentinho em kira — No Discord: o comando hug dos exemplos, usado com outro membro.

Quer botões, formulários, reações ou dados salvos? Os comandos personalizados também podem ser escritos em código. Veja Petto Code. Prefere não escrever código? O Gerador de Petto Code monta o comando com formulários, deixa você testá-lo em um canal de teste e te dá o comando para colar.

Comandos

!customcommand add <name> <response> [embed_template]
!customcommand edit <name> <response> [embed_template]
!customcommand remove <name>
!customcommand list
!customcommand show <name>
!customcommand info <name>
!customcommand rename <name> <new name>

!customcommand add regras "Oi {user}! As regras estão fixadas em {channel}, leia, por favor 💛"
!customcommand add socials --embed_template socials-embed
!customcommand show regras
!customcommand rename regras regulamento

!regras  →  Oi @Liam! As regras estão fixadas em #geral, leia, por favor 💛

!customcommand add

liam adiciona rules com a resposta entre aspas e o Petto confirma e cita !customcommand vars — No Discord: !rules é criado.

!customcommand add (embed salvo)

liam adiciona socials com --embed_template socials e o Petto confirma — No Discord: um comando que envia o embed salvo socials.

!customcommand add (um nome que o Petto usa)

liam tenta adicionar rank e o Petto responde que rank já é um comando de verdade — No Discord: rank é um comando do Petto, então o nome é recusado.

!customcommand edit

liam edita rules com uma resposta nova e o Petto responde que foi atualizado — No Discord: !rules ganha um texto novo.

!customcommand remove

liam remove say e o Petto responde Removido — No Discord: !say é apagado.

!customcommand list

O Petto lista 6 de 125 comandos personalizados: 8ball, hug, roll, rules, say e socials com o tipo e o tamanho — No Discord: os comandos do servidor, por nome, com como começam e o tamanho.

!customcommand show

O Petto mostra rules e a resposta com {user} e {channel} — No Discord: a resposta salva de !rules, com as variáveis como foram escritas.

!customcommand info

A info de rules do Petto: tipo texto, começa com o prefixo do servidor, tamanho em caracteres — No Discord: o que é !rules: um comando de texto, como começa e o tamanho.

!customcommand rename

liam renomeia rules para rulebook e o Petto confirma e avisa que os botões antigos mantêm o nome antigo — No Discord: !rules agora é !rulebook.

!rules (o resultado)

Chillet digita !rules e o Petto responde Oi @Chillet, as regras estão fixadas no general — No Discord: um membro usa !rules e o Petto responde à mensagem.

Coloque a resposta entre “aspas” quando ela tiver espaços. Sem elas, só a primeira palavra vira a resposta e o resto é lido como o nome de um embed salvo.

!cc é o nome curto de !customcommand. Um nome que já é um comando do Petto (como rank) é recusado, e também um nome que outro comando personalizado já tem.

Argumentos

Tudo o que o membro digita depois do comando pode ser usado na resposta. Texto entre aspas conta como um só argumento, e as menções digitadas pelos membros nunca notificam ninguém nem causam menções em massa.

Variável	Para `!hug @Mia "agora mesmo" por favor`
`{args}`	@Mia “agora mesmo” por favor
`{arg1}`, `{arg2}`, `{arg3}` … `{arg10}`	@Mia, agora mesmo, por favor
`{args_from:2}`	agora mesmo por favor
`{arg_count}`	3
`{command_name}`	hug
`{prefix}`	!

!customcommand vars mostra essas variáveis e as flags de resposta no Discord. Quando a resposta usa um argumento e o membro não escreve nada depois do comando, o Petto pede o texto em vez de enviar uma resposta vazia.

O cartão do Petto com as variáveis dos comandos personalizados: args, arg1 a arg10, args_from, arg_count, command_name, prefix e a flag reactreply — No Discord: !customcommand vars, os argumentos, as variáveis e as flags de resposta.

Chillet digita só !say e o Petto responde que esse comando personalizado precisa de texto depois — No Discord: !say precisa de texto depois, então o Petto pede.

Exemplos

Command

!customcommand add hug "{user} dá um abraço apertado em {arg1} {choose:🤗|💞|🫂}"

Result

!hug @Mia  →  @Liam dá um abraço apertado em @Mia 🫂

Command

!customcommand add say "{args}"

Result

!say Bom dia, pessoal!  →  Bom dia, pessoal!

shi digita !say Bom dia pessoal e o Petto responde com as mesmas palavras — No Discord: !say repete o que vem depois.

Command

!customcommand add 8ball "🎱 **{args}**{newline}{choose:Sim.|Não.|Talvez.|Pergunte mais tarde.|Com certeza!}"

Result

!8ball vai chover hoje?
🎱 vai chover hoje?
Talvez.

for pergunta à bola 8 se vai chover hoje e o Petto responde com a pergunta e uma resposta ao acaso — No Discord: a pergunta em negrito e uma resposta escolhida ao acaso.

Command

!customcommand add roll "🎲 {user.display_name} tirou **{range:1-20}**"

Result

!roll  →  🎲 Liam tirou 17

chu digita !roll e o Petto responde que chu tirou um número — No Discord: um número de 1 a 20 para quem rola.

Command

!customcommand add server "**{server_name}**{newline}👥 {server_membercount} membros · 💎 {server_boostcount} boosts ({guild.boost_tier}){newline}📅 Criado em {server_createdate}"

Result

Petto Land
👥 1840 membros · 💎 9 boosts (Nível 2)
📅 Criado em 30/09/2024

kira digita !server e o Petto responde Petto Land, 1840 membros, 9 boosts, nível 2 e a data de criação — No Discord: o nome, os membros, os impulsos e a data de criação do Petto Land.

Command

!customcommand add vote "📊 {user} pergunta: **{args}** {reactreply:👍}{reactreply:👎}"

Result

!vote pizza hoje à noite?  →  📊 @Liam pergunta: pizza hoje à noite?
(com 👍 e 👎 adicionados como reações)

liam pergunta pizza hoje à noite e a resposta do Petto tem uma reação de joinha e outra de polegar para baixo — No Discord: a pergunta com as reações 👍 e 👎 para votar.

Os embeds salvos usados por um comando personalizado também podem usar tudo isso. A lista completa está na página Variáveis. Para qualquer coisa com condições (if), dados salvos ou botões, escreva o comando em Petto Code. Coloque um ! antes de uma menção em uma resposta (!@Cargo, !{user.mention}) para mostrá-la sem notificar ninguém: veja Menções silenciosas.

Texto simples ou embed

Se embed_template estiver definido, ele tem prioridade sobre response: o embed salvo é enviado no lugar do texto simples. Gerencie os modelos de embed na página Embeds do dashboard ou com !embed. Um comando personalizado pode usar só um modelo de embed, sem texto. Ao editar um comando, os campos que você não informar são mantidos.

shi digita !socials e o Petto responde com o embed Nossas redes com o site, YouTube e X — No Discord: !socials envia o embed salvo em vez de texto.

Limites

Um servidor Free pode ter 125 comandos personalizados e um servidor Premium, 250 (os comandos em código também contam). Veja Premium.

Dashboard

Os mesmos comandos estão em Automação → Comandos personalizados do dashboard: cada comando como um membro usaria e a resposta do Petto, um botão para apagar e um formulário para adicionar um com o texto ou um embed salvo. Os comandos escritos em código são editados em Comandos em código.

A seção Comandos personalizados, 8 de 125, com 8ball, hug, rank, roll, rules, socials, vote e whois (os em código dizem Escrito em código), e o formulário para adicionar — Dashboard → Automação → Comandos personalizados: cada comando como um membro usaria e a resposta do Petto, e o formulário para adicionar um.

Início

Guias

Conceitos

Moderação

Automação

Comunidade

Roleplay

Diversos

Boas-vindas

Configuração

Recursos

Problemas comuns

Novidades

Comandos personalizados

Visão geral

Comandos

Argumentos

Exemplos

Texto simples ou embed

Limites

Dashboard

​Visão geral

​Comandos

​Argumentos

​Exemplos

​Texto simples ou embed

​Limites

​Dashboard

Visão geral

Comandos

Argumentos

Exemplos

Texto simples ou embed

Limites

Dashboard