| D++ (DPP) C++ Discord API Bot Library

Search
Loading...
Searching...
No Matches
Building a Discord Bot using CLion & VCPKG (Windows)

Warning
  This page is for Windows only. If you want to use CLion on Linux, look to use this page. Like always with windows, we highly recommends you use the pre-made Visual Studio template. This tutorial also assumes you have installed D++ via VCPKG already. If you haven't, look at this page.

### Changing Toolchains

Note
  If you have already configured your toolchain to use anything but MinGW64, then you can skip to the next section. Otherwise, it is critical that you follow along with this section. It should also be noted that you need Visual Studio for this.

Head on over to File > Settings (Ctrl+Alt+S), then navigate to Build, Execution, Deployment > Toolchains.

If there is a Visual Studio toolchain there, drag it to the top of the list. This will make the Visual Studio toolchain the default toolchain.

If you don't have the Visual Studio toolchain, you can hit the plus symbol above the list of toolchains and add a toolchain. This is also how you can add WSL as a toolchain!

From there, you need to drag it to the top (if it didn't already add at the top) to ensure it's the default toolchain.

### Using VCPKG with CLion

To use vcpkg in CLion, add the following line to your CMake options in the settings (Located under Settings > Build, Execution, Deployment > CMake)

-DCMAKE_TOOLCHAIN_FILE=path_to_vcpkg_root_folder/scripts/buildsystems/vcpkg.cmake

For example, if your root folder is C:/vcpkg/ then the CMake option will be:

-DCMAKE_TOOLCHAIN_FILE=C:/vcpkg/scripts/buildsystems/vcpkg.cmake

### Making a test application.

Open your main.cpp file and then copy and paste the following example program in. Then, set your bot token (see Creating a Bot Token). Here's how your main.cpp file should look:

#include <dpp/dpp.h>
const std::string BOT_TOKEN = "add your token here";
int main() {
dpp::cluster bot(BOT_TOKEN);
bot.on_log(dpp::utility::cout_logger());
bot.on_slashcommand([](const dpp::slashcommand_t& event) {
if (event.command.get_command_name() == "ping") {
event.reply("Pong!");
}
});
bot.on_ready([&bot](const dpp::ready_t& event) {
if (dpp::run_once<struct register_bot_commands>()) {
bot.global_command_create(dpp::slashcommand("ping", "Ping pong!", bot.me.id));
}
});
bot.start(dpp::st_wait);
}
dpp::cluster
The cluster class represents a group of shards and a command queue for sending and receiving commands...
Definition cluster.h:89
dpp::interaction::get_command_name
std::string get_command_name() const
Get the command name for a command interaction.
dpp::slashcommand
Represents an application command, created by your bot either globally, or on a guild.
Definition appcommand.h:1449
dpp::utility::cout_logger
std::function< void(const dpp::log_t &)> DPP_EXPORT cout_logger()
Get a default logger that outputs to std::cout. e.g.
dpp::run_once
auto run_once()
Run some code within an if() statement only once.
Definition once.h:41
dpp::st_wait
@ st_wait
Wait forever on a condition variable. The cluster will spawn threads for each shard and start() will ...
Definition cluster.h:72
dpp::interaction_create_t::command
interaction command
command interaction
Definition dispatcher.h:789
dpp::ready_t
Session ready.
Definition dispatcher.h:1072
dpp::slashcommand_t
User has issued a slash command.
Definition dispatcher.h:806

If everything went well, you should now have a functioning bot! If not, feel free to ask us on the D++ discord server.

### Troubleshooting

If you see a message like Detecting C compiler ABI info - failed or something along the lines of "cl.exe" is not able to compile a simple test program, then try to reinstall Windows Build Tools along with the Windows SDK from the Visual Studio Installer.

D++ Library version 9.0.13 D++ Library version 9.0.12 D++ Library version 9.0.11 D++ Library version 9.0.10 D++ Library version 9.0.9 D++ Library version 9.0.8 D++ Library version 9.0.7 D++ Library version 9.0.6 D++ Library version 9.0.5 D++ Library version 9.0.4 D++ Library version 9.0.3 D++ Library version 9.0.2 D++ Library version 9.0.1 D++ Library version 9.0.0 D++ Library version 1.0.2 D++ Library version 1.0.1 D++ Library version 1.0.0