NadekoBot/README.md

53 lines
3.9 KiB
Markdown
Raw Normal View History

2015-12-05 10:13:23 +00:00
# NadekoBot
2016-03-03 03:58:56 +00:00
[**click here for a list of commands**](https://github.com/Kwoth/NadekoBot/blob/master/commandlist.md)
2016-01-22 08:16:10 +00:00
Nadeko Discord chatbot written in C# using Discord.net library.
2016-01-22 08:15:52 +00:00
You might want to join my discord server where i can provide help etc. https://discord.gg/0ehQwTK2RBhxEi0X
2015-12-05 11:02:45 +00:00
2016-02-08 09:56:38 +00:00
##This section will guide you through how to setup NadekoBot
2016-02-14 13:52:29 +00:00
#### For easy setup and no programming knowledge, you can download .exe from [releases](https://github.com/Kwoth/NadekoBot/releases) and follow the comprehensive [GUIDE](https://github.com/Kwoth/NadekoBot/blob/master/ComprehensiveGuide.md)
2015-12-05 11:02:45 +00:00
2016-02-08 09:56:38 +00:00
In your bin/debug folder (or next to your exe if you are using release version), you must have a file called 'credentials.json' in which you will store all the necessary data to make the bot know who the owner is, and your api keys.
2015-12-05 11:02:45 +00:00
**This is how the credentials.json should look like:**
```json
{
"Username":"bot_email",
"BotMention":"<@bot_id>",
"Password":"bot_password",
"GoogleAPIKey":"google_api_key",
"OwnerID":123123123123,
"TrelloAppKey": "your_trello_app_key (optional)",
"ForwardMessages": true,
"SoundCloudClientID": "your_soundcloud_key (optional)",
"MashapeKey": "your_mashape_key (optional)",
2015-12-05 11:02:45 +00:00
}
```
##### You can omit:
- googleAPIKey if you don't want music
- TrelloAppKey if you don't need trello notifications
2016-01-22 08:22:02 +00:00
- ForwardMessages if you don't want bot PM messages to be redirected to you
2016-01-11 19:10:47 +00:00
```json
{
"Username":"bot_email",
"BotMention":"<@bot_id>",
"Password":"bot_password",
"OwnerID":123123123123,
}
```
2016-01-11 18:39:55 +00:00
- BotMention(bot\_id) and OwnerID are **NOT** names of the owner and the bot. If you do not know the id of your bot, put 2 random numbers in those fields, run the bot and do `.uid @MyBotName` - that will give you your bot\_id, do the same for yourself `.uid @MyName` and copy the numbers in their respective fields.
2016-02-08 10:43:18 +00:00
- For google api key, you need to enable URL shortner, Youtube video search **and custom search** in the [dev console](https://console.developers.google.com/).
2016-02-05 22:20:19 +00:00
- For the Soundcloud Api key you need a Soundcloud account. You need to create a new app on http://soundcloud.com/you/apps/new and after that go here http://soundcloud.com/you/apps click on the name of your created your app and copy the Client ID. Paste it into credentials.json.
- For Mashape Api Key you need to create an account on their api marketplace here https://market.mashape.com/. After that you need to go to market.mashape.com/YOURNAMEHERE/applications/default-application and press GET THE KEYS in the right top corner copy paste it into your credentials.json and you are ready to race!
2016-01-12 16:28:51 +00:00
- If you want to have music, you need to download FFMPEG from this link http://ffmpeg.zeranoe.com/builds/ (static build version) and add ffmpeg/bin folder to your PATH environment variable. You do that by opening explorer -> right click 'This PC' -> properties -> advanced system settings -> In the top part, there is a PATH field, add `;` to the end and then your ffmpeg install location /bin (for example ;C:\ffmpeg-5.6.7\bin) and save. Open command prompt and type ffmpeg to see if you added it correctly. If it says "command not found" then you made a mistake somewhere. There are a lot of guides on the internet on how to add stuff to your PATH, check them out if you are stuck.
2016-02-08 09:56:38 +00:00
- **IF YOU HAVE BEEN USING THIS BOT BEFORE AND YOU HAVE DATA FROM PARSE THAT YOU WANT TO KEEP** you should export your parse data and extract it inside /data/parsedata in your bot's folder. Next time you start the bot, type `.parsetosql` and the bot will fill your local sqlite db with data from those .json files.
2015-12-05 11:02:45 +00:00
2016-02-08 09:56:38 +00:00
**IF BUILDING FROM SOURCE**
2016-01-28 09:21:44 +00:00
You should **remove** Discord.Net projects from your solution, and use add reference to the Discord.NET DLLs in your bin/debug.
2016-02-08 09:56:38 +00:00
Wait for it to resolve dependencies and start NadekoBot.
2015-12-05 11:02:45 +00:00
Enjoy
2015-12-05 11:25:40 +00:00
2016-01-29 14:55:53 +00:00
##List of commands
2016-03-03 03:58:56 +00:00
[**click here for a list of commands**](https://github.com/Kwoth/NadekoBot/blob/master/commandlist.md)