Contents
Birthdays & Anniversaries Guide
The Birthday module tracks four kinds of member "birthdays" and automatically celebrates each one with configurable rewards. Members register their real birthday themselves; the other three are detected from Discord metadata.
The Four Event Types
| Event | Triggered by |
|---|---|
| Real Birthday | The member registers their birth date with /birthday set |
| Discord Anniversary | Yearly anniversary of the member's Discord account creation |
| Join Anniversary | Yearly anniversary of the member joining this server |
| Server Birthday | Yearly anniversary of the server itself, celebrated server-wide |
Each event type can be enabled or disabled independently. You can run only Real Birthdays, only Anniversaries, or any combination that fits your community.
Member Commands
All user-facing commands live under the /birthday group:
| Command | Description |
|---|---|
/birthday show |
Opens your private birthday hub |
/birthday set <date> |
Shortcut: register your birthday (required for Real Birthday events) |
/birthday remove |
Shortcut: remove your stored birthday |
The hub has two tabs:
| Tab | Description |
|---|---|
| My birthday | Your stored birthday and when it is next. Set birthday (or Change birthday) opens a form, Remove deletes it |
| Upcoming | The next birthdays members have shared on this server |
Enter the date as DD-MM (for example 24-08) or YYYY-MM-DD (for example 2001-08-24). The year is optional; with a year, the announcement mentions your new age. Other members only see day and month.
Each member can only have one birthday stored per server. Registration is entirely optional; members who don't register simply don't trigger Real Birthday events. After a change, a lock applies before you can change your birthday again, and removing it and setting it again does not skip that lock.
Birthdays on 29 February are celebrated on 28 February in years without a 29 February.
Managing Birthdays in Discord
Admins configure the module in /setup under Community and then Birthdays: each occasion (member birthdays, Discord anniversaries, join anniversaries and the server birthday) has its own switch and channel, plus the Birthday role for the day and the Role to ping.
The Member birthdays button on the same page opens a screen for managing other members:
| Button | Description |
|---|---|
| Set a birthday | Set a birthday on another member's behalf |
| Remove a birthday | Remove another member's stored birthday |
| List with paging | Inspect registered birthdays on the server |
Rewards
Per event type, you can configure:
- Points: points credited to the member on the day (Points per member for the Server Birthday).
- XP: XP granted via the leveling system (XP per member for the Server Birthday).
- Birthday Role (24h): for Real Birthdays only, a role assigned for about 24 hours and removed automatically afterwards, also when the bot restarts in between. The Server Birthday has a Ping role instead.
- Message: your own announcement text. Leave it empty to use the default text, translated into the server language. Placeholders:
{user}for the member mention,{years}, and{server}for the server name (the Server Birthday also uses{awarded}).
Real Birthdays, Discord Anniversaries, and Join Anniversaries are celebrated in an announcement channel you designate. Without a channel, that occasion is not announced; an empty message never switches announcements off. The Server Birthday event is celebrated server-wide, typically with a larger reward since it affects everyone.
Announcements are cards in the server language. The In my language button shows the same card in your own language, visible only to you.
Preview and test
Under each message field the dashboard shows a preview of the card with sample values and your name. An empty message previews the default text, and the preview updates as you type. Send test posts one card into the saved announcement channel of that occasion, marked as a test. A test never pings anyone and grants no rewards. It uses the saved settings, so unsaved changes are saved first.
Scheduling
A single Announce at (UTC) hour controls when Levlix posts that day's celebrations. The scheduler checks every server at that hour once per day, so you can align announcements with your community's peak activity time, with no separate cron job per guild.
Audit Log
The dashboard includes an Audit tab with Recent Changes (the last 50 birthday edits, by members or admins) and Recent Rewards (the last 20 payouts with their points and XP). Useful for checking who changed a date or verifying reward payouts.
Setup at a Glance
- Open the Levlix Dashboard and open Engagement → Birthdays in your server's sidebar.
- Switch on the Birthday Module card and choose the Announce at (UTC) hour.
- Enable the event types you want to celebrate and configure rewards and messages for each.
- Optionally pick a Birthday Role (24h) for Real Birthdays and a Ping role for the Server Birthday.
- Ask your members to run
/birthday setto register their real birthdays.