Créer un robot IRC avec NodeJS

De WikiIRC

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 en le nommant 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 un éditeur JavaScript.

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

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

const IRC = require('./');

Vous pouvez ajouter ce code de base juste en dessous (et c'est même commenté):

//const IRC = require('./');
const bot = new IRC.Client(); // 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: 'Robot'
});

// Événement équivalent au raw 001=RPL_WELCOME
bot.on('registered', function() {
    console.log('Connected!');
    bot.join('#quizz'); // Joindre le salon #quizz à partir du raw 001.
    // 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.
    // });
});

// Plus flexible et adapté aux cas d'utilisation avancés; l'utilisation 
// du raw 005=RPL_ISUPPORT peut être avantageux. Il faudra voir du côté de cet event :
/*
let raw005 = false;
bot.on('server options', function(event) {
	if (!raw005) { // Afin d'éviter le multiple lignes du 005.
		raw005=true; // Ne pas oublier d'ajouter raw005=false; dans 001=registered.
		bot.join('#quizz'); // Joindre le salon #quizz à partir du raw 005.
	}
});
// Il y a aussi 376=RPL_ENDOFMOTD ou 422=RPL_NOMOTD
*/

// Événement déconnexion du bot; bug ou 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);
    // 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>
    if (event.message.indexOf('whois') === 0) {
        bot.whois(event.message.split(' ')[1]); // l'argument [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 salon #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..
bot.on('userlist', function(event) {
    console.log('userlist for', event.channel, event.users);
});

// Événement 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 petit robot IRC 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 un robot IRC, c'est npm install irc (https://www.npmjs.com/package/irc) que je déconseille d'utiliser, car incomplet et en plus il semble abandonné depuis 2016.




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

Pseudo sur Discussionner Nom du bot Date de création/Première version 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 #16-25ans. Exam est aussi présent sur EuropNet dans le salon #mimacy.
tapavu TapaVu.js-stable Janvier 2021 Madrix Robot entièrement recopié au TapaVu de l'eggdrop

Veuillez me contacter par courrier électronique à l'adresse [email protected] si vous êtes intéressé par l'un de ces robots, en échange d'une contrepartie.