Slash Structure
Warning
This feature is still in beta, meaning a lot of bugs can be expected. If you find any, please report them to our GitHub!
We highly recommand to turn on debug mode (in Disky's configuration) to see more details about the errors you may encounter!
DiSky v4.17 introduce a brand-new way to create, register and handle slash commands, in a all-in-one way! It utilizes the new Skript structure system to make it easier to create and manage your slash commands.
Core Structure
If you're not familiar with Skript structures, read this tutorial
The core structure of a slash command is the following:
You have two things to replace here:
{name}
This is the name of your slash command. It must be unique, and can only contain alphanumeric characters. Do not include the / prefix.
{arguments}
This is the list of arguments your slash command will have. It works the same as Skript's command arguments, but the only a few types are supported:
| Type | Description | Support Choices |
|---|---|---|
string |
A simple text argument | |
integer |
An integer argument (1, 2, 3, ...) |
|
number |
An number argument (6, 3.14, ...) |
|
user |
A Discord user argument | |
channel |
A Discord channel argument (also includes categories) | |
role |
A Discord role argument | |
boolean |
A boolean argument (true or false) |
|
attachment |
A file attachment argument |
An argument format is <type="name">, and can be surrounded by [] to make it optional.
Entries
Description
If not specified, the description will default to No description provided.. It is recommended to provide a description for your command:
slash command level:
description:
fr: Vérifiez votre niveau
en: Check your own level # same as 'en-US'
Check your own level for English clients, and Vérifiez votre niveau for French clients. Check the list of Discord locales here.
Registration
This will tell DiSky where and how to register your slash command:
- If there's only a
botentry, it'll register globally. - If there's also a
guildentry, it'll register per-guild (with the specified bot)
Example
Execution
This is where you put the code that will be executed when the command is called:
slash command level:
description: Check your own level
bot: my_bot
trigger:
# Your code here. It's like a 'on slash command' event, meaning you can reply to the interaction and all.
# You can also uses the argument system, such as `arg-1` for the first argument, `arg-2` for the second, etc.
reply with hidden "You're level XXX!"
Arguments
Although we defined the argument's type (and name) in the command's structure, we can add more details about them, such as the argument's description and choices. This entry takes argument's names as keys:
Description
slash command level [<user="target">]:
description: Check your level
arguments:
target: #(1)!
description: The user to check the level of
-
If you only provide a description, you can directly write it after the argument's name, like this:
Choices
Choices are a way to limit the user's input to a list of predefined values. They are only available for string, integer and number arguments.
slash command set_level <user="target"> [<integer="level">]:
description: Change someone's level
guilds: 937001799896956988
bot: disky
arguments:
target: The user to change the level of
level:
description: The new level
choices:
# <name on Discord> : <value in Skript>
Level 1: 1
Level 2: 2
Level 3: 3
trigger:
reply with "Changed %mention tag of arg-1%'s level to %arg-2%"
In this example, the level argument will only accept Level 1, Level 2 or Level 3, and arg-1 will be replaced by the corresponding value (1, 2 or 3).
Auto Completion
If you want to provide auto-completion for your arguments, you can use the on completion request entry. The provided code will be ran when the user is typing the argument's value.
slash command set_level <user="target"> [<integer="level">]:
description: Change someone's level
guilds: 937001799896956988
bot: disky
arguments:
target: The user to change the level of
level:
description: The new level
on completion request:
loop 5 times:
add new choice "Level %loop-value%" with value loop-value to {_c::*}
return {_c::*}
trigger:
reply with "Changed %mention tag of arg-1%'s level to %arg-2%"
You cannot mix choices and on completion request, as one argument cannot have both.
Permissions
You can restrict who can use your command by using the enabled for entry. It takes a list of permissions, and will only allow users with one of these permissions to use the command. In additions, you can set true to the disabled entry to disable the command to everyone except admins:
slash command level:
description: Check your own level
bot: my_bot
enabled for: manage server, administrator
trigger:
reply with hidden "You're level XXX!"
Cooldown System
DiSky offer a built-in cooldown system for slash commands. Cooldowns are per-user, and a specific code can be run when the user is on cooldown.
slash command level:
description: Check your own level
bot: my_bot
cooldown: 1 minute
on cooldown:
if discord id of event-user is "XXX":
cancel event #(1)!
stop
reply with "You still have to wait %remaining time% before using this command again!"
trigger:
reply with hidden "You're level XXX!"
- The
on cooldownsection is run the same as a slash command event, and can be used to let specific users bypass the cooldown. Simply usecancel eventto let the command execute normally!