diff --git a/docs/guides/getting_started/first-bot.md b/docs/guides/getting_started/first-bot.md index f23e133f4..2c3b2be70 100644 --- a/docs/guides/getting_started/first-bot.md +++ b/docs/guides/getting_started/first-bot.md @@ -12,25 +12,26 @@ now, it is a good starting point. ## Creating a Discord Bot -Before writing your bot, it is necessary to create a bot account via +Before writing your bot, it is necessary to create a bot account via the Discord Applications Portal first. 1. Visit the [Discord Applications Portal]. -2. Create a New Application. +2. Create a new application. 3. Give the application a name (this will be the bot's initial username). -4. Create the Application. +4. On the left-hand side, under `Settings`, click `Bot`. - ![Step 4](images/intro-create-app.png) + ![Step 4](images/intro-bot-settings.png) -5. In the application review page, click **Create a Bot User**. +5. Click on `Add Bot`. - ![Step 5](images/intro-create-bot.png) + ![Step 5](images/intro-add-bot.png) 6. Confirm the popup. -7. (Optional) If this bot will be public, check "Public Bot." - * **Do not tick any other options!** +7. (Optional) If this bot will be public, tick `Public Bot`. -[Discord Applications Portal]: https://discordapp.com/developers/applications/me + ![Step 7](images/intro-public-bot.png) + +[Discord Applications Portal]: https://discordapp.com/developers/applications/ ## Adding your bot to a server @@ -38,26 +39,31 @@ Bots **cannot** use invite links; they must be explicitly invited through the OAuth2 flow. 1. Open your bot's application on the [Discord Applications Portal]. -2. Navigate to `OAuth2 URL Generator` and click on `Generate OAuth2 URL`. +2. On the left-hand side, under `Settings`, click `OAuth2`. + + ![Step 2](images/intro-oauth-settings.png) - ![Step 2](images/intro-generate-oauth.png) +3. Scroll down to `OAuth2 URL Generator` and under `Scopes` tick `bot`. -3. Select the permissions that you wish to assign your bot with. + ![Step 3](images/intro-scopes-bot.png) + +4. Scroll down further to `Bot Permissions` and select the + permissions that you wish to assign your bot with. > [!NOTE] > This will assign the bot with a special "managed" role that no > one else can use. The permissions can be changed later in the > roles settings if you ever change your mind! -4. Open the generated authorization URL in your browser. -5. Select a server. -6. Click on Authorize. +5. Open the generated authorization URL in your browser. +6. Select a server. +7. Click on Authorize. > [!NOTE] > Only servers where you have the `MANAGE_SERVER` permission will be > present in this list. - ![Step 6](images/intro-add-bot.png) + ![Step 6](images/intro-authorize.png) ## Connecting to Discord @@ -167,6 +173,12 @@ The following lines can now be added: At this point, feel free to start your program and see your bot come online in Discord. +> [!INFO] +> Getting a warning saying `A supplied token was invalid.` and having +> trouble with logging in? Double-check whether you put in the correct +> credentials. Note that a client secret is not the same as a bot +> token! + > [!TIP] > Encountering a `PlatformNotSupportedException` when starting your bot? > This means that you are targeting a platform where .NET's default diff --git a/docs/guides/getting_started/images/intro-add-bot.png b/docs/guides/getting_started/images/intro-add-bot.png index e40997ed3..3b5343ac6 100644 Binary files a/docs/guides/getting_started/images/intro-add-bot.png and b/docs/guides/getting_started/images/intro-add-bot.png differ diff --git a/docs/guides/getting_started/images/intro-copy-oauth.png b/docs/guides/getting_started/images/intro-copy-oauth.png deleted file mode 100644 index 31dc6f743..000000000 Binary files a/docs/guides/getting_started/images/intro-copy-oauth.png and /dev/null differ diff --git a/docs/guides/getting_started/images/intro-create-app.png b/docs/guides/getting_started/images/intro-create-app.png deleted file mode 100644 index 94f229a73..000000000 Binary files a/docs/guides/getting_started/images/intro-create-app.png and /dev/null differ diff --git a/docs/guides/getting_started/images/intro-create-bot.png b/docs/guides/getting_started/images/intro-create-bot.png deleted file mode 100644 index cc4e55ec3..000000000 Binary files a/docs/guides/getting_started/images/intro-create-bot.png and /dev/null differ diff --git a/docs/guides/getting_started/images/intro-generate-oauth.png b/docs/guides/getting_started/images/intro-generate-oauth.png deleted file mode 100644 index 5d7100ad2..000000000 Binary files a/docs/guides/getting_started/images/intro-generate-oauth.png and /dev/null differ diff --git a/docs/guides/getting_started/images/intro-token.png b/docs/guides/getting_started/images/intro-token.png index 8617cb76f..0fcdac077 100644 Binary files a/docs/guides/getting_started/images/intro-token.png and b/docs/guides/getting_started/images/intro-token.png differ