Slash Commands in Your Discord Bot: Options, Subcommands and Permissions

const { SlashCommandBuilder } = require("discord.js");

const commands = [
  new SlashCommandBuilder()
    .setName("dice")
    .setDescription("Roll a die")
    .addIntegerOption((o) =>
      o.setName("sides").setDescription("Number of sides").setMinValue(2).setMaxValue(100)),
  new SlashCommandBuilder()
    .setName("announce")
    .setDescription("Post an announcement")
    .addStringOption((o) => o.setName("text").setDescription("What it says").setRequired(true))
    .addStringOption((o) =>
      o.setName("colour").setDescription("Announcement colour").addChoices(
        { name: "Red", value: "red" },
        { name: "Green", value: "green" },
      )),
];

// In InteractionCreate:
if (i.commandName === "dice") {
  const sides = i.options.getInteger("sides") ?? 6;
  await i.reply(`🎲 You rolled a ${1 + Math.floor(Math.random() * sides)}`);
}
if (i.commandName === "announce") {
  const text = i.options.getString("text", true);
  const colour = i.options.getString("colour") ?? "green";
  await i.reply(`${colour === "red" ? "🔴" : "🟢"} ${text}`);
}

import random

import discord
from discord import app_commands


@tree.command(name="dice", description="Roll a die")
@app_commands.describe(sides="Number of sides")
async def dice(interaction: discord.Interaction, sides: app_commands.Range[int, 2, 100] = 6):
    await interaction.response.send_message(f"🎲 You rolled a {random.randint(1, sides)}")


@tree.command(name="announce", description="Post an announcement")
@app_commands.describe(text="What it says", colour="Announcement colour")
@app_commands.choices(colour=[
    app_commands.Choice(name="Red", value="red"),
    app_commands.Choice(name="Green", value="green"),
])
async def announce(interaction: discord.Interaction, text: str, colour: str = "green"):
    emoji = "🔴" if colour == "red" else "🟢"
    await interaction.response.send_message(f"{emoji} {text}")

new SlashCommandBuilder()
  .setName("music")
  .setDescription("Control the music")
  .addSubcommand((s) =>
    s.setName("play").setDescription("Play a song")
      .addStringOption((o) => o.setName("song").setDescription("Name or link").setRequired(true)))
  .addSubcommand((s) => s.setName("stop").setDescription("Stop the music"));

// In InteractionCreate:
if (i.commandName === "music") {
  const sub = i.options.getSubcommand(); // "play" or "stop"
}

music = app_commands.Group(name="music", description="Control the music")


@music.command(name="play", description="Play a song")
async def play(interaction: discord.Interaction, song: str):
    await interaction.response.send_message(f"Playing {song}")


@music.command(name="stop", description="Stop the music")
async def stop(interaction: discord.Interaction):
    await interaction.response.send_message("Music stopped")


tree.add_command(music)

const { PermissionFlagsBits } = require("discord.js");

new SlashCommandBuilder()
  .setName("announce")
  .setDescription("Post an announcement")
  .setDefaultMemberPermissions(PermissionFlagsBits.ManageMessages);

@tree.command(name="announce", description="Post an announcement")
@app_commands.default_permissions(manage_messages=True)
async def announce(interaction: discord.Interaction, text: str):
    ...

const { MessageFlags } = require("discord.js");

await i.deferReply(); // “… is thinking”
const data = await somethingSlow();
await i.editReply(`Done: ${data}`);

// Only the person who ran the command sees it:
await i.reply({ content: "You have no pending announcements.", flags: MessageFlags.Ephemeral });

await interaction.response.defer()  # “… is thinking”
data = await something_slow()
await interaction.followup.send(f"Done: {data}")

# Only the person who ran the command sees it:
await interaction.response.send_message("You have no pending announcements.", ephemeral=True)

const FRUITS = ["apple", "banana", "melon", "orange", "pear"];

// When defining the option: .addStringOption((o) => o.setName("fruit").setDescription("Which one").setAutocomplete(true))

client.on(Events.InteractionCreate, async (i) => {
  if (i.isAutocomplete()) {
    const typed = i.options.getFocused().toLowerCase();
    const matches = FRUITS.filter((f) => f.startsWith(typed)).slice(0, 25);
    await i.respond(matches.map((f) => ({ name: f, value: f })));
    return;
  }
  // … the commands go here
});

FRUITS = ["apple", "banana", "melon", "orange", "pear"]


@tree.command(name="fruit", description="Pick a fruit")
async def fruit(interaction: discord.Interaction, fruit: str):
    await interaction.response.send_message(f"You picked {fruit}")


@fruit.autocomplete("fruit")
async def suggest_fruit(interaction: discord.Interaction, current: str):
    matches = [f for f in FRUITS if f.startswith(current.lower())][:25]
    return [app_commands.Choice(name=f, value=f) for f in matches]

const TEST_SERVER = "123456789012345678"; // right-click your server → “Copy Server ID”

// Only on your test server (straight away):
await c.application.commands.set(commands.map((x) => x.toJSON()), TEST_SERVER);
// Global (on every server the bot is in):
await c.application.commands.set(commands.map((x) => x.toJSON()));

TEST_SERVER = discord.Object(id=123456789012345678)  # “Copy Server ID”

# Only on your test server (straight away):
tree.copy_global_to(guild=TEST_SERVER)
await tree.sync(guild=TEST_SERVER)
# Global (on every server the bot is in):
await tree.sync()