Birthdays
Birthday management commands for setting, checking, and listing birthdays on the server.
Commands
/birthday set
Set your own birthday. Can only be set once — use cannot change their own birthday after setting it.
| Parameter | Type | Required | Description |
|---|---|---|---|
day | integer (1–31) | Yes | Day of birth |
month | integer (1–12) | Yes | Month of birth |
year | integer (1900–2025) | No | Year of birth |
Permissions: Everyone
Example: /birthday set day:14 month:7 year:1995
Success: Ephemeral message confirming the birthday was set. Logged in the birthdays category (event: birthday_set).
Errors:
- Invalid date (e.g., February 30)
- Birthday already set — user cannot re-set their own birthday
- Birthdays cog not enabled on the server
/birthday set-user
Set or update a birthday for another user. Moderator-only command — checks the moderators' roles from the Moderation cog configuration.
| Parameter | Type | Required | Description |
|---|---|---|---|
user | user | Yes | The user to set the birthday for |
day | integer (1–31) | Yes | Day of birth |
month | integer (1–12) | Yes | Month of birth |
year | integer (1900–2025) | No | Year of birth |
Permissions: Moderator (must have a role configured in the Moderation cog's moderation_roles)
Example: /birthday set-user user:@Alice day:3 month:12 year:2001
Success: Ephemeral message confirming the birthday was set for the target user. Uses INSERT ... ON CONFLICT DO UPDATE — upserts existing records. Logged in the birthdays category (event: birthday_set_mod).
Errors:
- Missing moderator permissions
- Invalid date
- Birthdays cog not enabled
/birthday remove-user
Remove another user's birthday. Moderator-only command.
| Parameter | Type | Required | Description |
|---|---|---|---|
user | user | Yes | The user whose birthday to remove |
Permissions: Moderator (same role check as set-user)
Example: /birthday remove-user user:@Alice
Success: Ephemeral message confirming the birthday was removed. Logged in the birthdays category (event: birthday_removed).
Errors:
- Missing moderator permissions
- User does not have a birthday set
- Birthdays cog not enabled
/birthday list
Show upcoming birthdays, sorted by the next chronological birthday. Shows at most 15 entries in an ephemeral embed.
Gets all birthdays for the guild
Sorts by upcoming date — birthdays later this year come first, then birthdays from the start of the year
Limits to the 15 nearest birthdays
Shows an ephemeral embed with date, user mention, and age turning
| Parameter | Type | Required | Description |
|---|---|---|---|
| (none) | — | — | — |
Permissions: Everyone — response is ephemeral
Example: /birthday list
Success: Ephemeral embed listing upcoming birthdays with:
- Each line:
DD/MM — @User (turns X)when year is known, orDD/MM — @Userwhen year is unknown - Footer: total number of birthdays stored
- Embed color from the cog configuration
Errors:
- No birthdays set on the server yet
- Birthdays cog not enabled
/birthday check
Check your own set birthday.
| Parameter | Type | Required | Description |
|---|---|---|---|
| (none) | — | — | — |
Permissions: Everyone — response is ephemeral
Example: /birthday check
Success: Ephemeral message showing your birthday in DD/MM/YYYY format (year shown only if set)
Errors:
- Birthday not set yet
- Birthdays cog not enabled