DiscordKt/me.jakejmattson.discordkt.commands

Package me.jakejmattson.discordkt.commands

Command builders, events, and functions.

Types

open class CommandEvent<T : TypeContainer>( val rawInputs: RawInputs, val discord: Discord, val message: Message?, val author: User, val channel: MessageChannel, val guild: Guild?) : Responder

A generic command execution event.

CommandSet

class CommandSet( category: String, requiredPermissionLevel: Permissions?, collector: CommandSetBuilder.() -> Unit) : BuilderRegister

This is not for you...

CommandSetBuilder

data class CommandSetBuilder( val discord: Discord, val category: String, requiredPermissions: Permissions)

DSL used to build a set of commands.

ContextCommand

class ContextCommand( val name: String, val displayText: String, var description: String, val category: String, var requiredPermissions: Permissions, val executions: MutableList<Execution<CommandEvent<*>>> = mutableListOf()) : GuildSlashCommand

A command that can be executed via the context menu.

ContextEvent

data class ContextEvent<T>( val rawInputs: RawInputs, val discord: Discord, val message: Message?, val author: User, val channel: MessageChannel, val guild: Guild, val interaction: GuildApplicationCommandInteraction?, val arg: T) : SlashCommandEvent<Args1<T>> , SlashResponder

An event fired by a contextual slash command.

DiscordContext

open class DiscordContext( val discord: Discord, val message: Message?, val author: User, val channel: MessageChannelBehavior, val guild: Guild?) : Responder

The discord context of the command execution.

DmCommandEvent

data class DmCommandEvent<T : TypeContainer>( val rawInputs: RawInputs, val discord: Discord, val message: Message, val author: User, val channel: DmChannel, val guild: Guild? = null) : CommandEvent<T>

An event that can only be fired in a DM.

DmTextCommand

class DmTextCommand( val names: List<String>, var description: String = "", val category: String, var requiredPermissions: Permissions, val executions: MutableList<Execution<CommandEvent<*>>> = mutableListOf()) : TextCommand

A text command that can only be executed in a DM.

Execution

data class Execution<T : CommandEvent<*>>(val arguments: List<Argument<*, *>>, val action: suspend T.() -> Unit)

The bundle of information to be executed when a command is invoked.

GlobalSlashCommand

class GlobalSlashCommand( val name: String, var description: String, val category: String, var requiredPermissions: Permissions, val executions: MutableList<Execution<CommandEvent<*>>> = mutableListOf()) : SlashCommand

A slash command that can be executed anywhere.

GlobalTextCommand

class GlobalTextCommand( val names: List<String>, var description: String = "", val category: String, var requiredPermissions: Permissions, val executions: MutableList<Execution<CommandEvent<*>>> = mutableListOf()) : TextCommand

A text command that can be executed from anywhere.

GuildCommandEvent

data class GuildCommandEvent<T : TypeContainer>( val rawInputs: RawInputs, val discord: Discord, val message: Message, val author: User, val channel: GuildMessageChannel, val guild: Guild) : CommandEvent<T>

An event that can only be fired in a guild.

GuildSlashCommand

open class GuildSlashCommand( val name: String, var description: String, val category: String, var requiredPermissions: Permissions, val executions: MutableList<Execution<CommandEvent<*>>> = mutableListOf()) : SlashCommand

A slash command that can be executed in a guild.

GuildSlashCommandEvent

data class GuildSlashCommandEvent<T : TypeContainer>( val rawInputs: RawInputs, val discord: Discord, val message: Message?, val author: User, val channel: MessageChannel, val guild: Guild, val interaction: GuildApplicationCommandInteraction?) : SlashCommandEvent<T> , SlashResponder

An event fired by a guild slash command.

GuildTextCommand

class GuildTextCommand( val names: List<String>, var description: String = "", val category: String, var requiredPermissions: Permissions, val executions: MutableList<Execution<CommandEvent<*>>> = mutableListOf()) : TextCommand

A text command that can only be executed in a guild.

RawInputs

data class RawInputs( val rawMessageContent: String, val commandName: String, val prefixCount: Int, val commandArgs: List<String> = rawMessageContent.split(" ").drop(1))

Data class containing the raw information from the command execution.

SlashCommand

interface SlashCommand : Command

Abstract slash command representation.

SlashCommandEvent

open class SlashCommandEvent<T : TypeContainer>( val rawInputs: RawInputs, val discord: Discord, val message: Message?, val author: User, val channel: MessageChannel, val guild: Guild? = null, val interaction: ApplicationCommandInteraction?) : CommandEvent<T> , SlashResponder

An event fired by a slash command.

SubCommandSet

class SubCommandSet( name: String, requiredPermissionLevel: Permissions?, collector: SubCommandSetBuilder.() -> Unit) : BuilderRegister

This is not for you...

SubCommandSetBuilder

data class SubCommandSetBuilder( val discord: Discord, val category: String, requiredPermissions: Permissions)

DSL used to build a set of commands.

TextCommand

interface TextCommand : Command

Abstract text command representation.

Functions

commands

fun commands( category: String, requiredPermissionLevel: Permissions? = null, construct: CommandSetBuilder.() -> Unit): CommandSet

Create a block for registering commands.

findByName

fun <T : Command> List<T>.findByName(name: String): T?

Find a command by its name (case-insensitive).

subcommand

fun subcommand( name: String, requiredPermissionLevel: Permissions? = null, construct: SubCommandSetBuilder.() -> Unit): SubCommandSet

Create a block for registering commands.