Bdays Module

class Bdays(*args: Any, **kwargs: Any)

Bases: Cog

This module handles all birthday-related commands and features for Love Live Radio guild.

It allows users to add, delete, and display their birthdays.

See also

Module is locked to the Love Live Radio (LLR) server.

Attention

All commands assume minimum bot permissions: View Channel, Send Messages.

async idolized(ctx, search_name)

Return UR card for the Idol name given. Automatically runs for birthday announcements.

Syntax:

!!idolized <search_name>

Example:

!!idolized umi
Returns:

A random UR card for the idol given.

Return type:

discord.Message

Permissions

Author: LLR Admin

Bot: Embed Links

async bin(ctx, name=None)

Set or check bday idol name. To remove bday idol leave name param blank

Syntax:

!!bin [name]

Example:

!!bin
!!bin eli
Parameters:

name (str, optional) – The idol name to set as birthday idol, if blank it will reset.

Returns:

Update or removal confirmation message.

Return type:

discord.Message

Attention

Author Permissions: LLR Admin

Permissions

Author: LLR Admin (server owner / bot owner)

Bot: View Channel, Send Messages (plus Connect/Speak for voice commands)

birthday = <discord.app_commands.commands.Group object>
async birthday_add(interaction: Interaction, day: int, month: str, timezone: str, idol: str)

Add user’s birthday with the given details.

Permissions

Author: Everyone (subject to channel/guild command restrictions)

Bot: View Channel, Send Messages (plus Connect/Speak for voice commands)

Syntax:

/birthday add
async birthday_delete(interaction: Interaction)

Delete user’s birthday entry.

Permissions

Author: Everyone (subject to channel/guild command restrictions)

Bot: View Channel, Send Messages (plus Connect/Speak for voice commands)

Syntax:

/birthday delete
async birthday_show(interaction: Interaction)

Show user’s registered birthday.

Permissions

Author: Everyone (subject to channel/guild command restrictions)

Bot: View Channel, Send Messages (plus Connect/Speak for voice commands)

Syntax:

/birthday show
async show_birthdays(ctx)

Return all member birthdays recorded in the database as user_id, date, tz, idol.

Aliases: sb

Syntax:

!!show_birthdays
Returns:

An embedded message with a list of all member birthdays.

Return type:

discord.Embed

Attention

Author Permissions: Owner

Permissions

Author: LLR Admin (server owner / bot owner)

Bot: View Channel, Send Messages (plus Connect/Speak for voice commands)

async birthday_export(ctx)

Export all member birthdays as a JSON file attachment.

Syntax:

!!birthday_export

Aliases: bday_export, export_birthdays

Returns:

A JSON file containing all member birthdays.

Return type:

discord.File

Attention

Author Permissions: LLR Admin

Permissions

Author: LLR Admin (server owner / bot owner)

Bot: View Channel, Send Messages (plus Connect/Speak for voice commands)

async birthday_recover(ctx)

Manually trigger a check for missed birthdays and activate them with adjusted role removal times. The missed time is calculated based on when this command is executed.

Syntax:

!!birthday_recover

Aliases: bday_recover

Returns:

A message indicating how many birthdays were activated.

Return type:

discord.Message

Attention

Author Permissions: LLR Admin

Permissions

Author: LLR Admin (server owner / bot owner)

Bot: View Channel, Send Messages (plus Connect/Speak for voice commands)

async birthday_force(ctx, member: Member)

Force the birthday message to activate for a user, even if it’s not their birthday.

Permissions

Author: Everyone (subject to channel/guild command restrictions)

Bot: View Channel, Send Messages (plus Connect/Speak for voice commands)