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 <dpp/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(fmt::format("<@{}> has now been turned into a dog.", user));
} 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(fmt::format("<@{}> has now been turned into a cat.", user));
} else {
/* Reply if there were no options.. */
event.reply("<A picture of a cat.>");
}
}
}
});
bot.start(false);
return 0;
}
The cluster class represents a group of shards and a command queue for sending and receiving commands...
Definition: cluster.h:469
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:810
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
Details of a command within an interaction. This subobject represents the application command associa...
Definition: appcommand.h:538
std::vector< command_data_option > options
Optional: the params + values from the user.
Definition: appcommand.h:541
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: cluster.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.35D++ Library version 10.0.34D++ Library version 10.0.33D++ Library version 10.0.32D++ Library version 10.0.31D++ Library version 10.0.30D++ Library version 10.0.29D++ Library version 10.0.28D++ Library version 10.0.27D++ Library version 10.0.26D++ Library version 10.0.25D++ Library version 10.0.24D++ Library version 10.0.23D++ Library version 10.0.22D++ Library version 10.0.21D++ Library version 10.0.20D++ Library version 10.0.19D++ Library version 10.0.18D++ Library version 10.0.17D++ 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