Documentation ¶
Index ¶
- Variables
- func AddRootCommands(p common.Plugin, cmds ...*YAGCommand)
- func AddRootCommandsWithMiddlewares(p common.Plugin, middlewares []dcmd.MiddleWareFunc, cmds ...*YAGCommand)
- func BlockingAddRunningCommand(guildID int64, channelID int64, authorID int64, cmd *YAGCommand, ...) bool
- func CensorError(err error) string
- func ChannelOverrideMiddleware(...) web.ControllerHandlerFunc
- func CmdNotFound(search string) string
- func CommonContainerNotFoundHandler(container *dcmd.Container, fixedMessage string) func(data *dcmd.Data) (interface{}, error)
- func ContainerSlashCommandPermissions(container *slashCommandsContainer, ...) ([]*discordgo.ApplicationCommandPermissions, error)
- func FilterBadInvites(msg string, guildID int64, replacement string) string
- func FilterResp(in interface{}, guildID int64) interface{}
- func GetAllOverrides(ctx context.Context, guildID int64) ([]*models.CommandsChannelsOverride, error)
- func GetCommandPrefixBotEvt(evt *eventsystem.EventData) (string, error)
- func GetCommandPrefixRedis(guild int64) (string, error)
- func GetOverridesForChannel(channelID, channelParentID, guildID int64) ([]*models.CommandsChannelsOverride, error)
- func HandleCommands(w http.ResponseWriter, r *http.Request) (web.TemplateData, error)
- func HandleCreateChannelsOverride(w http.ResponseWriter, r *http.Request) (web.TemplateData, error)
- func HandleCreateCommandOverride(w http.ResponseWriter, r *http.Request, ...) (web.TemplateData, error)
- func HandleDeleteChannelsOverride(w http.ResponseWriter, r *http.Request, ...) (web.TemplateData, error)
- func HandleDeleteCommandOverride(w http.ResponseWriter, r *http.Request, ...) (web.TemplateData, error)
- func HandlePostCommands(w http.ResponseWriter, r *http.Request) (web.TemplateData, error)
- func HandleUpdateChannelsOverride(w http.ResponseWriter, r *http.Request, ...) (web.TemplateData, error)
- func HandleUpdateCommandOVerride(w http.ResponseWriter, r *http.Request, ...) (web.TemplateData, error)
- func InitCommands()
- func IsSlashCommandPermissionCommandEnabled(fullName string, overrides []*models.CommandsChannelsOverride) bool
- func NewUserError(a ...interface{}) error
- func NewUserErrorf(f string, a ...interface{}) error
- func PubsubSendUpdateSlashCommandsPermissions(gID int64)
- func RegisterPlugin()
- func RegisterSlashCommandsContainer(container *dcmd.Container, defaultPermissions bool, rolesRunFunc RolesRunFunc)
- func TmplExecCmdFuncs(ctx *templates.Context, maxExec int, dryRun bool) (userCtxCommandExec cmdExecFunc, botCtxCommandExec cmdExecFunc)
- func YAGCommandMiddleware(inner dcmd.RunFunc) dcmd.RunFunc
- type CanExecuteError
- type CanExecuteType
- type ChannelOverrideForm
- type CommandOverrideForm
- type CommandProvider
- type CommandSettings
- type ContextKey
- type CtxKey
- type DurationArg
- func (d *DurationArg) HelpName() string
- func (d *DurationArg) Matches(def *dcmd.ArgDef, part string) bool
- func (d *DurationArg) ParseFromInteraction(def *dcmd.ArgDef, data *dcmd.Data, options *dcmd.SlashCommandsParseOptions) (val interface{}, err error)
- func (d *DurationArg) ParseFromMessage(def *dcmd.ArgDef, part string, data *dcmd.Data) (interface{}, error)
- func (d *DurationArg) SlashCommandOptions(def *dcmd.ArgDef) []*discordgo.ApplicationCommandOption
- type DurationOutOfRangeError
- type EphemeralOrGuild
- type EphemeralOrNone
- type MemberArg
- func (ma *MemberArg) ExtractID(part string, data *dcmd.Data) int64
- func (ma *MemberArg) HelpName() string
- func (ma *MemberArg) Matches(def *dcmd.ArgDef, part string) bool
- func (ma *MemberArg) ParseFromInteraction(def *dcmd.ArgDef, data *dcmd.Data, options *dcmd.SlashCommandsParseOptions) (val interface{}, err error)
- func (ma *MemberArg) ParseFromMessage(def *dcmd.ArgDef, part string, data *dcmd.Data) (interface{}, error)
- func (ma *MemberArg) SlashCommandOptions(def *dcmd.ArgDef) []*discordgo.ApplicationCommandOption
- type MessageFilterFunc
- type Plugin
- func (p *Plugin) AllFeatureFlags() []string
- func (p *Plugin) BotInit()
- func (p *Plugin) InitWeb()
- func (p *Plugin) LoadServerHomeWidget(w http.ResponseWriter, r *http.Request) (web.TemplateData, error)
- func (p *Plugin) PluginInfo() *common.PluginInfo
- func (p *Plugin) Prefix(data *dcmd.Data) string
- func (p *Plugin) StopBot(wg *sync.WaitGroup)
- func (p *Plugin) UpdateFeatureFlags(guildID int64) ([]string, error)
- type PublicError
- type RoleArg
- func (ra *RoleArg) ExtractID(part string, data *dcmd.Data) interface{}
- func (ra *RoleArg) HelpName() string
- func (ra *RoleArg) Matches(def *dcmd.ArgDef, part string) bool
- func (ra *RoleArg) ParseFromInteraction(def *dcmd.ArgDef, data *dcmd.Data, options *dcmd.SlashCommandsParseOptions) (val interface{}, err error)
- func (ra *RoleArg) ParseFromMessage(def *dcmd.ArgDef, part string, data *dcmd.Data) (interface{}, error)
- func (ra *RoleArg) SlashCommandOptions(def *dcmd.ArgDef) []*discordgo.ApplicationCommandOption
- type RolesRunFunc
- type RunningCommand
- type UserError
- type YAGCommand
- func (yc *YAGCommand) ArgDefs(data *dcmd.Data) (args []*dcmd.ArgDef, required int, combos [][]int)
- func (yc *YAGCommand) Category() *dcmd.Category
- func (yc *YAGCommand) Descriptions(data *dcmd.Data) (short, long string)
- func (yc *YAGCommand) FindNameFromContainerChain(cc []*dcmd.Container) string
- func (cs *YAGCommand) GetSettings(containerChain []*dcmd.Container, channelID, channelParentID, guildID int64) (settings *CommandSettings, err error)
- func (cs *YAGCommand) GetSettingsWithLoadedOverrides(containerChain []*dcmd.Container, guildID int64, ...) (settings *CommandSettings, err error)
- func (yc *YAGCommand) GetTrigger() *dcmd.Trigger
- func (cs *YAGCommand) GuildScopeCooldownLeft(cc []*dcmd.Container, guildID int64) (int, error)
- func (yc *YAGCommand) Logger(data *dcmd.Data) *logrus.Entry
- func (cs *YAGCommand) LongestCooldownLeft(cc []*dcmd.Container, userID int64, guildID int64) (int, error)
- func (yc *YAGCommand) PostCommandExecuted(settings *CommandSettings, cmdData *dcmd.Data, resp interface{}, err error)
- func (yc *YAGCommand) Run(data *dcmd.Data) (interface{}, error)
- func (cs *YAGCommand) SetCooldownGuild(cc []*dcmd.Container, guildID int64) error
- func (cs *YAGCommand) SetCooldownUser(cc []*dcmd.Container, userID int64) error
- func (cs *YAGCommand) SetCooldowns(cc []*dcmd.Container, userID int64, guildID int64) error
- func (yc *YAGCommand) SlashCommandPermissions(overrides []*models.CommandsChannelsOverride, defaultEnabeld bool, ...) (allowRoles []int64, denyRoles []int64, allowAll bool, denyAll bool, err error)
- func (yc *YAGCommand) Switches() []*dcmd.ArgDef
- func (yc *YAGCommand) TopLevelSlashCommandPermissions(overrides []*models.CommandsChannelsOverride, gs *dstate.GuildSet) ([]*discordgo.ApplicationCommandPermissions, error)
- func (cs *YAGCommand) UserScopeCooldownLeft(cc []*dcmd.Container, userID int64) (int, error)
Constants ¶
This section is empty.
Variables ¶
var ( CategoryGeneral = &dcmd.Category{ Name: "General", Description: "General & informational commands", HelpEmoji: "ℹ️", EmbedColor: 0xe53939, } CategoryTool = &dcmd.Category{ Name: "Tools & Utilities", Description: "Various miscellaneous commands", HelpEmoji: "🔨", EmbedColor: 0xeaed40, } CategoryModeration = &dcmd.Category{ Name: "Moderation", Description: "Moderation commands", HelpEmoji: "👮", EmbedColor: 0xdb0606, } CategoryFun = &dcmd.Category{ Name: "Fun", Description: "Various commands meant for entertainment", HelpEmoji: "🎉", EmbedColor: 0x5ae26c, } CategoryDebug = &dcmd.Category{ Name: "Debug & Maintenance", Description: "Debug and other commands to inspect the bot", HelpEmoji: "🖥", EmbedColor: 0, } )
var ( RKeyCommandCooldown = func(uID int64, cmd string) string { return "cmd_cd:" + discordgo.StrID(uID) + ":" + cmd } RKeyCommandCooldownGuild = func(gID int64, cmd string) string { return "cmd_guild_cd:" + discordgo.StrID(gID) + ":" + cmd } RKeyCommandLock = func(uID int64, cmd string) string { return "cmd_lock:" + discordgo.StrID(uID) + ":" + cmd } CommandExecTimeout = time.Minute )
var (
CommandSystem *dcmd.System
)
var DBSchemas = []string{`
CREATE TABLE IF NOT EXISTS commands_channels_overrides (
id BIGSERIAL PRIMARY KEY,
guild_id BIGINT NOT NULL,
channels BIGINT[],
channel_categories BIGINT[],
global bool NOT NULL,
commands_enabled BOOL NOT NULL,
autodelete_response BOOL NOT NULL,
autodelete_trigger BOOL NOT NULL,
autodelete_response_delay INT NOT NULL,
autodelete_trigger_delay INT NOT NULL,
require_roles BIGINT[] NOT NULL,
ignore_roles BIGINT[] NOT NULL
);
`, `
CREATE INDEX IF NOT EXISTS commands_channels_overrides_guild_idx ON commands_channels_overrides(guild_id);
`, `
CREATE UNIQUE INDEX IF NOT EXISTS commands_channels_overrides_global_uniquex ON commands_channels_overrides (guild_id) WHERE global;
`, `
CREATE TABLE IF NOT EXISTS commands_command_overrides (
id BIGSERIAL PRIMARY KEY,
guild_id BIGINT NOT NULL,
commands_channels_overrides_id BIGINT references commands_channels_overrides(id) ON DELETE CASCADE NOT NULL,
commands TEXT[] NOT NULL,
commands_enabled BOOL NOT NULL,
autodelete_response BOOL NOT NULL,
autodelete_trigger BOOL NOT NULL,
autodelete_response_delay INT NOT NULL,
autodelete_trigger_delay INT NOT NULL,
require_roles BIGINT[] NOT NULL,
ignore_roles BIGINT[] NOT NULL
);
`, `
CREATE INDEX IF NOT EXISTS commands_command_groups_channels_override_idx ON commands_command_overrides(commands_channels_overrides_id);
`}
var MessageFilterFuncs []MessageFilterFunc
These functions are called on every message, and should return true if the message should be checked for commands, false otherwise
var PageHTML string
Functions ¶
func AddRootCommands ¶
func AddRootCommands(p common.Plugin, cmds ...*YAGCommand)
func AddRootCommandsWithMiddlewares ¶ added in v1.19.0
func AddRootCommandsWithMiddlewares(p common.Plugin, middlewares []dcmd.MiddleWareFunc, cmds ...*YAGCommand)
func BlockingAddRunningCommand ¶ added in v1.17.2
func CensorError ¶
Keys and other sensitive information shouldnt be sent in error messages, but just in case it is
func ChannelOverrideMiddleware ¶ added in v1.4.1
func ChannelOverrideMiddleware(inner func(w http.ResponseWriter, r *http.Request, override *models.CommandsChannelsOverride) (web.TemplateData, error)) web.ControllerHandlerFunc
Channel override handlers
func CmdNotFound ¶
func CommonContainerNotFoundHandler ¶ added in v1.13.0
func CommonContainerNotFoundHandler(container *dcmd.Container, fixedMessage string) func(data *dcmd.Data) (interface{}, error)
CommonContainerNotFoundHandler is a common "NotFound" handler that should be used with dcmd containers it ensures that no messages is sent if none of the commands in te container is enabeld if "fixedMessage" is empty, then it shows default generated container help
func ContainerSlashCommandPermissions ¶ added in v1.31.10
func ContainerSlashCommandPermissions(container *slashCommandsContainer, overrides []*models.CommandsChannelsOverride, gs *dstate.GuildSet) ([]*discordgo.ApplicationCommandPermissions, error)
Since we can't put permissions on subcommands we do a similar thing we do to command settings that is
func FilterBadInvites ¶ added in v1.5.2
func FilterResp ¶ added in v1.6.0
func FilterResp(in interface{}, guildID int64) interface{}
func GetAllOverrides ¶ added in v1.31.10
func GetAllOverrides(ctx context.Context, guildID int64) ([]*models.CommandsChannelsOverride, error)
GetAllOverrides returns all channel overrides and ensures the global override with atleast a default is present
func GetCommandPrefixBotEvt ¶ added in v1.31.10
func GetCommandPrefixBotEvt(evt *eventsystem.EventData) (string, error)
func GetCommandPrefixRedis ¶ added in v1.31.10
func GetOverridesForChannel ¶ added in v1.13.0
func GetOverridesForChannel(channelID, channelParentID, guildID int64) ([]*models.CommandsChannelsOverride, error)
func HandleCommands ¶
func HandleCommands(w http.ResponseWriter, r *http.Request) (web.TemplateData, error)
Servers the command page with current config
func HandleCreateChannelsOverride ¶ added in v1.4.1
func HandleCreateChannelsOverride(w http.ResponseWriter, r *http.Request) (web.TemplateData, error)
func HandleCreateCommandOverride ¶ added in v1.4.1
func HandleCreateCommandOverride(w http.ResponseWriter, r *http.Request, channelOverride *models.CommandsChannelsOverride) (web.TemplateData, error)
Command handlers
func HandleDeleteChannelsOverride ¶ added in v1.4.1
func HandleDeleteChannelsOverride(w http.ResponseWriter, r *http.Request, currentOverride *models.CommandsChannelsOverride) (web.TemplateData, error)
func HandleDeleteCommandOverride ¶ added in v1.4.1
func HandleDeleteCommandOverride(w http.ResponseWriter, r *http.Request, channelOverride *models.CommandsChannelsOverride) (web.TemplateData, error)
func HandlePostCommands ¶
func HandlePostCommands(w http.ResponseWriter, r *http.Request) (web.TemplateData, error)
Handles the updating of global and per channel command settings
func HandleUpdateChannelsOverride ¶ added in v1.4.1
func HandleUpdateChannelsOverride(w http.ResponseWriter, r *http.Request, currentOverride *models.CommandsChannelsOverride) (web.TemplateData, error)
func HandleUpdateCommandOVerride ¶ added in v1.4.1
func HandleUpdateCommandOVerride(w http.ResponseWriter, r *http.Request, channelOverride *models.CommandsChannelsOverride) (web.TemplateData, error)
func InitCommands ¶ added in v1.4.1
func InitCommands()
func IsSlashCommandPermissionCommandEnabled ¶ added in v1.31.10
func IsSlashCommandPermissionCommandEnabled(fullName string, overrides []*models.CommandsChannelsOverride) bool
IsSlashCommandPermissionCommandEnabled following up on the no per channel permissions for slash commands This might seem like a mouthfull but essentially for us to be able to disable a command in a guild it has to be disabled in all channels. If its enabled it atleast 1 channel override of command override we need to be able to pick it from the slash command list
func NewUserError ¶ added in v1.31.10
func NewUserError(a ...interface{}) error
func NewUserErrorf ¶ added in v1.31.10
func PubsubSendUpdateSlashCommandsPermissions ¶ added in v1.31.10
func PubsubSendUpdateSlashCommandsPermissions(gID int64)
func RegisterPlugin ¶
func RegisterPlugin()
func RegisterSlashCommandsContainer ¶ added in v1.31.10
func RegisterSlashCommandsContainer(container *dcmd.Container, defaultPermissions bool, rolesRunFunc RolesRunFunc)
register containers seperately as they need special handling
note: we could infer all the info from the members of the container but i felt that this explicit method was better and less quirky
func TmplExecCmdFuncs ¶
func TmplExecCmdFuncs(ctx *templates.Context, maxExec int, dryRun bool) (userCtxCommandExec cmdExecFunc, botCtxCommandExec cmdExecFunc)
Returns 2 functions to execute commands in user or bot context with limited about of commands executed
func YAGCommandMiddleware ¶ added in v1.4.1
func YAGCommandMiddleware(inner dcmd.RunFunc) dcmd.RunFunc
Types ¶
type CanExecuteError ¶ added in v1.31.10
type CanExecuteError struct { Type CanExecuteType Message string }
type CanExecuteType ¶ added in v1.31.10
type CanExecuteType int
const ( ReasonError CanExecuteType = iota ReasonCommandDisabaledSettings ReasonMissingRole ReasonIgnoredRole ReasonUserMissingPerms ReasonBotMissingPerms ReasonCooldown )
type ChannelOverrideForm ¶ added in v1.4.1
type ChannelOverrideForm struct { Channels []int64 `valid:"channel,true"` ChannelCategories []int64 `valid:"channel,true"` Global bool CommandsEnabled bool AutodeleteResponse bool AutodeleteTrigger bool AutodeleteResponseDelay int AutodeleteTriggerDelay int RequireRoles []int64 `valid:"role,true"` IgnoreRoles []int64 `valid:"role,true"` }
type CommandOverrideForm ¶ added in v1.4.1
type CommandProvider ¶ added in v1.4.1
type CommandProvider interface {
// This is where you should register your commands, called on both the webserver and the bot
AddCommands()
}
type CommandSettings ¶ added in v1.4.1
type DurationArg ¶
func (*DurationArg) HelpName ¶
func (d *DurationArg) HelpName() string
func (*DurationArg) Matches ¶
func (d *DurationArg) Matches(def *dcmd.ArgDef, part string) bool
func (*DurationArg) ParseFromInteraction ¶ added in v1.31.10
func (d *DurationArg) ParseFromInteraction(def *dcmd.ArgDef, data *dcmd.Data, options *dcmd.SlashCommandsParseOptions) (val interface{}, err error)
func (*DurationArg) ParseFromMessage ¶ added in v1.31.10
func (d *DurationArg) ParseFromMessage(def *dcmd.ArgDef, part string, data *dcmd.Data) (interface{}, error)
func (*DurationArg) SlashCommandOptions ¶ added in v1.31.10
func (d *DurationArg) SlashCommandOptions(def *dcmd.ArgDef) []*discordgo.ApplicationCommandOption
type DurationOutOfRangeError ¶ added in v1.5.1
func (*DurationOutOfRangeError) Error ¶ added in v1.5.1
func (o *DurationOutOfRangeError) Error() string
type EphemeralOrGuild ¶ added in v1.31.10
type EphemeralOrGuild struct { Content string Embed *discordgo.MessageEmbed }
func (*EphemeralOrGuild) Send ¶ added in v1.31.10
func (e *EphemeralOrGuild) Send(data *dcmd.Data) ([]*discordgo.Message, error)
type EphemeralOrNone ¶ added in v1.31.10
type EphemeralOrNone struct { Content string Embed *discordgo.MessageEmbed }
func (*EphemeralOrNone) Send ¶ added in v1.31.10
func (e *EphemeralOrNone) Send(data *dcmd.Data) ([]*discordgo.Message, error)
type MemberArg ¶ added in v1.17.0
type MemberArg struct{}
MemberArg matches a id or mention and returns a MemberState object for the user
func (*MemberArg) ParseFromInteraction ¶ added in v1.31.10
func (*MemberArg) ParseFromMessage ¶ added in v1.31.10
func (*MemberArg) SlashCommandOptions ¶ added in v1.31.10
func (ma *MemberArg) SlashCommandOptions(def *dcmd.ArgDef) []*discordgo.ApplicationCommandOption
type MessageFilterFunc ¶ added in v1.4.8
type MessageFilterFunc func(evt *eventsystem.EventData, msg *discordgo.Message) bool
type Plugin ¶
type Plugin struct{}
func (*Plugin) AllFeatureFlags ¶ added in v1.31.10
func (*Plugin) LoadServerHomeWidget ¶ added in v1.17.0
func (p *Plugin) LoadServerHomeWidget(w http.ResponseWriter, r *http.Request) (web.TemplateData, error)
func (*Plugin) PluginInfo ¶ added in v1.17.0
func (p *Plugin) PluginInfo() *common.PluginInfo
type PublicError ¶ added in v1.5.1
type PublicError string
PublicError is a error that is both logged and returned as a response
func NewPublicError ¶ added in v1.5.1
func NewPublicError(a ...interface{}) PublicError
func NewPublicErrorF ¶ added in v1.5.1
func NewPublicErrorF(f string, a ...interface{}) PublicError
func (PublicError) Error ¶ added in v1.5.1
func (p PublicError) Error() string
type RoleArg ¶ added in v1.31.10
type RoleArg struct{}
RoleArg matches an id or name and returns a discordgo.Role
func (*RoleArg) ParseFromInteraction ¶ added in v1.31.10
func (*RoleArg) ParseFromMessage ¶ added in v1.31.10
func (*RoleArg) SlashCommandOptions ¶ added in v1.31.10
func (ra *RoleArg) SlashCommandOptions(def *dcmd.ArgDef) []*discordgo.ApplicationCommandOption
type RolesRunFunc ¶ added in v1.31.10
type RunningCommand ¶ added in v1.17.2
type RunningCommand struct { GuildID int64 ChannelID int64 AuthorID int64 Command *YAGCommand }
type UserError ¶ added in v1.31.10
type UserError string
UserError is a special error type that is only sent as a response, and not logged
func (UserError) IsUserError ¶ added in v1.31.10
type YAGCommand ¶
type YAGCommand struct { Name string // Name of command, what its called from Aliases []string // Aliases which it can also be called from Description string // Description shown in non targetted help LongDescription string // Longer description when this command was targetted Arguments []*dcmd.ArgDef // Slice of argument definitions, ctx.Args will always be the same size as this slice (although the data may be nil) RequiredArgs int // Number of reuquired arguments, ignored if combos is specified ArgumentCombos [][]int // Slice of argument pairs, will override RequiredArgs if specified ArgSwitches []*dcmd.ArgDef // Switches for the commadn to use AllowEveryoneMention bool HideFromCommandsPage bool // Set to hide this command from the commands page Key string // GuildId is appended to the key, e.g if key is "test:", it will check for "test:<guildid>" CustomEnabled bool // Set to true to handle the enable check itself Default bool // The default enabled state of this command Cooldown int // Cooldown in seconds before user can use it again CmdCategory *dcmd.Category GuildScopeCooldown int RunInDM bool // Set to enable this commmand in DM's HideFromHelp bool // Set to hide from help RequireDiscordPerms []int64 // Require users to have one of these permission sets to run the command RequireBotPerms [][]int64 // Discord permissions that the bot needs to run the command, (([0][0] && [0][1] && [0][2]) || ([1][0] && [1][1]...)) Middlewares []dcmd.MiddleWareFunc // Run is ran the the command has sucessfully been parsed // It returns a reply and an error // the reply can have a type of string, *MessageEmbed or error RunFunc dcmd.RunFunc Plugin common.Plugin // Slash commands integration (this is unused on sub commands) // // Note about channel overrides: // Since the slash commands permissions is limited to roles/users only and can't be per channel, it takes the common set of roles required to run the command between all overrides // e.g if the command does not require a role in one channel, but it requires one in another channel, then the required permission for the slash command will be none set, // note that these settings are still checked when the command is run, but they just show the command in the client even if you can't use it in this case, so its just a visual limitation of slash commands. // // If it's disabled in all chanels, then for default_enabled = true commands, it adds the everyone role to the blacklist, otherwise it adds no role to the whitelist (does this even work? can i use the everyone role in this context?) SlashCommandEnabled bool // Wether the command is enabled in all guilds by default or not DefaultEnabled bool // If default enabled = false // then this returns the roles that CAN use the command // if default enabled = true // then this returns the roles that CAN'T use the command RolesRunFunc RolesRunFunc // contains filtered or unexported fields }
Slight extension to the simplecommand, it will check if the command is enabled in the HandleCommand func And invoke a custom handlerfunc with provided redis client
func (*YAGCommand) ArgDefs ¶
func (yc *YAGCommand) ArgDefs(data *dcmd.Data) (args []*dcmd.ArgDef, required int, combos [][]int)
func (*YAGCommand) Category ¶
func (yc *YAGCommand) Category() *dcmd.Category
CmdWithCategory puts the command in a category, mostly used for the help generation
func (*YAGCommand) Descriptions ¶
func (yc *YAGCommand) Descriptions(data *dcmd.Data) (short, long string)
func (*YAGCommand) FindNameFromContainerChain ¶ added in v1.31.10
func (yc *YAGCommand) FindNameFromContainerChain(cc []*dcmd.Container) string
func (*YAGCommand) GetSettings ¶ added in v1.4.1
func (cs *YAGCommand) GetSettings(containerChain []*dcmd.Container, channelID, channelParentID, guildID int64) (settings *CommandSettings, err error)
GetSettings returns the settings from the command, generated from the servers channel and command overrides
func (*YAGCommand) GetSettingsWithLoadedOverrides ¶ added in v1.13.0
func (cs *YAGCommand) GetSettingsWithLoadedOverrides(containerChain []*dcmd.Container, guildID int64, channelOverrides []*models.CommandsChannelsOverride) (settings *CommandSettings, err error)
func (*YAGCommand) GetTrigger ¶
func (yc *YAGCommand) GetTrigger() *dcmd.Trigger
func (*YAGCommand) GuildScopeCooldownLeft ¶ added in v1.31.10
func (cs *YAGCommand) GuildScopeCooldownLeft(cc []*dcmd.Container, guildID int64) (int, error)
GuildScopeCooldownLeft returns the number of seconds before a command can be used again on this server
func (*YAGCommand) Logger ¶
func (yc *YAGCommand) Logger(data *dcmd.Data) *logrus.Entry
func (*YAGCommand) LongestCooldownLeft ¶ added in v1.31.10
func (cs *YAGCommand) LongestCooldownLeft(cc []*dcmd.Container, userID int64, guildID int64) (int, error)
LongestCooldownLeft returns the longest cooldown for this command, either user scoped or guild scoped
func (*YAGCommand) PostCommandExecuted ¶ added in v1.4.1
func (yc *YAGCommand) PostCommandExecuted(settings *CommandSettings, cmdData *dcmd.Data, resp interface{}, err error)
PostCommandExecuted sends the response and handles the trigger and response deletions
func (*YAGCommand) Run ¶
func (yc *YAGCommand) Run(data *dcmd.Data) (interface{}, error)
func (*YAGCommand) SetCooldownGuild ¶ added in v1.31.10
func (cs *YAGCommand) SetCooldownGuild(cc []*dcmd.Container, guildID int64) error
SetCooldownGuild sets the guild scoped cooldown of the command as it's defined in the struct
func (*YAGCommand) SetCooldownUser ¶ added in v1.31.10
func (cs *YAGCommand) SetCooldownUser(cc []*dcmd.Container, userID int64) error
SetCooldownUser sets the user scoped cooldown of the command as it's defined in the struct
func (*YAGCommand) SetCooldowns ¶ added in v1.31.10
func (cs *YAGCommand) SetCooldowns(cc []*dcmd.Container, userID int64, guildID int64) error
SetCooldowns is a helper that serts both User and Guild cooldown
func (*YAGCommand) SlashCommandPermissions ¶ added in v1.31.10
func (yc *YAGCommand) SlashCommandPermissions(overrides []*models.CommandsChannelsOverride, defaultEnabeld bool, containerChain []*dcmd.Container, gs *dstate.GuildSet) (allowRoles []int64, denyRoles []int64, allowAll bool, denyAll bool, err error)
func (*YAGCommand) Switches ¶
func (yc *YAGCommand) Switches() []*dcmd.ArgDef
func (*YAGCommand) TopLevelSlashCommandPermissions ¶ added in v1.31.10
func (yc *YAGCommand) TopLevelSlashCommandPermissions(overrides []*models.CommandsChannelsOverride, gs *dstate.GuildSet) ([]*discordgo.ApplicationCommandPermissions, error)
func (*YAGCommand) UserScopeCooldownLeft ¶ added in v1.31.10
func (cs *YAGCommand) UserScopeCooldownLeft(cc []*dcmd.Container, userID int64) (int, error)
UserScopeCooldownLeft returns the number of seconds before a command can be used again by this user