D++ (DPP)
C++ Discord API Bot Library
Using sub-commands in slash commands

This is how to use Subcommands within your Slash Commands for your bots.

To make a subcomamnd within your command use this

#include <dpp/dpp.h>
#include <fmt/format.h>
#include <iostream>
int main() {
/* Setup the bot */
dpp::cluster bot("token");
/* Executes on ready. */
bot.on_ready([&bot](const dpp::ready_t & event) {
if (dpp::run_once<struct register_bot_commands>()) {
// Define a slash command.
dpp::slashcommand image("image", "Send a specific image.", bot.me.id);
image.add_option(
// Create a subcommand type option.
dpp::command_option(dpp::co_sub_command, "dog", "Send a picture of a dog.").
add_option(dpp::command_option(dpp::co_user, "user", "User to make a dog off.", false))
);
image.add_option(
// Create another subcommand type option.
dpp::command_option(dpp::co_sub_command, "cat", "Send a picture of a cat.").
add_option(dpp::command_option(dpp::co_user, "user", "User to make a cat off.", false))
);
// Create command with a callback.
bot.global_command_create(image, [ & ]( const dpp::confirmation_callback_t &callback ) {
if (callback.is_error()) {
std::cout << callback.http_info.body << "\n" ;
}
});
}
});
/* Use the on_slashcommand event to look for commands */
bot.on_slashcommand([&bot](const dpp::slashcommand_t & event) {
dpp::command_interaction cmd_data = event.command.get_command_interaction();
/* Check if the command is the image command. */
if (event.command.get_command_name() == "image") {
/* Check if the subcommand is "dog" */
if (cmd_data.options[0].name == "dog") {
/* Checks if the subcommand has any options. */
if (cmd_data.options[0].options.size() > 0) {
/* Get the user option as a snowflake. */
dpp::snowflake user = std::get<dpp::snowflake>(cmd_data.options[0].options[0].value);
event.reply("<@" + std::to_string(user) + "> has now been turned into a dog."));
} else {
/* Reply if there were no options.. */
event.reply("<A picture of a dog.>");
}
}
/* Check if the subcommand is "cat" */
if (cmd_data.options[0].name == "cat") {
/* Checks if the subcommand has any options. */
if (cmd_data.options[0].options.size() > 0) {
/* Get the user option as a snowflake. */
dpp::snowflake user = std::get<dpp::snowflake>(cmd_data.options[0].options[0].value);
event.reply("<@" + std::to_string(user) + "> has now been turned into acat."));
} else {
/* Reply if there were no options.. */
event.reply("<A picture of a cat.>");
}
}
}
});
bot.start(dpp::st_wait);
return 0;
}
The cluster class represents a group of shards and a command queue for sending and receiving commands...
Definition: cluster.h:271
std::string get_command_name() const
Get the command name for a command interaction.
Represents an application command, created by your bot either globally, or on a guild.
Definition: appcommand.h:826
std::function< void(const dpp::log_t &)> DPP_EXPORT cout_logger()
Get a default logger that outputs to std::cout. e.g.
uint64_t snowflake
A 64 bit unsigned value representing many things on discord. Discord calls the value a 'snowflake' va...
Definition: snowflake.h:32
@ co_sub_command
Definition: appcommand.h:50
@ co_user
Definition: appcommand.h:60
@ st_wait
Wait forever on a condition variable. The cluster will spawn threads for each shard and start() will ...
Definition: cluster.h:254
Details of a command within an interaction. This subobject represents the application command associa...
Definition: appcommand.h:554
std::vector< command_data_option > options
Optional: the params + values from the user.
Definition: appcommand.h:557
Each command option is a command line parameter. It can have a type (see dpp::command_option_type),...
Definition: appcommand.h:150
The results of a REST call wrapped in a convenient struct.
Definition: restresults.h:238
bool is_error() const
Returns true if the call resulted in an error rather than a legitimate value in the confirmation_call...
interaction command
command interaction
Definition: dispatcher.h:488
Session ready.
Definition: dispatcher.h:783
User has issued a slash command.
Definition: dispatcher.h:499
D++ Library version 10.0.16D++ Library version 10.0.15D++ Library version 10.0.14D++ Library version 10.0.13D++ Library version 10.0.12D++ Library version 10.0.11D++ Library version 10.0.10D++ Library version 10.0.9D++ Library version 10.0.8D++ Library version 10.0.7D++ Library version 10.0.6D++ Library version 10.0.5D++ Library version 10.0.4D++ Library version 10.0.3D++ Library version 10.0.2D++ Library version 10.0.1D++ Library version 10.0.0D++ Library version 9.0.19D++ Library version 9.0.18D++ Library version 9.0.17D++ Library version 9.0.16D++ Library version 9.0.15D++ Library version 9.0.14D++ Library version 9.0.13D++ Library version 9.0.12D++ Library version 9.0.11D++ Library version 9.0.10D++ Library version 9.0.9D++ Library version 9.0.8D++ Library version 9.0.7D++ Library version 9.0.6D++ Library version 9.0.5D++ Library version 9.0.4D++ Library version 9.0.3D++ Library version 9.0.2D++ Library version 9.0.1D++ Library version 9.0.0D++ Library version 1.0.2D++ Library version 1.0.1D++ Library version 1.0.0