The basics of using commands

In Discord Bots, it is important to first know how commands are used, with legacy prefixed commands and the new Slash Commands system, it may get confusing with how many ways there are to use commands.

In the end, it all boils down to preferences!

How to Read Command Documentation:

Commands are documented by including their arguments / parameters in the command line. It is just text.

The different types of brackets pertain to whether a command argument is required or optional.

  • <arg_name>: The <less than and greater than> symbols mean that this command argument is required.
  • [arg_name]: The [square] brackets mean that this command argument is optional.

Infinite input:

  • <arg name...>: The ellipses mean that this command argument is infinite and all text going beyond will be considered as one argument.

  • [arg name...]: The ellipses mean that this command argument is infinite, yet optional and all text going beyond will be considered as one argument.

Prefixed Commands:

This is the original and OG way of using bot commands. It is currently the most stable way of using bot commands, aging finely from Discord’s roots.

At Succubus, we support three prefix systems, namely: @mention, user-prefix and guild-prefix.

By default, the prefix will always just be @mention and sc!

User Prefix:

User prefix lets you set your own preferred prefix globally that works on all servers. You may set it with:

sc!set user_prefix <prefix>

Ex: sc!set user_prefix .

Guild Prefix:

In discord, Servers are also known as “Guilds”. A guild prefix only applies to the server you are in. You may set it with:

sc!set guild_prefix <prefix>

Ex: sc!set guild_prefix .

Mention Prefix:

All bots have a username, and we use it as an always-unique prefix to pertain to the bot. It does not require any setup, simply mention the bot and **remove the space** after the username.

Example:

@Succubus✨help

This will run the help command.

B-but, mr. documentation person… What happens if I don’t remove the space?

The world will implode and humanity’s fate will be sealed in obscurity forever (kidding) The bot will treat this input as a message to the Chatbot, and will automagically reply to you unless otherwise configured with sc!chat set_disabled.

Click here to learn more about our AI Chatbot