Crear un bot de Discord#6¡Implementa menús desplegables (Select Menu)!

¡Hola! Soy Mojangcam 😎

En el episodio #5 vimos cómo interactuar con el bot mediante botones (Button), ¿verdad? Esta vez vamos un paso más allá y crearemos un menú desplegable (Select Menu).

Los botones van bien cuando hay 2 o 3 opciones, pero cuando pasas de 5, la pantalla se llena de botones. En esos casos, con un menú desplegable puedes meter hasta 25 opciones de forma ordenada en un solo menú. ¡Se usa muchísimo para elegir roles, hacer encuestas o seleccionar servidores de juego!

📌 Lo que necesitas

• Python 3.8 o superior
• discord.py 2.x (¡los Select Menu están disponibles desde la 2.0!)
• Token del bot + el bot ya invitado a tu servidor (¡mira el episodio 1!)

pip install -U discord.py

Puedes comprobar la versión con pip show discord.py. ¡Si es 2.x o superior, todo listo! En la versión 1.x no funciona.

📌 Paso 1 - Crear la clase Select (menú desplegable)

La clave del menú desplegable es la clase discord.ui.Select. Heredas de esta clase y defines las opciones (SelectOption) y lo que ocurre cuando se elige una (callback).

import discord
from discord.ext import commands

class GameSelect(discord.ui.Select):
    def __init__(self):
        options = [
            discord.SelectOption(label="Minecraft", value="minecraft", description="Un mundo hecho de bloques", emoji="⛏️"),
            discord.SelectOption(label="ARK Survival", value="ark", description="¡Sobrevive entre dinosaurios!", emoji="🦖"),
            discord.SelectOption(label="Valorant", value="valorant", description="FPS táctico 5 contra 5", emoji="🔫"),
        ]
        super().__init__(
            placeholder="¡Selecciona tu juego favorito!",
            min_values=1,
            max_values=1,
            options=options,
        )

    async def callback(self, interaction: discord.Interaction):
        await interaction.response.send_message(
            f"🎮 ¡{interaction.user.mention} eligió **{self.values[0]}**!"
        )

Vamos a verlo parte por parte 💡

• SelectOption : cada una de las opciones que aparecen en el menú. label es el nombre que se ve en pantalla, value es el valor que recibes en el código, description es el texto de ayuda en gris y emoji es el emoji que va delante.
• placeholder : el texto de ayuda que se muestra cuando todavía no se ha elegido nada.
• min_values / max_values : el número mínimo y máximo de opciones que se pueden elegir. ¡Con max_values=3 se convierte en un menú de selección múltiple! (máximo 25)
• callback : la función que se ejecuta cuando el usuario termina de elegir. Los valores elegidos llegan en la lista self.values.

📌 Paso 2 - Meterlo en una View

Como vimos en el episodio de los botones, todos los componentes de UI se tienen que enviar dentro de un contenedor llamado View.

class GameSelectView(discord.ui.View):
    def __init__(self):
        super().__init__(timeout=60)  # Se desactiva tras 60 segundos
        self.add_item(GameSelect())

Por cierto, cada menú desplegable ocupa una fila (row) entera de la View. Una View tiene como máximo 5 filas, así que puedes meter hasta 5 menús desplegables en una sola View.

📌 Paso 3 - Enviarlo con un Slash Command

intents = discord.Intents.default()
bot = commands.Bot(command_prefix="!", intents=intents)

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

@bot.tree.command(name="게임선택", description="¡Elige tu juego favorito!")
async def game_select(interaction: discord.Interaction):
    await interaction.response.send_message("¡Elige una opción aquí abajo! 👇", view=GameSelectView())

bot.run("Token")

📌 Código completo (puedes copiar y pegar)

# discord.py 2.x / Python 3.8+
import discord
from discord.ext import commands

class GameSelect(discord.ui.Select):
    def __init__(self):
        options = [
            discord.SelectOption(label="Minecraft", value="Minecraft", description="Un mundo hecho de bloques", emoji="⛏️"),
            discord.SelectOption(label="ARK Survival", value="ARK Survival", description="¡Sobrevive entre dinosaurios!", emoji="🦖"),
            discord.SelectOption(label="Valorant", value="Valorant", description="FPS táctico 5 contra 5", emoji="🔫"),
        ]
        super().__init__(placeholder="¡Selecciona tu juego favorito!", min_values=1, max_values=1, options=options)

    async def callback(self, interaction: discord.Interaction):
        await interaction.response.send_message(
            f"🎮 ¡{interaction.user.mention} eligió **{self.values[0]}**!"
        )

class GameSelectView(discord.ui.View):
    def __init__(self):
        super().__init__(timeout=60)
        self.add_item(GameSelect())

intents = discord.Intents.default()
bot = commands.Bot(command_prefix="!", intents=intents)

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

@bot.tree.command(name="게임선택", description="¡Elige tu juego favorito!")
async def game_select(interaction: discord.Interaction):
    await interaction.response.send_message("¡Elige una opción aquí abajo! 👇", view=GameSelectView())

bot.run("Token")

📌 Resultado

Al escribir /게임선택 (elegir juego), el bot envía un mensaje con un menú desplegable, y cuando eliges un juego en el menú responde "🎮 ¡OO eligió Minecraft!".

💡 Extra: ¡también hay menús desplegables especiales para elegir usuarios, roles y canales! Con discord.ui.UserSelect, discord.ui.RoleSelect y discord.ui.ChannelSelect no tienes que crear las opciones a mano: aparece automáticamente la lista de usuarios/roles/canales del servidor. ¡Si surge la ocasión, lo veremos en detalle más adelante!

📌 Errores frecuentes

1. This interaction failed (La interacción ha fallado)

Ocurre si no respondes dentro de 3 segundos en el callback. Si el proceso tarda, llama primero a await interaction.response.defer() y luego responde con interaction.followup.send().

2. El menú desplegable aparece gris y desactivado

Cuando pasa el tiempo de View(timeout=60), el componente caduca. Si el menú tiene que seguir funcionando, pon timeout=None. (Para que se mantenga incluso después de reiniciar el bot, necesitas una persistent view + indicar un custom_id, ¡pero eso lo veremos en un episodio avanzado!)

3. TypeError: __init__() got an unexpected keyword argument 'options'

Este error aparece cuando le pasas options a un Select especial como UserSelect en lugar de discord.ui.Select. Cuando definas tus propias opciones, usa siempre el discord.ui.Select básico.

📌 Para terminar

Hoy vimos cómo meter hasta 25 opciones de forma ordenada con un menú desplegable (Select Menu). Ya hemos pasado de los botones a los menús desplegables, así que en el próximo episodio veremos cómo pedir al usuario que escriba texto con un modal (Modal). ¡No te lo pierdas! 🙌

📚 Serie Crear un bot de Discord

1. Domina por completo los Slash Commands
2. Añade opciones (argumentos) a tus Slash Commands
3. Añade subcomandos a tus Slash Commands
4. Envía embeds con Slash Commands
5. Implementa interacciones con botones (Button)
6. Implementa menús desplegables (Select Menu) ← ¡estás leyendo este!