# What is the Birthday Announcer?

The Birthday Announcer is a function in Mantaro that allows her to send a birthday message to celebrate someone's birthday. Mantaro will send a message in the specified channel for each user and will provide them with the specified birthday role for that day.Warning: Since the opts command has not been ported to Slash Commands, this page is subject to massive changes in the future.

# Important/Main commands

1) What is it for? /birthday set date: dd-MM Used for: Specifying your birthday (dd-MM format) 2) What is it for? ~>opts birthday enable <channel name> <role name> Used for: Setting up the Birthday Announcer. 3) What is it for? ~>opts birthday message set <message> Used for: Setting a Custom Birthday Message. 4) What is it for? /birthday allowserver Used for: Allowing your birthday to be announced in the server you use this command on.

# Important information

You cannot add someone else's birthday for them. Every user needs to add their own birthday themselves. The list of users to announce each day is cached every 24 hours. Meaning that any changes to ones birthday will not be reflected until after the cache happens. Since changes are not reflected until after the cache happens, this also means that if a birthday is added before the actual day then it won't be announced. For example, if your birthday was June 6th and you add it on June 5th it will not be announced since it was not cached. Users need to use /birthday allowserver if they want their birthday announced. If they don't use the command it will not be announced. Birthdays are announced at midnight America/Chicago time. This is a global setting and cannot be changed.

# How do I enable the Birthday Announcer?

Before enabling the birthday announcer you need to check some things first.You need to choose a channel in which Mantaro will announce the birthdays. You need to choose a role to be assigned on each birthday. Warning: Make sure that the role you choose is not a role with permissions you would not want all users to have. As well, make sure that the role is not an actively used role, for example a role called Member that is given to everyone is not a good choice.Once you have those two you can activate the Birthday Announcer with:~>opts birthday enable <channel name> <role name> null https://i.imgur.com/c1T9vAd.png image Once again there's a couple of things to keep in mind.You have to type the name of both channel and role. Do not mention them. If your role name has spaces on it (it's not a single word) then you have to type the name in quotes. "Just like this" If your role/channel name has special characters on it know that Mantaro at times does not recognize them and will fail the command because of them. You can rename the role so it does not have special characters, setup the announcer and then rename your role back.

# Other/Extra commands

1) What is it for? ~>opts birthday disable Used for: Removes the Birthday Announcer. 2) What is it for? ~>opts birthday test <@mention> Used for: Allows you to test the Birthday Announcer. Doesn't process embeds. 3) What is it for? ~>opts birthday message clear Used for: Removes the custom message you had and restores the default message for the Birthday Announcer. 4) What is it for? ~>opts commands birthdayblacklist add/remove <@mention> Used for: Allows you to blacklist a user from having their birthday announced on the server.