Interface: CommandOptions
The Command options.
Since
1.0.0
Hierarchy
FlagStrategyOptions↳
CommandOptions
Properties
aliases
• Optional Readonly aliases: readonly string[]
The aliases for the piece.
Default
[]
Inherited from
AliasPiece.Options.aliases
Defined in
node_modules/@sapphire/pieces/dist/index.d.ts:671
cooldownDelay
• Optional cooldownDelay: number
The time in milliseconds for the cooldown entries to reset, if set to a non-zero value alongside cooldownLimit, the Cooldown precondition will be added to the list.
Since
2.0.0
Default
0
Defined in
projects/framework/src/lib/structures/Command.ts:666
cooldownFilteredUsers
• Optional cooldownFilteredUsers: string[]
The users that are exempt from the Cooldown precondition. Use this to filter out someone like a bot owner
Since
2.0.0
Default
undefined
Defined in
projects/framework/src/lib/structures/Command.ts:681
cooldownLimit
• Optional cooldownLimit: number
The amount of entries the cooldown can have before filling up, if set to a non-zero value alongside cooldownDelay, the Cooldown precondition will be added to the list.
Since
2.0.0
Default
1
Defined in
projects/framework/src/lib/structures/Command.ts:659
cooldownScope
• Optional cooldownScope: BucketScope
The scope of the cooldown entries.
Since
2.0.0
Default
BucketScope.User
Defined in
projects/framework/src/lib/structures/Command.ts:673
description
• Optional description: string
The description for the command.
Since
1.0.0
Default
''
Defined in
projects/framework/src/lib/structures/Command.ts:602
detailedDescription
• Optional detailedDescription: DetailedDescriptionCommand
The detailed description for the command.
Since
1.0.0
Default
''
Defined in
projects/framework/src/lib/structures/Command.ts:609
enabled
• Optional Readonly enabled: boolean
Whether or not the piece should be enabled. If set to false, the piece will be unloaded.
Default
true
Inherited from
AliasPiece.Options.enabled
Defined in
node_modules/@sapphire/pieces/dist/index.d.ts:420
flags
• Optional flags: boolean | readonly string[]
The accepted flags. Flags are key-only identifiers that can be placed anywhere in the command. Two different types are accepted:
- An array of strings, e.g. [
silent]. - A boolean defining whether the strategy should accept all keys (
true) or none at all (false).
Default
[]
Inherited from
FlagStrategyOptions.flags
Defined in
projects/framework/src/lib/utils/strategies/FlagUnorderedStrategy.ts:14
fullCategory
• Optional fullCategory: string[]
The full category path for the command
Since
2.0.0
Default
'An array of folder names that lead back to the folder that is registered for in the commands store'
Example
// Given a file named `ping.js` at the path of `commands/General/ping.js`
['General']
// Given a file named `info.js` at the path of `commands/General/About/ping.js`
['General', 'About']
Defined in
projects/framework/src/lib/structures/Command.ts:624
generateDashLessAliases
• Optional generateDashLessAliases: boolean
Whether to add aliases for commands with dashes in them
Since
1.0.0
Default
false
Defined in
projects/framework/src/lib/structures/Command.ts:588
generateUnderscoreLessAliases
• Optional generateUnderscoreLessAliases: boolean
Whether to add aliases for commands with underscores in them
Since
3.0.0
Default
false
Defined in
projects/framework/src/lib/structures/Command.ts:595
name
• Optional Readonly name: string
The name for the piece.
Default
''
Inherited from
AliasPiece.Options.name
Defined in
node_modules/@sapphire/pieces/dist/index.d.ts:415
nsfw
• Optional nsfw: boolean
Sets whether the command should be treated as NSFW. If set to true, the NSFW precondition will be added to the list.
Since
2.0.0
Default
false
Defined in
projects/framework/src/lib/structures/Command.ts:652
options
• Optional options: boolean | readonly string[]
The accepted options. Options are key-value identifiers that can be placed anywhere in the command. Two different types are accepted:
- An array of strings, e.g. [
silent]. - A boolean defining whether the strategy should accept all keys (
true) or none at all (false).
Default
[]
Inherited from
FlagStrategyOptions.options
Defined in
projects/framework/src/lib/utils/strategies/FlagUnorderedStrategy.ts:22
preconditions
• Optional preconditions: readonly PreconditionEntryResolvable[]
The Preconditions to be run, accepts an array of their names.
Seealso
Since
1.0.0
Default
[]
Defined in
projects/framework/src/lib/structures/Command.ts:632
prefixes
• Optional prefixes: string[]
The prefixes for both flags and options.
Default
['--', '-', '—']
Inherited from
FlagStrategyOptions.prefixes
Defined in
projects/framework/src/lib/utils/strategies/FlagUnorderedStrategy.ts:28
quotes
• Optional quotes: [string, string][]
The quotes accepted by this command, pass [] to disable them.
Since
1.0.0
Default
[
['"', '"'], // Double quotes
['“', '”'], // Fancy quotes (on iOS)
['「', '」'] // Corner brackets (CJK)
['«', '»'] // French quotes (guillemets)
]
Defined in
projects/framework/src/lib/structures/Command.ts:645
requiredClientPermissions
• Optional requiredClientPermissions: PermissionResolvable
The required permissions for the client.
Since
2.0.0
Default
0
Defined in
projects/framework/src/lib/structures/Command.ts:688
requiredUserPermissions
• Optional requiredUserPermissions: PermissionResolvable
The required permissions for the user.
Since
2.0.0
Default
0
Defined in
projects/framework/src/lib/structures/Command.ts:695
runIn
• Optional runIn: null | ChannelType | CommandOptionsRunType | CommandOptionsRunTypeEnum | readonly (ChannelType | CommandOptionsRunType | CommandOptionsRunTypeEnum)[]
The channels the command should run in. If set to null, no precondition entry will be added. Some optimizations are applied when given an array to reduce the amount of preconditions run (e.g. 'GUILD_TEXT' and 'GUILD_NEWS' becomes 'GUILD_ANY', and if both 'DM' and 'GUILD_ANY' are defined, then no precondition entry is added as it runs in all channels).
Since
2.0.0
Default
null
Defined in
projects/framework/src/lib/structures/Command.ts:702
separators
• Optional separators: string[]
The flag separators.
Default
['=', ':']
Inherited from
FlagStrategyOptions.separators
Defined in
projects/framework/src/lib/utils/strategies/FlagUnorderedStrategy.ts:34
typing
• Optional typing: boolean
If SapphireClient.typing is true, this option will override it. Otherwise, this option has no effect - you may call Channel#sendTyping` in the run method if you want specific commands to display the typing status.
Default
true