Démarrer avec les Bots & Automation

Ce guide vous aide à configurer votre serveur Bots & Automation sur ServerPrism. Vous apprendrez à déployer votre serveur, à configurer le bot choisi et à le faire fonctionner sur votre plateforme.

Avant de commencer

Avant de commander, identifiez le bot que vous souhaitez exécuter. Chaque bot nécessite des jetons ou des clés API spécifiques de la plateforme avec laquelle il interagit (par exemple, Twitch, Discord, serveurs de jeux). Obtenez ces clés à l'avance.

Commander sur ServerPrism

1. Sélectionnez un plan : Choisissez le jeu Bots & Automation sur la page de commande de ServerPrism. Nous recommandons un minimum de 2 Go de RAM pour les bots de base, jusqu'à 8 Go de RAM pour les configurations plus complexes ou les instances multiples.
2. Choisissez une région : Sélectionnez l'emplacement du centre de données le plus proche de votre public cible ou de vous-même pour des performances optimales.
3. Choisissez votre bot : Sur la page de configuration de la commande, sélectionnez le runtime de bot souhaité (par exemple, PhantomBot, SogeBot, JTS3ServerMod) parmi les options disponibles. Cela installera les fichiers de base pour vous.
4. Déployer : Terminez votre commande. Votre serveur commencera à se déployer automatiquement.

Premier démarrage

Après le déploiement, votre serveur démarrera pour la première fois. Le démarrage initial télécharge toutes les dépendances restantes pour le bot choisi. Vous pouvez surveiller la progression dans l'onglet Console du panneau ServerPrism. Le serveur est prêt lorsque la sortie de la console indique que le bot a démarré avec succès, souvent en affichant un message comme « Bot started » ou « Listening for commands. »

Connexion / invitation de joueurs

Les bots n'ont généralement pas de « connexion » directe comme un serveur de jeu. Au lieu de cela, ils se connectent à une plateforme (comme Twitch ou Discord) en utilisant les informations d'identification que vous fournissez. Une fois configuré, le bot fonctionne au sein de cette plateforme. Pour les bots qui gèrent des serveurs de jeu (comme Big Brother Bot B3 ou JTS3ServerMod), le bot se connecte au port RCON ou de requête du serveur de jeu.

Bases de la configuration

La configuration de votre bot se fait via des fichiers ou des variables d'environnement, selon le bot.

PhantomBot

1. Accéder aux fichiers : Utilisez le Gestionnaire de fichiers du panneau ServerPrism ou SFTP pour naviguer vers le répertoire phantombot de votre serveur.
2. Modifier botlogin.txt : Ce fichier contient votre chaîne Twitch, le nom d'utilisateur du bot et le jeton OAuth. Suivez les instructions du fichier pour saisir vos informations d'identification.
3. Modifier config.ini : Ajustez les paramètres généraux du bot comme le préfixe de commande, la langue et les configurations de module ici.
4. Redémarrer : Après avoir enregistré les modifications, redémarrez votre serveur depuis l'onglet Console ou Power du panneau ServerPrism pour qu'elles prennent effet.

SogeBot

SogeBot utilise principalement des variables d'environnement pour la configuration initiale.

1. Variables de démarrage : Accédez à l'onglet Startup de votre panneau ServerPrism.
2. Définir TWITCH_USERNAME et TWITCH_OAUTH : Saisissez ici votre nom d'utilisateur de bot Twitch et votre jeton OAuth. Vous devrez peut-être également définir CHANNEL pour la chaîne Twitch cible.
3. Autres paramètres : Consultez la documentation de SogeBot pour les autres variables d'environnement disponibles pour une configuration avancée.
4. Redémarrer : Redémarrez votre serveur depuis le panneau ServerPrism pour que les modifications soient appliquées.

JTS3ServerMod

1. Accéder aux fichiers : Utilisez le Gestionnaire de fichiers du panneau ServerPrism ou SFTP.
2. Naviguer : Allez dans config/server1/.
3. Modifier JTS3ServerMod_server.cfg : C'est le fichier de configuration principal. Modifiez les paramètres comme l'adresse de requête de votre serveur TeamSpeak 3, le port, le nom d'utilisateur, le mot de passe et les configurations de module spécifiques.
4. Enregistrer et redémarrer : Enregistrez le fichier et redémarrez votre serveur depuis le panneau ServerPrism.

Big Brother Bot (B3)

1. Accéder aux fichiers : Utilisez le Gestionnaire de fichiers du panneau ServerPrism ou SFTP.
2. Naviguer : Allez dans b3/conf/.
3. Modifier b3.xml : C'est le fichier de configuration principal. Vous devrez configurer votre connexion à la base de données (SQLite est souvent par défaut et suffisant), les détails du serveur de jeu (IP, port, mot de passe RCON) et les paramètres administratifs.
4. Modifier plugins.xml : Activez ou désactivez des plugins B3 spécifiques ici.
5. Enregistrer et redémarrer : Enregistrez toutes les modifications et redémarrez votre serveur depuis le panneau ServerPrism.

Problèmes courants

• Le bot ne se connecte pas à la plateforme : Vérifiez attentivement vos clés API, jetons OAuth et noms d'utilisateur pour les fautes de frappe. Assurez-vous qu'ils ont les autorisations correctes sur la plateforme (par exemple, le statut de modérateur pour les bots Twitch).
• Le bot ne démarre pas : Vérifiez l'onglet Console pour les messages d'erreur. Les dépendances manquantes, les chemins de fichiers incorrects ou la syntaxe de configuration invalide sont des coupables courants. Si vous avez apporté des modifications aux fichiers de configuration, annulez-les un par un pour isoler le problème.
• Les commandes ne fonctionnent pas : Vérifiez que le bot est connecté avec succès et que le préfixe de commande est correct. Pour les bots de serveur de jeu, assurez-vous que le mot de passe RCON et l'IP du serveur de jeu sont correctement configurés dans les paramètres du bot.
• Utilisation élevée des ressources : Si votre bot consomme trop de RAM ou de CPU, examinez sa configuration. Certains modules ou fonctionnalités peuvent être gourmands en ressources. Envisagez de mettre à niveau votre plan ServerPrism via le tableau de bord client si nécessaire.

Prochaines étapes

Une fois votre bot en marche, explorez toutes ses capacités :

• Gestion des modules/plugins : La plupart des bots vous permettent d'activer, de désactiver ou de configurer des modules ou plugins supplémentaires pour des fonctionnalités étendues.
• Commandes personnalisées : Apprenez à ajouter des commandes personnalisées spécifiques à votre communauté ou à votre serveur de jeu.
• Changement de runtime : Si vous souhaitez essayer un autre bot, vous pouvez changer le runtime de votre serveur directement depuis l'onglet Startup de votre panneau ServerPrism sans avoir à commander un nouveau serveur.
• Support communautaire : De nombreux bots ont des communautés actives ou une documentation que vous pouvez consulter pour des configurations avancées. Si vous rencontrez des problèmes persistants, ouvrez un ticket de support à l'adresse https://serverprism.com/tickets, en fournissant votre ID de serveur et tous les journaux de console pertinents.