General
There are three types of events, all falling under the title of "Celebration Event":
Birthday Event - The typical event of a user's birthday.
Member Anniversary Event - The yearly anniversary of a member joining the server.
Server Anniversary Event - The yearly anniversary of the creation of a server.
With the introduction of anniversaries in the Birthday Bot 3.0 update, the member anniversary and server anniversary events were added to represent when a member joined the server and when the server was created. Because of this, the bot was no longer exclusively birthday events, and I started using the "Celebration Event" term to represent any of the three of these events.
An example of a message embed is to run the command bday help! You will notice the message is specially formatted using Discord API. By default the birthday message is embedded; however, if you use a link to a GIF or image in your custom birthday message, they will not work in an embedded message, so turning this option off is what you would want.
Server configuration commands (and some sub-commands) require users to have the MANAGE_SERVER permission in order to use them. However, if your server has set the Birthday Master Role, users can use these commands if they have either.
You may have run into a bug with Discord where the bot is displaying a bunch of numbers (like: <@478288246858711040>) instead of correctly mentioning a user. This can happen either because that user has left the Discord or because Discord's cache wasn't up to date.
To fix this, I added the Name Format setting which decides in which format Birthday Bot should display users.
There are currently four options:
Mention (default):
Displays the user in the typical
@Userformat.Example: @Stqlth
Username:
Displays the user's username boldened.
Example: Stqlth
Nickname:
Displays the user's nickname (or username, if a nickname is not set) boldened.
Example: Scott
Tag
Displays the user's username followed by their discriminator.
Example: Stqlth#0001
The Default Timezone, is, as its name describes, the default timezone of a server. This timezone is used in multiple places.
Firstly, when a user is setting their birthday for the first time in your server, if the default timezone is set, the user will be suggested to use the timezone that the server uses (they can still choose a different one).
Secondly, it can also be used to decide the time a birthday message/role is sent/given. This is dependent on the Use Timezone setting.
Lastly, all Member Anniversaries and Server Anniversaries are celebrated based on the server timezone. Because of this, for either anniversary to work, the Server Default Timezone has to be set.
If the Default Timezone setting is set, then servers can decide which timezone to use for the birthday celebration. If this setting is set to server, all birthday events will happen based on the server's default timezone and if this setting is set to user, all birthday events will happen based on the user's timezone.
Note: If the UseTimezone setting is set to server and the Default Timezone setting is not set, then the user's timezone will be used for birthday events.
The date format setting decides how Birthday Bot detects birthdays when users are setting their birthday in your server. There are two options. The default, month_day and day_month. They function as their name suggests. For instance, if your server is using the month_day setting then the bot will detect the day 01/12 as January 12th. However, if your server is using the day_month setting then the bow will detect the date 01/12 as December 1st.
The birthday blacklist is a system that allows servers to prevent a member from having their birthday celebrated. This is to help server owners prevent members from abusing the system by setting their birthday multiple times.
