diff --git a/docs/creds-guide.md b/docs/creds-guide.md index 7e70afd3e..2fb856dfa 100644 --- a/docs/creds-guide.md +++ b/docs/creds-guide.md @@ -13,8 +13,13 @@ This document aims to guide you through the process of creating a Discord accoun - Click on the `Add a Bot` button and confirm that you do want to add a bot to this app. - **Optional:** Add bot's avatar and description. - Copy your Token to `creds.yml` as shown above. -- Scroll down to the `Privileged Gateway Intents` section and enable both intents. - These are required for a number of features to function properly, and should both be on. +- Scroll down to the `Privileged Gateway Intents` section + - Enabled the following: + - PRESENCE INTENT + - SERVER MEMBERS INTENT + - MESSAGE CONTENT INTENT + +These are required for a number of features to function properly, and all should be on. ##### Getting Owner ID*(s)*: @@ -32,7 +37,7 @@ For a single owner, it should look like this: - 105635576866156544 ``` -For multiple owners, it should look like this (pay attention to the commas, the last ID should **never** have a comma next to it): +For multiple owners, it should look like this: ```yml OwnerIds: @@ -56,4 +61,4 @@ For multiple owners, it should look like this (pay attention to the commas, the That's it! You may now go back to the installation guide you were following before 🎉 -[DiscordApp]: https://discordapp.com/developers/applications/me \ No newline at end of file +[DiscordApp]: https://discordapp.com/developers/applications/me diff --git a/docs/guides/linux-guide.md b/docs/guides/linux-guide.md index af5c7e3f0..83d43a965 100644 --- a/docs/guides/linux-guide.md +++ b/docs/guides/linux-guide.md @@ -13,11 +13,11 @@ Open Terminal (if you're on an installation with a window manager) and navigate 1. Download and run the **new** installer script `cd ~ && wget -N https://gitlab.com/Kwoth/nadeko-bash-installer/-/raw/master/linuxAIO.sh && bash linuxAIO.sh` 2. Install prerequisites (type `1` and press enter) 3. Download the bot (type `2` and press enter) -4. Exit the installer in order to set up your `creds.yml` +4. Exit the installer (type `5` and press enter) 5. Copy the creds.yml template `cp nadekobot/output/creds_example.yml nadekobot/output/creds.yml` 6. Open `nadekobot/output/creds.yml` with your favorite text editor. We will use nano here - `nano nadekobot/output/creds.yml` -7. [Enter your bot's token](../../creds-guide) +7. [Click here to follow creds guide](../../creds-guide) - After you're done, you can close nano (and save the file) by inputting, in order - `CTRL` + `X` - `Y` @@ -49,7 +49,7 @@ Open Terminal (if you're on an installation with a window manager) and navigate - `cp creds_example.yml creds.yml` 6. Open `creds.yml` with your favorite text editor. We will use nano here - `nano nadekobot/output/creds.yml` -8. [Enter your bot's token](../../creds-guide) +8. [Click here to follow creds guide](../../creds-guide) - After you're done, you can close nano (and save the file) by inputting, in order - `CTRL` + `X` - `Y` @@ -244,3 +244,34 @@ This method is similar to the one above, but requires one extra step, with the a 5. Start Nadeko: - `sudo systemctl start nadeko.service && sudo systemctl enable nadeko.service` + +### Setting up Nadeko on a Linux VPS (Digital Ocean Droplet) + +If you want Nadeko to play music for you 24/7 without having to hosting it on your PC and want to keep it cheap, reliable and convenient as possible, you can try Nadeko on Linux Digital Ocean Droplet using the link [DigitalOcean](http://m.do.co/c/46b4d3d44795/) (by using this link, you will get **$10 credit** and also support Nadeko) + +**Setting up NadekoBot** +Assuming you have followed the link above to setup an account and a Droplet with a 64-bit operational system on Digital Ocean and got the `IP address and root password (in your e-mail)` to login, it's time to get started. + +**This section is only relevant to those who want to host Nadeko on DigitalOcean. Go through this whole section before setting the bot up.** + +#### Prerequisites + +- Download [PuTTY](http://www.chiark.greenend.org.uk/~sgtatham/putty/download.html) +- Download [WinSCP](https://winscp.net/eng/download.php) *(optional)* +- [Create and invite the bot](../../creds-guide). + +#### Starting up + +- **Open PuTTY** and paste or enter your `IP address` and then click **Open**. + If you entered your Droplets IP address correctly, it should show **login as:** in a newly opened window. +- Now for **login as:**, type `root` and press enter. +- It should then ask for a password. Type the `root password` you have received in your e-mail address, then press Enter. + +If you are running your droplet for the first time, it will most likely ask you to change your root password. To do that, copy the **password you've received by e-mail** and paste it on PuTTY. + +- To paste, just right-click the window (it won't show any changes on the screen), then press Enter. +- Type a **new password** somewhere, copy and paste it on PuTTY. Press Enter then paste it again. + +**Save the new password somewhere safe.** + +After that, your droplet should be ready for use. [Follow the guide from the beginning](#linux-from-source) to set Nadeko up on your newly created VPS. diff --git a/docs/guides/windows-guide.md b/docs/guides/windows-guide.md index 9d95dba54..28f7cee03 100644 --- a/docs/guides/windows-guide.md +++ b/docs/guides/windows-guide.md @@ -12,11 +12,11 @@ | [Setup](#setup) | | [Starting the Bot](#starting-the-bot) | | [Updating Nadeko](#updating-nadeko) | -| [Manually Installing the Prerequisites from the Updater](#if-the-updater-fails-to-install-the-prerequisites-for-any-reason) | +| [Manually Installing the Prerequisites from the Updater](#music-prerequisites) | -*Note: If you want to make changes to Nadeko's source code, please follow the [From Source][SourceGuide] guide instead.* +*Note: If you want to make changes to Nadeko's source code, please follow the [From Source](#windows-from-source) guide instead.* -*If you have Windows 7 or a 32-bit system, please refer to the [From Source][SourceGuide] guide.* +*If you have Windows 7 or a 32-bit system, please refer to the [From Source](#windows-from-source)) guide.* #### Prerequisites @@ -38,7 +38,7 @@ - Click on **`DOWNLOAD`** at the lower right ![Bot Setup](https://i.imgur.com/HqAl36p.png "Bot Setup") - Click on **`Install`** next to **`Redis`**. -- **Note: If Redis fails to install, install Redis manually here: [Redis Installer](https://github.com/MicrosoftArchive/redis/releases/tag/win-3.0.504) Download and run the **`.msi`** file. +- Note: If Redis fails to install, install Redis manually here: [Redis Installer](https://github.com/MicrosoftArchive/redis/releases/tag/win-3.0.504) Download and run the **`.msi`** file. - If you will use the music module, click on **`Install`** next to **`FFMPEG`** and **`Youtube-DL`**. - If any dependencies fail to install, you can temporarily disable your Windows Defender/AV until you install them. If you don't want to, then read [the last section of this guide](#Manual-Prerequisite-Installation). - When installation is finished, click on **`CREDS`** to the left of **`RUN`** at the lower right. @@ -83,8 +83,8 @@ Open PowerShell (press windows button on your keyboard and type powershell, it s 1. `git clone https://gitlab.com/kwoth/nadekobot -b v3 --depth 1` 2. `cd nadekobot` 3. `dotnet publish -c Release -o output/ src/NadekoBot/` -4. `cd output' -5. 'cp creds_example.yml creds.yml` +4. `cd output` +5. `cp creds_example.yml creds.yml` 6. Open `creds.yml` with your favorite text editor (Please don't use Notepad or WordPad. You can use Notepad++, VSCode, Atom, Sublime, or something similar) 7. [Enter your bot's token](#creds-guide) 8. Run the bot `dotnet NadekoBot.dll` @@ -130,8 +130,6 @@ In order to use music commands, you need ffmpeg and youtube-dl installed. [Redis]: https://github.com/MicrosoftArchive/redis/releases/download/win-3.0.504/Redis-x64-3.0.504.msi [Visual C++ 2010 (x86)]: https://download.microsoft.com/download/1/6/5/165255E7-1014-4D0A-B094-B6A430A6BFFC/vcredist_x86.exe [Visual C++ 2017 (x64)]: https://aka.ms/vs/15/release/vc_redist.x64.exe -[SourceGuide]: ../from-source [ffmpeg-32bit]: https://cdn.nadeko.bot/dl/ffmpeg-32.zip [ffmpeg-64bit]: https://cdn.nadeko.bot/dl/ffmpeg-64.zip [youtube-dl]: https://yt-dl.org/downloads/latest/youtube-dl.exe - diff --git a/docs/jsons-explained.md b/docs/jsons-explained.md index c4a341769..0ed036302 100644 --- a/docs/jsons-explained.md +++ b/docs/jsons-explained.md @@ -11,6 +11,9 @@ This part is completely optional, **however it's necessary for music and a few o - Under the `YouTube APIs` section - Select `YouTube Data API v3`, - Click enable. + - Search for `Custom Search API` + - Select `Custom Search API`, + - Click enable. - Open up the `Navigation menu` on the top right with the three lines. - select `APIs & Services`, then select `Credentials`, - Click `Create Credentials` button, @@ -21,7 +24,7 @@ This part is completely optional, **however it's necessary for music and a few o - Open up `creds.yml` and look for `GoogleAPIKey`, paste your API key after the `:`. - It should look like this: ```yml - GoogleApiKey: "AIzaSyDSci1sdlWQOWNVj1vlXxxxxxbk0oWMEzM" + GoogleApiKey: AIzaSyDSci1sdlWQOWNVj1vlXxxxxxbk0oWMEzM ``` - **MashapeKey** - Required for Hearthstone cards. @@ -95,11 +98,10 @@ version: 1 token: 'MTE5Nzc3MDIxMzE5NTc3NjEw.VlhNCw.BuqJFyzdIUAK1PRf1eK1Cu89Jew' # List of Ids of the users who have bot owner permissions # **DO NOT ADD PEOPLE YOU DON'T TRUST** -ownerIds: [ - 105635123466156544, - 145521851676884992, - 341420590009417729 -] +ownerIds: + - 105635123466156544 + - 145521851676884992 + - 341420590009417729 # The number of shards that the bot will running on. # Leave at 1 if you don't know what you're doing. totalShards: 1 diff --git a/src/NadekoBot.Tests/NadekoBot.Tests.csproj b/src/NadekoBot.Tests/NadekoBot.Tests.csproj index 81056fc9e..a3681bdaf 100644 --- a/src/NadekoBot.Tests/NadekoBot.Tests.csproj +++ b/src/NadekoBot.Tests/NadekoBot.Tests.csproj @@ -9,7 +9,7 @@ - + diff --git a/src/NadekoBot/NadekoBot.csproj b/src/NadekoBot/NadekoBot.csproj index f3bd85e3b..3b7a33f30 100644 --- a/src/NadekoBot/NadekoBot.csproj +++ b/src/NadekoBot/NadekoBot.csproj @@ -14,21 +14,21 @@ - + - + - + - + all runtime; build; native; contentfiles; analyzers; buildtransitive - + all