Crear un bot de Discord #3 - ¡Añade subcomandos (Subcommand) a tus Slash Commands!

¡Hola! Soy Mojangcam 😎 ¡Esta vez toca una función un poco más avanzada! Vamos a ver los subcomandos, que agrupan varios Slash Commands.

Por ejemplo…

/user info → ver la información de un usuario
/user ban → bloquear a un usuario

¡La idea es meter varias funciones dentro de un solo grupo de comandos, así!

🧩 ¿Subcomandos? ¿Qué es eso?

Un subcomando es una estructura que se usa con la forma /명령어 서브명령어 (/comando subcomando). ¡Cuantas más funciones tenga tu bot, más útil es, porque te permite tenerlo todo bien ordenado!

🧑‍💻 Código de ejemplo

Python

import discord
from discord.ext import commands
from discord import app_commands

class UserCommandGroup(app_commands.Group):
    def __init__(self):
        super().__init__(name="user", description="¡Comandos relacionados con usuarios!")

    @app_commands.command(name="info", description="Muestra la información del usuario.")
    async def info(self, interaction: discord.Interaction, user: discord.User):
        await interaction.response.send_message(f"El ID de {user.name} es {user.id}.")

    @app_commands.command(name="ban", description="Bloquea al usuario.")
    async def ban(self, interaction: discord.Interaction, user: discord.User, reason: str):
        await interaction.response.send_message(f"¡Bloqueé a {user.name} por el motivo '{reason}'!")

intents = discord.Intents.default()
bot = commands.Bot(command_prefix="!", intents=intents)
bot.tree.add_command(UserCommandGroup())   # ¡Registra el grupo antes de llamar a sync()!

@bot.event
async def on_ready():
    await bot.tree.sync()
    print(f"✅ ¡El bot {bot.user} está listo!")

bot.run("YOUR_TOKEN")

🚀 Ejemplo de uso

/user info user:@JuanPérez → El ID de JuanPérez es 1234567890.
/user ban user:@JuanPérez reason:insultos → ¡Bloqueé a JuanPérez por el motivo 'insultos'!

🎁 Consejos extra

Puedes definir el nombre del grupo con name="..." y la descripción con description="...".
Para añadir comandos dentro del grupo, usa el decorador @app_commands.command().
¡Es perfecto cuando quieres agrupar funciones de administración, comandos de juego, comandos de configuración y cosas así en un servidor real!

📌 Para terminar

¡Los subcomandos se vuelven imprescindibles a medida que tu bot crece en funciones! Al agrupar los comandos de forma ordenada, tu bot se siente mucho más pulido.

La próxima vez…

¡Te enseñaré cómo añadir componentes de interfaz como botones y menús de selección (SelectMenu)! 😎