Birthdays

This module allows users to register their birthdays. On the celebratory day the bot will automatically congratulate the birthday person in a special channel and can grant them a temporary role.

Updated in v1.6.2

The module has been completely redesigned for maximum convenience and flexibility. A unified control panel, privacy settings, and extended capabilities for administrators have been added.

For users: Control panel

All actions are now gathered in a single interactive panel available via the command /birthday manage.

In this panel you can:

• Set or change your birth date: Specify your birth date once.

• Configure privacy: For each server you can choose one of three visibility levels:

  • 🌍 Public: Your birth date is visible in the profile /profile, and the bot sends a public congratulation in the general chat.

  • 👤 Anonymous: Your birth date is hidden from the profile, but the bot still congratulates you in the general chat.

  • 🔒 Private: Full confidentiality. Your date is hidden and there will be no public congratulations from the bot.

Commands for administrators

Command	Description
/birthday list	Show a list of all publicly specified birthdays on the server.

Module configuration

To configure the module use the command /settings birthday.

The settings panel provides extensive options:

• Channel for congratulations: Choose the channel where the bot will send congratulatory messages.

• Birthday role: Specify the role that will be automatically assigned to the user on their birthday and removed the next day.

• Time zone: Set your server's time zone so congratulations and role assignments happen exactly at midnight local time.

• DM congratulations: You can enable or disable sending private congratulations to users.

• Message editor: Customize different texts for congratulations in the general chat and in private messages.

• Image editor: Add different images for server and private congratulations. The bot will randomly choose one of them.

---

Placeholders (Variables)

Use them in the message editor. They will be automatically replaced with the appropriate values.

For server messages

Placeholder	Description
{guild.name}	Server name
{guild.member_count}	Number of members on the server
{birthday_users_list_comma}	Mentions of birthday people separated by commas (@User1, @User2)
{birthday_users_names_comma}	Names of birthday people separated by commas (User1, User2)
{birthday_users_list_row}	Mentions, each on a new line (- @User1\n- @User2)
{birthday_users_names_row}	Names, each on a new line (- User1\n- User2)
{birthday_users_list_row_with_age}	Mentions with age, each on a new line (- @User1 - 25 years old)
{birthday_users_names_row_with_age}	Names with age, each on a new line (- User1 - 25 years old)
{birthday_users_count}	Number of birthday people today

For direct messages (DM)

Placeholder	Description
{user.mention}	Mention of the birthday person
{user.name}	Username
{user.nick}	Birthday person's nickname on the server
{user.display_name}	Display name (nick or name)
{user.id}	Birthday person's ID
{guild.name}	Server name
{guild.member_count}	Number of members on the server
{age}	Age (number, for example, 25)
{age_word}	The word 'year' in the correct grammatical form (year/years (2-4)/years (5+))