EpikFail, bot de quiz

EpiKFail, un bot de quiz pour mIRC.

Télécharger EpikFail 1

Installation

Si ce n’est pas déjà fait, téléchargez mIRC ici, installez le et retenez le chemin du dossier d’installation.
Dézippez le dossier « ef_mono » (et pas ce qu’il contient) dans le dossier « scripts » du répertoire d’installation de votre mIRC.
Lancez mIRC, ouvrez l’éditeur de remote avec le raccourci clavier alt + R, ouvrez le menu File > Load…, entrez dans le dossier « scripts\ef_mono\ » et ouvrez « efmono.mrc ».
L’installation est terminée.
Note : Le fichier « questions.txt » contient les questions du quiz, un fichier contenant 1911 questions sur des thèmes divers et variés est fourni de base.
Ces questions ont été rédigées par les membres des équipes des salons officiels d’EpiKnet au cours des événements quiz de ces dernières années, un grand merci à eux !

Fonctions du robot

Résumé des commandes
/settoken ‹séparateur› Définit le caractère séparateur questions \ réponse (antislash par défaut)
/start Démarre le quiz dans la fenêtre de salon active
/start ‹#salon› Démarre le quiz sur le canal #salon
/start -u Démarre le quiz en boucle dans la fenêtre de salon active
/start -u ‹#salon› Démarre le quiz en boucle sur le canal #salon
/rmscores Remet les scores à zéro
/stop Met le quiz en pause
/restart Redémarre le quiz après la pause
/scores Affiche la liste des scores
/maestro ‹pseudonyme› Définit l’utilisateur qui a droit aux show commands qui suivent
!win ‹pseudonyme› Fait gagner un joueur pendant le laps de temps attribué à une question
+1 ‹pseudonyme› Ajoute un point à un joueur n’importe quand. Le joueur est averti par une notice
-1 ‹pseudonyme› Retire un point à un joueur n’importe quand. Le joueur n’est pas averti par une notice

 

Le script lit le fichier scripts\ef_mono\questions.txt de votre dossier d’installation de mIRC, à la recherche d’erreurs de syntaxe.
Pendant cette étape le robot supprime les lignes totalement vides.
Si aucune erreur n’est trouvée, le script copie le fichier questions.txt dans temp.txt, puis le jeu démarre.
Le robot va alors prendre une question au hasard dans temp.txt et l’écrire sur le salon, puis supprimer cette question de ce même fichier.
Quand temp.txt est vide, toutes les questions ont été posées, et le jeu est donc terminé, sauf si vous avez lancé le robot par la commande /start -u
Par défaut le fichier questions.txt doit contenir sur chaque ligne : question \ réponse \ réponse synonyme \
Les réponses synonymes sont facultatives, vous pouvez donc écrire sur chaque ligne, simplement : question \ réponse
Vous avez la possibilité de changer le séparateur « \ » avec la commande /settoken suivi du nouveau caractère de séparation.
Choisissez un caractère formellement absent des questions \ réponses.

Aide sur les commandes internes

Ces commandes sont à entrer dans l’editbox du mIRC qui fait tourner le quiz :
Lancement : /start #salon ou uniquement /start sur le salon où se déroulera le jeu, ou encore /start -u pour que le jeu tourne en boucle.
/start -u ‹salon› fonctionne également.
À chaque fois que /start est tapée, le quiz reprend du début, mais attention, les scores ne sont pas remis à zéro.
Remise à zéro des scores : /rmscores (Note : si le quiz est lancé en boucle les scores sont remis à 0 à chaque redémarrage du jeu).
Pause : /stop
Redémarrage après pause : /restart
Afficher les scores : /scores
Pour définir le maestro du quiz tapez : /maestro ‹pseudonyme›
Concernant le maestro du quiz, il s’agit du pseudo de la personne qui a droit aux show commands qui suivent.
Définir un maestro n’est pas obligatoire, au lancement du bot le nick du maestro est automatiquement supprimé.
Si aucun maestro n’est définit, ou même s’il est définit, les show commands qui suivent sont toutes accessibles depuis le bot lui-même, sur le salon du quiz.

Aide sur les show commands (commandes à écrire sur le salon du quiz)

Ces commandes sont à entrer par le maestro ou par le bot sur le salon où a lieu le quiz :
!win ‹pseudonyme› fait gagner un joueur pendant le laps de temps attribué à une question.
+1 ‹pseudonyme› ajoute un point à un joueur n’importe quand. Le joueur est averti par une notice.
-1 ‹pseudonyme› retire un point à un joueur n’importe quand. Le joueur n’est pas averti par une notice.
Le maestro reçoit la bonne réponse en notice et le bot affiche en interne la bonne réponse sur la fenêtre de salon du quiz.
Le maestro peut donc être uniquement la personne qui fait tourner le bot, à vous de voir.

Aide à la rédaction du fichier des questions

Le fichier « questions.txt » doit contenir sur chaque ligne : question \ réponse \ réponse synonyme 1 \ réponse synonyme 2 \ …
Et autant de réponses synonymes que vous souhaitez, un exemple :
Combien de faces un dé à jouer possède-t’il ? \ 6 \ six
6 et six sont les deux bonnes réponses acceptées par le bot.
Toutefois les réponses synonymes sont facultatives, vous pouvez vous contenter d’une seule réponse, mais dans un souci de qualité du quiz, il est préférable de s’en préoccuper.

Vous avez la possibilité d’utiliser un caractère de séparation question \ réponse différent de l’antislash, mais ce doit être un seul même caractère pour toutes les lignes, et jamais présent dans les questions ou les réponses.

Aussi vous n’êtes pas obligés de mettre un point d’intérrogation à la fin de vos questions, le bot le rajoutera s’il n’est pas présent.

D’autre part le bot supprime certains mots en début de réponse, à la fois dans les réponses écrites dans le fichier du quiz, et dans les réponses proposées par les joueurs, pour arriver à une égalité.
Le bot supprime donc en début de réponse : le, la, en, de, un, du, au, l’, d’, une, les, des, aux, d’un
Il est donc inutile d’écrire une réponse avec un de ces mots au début, et une autre réponse sans.

Si la réponse est Un bâtonbâton comptera comme bonne réponse pendant le jeu, donc ne vous privez pas d’écrire ces « articles » dans les réponses du fichier, ils seront automatiquement ignorés.

Il est même conseillé de les mettre, car le bot affichera comme bonne réponse, la réponse du fichier qui colle avec la réponse du joueur, mais avec l’article, s’il est présent dans le fichier.

Par exemple : Quel objet d’éleveur est associé à un célèbre saucisson ? La réponse la plus logique étant Un bâton (pour le baton de berger), il est conseillé de mettre le Un dans ce cas.

Le bot supprime aussi en fin de réponse le point, le point d’exclamation, et le point d’interrogation, et ceci toujours pour les réponses du fichier, et pour les réponses proposées par les joueurs.
Il est donc inutile d’en faire la distinction avec des réponses synonymes.

Le bot remplace aussi tous les caractères accentués par le même caractère, mais sans accent.

Evidemment le bot est insensible à la casse (minuscules/majuscules).

Votre fichier doit être un simple fichier texte (.txt sous windows), et s’il ne contient pas de tabulations et de lignes vides, c’est mieux.
Le plus propre étant d’écrire votre fichier avec un simple éditeur de texte (bloc note, notepad++, gedit, geany, nano, vim …).

Bon jeu ! :)