# Every Morty needs a Rick, and every Discord server needs a Robo Rick.
I am a moderation bot that brings some Rick and Morty fun into the server. I welcome people to the server with random Rick and Morty quotes, send DMs to new members, respond to keywords in chat, I can announce on your behalf, kick people, ban people, temporarily ban people, and so much more! A detailed list of the commands I have and how they work are listed below:
# Robo-Rick (Now with slash commands!)

## Important note:
 * Discord introduced slash commands *March 24, 2021*. On **August 11, 2021** Robo Rick was updated to support both slash commands **and** the traditional `$` commands. If you added Robo Rick to your server before 8/11/21 you will not have access to the slash commands. **To get slash commands:** kick Robo Rick from your server and re-add him. After you re-add him you may need to reassign your admin and updates channel.

# Bot events:
#### Welcome message
 * Welcomes new members into the server by name with a random welcome message from Rick and Morty 
![WelcomeMessageImage](https://raw.githubusercontent.com/TrevorSLong/Robo-Rick/main/Screenshots/welcomemessages.PNG)
#### Welcome DM
 * Welcomes new members into the server by sending them a DM 
![WelcomeDMImage](https://raw.githubusercontent.com/TrevorSLong/Robo-Rick/main/Screenshots/welcomedm.PNG)
#### Chat response
 * Responds to "hello" with "Wubbalubbadubdub" 
![ChatResponseImage](https://raw.githubusercontent.com/TrevorSLong/Robo-Rick/main/Screenshots/hello.PNG)
#### Changes bot status
 * Robo Ricks status is "Listening to Snake Jazz" 
![BotStatusImage](https://raw.githubusercontent.com/TrevorSLong/Robo-Rick/main/Screenshots/status.PNG)
#### Join server message
 * Robo Rick sends a message in the default channel when he joins the server for the first time introducing himself 
![JoinServerImage](https://raw.githubusercontent.com/TrevorSLong/Robo-Rick/main/Screenshots/joinmessage.PNG)

# Slash Commands:
 * Slash commands were introduced to Discord 3/24/21, they much more user-friendly because they suggest and auto-fill based on whether the expected value is a string, user, channel, etc. As of 8/11/21 Robo Rick supports slash commands although you may need to reinvite him to the server. Below is a list of all of the slash commands:
#### Ping
 * Responds to `/ping` with "Pong" and the server latency
![SlashPingImage1](https://raw.githubusercontent.com/TrevorSLong/Robo-Rick/main/Screenshots/slashping1.PNG)
![SlashPingImage2](https://raw.githubusercontent.com/TrevorSLong/Robo-Rick/main/Screenshots/slashping2.PNG)
#### UpdateChannel
 * Changed the channel Robo Rick sends updates to (Welcome messages, leave messages, etc.)
 * Hitting tab will autofill the command and bring up a list of channels on your server. If it doesn't see the channel in the UI just type it out.
 * Note: command and result are using a different channel
![UpdateImage1](https://raw.githubusercontent.com/TrevorSLong/Robo-Rick/main/Screenshots/slashupdate1.PNG)
![UpdateImage2](https://raw.githubusercontent.com/TrevorSLong/Robo-Rick/main/Screenshots/slashupdate2.PNG)
#### AdminChannel
 * Changed the channel Robo Rick sends admin updates to (Kicking, banning, temp banning, etc.)
 * Hitting tab will autofill the command and bring up a list of channels on your server. If it doesn't see the channel in the UI just type it out.
 * Note: command and result are using a different channel
![AdminImage1](https://raw.githubusercontent.com/TrevorSLong/Robo-Rick/main/Screenshots/slashadmin1.PNG)
![AdminImage2](https://raw.githubusercontent.com/TrevorSLong/Robo-Rick/main/Screenshots/slashadmin2.PNG)
#### Announcements
 * Allows a user with `Manage Server` ability to send an announcement to any channel in the server. Both a message and channel to send to are required.
 * After typing the command hit TAB to autofill the message parameter, then type your message and hit tab. It will then open a list of channels to send the announcement to.
![AnnounceImage1](https://raw.githubusercontent.com/TrevorSLong/Robo-Rick/main/Screenshots/slashannounce1.PNG)
![AnnounceImage2](https://raw.githubusercontent.com/TrevorSLong/Robo-Rick/main/Screenshots/slashannounce2.PNG)
#### Kick
 * `/kick member:` **@User** `reason:` **REQUIRED REASON, THE USER WILL SEE THIS REASON**
 * Kicks the user from the server, informs them of the reason. Also informs the admin channel that the person was kicked and the reason.
![KickImage1](https://raw.githubusercontent.com/TrevorSLong/Robo-Rick/main/Screenshots/slashkick1.PNG)
![KickImage2](https://raw.githubusercontent.com/TrevorSLong/Robo-Rick/main/Screenshots/slashkick2.PNG)
#### Ban
 * `/ban member:` **@User** `reason:` **REQUIRED REASON, THE USER WILL SEE THIS REASON**
 * Bans the user from the server, informs them of the reason. Also informs the admin channel that the person was kicked and the reason.
![BanImage1](https://raw.githubusercontent.com/TrevorSLong/Robo-Rick/main/Screenshots/slashban1.PNG)
#### TempBan
 * `/tempban member:` **@User** `reason:` **REQUIRED REASON, THE USER WILL SEE THIS REASON** duration: **How long in days**
 * Temporarily bans the user from the server, informs them of the reason. Also informs the admin channel that the person was kicked and the reason.
![TempBanImage1](https://raw.githubusercontent.com/TrevorSLong/Robo-Rick/main/Screenshots/slashtempban1.PNG)
#### UnBan
 * **Careful with the syntax here**
 * `/unban member1234: Username#1234`
 * This command will not autofill the user, you need to type the username and number
![UnBanImage1](https://raw.githubusercontent.com/TrevorSLong/Robo-Rick/main/Screenshots/slashunban1.PNG)

# Traditional ($) Commands:
 * Originally Robo Rick used dollar sign commands, before slash commands were introduced. Currently Robo Rick supports both slash and $ commands. Servers who added Robo Rick before slash commands will still be able to use dollar sign commands normally, while those who added after can use either.

#### Ping
 * Responds to $ping with "pong" and the bot server latency 
![PingImage](https://raw.githubusercontent.com/TrevorSLong/Robo-Rick/main/Screenshots/ping.PNG)
#### UpdateChannel
 * Use $updatechannel to change the channel Robo Rick sends all public updates
 * The channel will be changed to the channel that you send the command in
 * By default this channel will be the top text channel in the server
 * To change this permission, the user must have the "Manage Channel" permission in the Discord server 
![UpdateChannelImage](https://raw.githubusercontent.com/TrevorSLong/Robo-Rick/main/Screenshots/updatechannel.PNG)
 * $checkupdatechannel can be used to check which channel in your server is set to the update channel 
![CheckUpdateChannelImage](https://raw.githubusercontent.com/TrevorSLong/Robo-Rick/main/Screenshots/checkupdatechannel.PNG)
#### AdminChannel
 * Use $adminchannel to change the channel Robo Rick sends all admin updates
 * The channel will be changed to the channel that you send the command in
 * By default this channel will be the top text channel in the server
 * To change this permission, the user must have the "Manage Channel" permission in the Discord server 
![AdminChannelImage](https://raw.githubusercontent.com/TrevorSLong/Robo-Rick/main/Screenshots/adminchannel.PNG)
 * $checkadminchannel can be used to check which channel in your server is set to the admin update channel 
![CheckAdminChannelImage](https://raw.githubusercontent.com/TrevorSLong/Robo-Rick/main/Screenshots/checkadminchannel.PNG)
#### Announcements
 * $announce "_____" will send an announcement in the updates channel in your server. To change the channel it is sent in use $updatechannel 
 * You will need the permission 'Manage Channel' to use this command
![AnnouncementsImage](https://raw.githubusercontent.com/TrevorSLong/Robo-Rick/main/Screenshots/announce.PNG)
 * Announcements can be sent to a specific channel by adding the channel ID as an optional arguement
 * Example: $announce 123456789 This announcement was sent to a specific channel instead of the update channel 
![SpecificChannelAnnouncementsImage](https://raw.githubusercontent.com/TrevorSLong/Robo-Rick/main/Screenshots/announcespecific.jpg)
#### Kick
 * $kick "__" "__" kicks a member for a either a specified or unspecified reason
 * Sends an update in Admin channel and sends the reason in a DM to the member who was kicked
 * Example: `$kick @DroTron#1863 for this really valid reason` 
 * If a reason is specified:
 * In chat where command was issued 
![KickImage1](https://raw.githubusercontent.com/TrevorSLong/Robo-Rick/main/Screenshots/kick1.PNG)
 * In Admin channel 
![KickImage2](https://raw.githubusercontent.com/TrevorSLong/Robo-Rick/main/Screenshots/kick2.PNG)
 * In users DM with Robo Rick 
![KickImage3](https://raw.githubusercontent.com/TrevorSLong/Robo-Rick/main/Screenshots/kick3.png)
 * If no reason is specified:
 * In chat where command was issued 
![aKickImage4](https://raw.githubusercontent.com/TrevorSLong/Robo-Rick/main/Screenshots/kickNR1.PNG)
 * In Admin channel 
![KickImage5](https://raw.githubusercontent.com/TrevorSLong/Robo-Rick/main/Screenshots/kickNR2.PNG)
 * In users DM with Robo Rick 
![KickImage6](https://raw.githubusercontent.com/TrevorSLong/Robo-Rick/main/Screenshots/kickNR3.png) 
#### Ban
 * $ban "__" "__" bans a member for a either a specified or unspecified reason
 * Sends an update in Admin channel and sends the reason in a DM to the member who was banned
 * Example: `$ban @DroTron#1863 for this really valid reason` 
 * If a reason is specified:
 * In chat where command was issued 
![BanImage1](https://raw.githubusercontent.com/TrevorSLong/Robo-Rick/main/Screenshots/ban1.PNG)
 * In Admin channel 
![BanImage2](https://raw.githubusercontent.com/TrevorSLong/Robo-Rick/main/Screenshots/ban2.PNG)
 * In users DM with Robo Rick 
![BanImage3](https://raw.githubusercontent.com/TrevorSLong/Robo-Rick/main/Screenshots/ban3.png)
 * If no reason is specified: 
 * In text chat where the command was issued 
![BanImage4](https://raw.githubusercontent.com/TrevorSLong/Robo-Rick/main/Screenshots/banNR1.PNG)
 * In Admin channel 
![BanImage5](https://raw.githubusercontent.com/TrevorSLong/Robo-Rick/main/Screenshots/banNR2.PNG)
 * In users DM with Robo Rick 
![BanImage6](https://raw.githubusercontent.com/TrevorSLong/Robo-Rick/main/Screenshots/banNR3.png)
#### Unban
 * $unban unbans a user that was previously banned
 * Example: `$unban DroTron#1863` 
 * **Important**: in ban and kick use @TrevorSLong after the command but here use DroTron#1863 with no @
 * In the admin channel 
![UnbanImage1](https://raw.githubusercontent.com/TrevorSLong/Robo-Rick/main/Screenshots/unban1.PNG)
 * In the users DM with Robo Rick 
![UnbanImage2](https://raw.githubusercontent.com/TrevorSLong/Robo-Rick/main/Screenshots/unban2.png)
#### Tempban
 * `$tempban user days reason` bans a user for a certain number of days for a reason and then unbans them
 * Example: `$tempban @Knightmare 2 because he sucks` 
 * **Important**: This command is not perfect, if Robo Rick is restarted or updated while a temporary ban is in place he will forget the ban and will not execute the unban. This is a known issue and is in the pipeline to be fixed.
 * Robo Rick sends an announcement in the admin channel and sends the user a DM
 * In the admin channel 
![TempbanImage1](https://raw.githubusercontent.com/TrevorSLong/Robo-Rick/main/Screenshots/tempban1.PNG)
 * In the users DM with Robo Rick 
![TempbanImage2](https://raw.githubusercontent.com/TrevorSLong/Robo-Rick/main/Screenshots/tempban2.png)
 * In the users DM with Robo Rick after the time has passed 
![TempbanImage3](https://raw.githubusercontent.com/TrevorSLong/Robo-Rick/main/Screenshots/tempban3.png)
 * In the admin channel after the time has passed 
![TempbanImage4](https://raw.githubusercontent.com/TrevorSLong/Robo-Rick/main/Screenshots/tempban4.PNG)
#### Error handling
 * Sends an error if a member tries to use a command they do not have access to 
![ErrorHandlingImage](https://raw.githubusercontent.com/TrevorSLong/Robo-Rick/main/Screenshots/errorhandling.png) 
#### Help
 * $help is here! Type this to get a less detailed summary of what is above. 
![HelpImage](https://raw.githubusercontent.com/TrevorSLong/Robo-Rick/main/Screenshots/help.PNG)

Robo Rick

Robo Rick brings enhanced moderation to your server with some Rick and Morty flair! Welcome messsages, announcements, kicking, and more!

Voter pour Robo Rick

Tu veux nous soutenir ?