Slash commands and interactions are a newer feature of Discord which allow bot's commands to be registered centrally within the system and for users to easily explore and get help with avaialble commands through the client itself.
To add a slash command you should use the dpp::cluster::global_command_create method for global commands (available to all guilds) or dpp::cluster::guild_command_create to create a local command (available only to one guild).
When a user issues these commands the reply will arrive via the on_interaction_create event which you can hook, and take action when you see your commands. It is possible to reply to an interaction by using either the dpp::interaction_create_t::reply method, or by manually instantiating an object of type dpp::interaction_response and attaching a dpp::message object to it.
dpp::interaction_create_t::reply has two overloaded versions of the method, one of which accepts simple std::string replies, for basic text-only messages (if your message is 'ephemeral' you must use this) and one which accepts a dpp::message for more advanced replies. Please note that at present, Discord only supports a small subset of message and embed features within an interaction response object.
- Note
- You can also use the unified command handler, which lets you combine channel based message commands and slash commands under the same lambda with the same code like they were one and the same. Note that after April of 2022 Discord will be discouraging bots from using commands that are prefixed messages via means of a privileged message intent. It is advised that you exclusively use slash commands, or the unified handler with only a prefix of "/" going forward for any new bots you create and look to migrating existing bots to this setup.
#include <dpp/dpp.h>
#include <dpp/fmt/format.h>
int main()
{
dpp::command_interaction cmd_data = std::get<dpp::command_interaction>(event.command.data);
if (cmd_data.name == "blep") {
std::string animal = std::get<std::string>(event.get_parameter("animal"));
event.reply(dpp::ir_channel_message_with_source, fmt::format("Blep! You chose {}", animal));
}
}
});
.set_description("Send a random adorable animal photo")
.set_application_id(bot.me.id)
)
)
);
bot.global_command_create(newcommand);
});
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:221
uint8_t type
the type of interaction
Definition: slashcommand.h:333
Represents an application command, created by your bot either globally, or on a guild.
Definition: slashcommand.h:432
slashcommand & add_option(const command_option &o)
Add an option (parameter)
slashcommand & set_name(const std::string &n)
Set the name of the command.
@ it_application_command
application command (slash command)
Definition: slashcommand.h:277
@ co_string
Definition: slashcommand.h:40
This struct represents choices in a multiple choice option for a command parameter....
Definition: slashcommand.h:69
Each command option is a command line parameter. It can have a type (see dpp::command_option_type),...
Definition: slashcommand.h:105
Create interaction.
Definition: dispatcher.h:140
interaction command
Definition: dispatcher.h:195
Session ready.
Definition: dispatcher.h:304