Setting up WizBot From Source

Table of Contents
Installing with the CLI Installer
Setup (CLI)
Launching WizBot (CLI)
Installing WizBot Manually
Setup
Launching WizBot
Updating WizBot

Installing with the CLI Installer

This is the recommended way of installing WizBot from source. If you don't want to use the installer, skip to Installing WizBot Manually.

Prerequisites (CLI)

Optional If you want WizBot to play music, do the following:

  • Install Visual C++ 2010 (x86) and Visual C++ 2017 (both are required - restart Windows after installation)
  • youtube-dl - Click on Windows.exe (on the top left corner) and download the file. Then move it to C:\youtube-dl. If the folder youtube-dl doesn't exist, create one.

Setup (CLI)

  • Download the CLI installer. Move it to where you want WizBot's files to be.
  • Right click the file and extract it.
  • Right click the WizBotInstaller.bat file and open it as Administrator
  • After the admin check, you should see main menu with the options below:
1. Download Latest Build
2. Run WizBot (normally)
3. Run WizBot with Auto Restart (check "if" WizBot is working properly, before using this)
4. Setup credentials.json
5. Install ffmpeg (for music)
6. Redis Installation (Opens Website) (64bit)
7. Run Redis (if its not running) (64bit)
8. Install Youtube-dl. (Opens Website)
9. Add Youtube-dl to PATH.
10. Add Redis to PATH. (Advanced Users Only) ("Run Redis" is enough for Normal Users.) (64bit)
11. Install .NET Core SDK (Opens Website)
12. Install Git. (Opens Website)
13. Copy libsodium and opus dll files for 32bit users. (Required for 32bit, Music)
14. Download and run redis-server for 32bit users. (32bit)
15. To exit
  • Run Option 1 to download WizBot (type 1 and press Enter). Once it's done, it should take you back to the main menu.
  • Run Option 4 to set up your credentials. Paste the info as requested.
    • If your Windows is 32-bit, run Option 14 now. Otherwise, ignore this step.
  • WizBot should be ready to launch. Run Option 2 to test it out. If everything goes well, WizBot should appear as online on your Discord server and respond to commands. Once you're done with testing, type .die to shut it down and return to the installer's main menu.

If you don't want the music features, you can launch WizBot with Option 3 and have fun with your newly created bot. Otherwise, follow the steps below.

  • If you haven't downloaded youtube-dl.exe and moved it to C:\youtube-dl yet, then do it now.
    • If your Windows is 32-bit, run Option 13. Otherwise, ignore this step.
  • Run Option 5 to download ffmpeg.
  • Run Option 9 to add youtube-dl.exe to your system's path environment variable.
  • That's it. You're done. Launch WizBot with Option 3 and have fun sharing music with your friends.

Launching WizBot (CLI)

  • Just open the CLI installer and run Option 2 or 3. Easy as that.

Installing WizBot Manually

This is the "hard" way of installing WizBot. If you're here, we are assuming you know what the hell you're doing.

Prerequisites

Optional
If you want WizBot to play music, do the following:

  • Notepad++ (makes it easier to edit your credentials)
  • Install Visual C++ 2010 (x86) and Visual C++ 2017 (both are required - restart Windows after installation)
  • youtube-dl - Click on Windows.exe (on the top left corner) and download the file. Store it somewhere accessible.
  • ffmpeg - Download the Static, Release build for your system and architecture. Extract it, then find and copy the ffmpeg.exe file to somewhere accessible.
  • For 32-bit Windows, download libsodium and (lib)opus and store them somewhere accessible.

Setup

  • Open command prompt (cmd.exe) and run the following command to download the source:
  • git clone -b 1.9 https://gitlab.com/Wizkiller96/WizBot
  • On Windows Explorer, go to WizBot/src/WizBot and edit the credentials.json file according to this guide.
  • Add these 2 arguments to your credentials file:
    "ShardRunCommand": "dotnet",
    "ShardRunArguments": "run -c Release --no-build -- {0} {1}",
  • Move youtube-dl.exe and ffmpeg.exe into wizBot/src/wizBot (or add them to your PATH environment variable, if you know how)
  • For 32-bit Windows, replace libsodium.dll and opus.dll in wizBot/src/wizBot with the ones you've downloaded.

Launching WizBot

  • For 32-bit Windows, run the redis-server.exe you have downloaded. You must have this window open while using WizBot.
  • On command prompt, move to the correct directory:
  • cd WizBot/src/WizBot
  • Build and run WizBot:
  • dotnet run -c Release
  • If everything goes well, WizBot should start up and show as online in your Discord server.

Updating WizBot

If you have not made custom edits to the source code.

  • If you're using the CLI installer, shut your bot down and run Option 1. That's it.
  • If you've installed manually, open command prompt (cmd.exe)
  • Move to WizBot's root folder:
  • cd WizBot
  • Update WizBot:
  • git pull

If you have made custom edits to the source code.

  • Open command prompt (cmd.exe)
  • Move to WizBot's root folder:
  • cd WizBot
  • Stash your changes:
  • git stash save "give me a nice name dd-mm-yyyy" or just git stash
  • Update WizBot:
  • git pull
  • Apply your stash:
  • git stash apply or git stash apply [email protected]{n} (where n is the ID of the stash)

Other useful commands:

  • git status to check the changes you've made
  • git stash list to see the list of saved stashes and their corresponding ID
  • git stash drop [email protected]{n} to delete a specific stash
  • git stash pop [email protected]{n} to apply and delete a specific stash