Bot de roles para Discord: botones para que cada uno elija sus roles (Python y JavaScript)

discord.py
python-dotenv

DISCORD_TOKEN=pega-aquí-tu-token

import os

import discord
from discord import app_commands
from dotenv import load_dotenv

load_dotenv()  # lee el token del fichero .env

# Solo hacen falta los intents por defecto: los botones llegan como interacciones.
client = discord.Client(intents=discord.Intents.default())
tree = app_commands.CommandTree(client)


@tree.command(name="panel-roles", description="Publica un mensaje con botones para coger roles")
@app_commands.guild_only()
@app_commands.default_permissions(manage_roles=True)  # solo lo ve quien gestiona roles
@app_commands.describe(
    titulo="Lo que pone encima de los botones",
    rol1="Un rol que se podrá coger",
    rol2="Otro rol (opcional)",
    rol3="Otro rol (opcional)",
    rol4="Otro rol (opcional)",
    rol5="Otro rol (opcional)",
)
async def panel_roles(
    interaction: discord.Interaction,
    titulo: str,
    rol1: discord.Role,
    rol2: discord.Role | None = None,
    rol3: discord.Role | None = None,
    rol4: discord.Role | None = None,
    rol5: discord.Role | None = None,
):
    roles = [r for r in (rol1, rol2, rol3, rol4, rol5) if r]
    mio = interaction.guild.me.top_role
    # Un bot no puede dar un rol igual o más alto que el suyo, ni los de otros bots o @everyone.
    imposibles = [r.name for r in roles if r >= mio or r.managed or r.is_default()]
    if imposibles:
        await interaction.response.send_message(
            f"No puedo dar {', '.join(imposibles)}: pon mi rol por encima en «Ajustes del servidor» → «Roles».",
            ephemeral=True,
        )
        return
    vista = discord.ui.View(timeout=None)
    for rol in roles:
        # El id del rol va en el propio botón: no hace falta base de datos.
        vista.add_item(discord.ui.Button(label=rol.name, custom_id=f"rol:{rol.id}"))
    tarjeta = discord.Embed(title=titulo, description="Pulsa un botón para ponerte o quitarte el rol.", color=0x5B4AE8)
    await interaction.channel.send(embed=tarjeta, view=vista)
    await interaction.response.send_message("Panel publicado.", ephemeral=True)


@client.event
async def on_interaction(interaction: discord.Interaction):
    # Llega cada clic en un botón, también en paneles publicados antes de reiniciar el bot.
    if interaction.type is not discord.InteractionType.component:
        return
    custom_id = interaction.data.get("custom_id", "")
    if not custom_id.startswith("rol:") or interaction.guild is None:
        return
    rol = interaction.guild.get_role(int(custom_id[4:]))
    if rol is None:
        await interaction.response.send_message("Ese rol ya no existe.", ephemeral=True)
        return
    try:
        if rol in interaction.user.roles:
            await interaction.user.remove_roles(rol, reason="Panel de roles")
            texto = f"Te he quitado {rol.mention}."
        else:
            await interaction.user.add_roles(rol, reason="Panel de roles")
            texto = f"Ya tienes {rol.mention}."
    except discord.Forbidden:
        texto = "No puedo darte ese rol: avisa a quien gestiona el servidor (mi rol tiene que estar por encima)."
    await interaction.response.send_message(texto, ephemeral=True)


@client.event
async def on_ready():
    await tree.sync()  # publica /panel-roles
    print(f"Conectado como {client.user}")


client.run(os.environ["DISCORD_TOKEN"])

{
  "name": "bot-roles",
  "version": "1.0.0",
  "main": "index.js",
  "dependencies": {
    "discord.js": "^14.17.0",
    "dotenv": "^16.4.0"
  }
}

DISCORD_TOKEN=pega-aquí-tu-token

require("dotenv").config(); // lee el token del fichero .env
const {
  ActionRowBuilder,
  ButtonBuilder,
  ButtonStyle,
  Client,
  EmbedBuilder,
  Events,
  GatewayIntentBits,
  InteractionContextType,
  MessageFlags,
  PermissionFlagsBits,
  SlashCommandBuilder,
} = require("discord.js");

// Solo hace falta Guilds: los botones llegan como interacciones.
const client = new Client({ intents: [GatewayIntentBits.Guilds] });

const comando = new SlashCommandBuilder()
  .setName("panel-roles")
  .setDescription("Publica un mensaje con botones para coger roles")
  .setContexts(InteractionContextType.Guild)
  .setDefaultMemberPermissions(PermissionFlagsBits.ManageRoles) // solo lo ve quien gestiona roles
  .addStringOption((o) => o.setName("titulo").setDescription("Lo que pone encima de los botones").setRequired(true))
  .addRoleOption((o) => o.setName("rol1").setDescription("Rol").setRequired(true));
for (let n = 2; n <= 5; n++) comando.addRoleOption((o) => o.setName(`rol${n}`).setDescription("Otro rol (opcional)"));

const privado = (content) => ({ content, flags: MessageFlags.Ephemeral });

client.on(Events.InteractionCreate, async (i) => {
  if (!i.inCachedGuild()) return;

  if (i.isChatInputCommand() && i.commandName === "panel-roles") {
    const roles = [1, 2, 3, 4, 5].map((n) => i.options.getRole(`rol${n}`)).filter(Boolean);
    const mio = i.guild.members.me.roles.highest;
    // Un bot no puede dar un rol igual o más alto que el suyo, ni los de otros bots o @everyone.
    const imposibles = roles.filter((r) => r.managed || r.id === i.guildId || r.comparePositionTo(mio) >= 0);
    if (imposibles.length) {
      const nombres = imposibles.map((r) => r.name).join(", ");
      return i.reply(privado(`No puedo dar ${nombres}: pon mi rol por encima en «Ajustes del servidor» → «Roles».`));
    }
    // El id del rol va en el propio botón: no hace falta base de datos.
    const fila = new ActionRowBuilder().addComponents(
      roles.map((r) => new ButtonBuilder().setCustomId(`rol:${r.id}`).setLabel(r.name).setStyle(ButtonStyle.Secondary)),
    );
    const tarjeta = new EmbedBuilder()
      .setColor(0x5b4ae8)
      .setTitle(i.options.getString("titulo"))
      .setDescription("Pulsa un botón para ponerte o quitarte el rol.");
    await i.channel.send({ embeds: [tarjeta], components: [fila] });
    return i.reply(privado("Panel publicado."));
  }

  // Llega cada clic en un botón, también en paneles publicados antes de reiniciar el bot.
  if (i.isButton() && i.customId.startsWith("rol:")) {
    const rol = i.guild.roles.cache.get(i.customId.slice(4));
    if (!rol) return i.reply(privado("Ese rol ya no existe."));
    let texto;
    try {
      if (i.member.roles.cache.has(rol.id)) {
        await i.member.roles.remove(rol, "Panel de roles");
        texto = `Te he quitado ${rol}.`;
      } else {
        await i.member.roles.add(rol, "Panel de roles");
        texto = `Ya tienes ${rol}.`;
      }
    } catch {
      texto = "No puedo darte ese rol: avisa a quien gestiona el servidor (mi rol tiene que estar por encima).";
    }
    await i.reply(privado(texto));
  }
});

client.once(Events.ClientReady, async (c) => {
  await c.application.commands.set([comando.toJSON()]); // publica /panel-roles
  console.log(`Conectado como ${c.user.tag}`);
});

client.login(process.env.DISCORD_TOKEN);