Configuración de pixel-bot en ServerPrism

Esta guía te acompaña en la configuración de pixel-bot, un bot de Discord basado en Python, en tu servidor ServerPrism. Crearás tu aplicación de bot en Discord, la invitarás a tu servidor y la configurarás en ServerPrism.

Crea tu bot en el Portal de Desarrolladores de Discord

1. Ve al Portal de Desarrolladores de Discord.
2. Haz clic en New Application.
3. Introduce un nombre para tu bot (por ejemplo, pixel-bot) y haz clic en Create.
4. En la barra lateral izquierda, haz clic en Bot.
5. Haz clic en Add Bot, luego en Yes, Do It!
6. Debajo de TOKEN, haz clic en Reset Token, luego en Yes, Do It! Copia este token inmediatamente; lo necesitarás más tarde. Mantenlo en secreto.
7. Debajo de Privileged Gateway Intents, habilita Message Content Intent. pixel-bot necesita esto para leer mensajes y responder a comandos.

Invita el bot a tu servidor

1. En el Portal de Desarrolladores de Discord, ve a la aplicación de tu bot.
2. En la barra lateral izquierda, haz clic en OAuth2 -> URL Generator.
3. Debajo de SCOPES, selecciona bot.
4. Debajo de BOT PERMISSIONS, selecciona los permisos que tu bot necesita. Para pixel-bot, Send Messages y Read Message History son buenos puntos de partida.
5. Copia la URL generada en la parte inferior de la página.
6. Pega la URL en tu navegador y selecciona el servidor de Discord al que quieres invitar al bot. Haz clic en Authorize.

Pedido en ServerPrism

Al pedir tu servidor de bot de Discord en ServerPrism, un plan de 1 GB de RAM suele ser suficiente para pixel-bot. Elige la región más cercana a tus usuarios para un rendimiento óptimo. Una vez pedido, tu servidor se implementará automáticamente con el tiempo de ejecución de pixel-bot preinstalado.

Configurar variables de inicio

Tu panel de ServerPrism te permite establecer variables de entorno para tu bot. Estas son cruciales para su funcionamiento.

1. Navega al servidor de tu bot en el panel de ServerPrism.

2. Haz clic en la pestaña Startup.

3. Establece las siguientes variables de entorno:

   • BOT_TOKEN: Pega el token del bot que copiaste del Portal de Desarrolladores de Discord.
   • PREFIX: Establece esto a tu prefijo de comando deseado (por ejemplo, !, /, p!). Así es como los usuarios interactuarán con tu bot (por ejemplo, !ping).
   • OWNER_ID: Tu ID de usuario de Discord. Esto es necesario para algunos comandos de administración. Para obtener tu ID de usuario, habilita el Modo Desarrollador en Discord (Configuración de usuario > Avanzado), luego haz clic derecho en tu perfil y selecciona Copy ID.

   La pestaña Startup también puede listar otras variables. Consulta el repositorio oficial de GitHub de pixel-bot para cualquier configuración adicional específica de ciertas características:

   • pixel-bot GitHub

Primer inicio

1. Ve a la pestaña Console en tu panel de ServerPrism.

2. Haz clic en Start.

3. Observa la salida de la consola. Un inicio exitoso mostrará mensajes que indican que el bot se está conectando a Discord e iniciando sesión. Deberías ver una salida similar a:

   [INFO] discord.client: logging in using static token
   [INFO] discord.gateway: Shard ID 0 has connected to Gateway (Session ID: ...)
   [INFO] discord.client: Ready! Logged in as pixel-bot#1234 (ID: ...)
   

4. Verifica tu servidor de Discord; tu bot debería aparecer en línea.

Problemas comunes

• Token del bot rechazado: Vuelve a verificar que BOT_TOKEN en la pestaña Startup sea correcto y no tenga espacios adicionales. Regenera el token en el Portal de Desarrolladores si no estás seguro.
• Bot en línea pero no responde: Asegúrate de que Message Content Intent esté habilitado en el Portal de Desarrolladores de Discord en la configuración de tu bot. Sin él, el bot no puede leer los comandos de mensajes.
• Bot no se conecta: Revisa los registros de la consola en busca de mensajes de error. Los problemas comunes incluyen tokens incorrectos, variables de entorno faltantes o errores críticos en el código del bot. Asegúrate de que todas las variables Startup requeridas estén configuradas.

Próximos pasos

¡Tu pixel-bot ya está funcionando! Puedes empezar a usar sus comandos en tu servidor de Discord. Para obtener una lista de los comandos disponibles y opciones de personalización adicionales, consulta el repositorio de GitHub de pixel-bot.