From 88cbd2f8045c5d75c18c40fc7b43cc1bff4f816c Mon Sep 17 00:00:00 2001 From: Scott Callaway Date: Tue, 19 Nov 2019 16:25:26 +0000 Subject: [PATCH] Update README.md for public consumption --- README.md | 77 ++++++++++++++++--------------------------------------- 1 file changed, 22 insertions(+), 55 deletions(-) diff --git a/README.md b/README.md index 15fc138..377816f 100644 --- a/README.md +++ b/README.md @@ -1,67 +1,34 @@ -# A Super Simple Boilerplate for creating Discord Bots 🤖 +# Dictionary 📚 -### Just want to get up and running developing your own bots for you Discord Server? This boilerplate code has you covered! Along with a comprehensive yet concise guide to setting up. +## A Discord bot for getting Dictionary definitions -## The Boring Setup 😴 -*As with anything, there is a bit of setup that is inevitable...* +> Built with the [Basic Bot boilerplate](https://github.com/scallaway/basic-bot) -**TL;DR** +### How to run -1.) [Here](https://discordapp.com/developers/applications/me) (might need to sign in) +This is assuming that you have the bot connected to your Discord server. More information on that can be found [here](https://github.com/scallaway/basic-bot). -2.) *Create a Bot User*, save Token somewhere +#### Install dependencies -3.) Here: `https://discordapp.com/oauth2/authorize?client_id=CLIENT_ID_GOES_HERE&scope=bot&permissions=0` +```bash +yarn install # If using Yarn +npm install # If using NPM +``` -### Things You Need - - NodeJS v9.4 or higher - - NPM v5 or higher +#### Add credentials -### Then jump [here](#finally-the-code) +1. Make an account on the Oxford Dictionary API website for any of the tiers. +2. Add the application to your account. +3. Copy the App ID and App Keys and paste them into a newly created `config.json` file. ---- +#### Run the bot -## The Slightly Longer version +```bash +node bot.js +``` -Navigate your way over to the [Discord Developer Applications](https://discordapp.com/developers/applications/me) page and create yourself a new app. Sign into your regular Discord account if asked to. +### Built with: -Give it a name, some sort of description and an icon if you're feeling fancy. - -Once that is done, you'll be shown a whole heap of information on your newly created app. You need to scroll down through all the guff to the bottom where it says **Bot**. - -Click the *Create a Bot User* button. This will allow you to *"interact with users in a more conversational manner"*. This is vital. (Say yes to the popup as well) - -**Get your pen and paper ready, you're going to have to jot some stuff down.** - -You'll now see various information in place of the button and you can now choose whether you want to make your bot Public and/or require OAuth2 (or learn more if you're that way inclined). - -Click the text that says *"click to reveal"* next to *"token"* and write down the long string of letters and numbers that it shows. This is how discord will know that the code you're writing is the bot you've said it is here. - -Before you go anywhere, quickly scroll right back to the top and grab your **ClientID**. This is important for the next bit. - -### Last bit of setup, hang in there 👌 - -Take this URL: `https://discordapp.com/oauth2/authorize?client_id=CLIENT_ID_GOES_HERE&scope=bot&permissions=0` - -Replace `CLIENT_ID_GOES_HERE` with the ClientID that you just noted down and then navigate to that page. - -From here, you can select the server that you wish to connect your bot to from the dropdown and then click Authorize. - -**Your bot is now allowed on your server!** - -*Depending on the roles setup on your particular server, you might have to assign a few to the bot to allow it to do everything you want.* - -## Finally, the code -### This bit is nice and simple 😊 - -1.) `cp config.example.json config.json` - -Creates a copy of the file `config.example.json` called `config.json` which is used by the bot. - -2.) Fill in the Discord Token in the `config.json` and pick a prefix (the default is `!`). - -3.) `npm install && node bot.js` - -Installs the required dependencies for the bot and then runs NodeJS on the `bot.js` file. - -4.) **Enjoy being able to interact with your bot from the comfort of your own Discord Server!** +- Discord.JS +- Node +- Oxford Dictionary API v2