So, what do I need?

Let's go through a short checklist, so you can check if you have everything you need.

You need:

Your Discord account (e-mail and password)
An internet browser (which you probably have, or how do you view this site?)
A Discord server where you can see and edit roles* and where you can change server settings (server name, region etc.)

*The roles permission is optional, but recommended. Discord sometimes forgets to create bot roles which causes errors.

Why do I need all of these?

You need your Discord account so Discord knows who wants to add MaryuBot. The internet browser is required to open the authentication website. On the Discord server, you need the roles permissions to check if the bot role has been created and the server manage permission to be able to add MaryuBot to it.

Got everything? Then let's start with the step-by-step instruction!

Step-by-step instruction

[1] Open the authorization website

Let's start with opening the authorization website. Click on the button below. This will open the site in a new tab.

Invite MaryuBot

Discord now probably prompts you to log into your account. Use your e-mail and password to log in. If you are on PC you can also use the QR code login by scanning the QR code with your mobile phone.

If you didn't get prompted, congrats! You are already logged in. Continue with step 2.

If you can't log in, double check your e-mail and password or try again. Forgot your password? Reset it with the "Forgot your password?" button below the password field.

[2] Authorize the bot

It's time to authorize MaryuBot. Let's do it together.

[Image] MaryuBot wants to access your account - Allow Slash commands - https://www.maryubot.maryu.eu/assets/get-started-authorization-screen.png

Now you should see something like this. Here, Discord tells you that MaryuBot's Developer (that's me :D) can create Slash commands in the server. Slash commands are pretty new and aren't used by many bots yet. Maybe MaryuBot will get some Slash commands someday! Here is Discord's documentation about them, if you're interested.

Next stop: Server selection. Click on "Select a server" and choose your server. If the desired server isn't listed there, make sure that you have the "Manage Server" permission in it. Then try again.

[Image] MaryuBot wants to access your account - Grant permissions - https://www.maryubot.maryu.eu/assets/get-started-authorization-screen-2.png

Now Discord wants to know which permissions you want to give MaryuBot. Please, don't unclick any checkboxes. Else MaryuBot tells you that he doesn't have enough permissions. Make sure all checkboxes are checked and click on "Authorize".

After clicking on Authorize, you might want to confirm that you are not a robot. And even if you are one, just click the checkbot next to "I'm not a robot". The captcha doesn't always appear, it only appears sometimes.

[3] Check if MaryuBot is working

If you authorized MaryuBot correctly, there should be a message in any chat on your server that looks like:

[Image] MaryuBot's welcome message - https://www.maryubot.maryu.eu/assets/get-started-joinmessage.png

If there is no message, don't worry. Either MaryuBot is overloaded or he didn't find a good channel to send it.

Now you should test if everything went well. Take a channel of your choice and type +help. This gives you the help page with all available commands. Or, if you already know some commands, run any other command.

The bot should execute the command now. If nothing happens, try again. If still nothing happens, try again. If still noth- okay enough. If really nothing happens, proceed to step 4 - the permissions check.

There might also be the case that MaryuBot replies with this:

[Image] Are you trying to execute a command? I cannot execute commands here. I am missing the following permissions. - https://www.maryubot.maryu.eu/assets/get-started-permission-denied.png

This often happens when the bot role didn't get created or if other permission overwrites deny the role permissions. Sounds complicated, I know. But that's why we have a guide! Continue with step 4.

[4] Check the permissions

This guide ends here. If you want to make sure that everything's working or if the bot is not working, continue with the permissions check guide over here.