Guide de l'utilisateur de Camfrog Bot
Pour commencer
Commencez par installer le bot Camfrog sur votre ordinateur en double cliquant sur l'installeur. Le Bot sera installé dans le dossier C:\Program Files\Camfrog. Maintenant lancez CamfrogBot en double cliquant sur le racourci, et l'icône grise du bot apparaît dans votre barre des tâches Windows. Quand l'icône apparait en gris, celà signifie que le bot n'est pas connecté au serveur central de Camfrog.
Une fois le bot installé, il vous faudra choisir et enregistrer un nom pour votre Bot auprès de Camfrog. Cliquez droit sur l'icône du bot dans la barre des tâches et choisissez "register new bot" pour enregistrer votre bot avec un nom de votre choix. A noter que vous ne pouvez pas utiliser votre pseudo Camfrog (client) pour votre Bot, vous devez en prendre un différent. Les pseudos Camfrog et ceux des Bots sont enregistrés dans des bases de données différentes et doivent être différents. Veuillez entrer un âge supérieur ou égal à 18ans pour votre bot si vous comptez l'utiliser dans un salon adulte +18 sous peine qu'il soit rejeté à son entrée dans le salon.
Si jamais vous perdez le mot de passe de votre bot, allez à la page : http://www.camfrog.com/lostpassword.phtml pour qu'il vous soitenvoyé à nouveau.
Une fois le pseudo et mot de passe choisis et acceptés, double cliquez sur l'icône du Bot dans votre barre des tâches et allez dans "connection" et entrez-y les informations suivantes : le nom de votre Bot (pseudo), le mot de passe (associé au pseudo du bot), le nom de votre salon (c'est ce salon que rejoindra votre bot), et le numéro de série de votre bot. Cochez la case "connect on startup" si vous voulez que votre bot joigne automatiquement le salon spécifié dès sa mise en route.
Attention : si vous faites de votre salon un salon avec webcam obligatoire, veillez à ajouter le Bot en tant que Owner (propriétaire) dans votre salon, sinon il ne pourra pas rejoindre votre room étant donné qu'il ne dispose pas de webcam.
Erreurs courantes
Si votre Bot ne parvient pas à rejoindre votre salon, vérifiez que :
1. Votre Bot a un âge supérieur ou égal à 18ans. Si votre Bot a effectivement un âge inférieur, recréez un pseudo avec un nouvel âge.
2. Votre Bot est Owner dans le salon (propriétaire). Vérifiez que vous avez entré correctement le nom du bot dans la liste des Owners.
3. Que vous n'empêchez pas les Bot d'entrer dans votre salon en vérifiant dans les settings de Camfrog Server.
Trivia et autres Plugins
Pour ajouter, enlever ou modifier les questions du quizz (Trivia), ouvrez le fichier questions.du situé dans le dossier "plugins\trivia". Vous pouvez l'ouvrir avec le bloc-note de Windows (Clic droit sur le fichier / ouvrir avec ... / Bloc-Note) et ainsi agir sur les questions qui s'y trouvent. Attention de ne pas modifier le format du fichier (.du).
Pour utiliser les autres modules, cliquez sur l'un d'entre eux une fois puis cliquez sur le bouton "settings" qui se trouve en bas à droite de la fenêtre. Vous pouvez aussi désactiver un module en le sélectionnant et en cliquant sur le bouton "Turn Off". La colonne la plus à droite passera alors d'un "A" (module Actif) à une fenêtre vide, ce qui permet de voir rapidement quels modules sont actifs ou non.
Si vous désirez créer un module personnalisé pour votre Bot Camfrog, examinez le code source du plugin dans le fichier "version.dll" (situé dans le dossier "plugins\sample-src"). Vous pouvez aussi consulter le forum, y trouver des astuces, et poser vos questions afin de vous aider à créer votre module.
Pour pouvoir taper des commandes texte au bot, il faut être owner (propriétaire) du Bot. Pour ce faire, cliquez sur le module "imcontrol" et ajoutez le pseudo camfrog de l'utilisateur. Vous pouvez par exemple utiliser la commande "whobanned" à travers ce module : en tapant /whobanned pseudo vous verrez qui a banni le pseudo spécifié.
Du fait que le bot soit orienté "plugin", les commandes sont orientées vers différents plugins. Toutes les commandes à l'exception de "/ver" passent par le plugin "imcontrol.dll". Ce plugin oriente automatiquement les commandes tapées vers le module approprié.
Liste des commandes du bot
Commandes standard du bot
/ver - affiche la version du bot (version.dll)
/shutdown - désactive le bot (imcontrol.dll)
Commandes pour le salon
/postmsg message - écrit un message à travers le bot (imcontrol.dll)
/kickuser pseudo - kick (sort) un utilisateur du salon (imcontrol.dll)
/punishuser pseudo - puni un utilisateur du salon (imcontrol.dll)
/unpunishuser pseudo - dé-puni un utilisateur du salon (imcontrol.dll)
Commandes pour le questionnaire (Trivia)
/trvplay 0|1 - active ou désactive le quiz (trivia.dll)
/trvstart - démarre le quiz (trivia.dll)
/trvstop - arrête le quiz (trivia.dll)
/trvclear - efface les enregistrements (trivia.dll)
Envoi de messages automatiques sur le salon
/msgrtime 30-30000 - définit à quel intervalle de temps sera envoyé le message (messenger.dll)
/msgrclear - effacer la liste des messages (messenger.dll)
/msgradd message - ajouter un message à la liste (messenger.dll)
Expressions interdites
/bexpr 0|1 - active ou désactive le détecteur de mots/expressions interdits (badwords.dll)
/bekick - sélectionne le kick pour les mots/expressions interdits (badwords.dll)
/bepunish - select punish for bad expressions (badwords.dll)
/bereason reason - définit une raison pour un kick/punish (badwords.dll)
/becount 1-10 - définit le compteur de mots interdits (badwords.dll)
/bewords 0|1 - Choisissez le mode expression complète ou mot seulement. Avec "0" vous utiliserez la vérification d'expression plus longue, parcontre avec "1" le module vérifiera les mots un à un pour évaluer la chaîne. (badwords.dll)
/beclear - efface la liste des mots interdits (badwords.dll)
/beadd expression - ajoute une expression interdite à la liste (badwords.dll)
Plugin Whobanned (Qui a banni?)
Ces commandes fonctionnent pour tous les évènements qui se sont déroulés pendant que le bot était en fonctionnement uniquement. Par exemple, si le bot quitte la room ou bien est redémarré, tous les évènements relatifs à la modération sont perdus, et il vous faut aller dans le fichier de log. L'historique des évènements se trouve dans le plugin logs du server.
/whobanned pseudo - voir qui a bannit le pseudo spécifié (whobanned.dll)
/whokicked pseudo - voir qui a kické le pseudo spécifié (whobanned.dll)
/whopunished pseudo - voir qui a puni le pseudo spécifié (whobanned.dll)
/whounpunished pseudo - voir qui a dé-puni le pseudo spécifié (whobanned.dll)
Gestion des propriétaires du bot
/owners - affiche la liste des propriétaires (owners) du bot (imcontrol.dll)
/addowner pseudo - ajoute un propriétaire (owner) à la liste des propriétaires du bot (imcontrol.dll)
/delowner pseudo - supprimer un propriétaire (owner) de la liste des propriétaires du bot (imcontrol.dll)
Exemples de règles pour mots interdits
(Exemple de règle <=> Mots correspondants)
Wor.d <=> World, Worsd, Wor d, Wor.d
Wo*rd <=> Wrd, Word, Wooord
Wo+rd <=> Word, Wooord
Wo?rd <=> Word, Wrd
Word{2,4} <=> Wordd, Worddd, Wordddd
Wor(d|k) <=> Word, Work
Wor[a-z] <=> Wora, Worb, : , Worz
[cba] <=> a, b, c
.*word.* <=> Tous les mots contenant 'word'
