Comandos con barra en tu bot de Discord: opciones, subcomandos y permisos

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

const comandos = [
  new SlashCommandBuilder()
    .setName("dado")
    .setDescription("Tira un dado")
    .addIntegerOption((o) =>
      o.setName("caras").setDescription("Número de caras").setMinValue(2).setMaxValue(100)),
  new SlashCommandBuilder()
    .setName("aviso")
    .setDescription("Publica un aviso")
    .addStringOption((o) => o.setName("texto").setDescription("Lo que dice").setRequired(true))
    .addStringOption((o) =>
      o.setName("color").setDescription("Color del aviso").addChoices(
        { name: "Rojo", value: "rojo" },
        { name: "Verde", value: "verde" },
      )),
];

// En el InteractionCreate:
if (i.commandName === "dado") {
  const caras = i.options.getInteger("caras") ?? 6;
  await i.reply(`🎲 Ha salido un ${1 + Math.floor(Math.random() * caras)}`);
}
if (i.commandName === "aviso") {
  const texto = i.options.getString("texto", true);
  const color = i.options.getString("color") ?? "verde";
  await i.reply(`${color === "rojo" ? "🔴" : "🟢"} ${texto}`);
}

import random

import discord
from discord import app_commands


@tree.command(name="dado", description="Tira un dado")
@app_commands.describe(caras="Número de caras")
async def dado(interaction: discord.Interaction, caras: app_commands.Range[int, 2, 100] = 6):
    await interaction.response.send_message(f"🎲 Ha salido un {random.randint(1, caras)}")


@tree.command(name="aviso", description="Publica un aviso")
@app_commands.describe(texto="Lo que dice", color="Color del aviso")
@app_commands.choices(color=[
    app_commands.Choice(name="Rojo", value="rojo"),
    app_commands.Choice(name="Verde", value="verde"),
])
async def aviso(interaction: discord.Interaction, texto: str, color: str = "verde"):
    emoji = "🔴" if color == "rojo" else "🟢"
    await interaction.response.send_message(f"{emoji} {texto}")

new SlashCommandBuilder()
  .setName("musica")
  .setDescription("Controla la música")
  .addSubcommand((s) =>
    s.setName("poner").setDescription("Pone una canción")
      .addStringOption((o) => o.setName("cancion").setDescription("Nombre o enlace").setRequired(true)))
  .addSubcommand((s) => s.setName("parar").setDescription("Para la música"));

// En el InteractionCreate:
if (i.commandName === "musica") {
  const sub = i.options.getSubcommand(); // "poner" o "parar"
}

musica = app_commands.Group(name="musica", description="Controla la música")


@musica.command(name="poner", description="Pone una canción")
async def poner(interaction: discord.Interaction, cancion: str):
    await interaction.response.send_message(f"Poniendo {cancion}")


@musica.command(name="parar", description="Para la música")
async def parar(interaction: discord.Interaction):
    await interaction.response.send_message("Música parada")


tree.add_command(musica)

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

new SlashCommandBuilder()
  .setName("aviso")
  .setDescription("Publica un aviso")
  .setDefaultMemberPermissions(PermissionFlagsBits.ManageMessages);

@tree.command(name="aviso", description="Publica un aviso")
@app_commands.default_permissions(manage_messages=True)
async def aviso(interaction: discord.Interaction, texto: str):
    ...

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

await i.deferReply(); // «… está pensando»
const datos = await algoQueTarda();
await i.editReply(`Listo: ${datos}`);

// Solo la ve quien escribió el comando:
await i.reply({ content: "No tienes ningún aviso pendiente.", flags: MessageFlags.Ephemeral });

await interaction.response.defer()  # «… está pensando»
datos = await algo_que_tarda()
await interaction.followup.send(f"Listo: {datos}")

# Solo la ve quien escribió el comando:
await interaction.response.send_message("No tienes ningún aviso pendiente.", ephemeral=True)

const FRUTAS = ["manzana", "melón", "naranja", "pera", "plátano"];

// Al definir la opción: .addStringOption((o) => o.setName("fruta").setDescription("Cuál").setAutocomplete(true))

client.on(Events.InteractionCreate, async (i) => {
  if (i.isAutocomplete()) {
    const escrito = i.options.getFocused().toLowerCase();
    const encajan = FRUTAS.filter((f) => f.startsWith(escrito)).slice(0, 25);
    await i.respond(encajan.map((f) => ({ name: f, value: f })));
    return;
  }
  // … aquí, los comandos
});

FRUTAS = ["manzana", "melón", "naranja", "pera", "plátano"]


@tree.command(name="fruta", description="Elige una fruta")
async def fruta(interaction: discord.Interaction, fruta: str):
    await interaction.response.send_message(f"Has elegido {fruta}")


@fruta.autocomplete("fruta")
async def sugerir_fruta(interaction: discord.Interaction, actual: str):
    encajan = [f for f in FRUTAS if f.startswith(actual.lower())][:25]
    return [app_commands.Choice(name=f, value=f) for f in encajan]

const SERVIDOR_PRUEBAS = "123456789012345678"; // clic derecho en tu servidor → «Copiar ID del servidor»

// Solo en tu servidor de pruebas (al momento):
await c.application.commands.set(comandos.map((x) => x.toJSON()), SERVIDOR_PRUEBAS);
// Globales (en todos los servidores del bot):
await c.application.commands.set(comandos.map((x) => x.toJSON()));

SERVIDOR_PRUEBAS = discord.Object(id=123456789012345678)  # «Copiar ID del servidor»

# Solo en tu servidor de pruebas (al momento):
tree.copy_global_to(guild=SERVIDOR_PRUEBAS)
await tree.sync(guild=SERVIDOR_PRUEBAS)
# Globales (en todos los servidores del bot):
await tree.sync()