Slash Commands

Let’s create a simple ping command. Create a new file in your interactions directory called ping.js and add the following code.

import { SlashCommand } from 'hiei.js'
import { PermissionFlagsBits } from 'discord.js'

class Ping extends SlashCommand {
  constructor () {
    super({
      name: 'ping',
      description: 'Check if the bot is online'
    })
  }

  run (interaction) {
    return interaction.reply({ content: 'Pong!' })
  }
}

export default Ping

At minimum, your slash command must have a name, description, and run() function defined.

The code you put in your run() function will run when the command is invoked. The interaction parameter gives you access to the interaction that triggered the command.

Options

For more advanced commands, you can add options that allow people to send more data along with the command, such as a user or a role. For example, you might set up a user info command like this:

import { SlashCommand } from 'hiei.js'
import { ApplicationCommandOptionType, PermissionFlagsBits } from 'discord.js'

class UserInfo extends SlashCommand {
  constructor () {
    super({
      name: 'userinfo',
      description: 'Learn more about a user',
      options: [
        {
          type: ApplicationCommandOptionType.User,
          name: 'user',
          description: 'The user you want to learn about',
          required: true
        }
      ]
    })
  }

  run (interaction) {
    // ...
  }
}

export default UserInfo

Learn about parsing options here.

Cooldowns

You can avoid command spam by adding a cooldown. This requires two things: a cooldown property and a special onCooldown() function.

Let’s add a cooldown to our Ping command.

import { SlashCommand } from 'hiei.js'
import { PermissionFlagsBits } from 'discord.js'

class Ping extends SlashCommand {
  constructor () {
    super({
      name: 'ping',
      description: 'Check if the bot is online',
      cooldown: 5000
    })
  }

  onCooldown (interaction, cooldown, remaining) {
    return interaction.reply({ content: `Command is on cooldown. Expires in ${remaining}. Last used by ${cooldown.member.user.username} at ${time(new Date(cooldown.timestamp))}.`, ephemeral: true })
  }

  run (interaction) {
    return interaction.reply({ content: 'Pong!', ephemeral: true })
  }
}

export default Ping

The cooldown property takes a number in milliseconds. I set it to 5000, which equates to 5 seconds. I recommend using a package like ms to write the cooldown in human-readable language.

The onCooldown() function will run when the command is invoked if it is on cooldown. In this case, we return a simple message that lets the user know when the cooldown expires. It also tells them who last used the command and when.