Primeros pasos con Bots y Automatización

Esta guía te ayudará a configurar tu servidor de Bots y Automatización en ServerPrism. Aprenderás a desplegar tu servidor, configurar el bot elegido y ponerlo en marcha en tu plataforma.

Antes de empezar

Antes de realizar el pedido, identifica el bot que deseas ejecutar. Cada bot requiere tokens o claves API específicas de la plataforma con la que interactúa (por ejemplo, Twitch, Discord, servidores de juegos). Obtén estas claves con antelación.

Pedido en ServerPrism

1. Selecciona un plan: Elige el juego Bots & Automation en la página de pedidos de ServerPrism. Recomendamos un mínimo de 2 GB de RAM para bots básicos, hasta 8 GB de RAM para configuraciones más complejas o múltiples instancias.
2. Elige una región: Selecciona la ubicación del centro de datos más cercana a tu público objetivo o a ti mismo para un rendimiento óptimo.
3. Elige tu bot: En la página de configuración del pedido, selecciona el tiempo de ejecución del bot deseado (por ejemplo, PhantomBot, SogeBot, JTS3ServerMod) de las opciones disponibles. Esto instalará los archivos principales por ti.
4. Desplegar: Completa tu pedido. Tu servidor comenzará a desplegarse automáticamente.

Primer arranque

Después del despliegue, tu servidor se iniciará por primera vez. El arranque inicial descarga las dependencias restantes para el bot elegido. Puedes monitorear el progreso en la pestaña Console del panel de ServerPrism. El servidor estará listo cuando la salida de la consola indique que el bot se ha iniciado correctamente, a menudo mostrando un mensaje como "Bot started" o "Listening for commands."

Conexión / invitación de jugadores

Los bots normalmente no tienen una "conexión" directa como un servidor de juegos. En su lugar, se conectan a una plataforma (como Twitch o Discord) utilizando las credenciales que proporcionas. Una vez configurado, el bot opera dentro de esa plataforma. Para bots que gestionan servidores de juegos (como Big Brother Bot B3 o JTS3ServerMod), el bot se conecta al puerto RCON o de consulta del servidor de juegos.

Conceptos básicos de configuración

La configuración de tu bot se realiza a través de archivos o variables de entorno, dependiendo del bot.

PhantomBot

1. Acceder a los archivos: Utiliza el File Manager del panel de ServerPrism o SFTP para navegar al directorio phantombot de tu servidor.
2. Editar botlogin.txt: Este archivo contiene tu canal de Twitch, nombre de usuario del bot y token OAuth. Sigue las instrucciones dentro del archivo para introducir tus credenciales.
3. Editar config.ini: Ajusta la configuración general del bot, como el prefijo de comando, el idioma y las configuraciones de módulos aquí.
4. Reiniciar: Después de guardar los cambios, reinicia tu servidor desde la pestaña Console o Power del panel de ServerPrism para que surtan efecto.

SogeBot

SogeBot utiliza principalmente variables de entorno para la configuración inicial.

1. Variables de inicio: Ve a la pestaña Startup en tu panel de ServerPrism.
2. Configurar TWITCH_USERNAME y TWITCH_OAUTH: Introduce tu nombre de usuario de bot de Twitch y tu token OAuth aquí. También es posible que necesites configurar CHANNEL para el canal de Twitch de destino.
3. Otras configuraciones: Consulta la documentación de SogeBot para otras variables de entorno disponibles para una configuración avanzada.
4. Reiniciar: Reinicia tu servidor desde el panel de ServerPrism para que se apliquen los cambios.

JTS3ServerMod

1. Acceder a los archivos: Utiliza el File Manager del panel de ServerPrism o SFTP.
2. Navegar: Ve a config/server1/.
3. Editar JTS3ServerMod_server.cfg: Este es el archivo de configuración principal. Edita configuraciones como la dirección de consulta de tu servidor TeamSpeak 3, puerto, nombre de usuario, contraseña y configuraciones de módulos específicos.
4. Guardar y reiniciar: Guarda el archivo y reinicia tu servidor desde el panel de ServerPrism.

Big Brother Bot (B3)

1. Acceder a los archivos: Utiliza el File Manager del panel de ServerPrism o SFTP.
2. Navegar: Ve a b3/conf/.
3. Editar b3.xml: Este es el archivo de configuración principal. Deberás configurar tu conexión a la base de datos (SQLite suele ser la predeterminada y suficiente), los detalles del servidor de juegos (IP, puerto, contraseña RCON) y la configuración administrativa.
4. Editar plugins.xml: Habilita o deshabilita plugins específicos de B3 aquí.
5. Guardar y reiniciar: Guarda todos los cambios y reinicia tu servidor desde el panel de ServerPrism.

Problemas comunes

• El bot no se conecta a la plataforma: Vuelve a verificar tus claves API, tokens OAuth y nombres de usuario en busca de errores tipográficos. Asegúrate de que tengan los permisos correctos en la plataforma (por ejemplo, estado de moderador para bots de Twitch).
• El bot no se inicia: Revisa la pestaña Console en busca de mensajes de error. Las dependencias faltantes, las rutas de archivo incorrectas o la sintaxis de configuración no válida son causas comunes. Si realizaste cambios en los archivos de configuración, reviértelos uno por uno para aislar el problema.
• Los comandos no funcionan: Verifica que el bot esté conectado correctamente y que el prefijo de comando sea el correcto. Para bots de servidores de juegos, asegúrate de que la contraseña RCON y la IP del servidor de juegos estén configuradas correctamente en la configuración del bot.
• Alto uso de recursos: Si tu bot está consumiendo demasiada RAM o CPU, revisa su configuración. Algunos módulos o características pueden consumir muchos recursos. Considera actualizar tu plan de ServerPrism a través del panel de cliente si es necesario.

Próximos pasos

Una vez que tu bot esté funcionando, explora todas sus capacidades:

• Gestión de módulos/plugins: La mayoría de los bots te permiten habilitar, deshabilitar o configurar módulos o plugins adicionales para una funcionalidad extendida.
• Comandos personalizados: Aprende a añadir comandos personalizados específicos para tu comunidad o servidor de juegos.
• Cambio de tiempo de ejecución: Si deseas probar un bot diferente, puedes cambiar el tiempo de ejecución de tu servidor directamente desde la pestaña Startup en tu panel de ServerPrism sin necesidad de volver a pedir tu servidor.
• Soporte de la comunidad: Muchos bots tienen comunidades activas o documentación a la que puedes consultar para configuraciones avanzadas. Si encuentras problemas persistentes, abre un ticket de soporte en https://serverprism.com/tickets, proporcionando tu ID de servidor y cualquier registro de consola relevante.