Commands
This page lists all usage and information about Birthday Bot's commands.
Last updated
Was this helpful?
This page lists all usage and information about Birthday Bot's commands.
Last updated
Was this helpful?
/
Please note the space after bday in the prefix. Each command should be run as follows:
/<command>
<>
denotes an mandatory parameter, while []
refers to an optional one.
Example Command Usage: /set
For help with command arguments, view the .
/premium
- View information about Birthday Bot Premium.
/subscribe
- Subscribe to Birthday Bot Premium.
/help
- Help with understanding the basics of Birthday Bot.
/view type:[type] user:[@User]
- View the birthday or member anniversary of yourself or another user. Defaults to birthday.
/next [type]
- View the next celebration event(s) in the server. Defaults to birthday.
/list type:[type] page:[page]
- View the list of birthdays/anniversaries for the server. Defaults to birthday.
/map
- View the time zone map.
/vote
- Vote for Birthday Bot.
/link link:donate
- Donate to Birthday Bot!
/link link:support
- Join the support server
/link link:invite
- Invite Birthday Bot.
/link link:docs
- View Birthday Bot's documentation.
/link link:faq
- View Birthday bot's FAQ.
/suggest date:[date] timezone:[timezone] user:[@User] birth_year:[2001]
- Suggest a birthday for another user, they will have to confirm the information.
/set date:[date] timezone:[timezone] birth_year:[2001]
- Set your birthday.
/user settings
- view your global user settings.
/user_server settings
- view your sever specific user settings.
/user edit show_birthday
- edit your global show birthday setting.
/user edit show_age
- edit your global show age setting.
/user_server edit show_birthday
- edit your server show birthday setting.
/user_server edit show_age
- edit your server show birthday setting.
/purge
- Remove your birthday data.
/claim_role option:
- Claim either your member anniversary role or your zodiac role.
/help
- Help with understanding the basics of Birthday Bot.
/info
- Info about the Birthday Bot.
/settings option:[option]
- View server's settings. Options: General
, Message
, & Advanced
. Defaults to General/
/setup
- Interactive guide for basic server setup.
/config option:Filter Birthday Age Messages
- Configure the
NOTE: To find a message id, use the /view_messages command.
/view_messages type:<type> page:[page]
- List all custom messages of the given type.
/message edit description type:<type> message:<message_id> description:<description>
- Edit a pre-existing message's description.
/message edit embed type:<type> message:<message_id> embed:<True/False>
- Edit a pre-existing message's embed setting.
/message remove message:<message_id>
- Remove a certain custom message of the given type.
/message clear type:<type>
- Clear all custom messages of the given type.
/edit hour type:<type> time:<0-23>
- Set the time messages should be sent in your server for the given type.
/edit ping type:<type> ping:<role/group>
- Set the custom message ping of the given type.
/edit channel type:<type> channel:<channel>
- Edit the channel messages will be sent in for the given type.
/message test type:<type> position:<position> user_count:[count]
- Test a custom message of the given type.
Trusted System Settings
/trustedRole add role:<@Role>
- Add a trusted role.
/trustedRole remove role:<@Role>
- Remove a trusted role.
/trustedRole remove id:<Id>
- Remove an Id.
/view_trusted_roles page:[page]
- List all trusted roles.
/trusted_role edit option:
- Edit how trusted roles work. The description of each will be in the option name.
blacklist add role_or_user:<@User/@Role>
- Add a user/role to the birthday blacklist.
blacklist remove id:<Id>
- Remove an Id from the blacklist.
blacklist remove role_or_user:<@User/@Role>
- Remove a user/role from the blacklist.
/blacklist clear
- Clear the birthday blacklist.
/view_blacklist page:[page]
- View the birthday blacklist list.
/premium
- View information about your server's premium subscription.
/message edit color type:<type> message:<message_id> color:<color/hex>
- Edit a pre-existing message's color setting.
/message edit title type:<type> message:<message_id> title:<title>
- Edit a pre-existing message's title setting.
/message edit footer type:<type> message:<message_id> footer:<footer>
- Edit a pre-existing message's footer setting.
/message edit image type:<type> message:<message_id> image:<image file>
- Edit a pre-existing message's image setting (Premium Only).
/zodiac set_emoji sign: emoji:
- Set a custom zodiac emoji
/zodiac clear_emoji sign:
- Clear a custom zodiac emoji
/zodiac set_role sign: role:
- Set a zodiac role
/zodiac clear_role sign:
- Clear a zodiac role
Example Usage: /message add type:Birthday message:Happy Birthday @Stqlth! Hope you have a great day!
Placeholder for years (not in birthday messages): %Year%
Placeholder for the server name: %Server%
/mar add role:<@role> year:<year>
- Add a member anniversary role for the given year.
/mar remove year:<year>
- Remove all member anniversary roles for the given year.
/mar clear
- Clear all member anniversary roles.
/view_member_anniversary_roles page:[page]
- List the member anniversary roles.
Commands which allow/take arguments will be displayed with either []
or <>
. Arguments in []
are not required while those in <>
are required. If an argument in either []
or <>
has a /
between two things it means OR.
Example Command: /message list type:<type> page:[page]
In this command, you must give a type, but you do not have to give a page.
Some example usage:
/message list type:Birthday
- Shows the first list.
/message list type:Birthday page:3
- Shows the third page of birthday messages.
Example Command: /list type:[type] page:[page]
In this command, you do not have to give a type or a page, but you can.
Some example usage:
/list
- Shows the birthday list starting at the first page.
/list page:3
- Shows the birthday list starting at the third page.
/list type:Member Anniversary
- Shows the member anniversary list starting at the first page.
/list type:Member Anniversary page:3
- Shows the member anniversary list starting at the third page.
Multiple commands require or allow the type argument, this can appear as [type]
or <type>
.
Birthday - represents the birthday event of a user
Member Anniversary - represents the member anniversary event of a user
Server Anniversary - represents the server anniversary event of a server
This type can't be used in the /list
command
Event - represents a custom event.
User Specific Birthday - represents a user-specific birthday message
This type is only used in the /message clear
commands
User Specific Member Anniversary - represents a user-specific member anniversary message
This type is only used in the /message clear
commands
/test type:<type> user:[User] year:[anniversary year]
- Test a . Optional parameter of a user to mention and year (anniversaries only).
Commands
/config option:Name Format
- Configure setting.
/config option:Time Zone
- Configure the setting.
/config option:Use Time Zone
- Configure the setting, which is the time zone that the bot will use to send celebration messages.
/config option:Date Format
- Configure the setting.
/config option:Image Format
- Configure the setting.
/config option:Disable Ages
- Configure the if in this server.
setting.
/config option:Zodiac Auto Assign.
- Configure the Setting.
/config option:Member Anniversary Remove Old Roles
- Configure the Setting.
Settings
/message add type:<type> message:<message_id> image:[image]
- Add a custom birthday message. {Users}
is the placeholder for the messages to mention the birthday users. Note: Only Premium servers can set and images.
/message edit color type:<type> message:<message_id> color:<color/hex>
- Edit a pre-existing message's (Premium Only).
/message edit title type:<type> message:<message_id> title:<title>
- Edit a pre-existing message's (Premium Only).
/message edit footer type:<type> message:<message_id> footer:<footer>
- Edit a pre-existing message's (Premium Only).
/message edit image type:<type> message:<message_id> image:<image file>
- Edit a pre-existing message's (Premium Only).
/edit post_mode type:<type> postMode:<postMode>
- Configure the for the given type.
NOTE: The free version of Birthday Bot can only have one trusted role. Check out !
Settings
/message add type:<type> message:<message>
- Add a message of the given type. It can add ! (Hint simply @ the user instead of using the {Users} placeholder!)
/view_messages type:<type>
- will automatically show up within this list for the given type.
/message remove message:<message_id>
- Remove a of the id.
/message clear type:<type>
- Clear all of the given type.
This is the type, though it varies between commands slightly: