Configurando Red Discord Bot

Esta guía te lleva a través de la configuración de Red Discord Bot en ServerPrism, desde la creación del bot en el portal de desarrolladores de Discord hasta la reclamación de propietario y la carga de tus primeros cogs.

Antes de empezar

Necesitarás una cuenta de Discord y un servidor donde tengas el permiso Gestionar Servidor.

1. Crea tu bot en el Portal de Desarrolladores de Discord

1. Ve a discord.com/developers/applications y haz clic en Nueva Aplicación.
2. Dale un nombre (esta es la identidad de tu bot; elige uno que te guste), acepta los términos y haz clic en Crear.
3. En la barra lateral izquierda, haz clic en Bot.
4. Debajo del nombre de usuario del bot, haz clic en Restablecer Token y copia el token en un lugar seguro. Lo pegarás en ServerPrism en un momento. Trátalo como una contraseña: cualquiera con él puede controlar tu bot.

2. Habilita los Privileged Gateway Intents

Este paso es crítico: Red se negará a iniciarse sin los tres intents habilitados, saliendo con CONFIGURATION_ERROR (código de salida 78).

Todavía en la página Bot, desplázate hasta Privileged Gateway Intents y activa:

• Presence Intent
• Server Members Intent
• Message Content Intent

Haz clic en Guardar Cambios en la parte inferior.

3. Invita al bot a tu servidor de Discord

1. En la barra lateral izquierda, haz clic en OAuth2 → Generador de URL.
2. En Scopes, marca bot y applications.commands.
3. En Bot Permissions, marca los permisos que quieres que tenga. Para la mayoría de las configuraciones, Administrator es el punto de partida más fácil; puedes ajustarlo más tarde.
4. Copia la URL generada en la parte inferior, ábrela en una nueva pestaña, elige tu servidor de Discord y autoriza.

El bot se unirá a tu servidor pero aparecerá como desconectado hasta que lo inicies en ServerPrism.

4. Pide Red Discord Bot en ServerPrism

1. Dirígete a la categoría de Bots de Discord en nuestro sitio y elige el producto Red Discord Bot.
2. Elige un plan (1 GB de RAM es suficiente para la mayoría de las configuraciones), selecciona una región cercana a ti y finaliza la compra.
3. Durante el pedido, se te pedirá:
   • Discord Bot Token: pega el token del paso 1.
   • Command Prefix: el carácter que los usuarios escriben antes de los comandos, por ejemplo, ! o <. Puedes cambiar esto más tarde en Discord.
4. Una vez aprovisionado, el panel instalará Red e iniciará el bot. La primera instalación tarda un par de minutos (instalaciones de pip + dependencias).

5. Reclama la propiedad en Discord

Cuando el bot esté en línea, debes indicarle a Red quién es su propietario para que puedas ejecutar comandos de administración.

1. En Discord, envía un mensaje directo a tu bot con el comando <set owner (reemplaza < con tu prefijo).

2. Red imprimirá un token de confirmación de un solo uso en la consola del panel; verás algo como:

   Use the command [p]set owner XXXXXX in DM to confirm
   

3. Copia ese token de confirmación de la consola y luego envía un mensaje directo al bot:

   <set owner XXXXXX
   

4. Red responderá con "Ahora te reconozco como mi propietario." Has terminado: los comandos de administración funcionan para ti ahora.

6. Carga tus primeros cogs

Los cogs son los plugins de Red. Para habilitar su descarga e instalación:

<load downloader
<repo add aikaterna-cogs https://github.com/aikaterna/aikaterna-cogs
<cog install aikaterna-cogs trivia
<load trivia

Explora el índice de Red Cogs para encontrar cientos de cogs más. Cada uno tiene instrucciones de instalación en su página.

Problemas comunes

"redbot: command not found" en el primer inicio

El instalador no terminó. Este fue un error conocido en nuestro egg de Red que ya está solucionado; si te encuentras con él en una instalación nueva, abre un ticket de soporte y reinstalaremos el egg en tu servidor.

"You need to configure the bot instance using redbot-setup prior to running the bot"

Falta el archivo de configuración de la instancia. Lo mismo que lo anterior: abre un ticket y lo solucionaremos. Reinstalar el servidor desde el panel también lo solucionará en eggs recién desplegados.

Código de salida 78 / "Red requires all Privileged Intents to be enabled"

Vuelve al paso 2 y habilita los tres privileged intents en el Portal de Desarrolladores de Discord. Están desactivados por defecto.

El bot está en línea pero no responde a los comandos

Dos causas comunes:

1. Message Content Intent está desactivado: vuelve a verificar el paso 2. Sin esto, el bot no puede ver el texto del mensaje.
2. Estás usando el prefijo incorrecto: verifica la consola de tu panel para ver el prefijo con el que se inició el bot, o usa @TuBot prefix en Discord (mencionar al bot siempre funciona, independientemente del prefijo).

Cambiar el prefijo del bot

<set prefix !

El nuevo prefijo surte efecto inmediatamente.

Obtener ayuda

Para preguntas específicas de Red, la documentación oficial de Red es el mejor recurso. Para preguntas de alojamiento de ServerPrism (facturación, cambios de plan, rendimiento), abre un ticket de soporte y te responderemos.