Os membros registram o aniversário uma única vez com /birthday set, e o bot os parabeniza no dia, no canal que você escolher, com um cargo de aniversário temporário opcional.
🎂 Como funciona
- Ative Aniversários e abra a página Aniversários.
- Escolha um canal de anúncios, um horário e um fuso horário. Nada é anunciado enquanto não houver um canal definido.
- Componha a mensagem. Peça aos seus membros que usem
/birthday set.
No dia, o bot publica o seu anúncio, atribui o cargo de aniversário se você configurou um e o retira quando a duração termina.
🗓️ Um aniversário, todos os servidores
Com um prefixo de texto definido, as mesmas ações funcionam a partir de uma mensagem normal, por exemplo !birthday set 14 July. Veja Comandos de texto e o prefixo.
A data de um membro é guardada uma única vez para a conta do Discord dele, e não uma vez por servidor. Quem já registrou o aniversário em outro servidor que usa o YAWBDB não digita nada: executar /birthday set aqui apenas o inscreve.
Isso significa que:
- Ninguém precisa digitar a mesma data de novo em cinco servidores diferentes.
/birthday removecancela a inscrição somente neste servidor. A data continua salva para os outros./birthday forgetexclui o registro em todo lugar, em todos os servidores. Isso sempre funciona, mesmo que um servidor tenha o recurso desativado.
Ninguém vê o aniversário de um membro em um servidor no qual ele não se inscreveu.
⌨️ Comandos dos membros
| Comando | O que faz |
|---|---|
/birthday set |
Salva a data. Dia, mês e um ano de nascimento opcional. |
/birthday get |
Mostra o seu aniversário, ou o de outro membro se ele se inscreveu aqui. |
/birthday next |
Lista os próximos aniversários neste servidor. |
/birthday remove |
Deixa de anunciar o seu aniversário neste servidor. |
/birthday forget |
Exclui o seu aniversário do YAWBDB por completo. |
Toda resposta é privada: só quem executou o comando a vê. O anúncio no dia é a única coisa que fica pública.
O ano de nascimento é opcional e só é usado para mostrar uma idade. Um membro que não o informa simplesmente nunca terá a idade exibida.
💻 Definindo pelo painel
Um membro também pode definir ou remover o próprio aniversário no seu perfil do painel, sem tocar no Discord, desde que a conta do Discord esteja vinculada à conta do painel, pois é esse vínculo que diz ao painel qual aniversário é o dele.
Valem as mesmas regras do /birthday set: dia, mês e um ano opcional, e o mesmo bloqueio de 30 dias depois de uma alteração. É a data da conta inteira, não presa a um servidor específico: exatamente como o registro que o /birthday set grava, só que lhe dá uma tela em vez de um comando de barra.
⚙️ Configurações
| Configuração | O que faz |
|---|---|
| Canal de anúncios | Onde a mensagem é publicada. Obrigatório. |
| Anunciar às / Fuso horário | O horário local em que os aniversários do dia são enviados. A janela fica aberta por duas horas depois desse horário. |
| Cargo a mencionar | Mencionado junto com o anúncio. Opcional. |
| Cargo de aniversário | Atribuído no dia e removido automaticamente. Opcional. |
| Duração do cargo (horas) | Por quantas horas o cargo de aniversário é mantido, de 1 a 168 (uma semana). |
| Dias mínimos no servidor | Um membro que entrou há menos tempo que isso é ignorado no ano. |
| Agrupar acima de | Acima desse número de aniversários no mesmo dia, eles saem em uma única mensagem em vez de várias. |
| Mostrar a idade | Exibe a idade, somente para os membros que informaram o ano de nascimento por vontade própria. |
| Parabenizar também por mensagem privada | Envia ao membro anunciado a mesma mensagem por DM, sem a menção ao cargo. Os membros que fecharam as DMs simplesmente veem a publicação no canal, como todo mundo. |
Por que a janela de duas horas? Os anúncios do dia só saem entre o horário escolhido e duas horas depois. Fora dela, nada é publicado: assim, um membro que define a data como "hoje" à noite espera até o ano seguinte em vez de provocar uma menção instantânea.
✍️ Escrevendo o anúncio
A mensagem é composta com o mesmo editor do Criador de embeds: uma linha de texto simples em cima, um embed completo embaixo e uma prévia ao vivo à direita.
Estes marcadores funcionam no texto e em qualquer lugar do embed: título, descrição, campos, rodapé:
| Marcador | Vira |
|---|---|
{mention} |
Uma menção ao membro, ou a todos eles em uma mensagem agrupada |
{user} |
O mesmo que {mention} |
{age} |
A idade que a pessoa está completando. Vazio em uma mensagem agrupada, e vazio se ela não informou o ano de nascimento ou se Mostrar a idade está desativado |
{count} |
Quantos membros estão sendo celebrados |
Se você deixar a mensagem e o embed vazios, o bot recorre a um simples "🎂 Happy birthday @member!" em vez de não publicar nada no aniversário de alguém.
Os anúncios nunca mencionam @everyone nem @here.
🛡️ Ninguém consegue abusar dos holofotes
Os anúncios de aniversário são uma menção em um canal público, então vale a pena tentar abusar deles. Várias coisas impedem isso:
- Uma vez por ano, por servidor. Por mais vezes que um membro reescreva a data, ele é anunciado no máximo uma vez por ano civil em um dado servidor. Cancelar a inscrição e voltar não zera isso.
- O comando nunca anuncia nada. Somente a verificação agendada publica, então definir a data como hoje não dispara uma mensagem.
- As alterações têm limite de frequência. O primeiro salvamento é livre, porque as pessoas erram ao digitar. Alterar a data depois disso a bloqueia por 30 dias.
- Tempo mínimo no servidor. Defina-o para que contas recém-criadas não possam entrar, reivindicar o dia de hoje e receber uma menção.
- A janela de duas horas descrita acima.
Se um membro realmente errou a data e agora está bloqueado, a equipe pode remover o bloqueio na página Aniversários.
🧑💼 O lado do painel
A página Aniversários lista todos os que se inscreveram, ordenados por quão perto está o aniversário, com um selo para os membros bloqueados ou já anunciados no ano.
- Desbloquear - remove a espera de 30 dias para alterações de um membro que cometeu um erro genuíno.
- Remover - exclui o aniversário desse membro somente deste servidor. O registro dele em outros servidores não é tocado.
🏆 Aniversários e Níveis
Se os Níveis estiverem ativados, o Gráfico de recompensas ganha um gatilho No aniversário. Ele dispara uma vez por ano para cada membro, logo depois que o anúncio sai.
Encadeie-o a qualquer ação: conceder XP de bônus, dar um multiplicador de XP pessoal para o dia, atribuir um cargo, enviar uma DM. Como todo gatilho entre recursos, o nó fica bloqueado na paleta até que os Aniversários sejam ativados.
✅ Permissões
Os Aniversários precisam das permissões básicas do bot (View Channels, Send Messages, Embed Links) no canal de anúncios, e também de Manage Roles se você usar um cargo de aniversário. Veja Permissões dos recursos.
O cargo do bot precisa ficar acima do cargo de aniversário em Server Settings → Roles, caso contrário o Discord se recusa a atribuí-lo.
Para mencionar um cargo, torne esse cargo mencionável ou conceda ao bot a permissão Mention @everyone, @here, and All Roles.
💡 Boas práticas
- Escolha um horário em que o seu servidor esteja de fato acordado: um anúncio às 03:00 é um anúncio desperdiçado.
- Deixe Dias mínimos no servidor em uma semana ou mais em servidores públicos.
- Mantenha Mostrar a idade desativado, a menos que a sua comunidade realmente queira; muita gente compartilha o dia e o mês, mas não o ano.
- Use o limite de agrupamento: em um servidor grande, cinco menções seguidas parecem spam, e uma mensagem com cinco menções parece uma comemoração.
❓ Nada foi anunciado
- Há um canal definido, e o bot consegue publicar e incluir links de embed ali?
- O horário de anúncio já passou hoje? A janela tem apenas duas horas.
- O membro já foi anunciado neste ano? Confira o selo na página Aniversários.
- Ele entrou há menos tempo que Dias mínimos no servidor?
- O aniversário está mesmo registrado neste servidor? Um membro pode ter uma data salva em outro lugar sem ter se inscrito aqui.