Créer un robot IRC avec NodeJS

De Wiki IRC

La création d'un robot IRC avec Node.js est simple, il suffit d'avoir un peu de compétence en JavaScript et il sera facile de comprendre petit à petit de comment ça marche.

Ici pas de blablabla, je vais pas écrire un grand article à propos de NodeJS et JavaScript. Le mieux c'est de passer au tuto directement pour créer ce bot IRC.

Installation de NodeJS

Tout d'abord, il faut avoir Node.js sur l'ordinateur, si vous ne l'avez pas, il suffit d'aller à cette adresse et de l'installer: https://nodejs.org/fr/download/

Il est recommandé de prendre la version LTS pour une meilleure stabilité.

En installant Node.js, l'application npm sera aussi installée, c'est le gestionnaire de paquets par défaut de NodeJS.

Pour la suite de ce tuto, nous allons utiliser l'invite de commande de Windows et on va faire comme si que Node.js est installé sur Windows.


Création d'un dossier pour ce projet de bot

Sur le bureau, créez un dossier nommé Robot IRC.

Utilisation du paquet "IRC Framework"

Ouvrez l'invite de commande, et tapez: cd "C:\Users\<nom ordinateur>\Desktop\Robot IRC"

Une fois que vous êtes dans le dossier Robot IRC, tapez npm install irc-framework. Un dossier "node_modules" sera visible dans notre dossier "Robot IRC", cela voudra donc dire que le paquet irc-framework a bien été installé.

Note: il se peut qu'il y a des erreurs liées à Yarn pendant l'installation, il suffit d'ignorer ces erreurs sur Windows. Yarn c'est le concurrent de npm, et pour faire ce tuto nous n'avons pas besoin de Yarn.
Si jamais on a besoin de Yarn, il suffit alors de l'installer avec npm install --global yarn puis de vérifier sa version yarn --version (c'est utile de connaitre la version) et ensuite il suffit d'installer irc-framework avec yarn add irc-framework ou si vous êtes à l'intérieur du dossier irc-framework alors il suffit juste de taper yarn et d'attendre quelques secondes et normalement après c'est installé.


Création d'un fichier "bot.js" et le lancer

Dans le dossier Robot IRC, créez un fichier nommé bot.js.

Pour cela il faut utiliser Bloc-note ou NotePad++ ou encore un éditeur JavaScript.

Il faut faire en sorte que le fichier s'appel bien bot.js et non pas bot.js.txt.

Ensuite tout en haut du fichier bot.js, ajoutez ceci :

const IRC = require('./');

A la suite vous pouvez ajouter ceci (et c'est même commenté):

const bot = new IRC.Client(); // le constructeur

// Configuration de la connexion
// Voir la liste complète sur https://github.com/kiwiirc/irc-framework/blob/master/docs/clientapi.md
bot.connect({
    host: 'irc.discussionner.com',
    nick: 'Bobot'
});

// Événement équivalente au raw 005 
bot.on('registered', function() {
    console.log('Connected!');
    bot.join('#quizz'); // connexion au salon #quizz à la connexion
    // var channel = bot.channel('#quizz');
    // channel.join();
    // channel.say('Hi!');
    // channel.updateUsers(function() {
    //   console.log(channel.users); // liste tous les users présents sur #quizz
    // });
});

// Événement close du bot / une connexion impossible 
bot.on('close', function() {
    console.log('Connection close');
});

// Événement des messages en salons et en privés reçus sur le bot.
bot.on('message', function(event) {
    console.log('<' + event.target + '>', event.message);
    if (event.message.indexOf('whois') === 0) { // Il suffit de taper /msg Bobot whois <pseudo> et ce if sera enclenché. Il sera même enclenché si le message est tapé en salon : /msg #quizz whois <pseudo>
        bot.whois(event.message.split(' ')[1]); // le arg [1] signifie <pseudo>, le robot exécutera un /whois <pseudo>.
    }
});

// Événement en salon ou en pv, on tape "!hi" dans le pv du bot ou dans le slaon #quizz et le bot répondra "sup".
// Ce système peut aussi être construit directement dans l'événement 'message'.
bot.matchMessage(/^!hi/, function(event) {
    event.reply('sup');
});

// Événement whois & réception de la réponse du whois
bot.on('whois', function(event) {
    console.log(event);
});

// Événement join & réception des joins
bot.on('join', function(event) {
    console.log('user joined', event);
});

// Événement userlist & réception des pseudos du salon concerné.
bot.on('userlist', function(event) {
    console.log('userlist for', event.channel, event.users);
});

// Événement part & réception d'un part
bot.on('part', function(event) {
    console.log('user part', event);
});

Enregistrez le fichier et démarrez votre bot en tapant node bot.js dans votre terminal (invite de commande). Vous pouvez aussi utiliser node bot pour le démarrer.

Pour stopper sa connexion, tapez Ctrl + c.


Voila, c'est tout ce qu'il faut au minimum pour créer un bon petit robot avec Node.js.


Paquet IRC Framework sur GitHub : https://github.com/kiwiirc/irc-framework

Le même paquet sur npmjs : https://www.npmjs.com/package/irc-framework

Documentations IRC Framework : https://github.com/kiwiirc/irc-framework/tree/master/docs

Le projet IRC-Framework est créé par le groupe KiwiIRC, il est parfait pour créer des robots IRC et des clients IRC (comme celui qu'il y a sur https://discussionner.com).


Il existe un autre paquet pour créer des robots IRC, c'est npm install irc (https://www.npmjs.com/package/irc) que je déconseille d'utiliser, car incomplet et il semble abandonné depuis 2016.




Depuis 2019, j'ai créé 5 robots NodeJS (avec le paquet irc-framework), et ils sont actuellement en ligne sur le serveur IRC Discussionner.com dans différents salons, les noms des robots sont:

Pseudo sur Discussionner Nom du bot Date de création Créateur Description
Sysop Sysop.js-stable Janvier 2020 Madrix Robot autonome, commandes administrateurs et commandes globops
Uno Uno.js-stable Avril 2020 Madrix Le jeu du Uno par écrit, il est en ligne sur #uno
Quizz Quizz.js-stable Mars 2018 Madrix Robot entièrement recopié au Quizz Trivia d'eggdrop, ce bot est en ligne sur le salon #quizz
Sympa et Exam Quizz-ados.js-stable Décembre 2019 Madrix idem, mais cette fois optimisé pour les ados du salon #Ados avec des questions versions collégiens. Exam est présent sur #15-25ans.
tapavu TapaVu.js-stable Janvier 2021 Madrix Robot entièrement recopié au TapaVu de l'eggdrop

Contactez-moi par mail [email protected] si vous êtes intéressé par l'un de ces robots, en échange d'un bon procédé.