NoxBot NoxBot Docs

Birthdays

Members add their own birthday with a slash command and the bot celebrates them in a channel and with an optional birthday role.


Let your members share their birthday and have NoxBot celebrate them automatically. Each member adds their own date with a command, and on the day the bot posts a congratulations message and can hand out a special birthday role.

How members add their birthday

Members run /birthday set and type their date. The year is optional: with a year, the bot can show their age; without one, only the day and month are stored.

  • /birthday set saves or updates the birthday
  • /birthday remove deletes it again
  • /birthday list shows the upcoming birthdays

The date is read in the format you choose in the dashboard, so members type it the way they are used to.

Dashboard settings

Open the Birthdays page for your server to configure:

  • Congratulations channel where the message is posted
  • Timezone and time that decide when the bot posts on the day (for example 09:00 in your server’s timezone)
  • Date format (day/month/year, month/day/year or year/month/day)
  • Birthday role that the birthday child wears for the day. You can pick an existing role or let the bot create one and give it a name.

You also get an overview of everyone who saved a birthday, with their date and age, and you can remove or correct an entry as an admin.

The message

The congratulations message uses the same editor as the welcome module: plain text or a rich embed, with a live preview. Drop in variables such as the member mention, their name or their age, and the bot fills them in for the real person.

Role hierarchy

For the birthday role to work, the bot's own role must sit ABOVE the birthday role in your server settings. Discord never lets a bot manage a role that is higher than its own.

Counting starts when set

The bot only knows the birthdays members enter themselves. There is no way to import them from Discord, so the list fills up as people use /birthday set.