Criar um comando personalizado com a Nekotina

Os comandos personalizados permitem que a Nekotina responda às palavras-gatilho do seu servidor com mensagens, embeds e muito mais. Neste guia você vai criar o happybirthday, um comando para desejar feliz aniversário a um membro com um embed e um GIF.

Se o prefixo do seu servidor for ! (padrão da Nekotina), o uso fica assim:

!happybirthday @Kwee

Neste exemplo, Gwee executa o comando e Kwee recebe os parabéns.

Pré-requisitos

Antes de começar, confira se:

1. Você tem acesso ao dashboard da Nekotina com permissões de administrador no servidor.
2. Você sabe o prefixo de comandos do seu servidor (padrão ! na Nekotina; também pode ser -, ? etc.).
3. A Nekotina pode enviar mensagens e inserir links no canal onde você vai testar o comando.
4. Você tem um GIF pronto para enviar (formato GIF, PNG, JPG ou WEBP).

É assim que a resposta final ficará quando Gwee desejar feliz aniversário a Kwee:

Passo 1 — Criar o comando

1. Abra o dashboard e selecione seu servidor.
2. Vá em Utilidades → Comandos personalizados.
3. Clique em Criar comando e escolha Começar do zero.
4. Na etapa Comando, digite a palavra-gatilho:

happybirthday

5. Adicione uma descrição opcional, por exemplo: Desejar feliz aniversário a um membro do servidor.
6. Você pode usar o modo básico do editor; é suficiente para este tutorial.

Passo 2 — Adicionar o argumento de membro

O comando precisa saber quem parabenizar. Adicione um argumento do tipo Membro:

1. Na etapa Argumentos (modo avançado) ou durante a configuração do comando, clique em Adicionar argumento.
2. Configure o argumento:

Como os argumentos funcionam nas mensagens

Quando alguém digita !happybirthday @Kwee, o Discord divide o comando em partes:

A Nekotina não adivinha a quem você se refere: você define quais dados o comando espera (um membro, um número, texto…) e o usuário informa depois do nome do comando. Esse valor fica armazenado com o nome que você deu ao argumento.

Para usar esse valor dentro da mensagem ou do embed, escreva uma variável neste formato:

{{arg.nome-do-argumento}}

No nosso caso o argumento se chama target, então a variável é:

{{arg.target}}

Regras importantes:

• O texto depois de arg. deve corresponder ao nome do argumento exatamente. Se você nomeou target, escreva {{arg.target}}; se nomear birthdayMember, seria {{arg.birthdayMember}}.
• Se o nome não corresponder, a Nekotina não consegue substituir a variável e a mensagem pode mostrar o texto literal ou falhar.
• Argumentos do tipo Membro podem ser usados como menção (@Kwee) ou, com outras variáveis, como avatar ({{arg.target.avatar}}).
• Se você adicionar mais de um argumento, eles são lidos em ordem. Por exemplo, !happybirthday @Kwee preenche o primeiro argumento; um segundo argumento viria depois.

Exemplo de como configuração e mensagem se encaixam:

Quando Gwee executa !happybirthday @Kwee, a Nekotina substitui:

• {{user.mention}} → menção de Gwee (quem executou o comando)
• {{arg.target}} → menção de Kwee (o membro que Gwee especificou)

Uso no Discord:

!happybirthday @Kwee

Passo 3 — Configurar a ação Enviar mensagem

1. Vá para a etapa Ações.
2. Adicione uma ação Enviar mensagem (responde no mesmo canal onde o comando foi usado).
3. Clique em Adicionar à mensagem e selecione Embeds.

É assim que o embed fica antes de adicionar o GIF:

Passo 4 — Configurar o embed

No editor de embed, preencha os campos principais:

Variáveis úteis:

Em Configurações da mensagem, ative Menções de usuário para o Discord resolver menções no embed corretamente.

Passo 5 — Acesso e cooldown (opcional)

Na etapa Acesso você pode ajustar quem usa o comando e com que frequência:

Se você não definir restrições, qualquer membro pode usar o comando em qualquer canal onde o bot tenha permissão de escrever.

Passo 6 — Salvar e testar

1. Revise a etapa Resumo do editor.
2. Clique em Salvar.
3. No Discord, execute o comando com um membro real:

!happybirthday @Kwee

A Nekotina publicará o embed com o GIF no canal. Se Gwee executar, a descrição mostrará as duas menções.

Limites a considerar

Com Premium você pode encadear várias ações (por exemplo, dar um cargo de aniversário além da mensagem). No plano grátis, a ação Enviar mensagem é suficiente para este tutorial.

Dicas

• Use um GIF otimizado (arquivo pequeno) para carregar rápido no Discord.
• O nome do argumento (target) deve corresponder ao que você escreve em {{arg.target}}.
• Não inclua o prefixo na palavra-gatilho: escreva happybirthday, não !happybirthday.
• Você pode duplicar o comando e trocar o GIF para variantes como happybirthday-vip.

Problemas comuns

Ir além

Se você ativar o modo avançado, pode adicionar vários embeds e escolher Enviar um embed aleatório para a Nekotina mostrar uma mensagem de aniversário diferente a cada vez (semelhante ao template Comfort no dashboard). Você também pode usar variáveis computadas para escolher frases aleatórias.

Resumo do fluxo

1. Criar comando → Palavra-gatilho happybirthday
2. Adicionar argumento → target (Membro)
3. Ação → Enviar mensagem com embed
4. Embed → Descrição com variáveis + cor + GIF
5. Salvar → Testar com !happybirthday @Kwee

Pronto! Agora você tem um comando personalizado de aniversário no seu servidor com a Nekotina.