Setting Up WizBot on Windows from source

Prerequisites

• Windows 10 or later (64-bit)
• .net 8 sdk
• If you want wizbot to play music: [Visual C++ 2010 (x86)] and [Visual C++ 2017 (x64)] (both are required, you may install them later)
• git - needed to clone the repository (you can also download the zip manually and extract it, but this guide assumes you're using git)
• Optional Any code editor, for example Visual Studio Code
  • You'll need to at least modify creds.yml, notepad is inadequate

---

Creating a Discord Bot & Getting Credentials

Creating your own Discord bot

This guide will show you how to create your own discord bot, invite it to your server, and obtain the credentials needed to run it.

1. Go to the Discord developer application page.
2. Log in with your Discord account.
3. Click New Application.
4. Fill out the Name field however you like, accept the terms, and confirm.
5. Go to the Bot tab on the left sidebar.
6. Click on the Add a Bot button and confirm that you do want to add a bot to this app.
7. Optional: Add bot's avatar and description.
8. Copy your Token to creds.yml as shown above.
9. Scroll down to the Privileged Gateway Intents section
   • You MUST enable the following:
     • PRESENCE INTENT
     • SERVER MEMBERS INTENT
     • MESSAGE CONTENT INTENT

Inviting your bot to your server

• On the General Information tab, copy your Application ID from your applications page.
• Replace the YOUR_CLIENT_ID_HERE in this link: https://discordapp.com/oauth2/authorize?client_id=YOUR_CLIENT_ID_HERE&scope=bot&permissions=66186303 with your Client ID
• The link should now look something like this: https://discordapp.com/oauth2/authorize?client_id=123123123123&scope=bot&permissions=66186303
• Access that newly created link, pick your Discord server, click Authorize and confirm with the captcha at the end
• The bot should now be in your server

---

Installation Instructions

Open PowerShell (press windows button on your keyboard and type powershell, it should show up; alternatively, right click the start menu and select Windows PowerShell), and

1. Navigate to the location where you want to install the bot
   • for example, type cd ~/Desktop/ and press enter
2. git clone https://github.com/Wizkiller96/WizBot -b v6 --depth 1
3. cd WizBot/src/WizBot
4. dotnet build -c Release
5. cp data/creds_example.yml data/creds.yml
6. "You're done installing, you may now proceed to set up your bot's credentials by following the [#creds-guide]
   • Once done, come back here and run the last command
7. Run the bot dotnet WizBot.dll
8. 🎉 Enjoy

Update Instructions

Open PowerShell as described above and run the following commands:

1. Stop the bot
   • ⚠️ Make sure you don't have your database, credentials or any other wizbot folder open in some application, this might prevent some of the steps from executing successfully
2. Navigate to your bot's folder, example:
   • cd ~/Desktop/WizBot
3. Pull the new version, and make sure you're on the v6 branch
   • git pull
   • ⚠️ IF this fails, you may want to git stash or remove your code changes if you don't know how to resolve merge conflicts
4. Backup old output in case your data is overwritten
   • cp -r -fo output/ output-old
5. Build the bot again
   • dotnet run -c Release src/WizBot/
6. Copy old data, and new strings
   • cp -r -fo .\output-old\data\ .\output\
7. Run the bot
   • cd output
   • dotnet WizBot.dll
8. 🎉 Enjoy

Music Prerequisites

In order to use music commands, you need ffmpeg and yt-dlp installed.

• ffmpeg
• yt-dlp
  • Click to download the yt-dlp.exe file, then move yt-dlp.exe to a path that's in your PATH environment variable. If you don't know what that is, just move the yt-dlp.exe file to your wizbot's output folder.