Skip to content

Birthday

Domekologe edited this page Jun 30, 2026 · 1 revision

Birthday

🌐 English · Deutsch

Birthday announces member birthdays in a channel and can assign a temporary birthday role for the day. It is opt-in per guild (disabled by default), bilingual (DE/EN) and integrates with the Web Dashboard (enable toggle, channel, role, language). Author: pd-codes · requires Red 3.5.0+ · Status: Alpha 0.1.0.

Installation

[p]repo add PDC https://github.com/pd-codes/PDC_Redbot_Cogs
[p]cog install PDC birthday
[p]load birthday
[p]slash sync

Commands

Command Type What it does
birthday set <date> Hybrid Store your birthday. Accepts 24.12, 24-12, 24/12 or YYYY-MM-DD.
birthday remove Hybrid Remove your stored birthday.
birthday list Hybrid Show upcoming birthdays (next first).
birthdayset enable <on/off> Admin Enable/disable the module for this server.
birthdayset channel <#channel> Admin Announcement channel.
birthdayset role [@role] Admin Birthday role assigned on the day (omit to clear).
birthdayset hour <0-23> Admin UTC hour at which to announce.
birthdayset message <text> Admin Template; {mention} and {name} are replaced.
birthdayset language <de-DE|en-US> Admin Output language.

How it works

A background task runs every ~15 minutes. At the configured UTC hour it announces that day's birthdays once (guarded against duplicates). If a birthday role is set, it is kept in sync: granted to today's birthday members and removed from everyone else — self-healing across restarts. The bot needs Manage Roles (for the role) and Send Messages (in the channel).

Dashboard

Under a server's Guild Settings the module appears as a Birthdays panel with switches for Enabled, Channel, Birthday role and Language.

Clone this wiki locally