// documentation
Documentation complète du serveur WOILOO IRC. Débutants comme utilisateurs avancés trouveront ici les commandes, services et concepts nécessaires pour maîtriser l'IRC.
protocole
IRC (Internet Relay Chat) est un protocole de communication textuelle en temps réel
créé en 1988 par Jarkko Oikarinen. C'est l'un des protocoles Internet les plus anciens encore activement utilisés.
Il repose sur une architecture client-serveur : un ou plusieurs
serveurs interconnectés forment un réseau, des
canaux (salons commençant par #)
organisent les discussions par thèmes, et des utilisateurs s'y connectent
via un client IRC.
connexion
commandes irc
Les commandes IRC commencent toujours par /.
Les paramètres entre <chevrons> sont obligatoires,
ceux entre [crochets] sont optionnels.
| Commande | Syntaxe | Description |
|---|---|---|
| /nick | /nick <nouveau_pseudo> | Changer de pseudonyme en cours de session |
| /join | /join <#salon> [clé] | Rejoindre un salon (avec clé si protégé par +k) |
| /part | /part [#salon] [message] | Quitter le salon actuel ou un salon spécifié |
| /quit | /quit [message] | Se déconnecter complètement du serveur |
| /msg | /msg <pseudo|#salon> <texte> | Envoyer un message privé à un utilisateur ou dans un salon |
| /me | /me <action> | Exprimer une action (affiche : * MonPseudo sourit) |
| /whois | /whois <pseudo> | Afficher les informations d'un utilisateur (IP cloakée, idle…) |
| /list | /list [motif] | Lister tous les salons publics du réseau |
| /away | /away [message] | Se marquer absent (sans argument : retour actif) |
| /topic | /topic [#salon] [nouveau topic] | Voir ou modifier le sujet du salon (droits op requis) |
| /kick | /kick <#salon> <pseudo> [raison] | Expulser un utilisateur du salon (droits op requis) |
| /ban | /mode <#salon> +b <masque> | Bannir un masque hostmask du salon (droits op requis) |
| /mode | /mode <cible> [+/-modes] | Appliquer ou retirer des modes sur un salon ou utilisateur |
| /notice | /notice <pseudo> <texte> | Envoyer une notification (sans ouvrir de fenêtre de MP) |
| /ignore | /ignore <pseudo> | Ignorer tous les messages d'un utilisateur |
| /names | /names [#salon] | Lister les utilisateurs d'un salon |
| /invite | /invite <pseudo> <#salon> | Inviter un utilisateur dans un salon (+i) |
services anope
NickServ permet d'enregistrer et de protéger votre pseudonyme. Une fois enregistré,
personne d'autre ne peut utiliser votre nick sans connaître votre mot de passe.
Toutes les commandes s'envoient via /msg NickServ <commande>.
Enregistrer son pseudonyme
/msg NickServ REGISTER <motdepasse> <email>
Enregistre le pseudo actuellement utilisé avec un mot de passe et une adresse e-mail. Un e-mail de confirmation sera envoyé.
S'authentifier à chaque connexion
/msg NickServ IDENTIFY [<pseudo>] <motdepasse>
Authentifie votre session. À faire à chaque connexion si SASL n'est pas configuré. Le champ pseudo est optionnel si vous utilisez déjà votre nick enregistré.
Regrouper plusieurs pseudos
/msg NickServ GROUP <pseudo_principal> <motdepasse>
Lie le pseudo actuel à un compte existant. Pratique pour gérer des variantes (Julien, Julien|away, Julien_).
Modifier ses informations
/msg NickServ SET PASSWORD <nouveau_mdp>
Change le mot de passe du compte.
/msg NickServ SET EMAIL <nouvel_email>
Change l'adresse e-mail associée au compte.
Récupérer son pseudo
/msg NickServ GHOST <pseudo> <motdepasse>
Déconnecte une session "fantôme" utilisant votre pseudo (connexion perdue sans déconnexion propre).
/msg NickServ RECOVER <pseudo> <motdepasse>
Force la déconnexion de quiconque utilise votre pseudo enregistré.
Consulter et supprimer
/msg NickServ INFO <pseudo>
Affiche les informations publiques d'un pseudo enregistré (date d'enregistrement, dernière connexion, email masqué…).
/msg NickServ DROP <pseudo> <motdepasse>
Supprime définitivement l'enregistrement d'un pseudo. Irréversible.
services anope
ChanServ permet d'enregistrer et d'administrer vos salons IRC de façon permanente.
Commandes envoyées via /msg ChanServ <commande>.
Enregistrer un salon
/msg ChanServ REGISTER <#salon> <description>
Enregistre le salon dont vous êtes fondateur. Vous devez être opérateur dans le salon au moment de la commande.
Définir un topic permanent
/msg ChanServ SET <#salon> TOPIC <texte>
Définit le topic qui sera automatiquement restauré à chaque fois que ChanServ rejoint le salon.
/msg ChanServ TOPIC <#salon> <texte>
Modifie le topic du salon directement (équivalent de /topic avec les droits ChanServ).
Gérer les droits utilisateurs
/msg ChanServ FLAGS <#salon> <pseudo> +<flags>
Attribue des droits. Principaux flags : +o (op), +v (voice), +a (auto-op), +b (ban), +F (fondateur).
Bannissement automatique
/msg ChanServ AKICK <#salon> ADD <pseudo|masque> [raison]
Ajoute une entrée dans la liste de kick automatique. L'utilisateur sera expulsé et banni dès qu'il tentera de rejoindre.
/msg ChanServ AKICK <#salon> DEL <pseudo|masque>
Retire une entrée de la liste d'AKICK.
/msg ChanServ AKICK <#salon> LIST
Affiche toutes les entrées AKICK du salon.
Bot de présence permanente
/msg ChanServ SET <#salon> GUARD ON
Force ChanServ à rester présent dans le salon en permanence, même quand il est vide. Utile pour conserver les modes et le topic.
Verrouiller des modes
/msg ChanServ SET <#salon> MLOCK +<modes>
Verrouille des modes sur le salon. Ex : +nt pour interdire les messages externes et réserver le topic aux ops. Ils seront restaurés automatiquement.
/msg ChanServ INFO <#salon>
Affiche toutes les informations enregistrées d'un salon : fondateur, description, flags, MLOCK…
services anope
MemoServ est une messagerie asynchrone intégrée : envoyez un mémo à un utilisateur enregistré,
il le recevra à sa prochaine connexion.
Via /msg MemoServ <commande>.
/msg MemoServ SEND <pseudo> <texte>
Envoie un mémo à un utilisateur ou à tous les membres d'un salon enregistré (préfixer de #).
/msg MemoServ LIST
Liste tous vos mémos reçus (numéro, expéditeur, date, statut lu/non lu).
/msg MemoServ READ <numéro|ALL>
Lit un mémo spécifique ou tous les mémos non lus.
/msg MemoServ DEL <numéro|ALL>
Supprime un mémo ou tous les mémos de votre boîte.
/msg MemoServ SET NOTIFY ON|OFF|MAIL
Configure les notifications : alerte à la connexion, désactivée, ou par e-mail à chaque réception.
/msg MemoServ INFO
Affiche le nombre de mémos reçus et votre quota actuel.
services anope
BotServ permet d'assigner un bot avec une identité personnalisée à votre salon enregistré.
Le bot remplace ChanServ et peut parler, effectuer des kicks automatiques et logguer l'activité.
Via /msg BotServ <commande>.
/msg BotServ BOTLIST
Liste les bots disponibles sur le réseau (noms et descriptions).
/msg BotServ ASSIGN <#salon> <bot>
Assigne un bot disponible à votre salon. Le bot y rejoindra immédiatement.
/msg BotServ UNASSIGN <#salon>
Retire le bot assigné du salon.
/msg BotServ SAY <#salon> <texte>
Fait parler le bot dans le salon. Pratique pour des annonces officielles.
/msg BotServ KICK <#salon> <pseudo> <raison>
Ordonne au bot d'expulser un utilisateur du salon.
/msg BotServ SET <#salon> <option> <valeur>
Configure les options du bot (DONTKICKOPS, GREET, FANTASY, NOBOT…).
#!quizz! et tapez !start pour lancer une partie. Le bot pose une série de questions directement dans le salon, à tour de rôle avec les autres joueurs présents — répondez simplement dans le tchat.
!meteo <ville> pour obtenir la météo actuelle ou du lendemain pour la ville de votre choix.
!actu pour les gros titres du moment, ou !actu <catégorie> (sport, tech, monde…) pour filtrer.
services anope
HostServ (vHost) vous permet de remplacer votre adresse IP masquée par un hôte virtuel
personnalisé visible lors d'un /whois
(ex : julien.woiloo.fr).
Soumis à validation par un IRCop.
Via /msg HostServ <commande>.
/msg HostServ REQUEST <hote.souhaite>
Demande un vHost personnalisé. Doit respecter le format DNS (ex : pseudo.users.woiloo.fr). La demande est soumise aux IRCops.
/msg HostServ ACTIVATE <pseudo>
(IRCops uniquement) Active le vHost demandé pour un utilisateur.
/msg HostServ ON | OFF
Active ou désactive l'affichage de votre vHost pour la session en cours.
/msg HostServ OFFERLIST
Affiche la liste des vHosts prédéfinis disponibles sur le réseau sans nécessiter de validation manuelle.
modes irc
Les modes modifient le comportement d'un salon ou d'un utilisateur. On les applique avec
/mode <cible> +mode
et on les retire avec /mode <cible> -mode.
modes de salon (channel modes)
| Mode | Nom | Effet |
|---|---|---|
| +i | Invite-only | Seuls les utilisateurs invités peuvent rejoindre |
| +m | Modéré | Seuls les ops et voices peuvent parler |
| +n | No external | Interdit les messages de l'extérieur du salon |
| +t | Topic protégé | Seuls les ops peuvent changer le topic |
| +k | Clé (mot de passe) | Entrée réservée aux utilisateurs connaissant la clé |
| +l | Limite | Nombre maximum d'utilisateurs simultanés |
| +b | Ban | Bannit un masque hostmask du salon |
| +o | Op | Donne les droits opérateur à un utilisateur |
| +v | Voice | Donne le droit de parole en salon modéré (+m) |
| +s | Secret | Cache le salon dans /list et /whois |
| +p | Privé | Masque le salon dans /list (remplacé par +s) |
modes utilisateur (user modes)
| Mode | Nom | Effet |
|---|---|---|
| +x | Cloak | Masque l'adresse IP réelle (activé par défaut) |
| +i | Invisible | N'apparaît pas dans /who sauf si dans un salon commun |
| +w | Wallops | Reçoit les messages diffusés par les IRCops |
| +o | IRCop | Statut d'opérateur réseau (accordé par OPER) |
| +r | Registered | Indique que le pseudo est authentifié via NickServ |
| +R | Registered only | Bloque les messages privés des nicks non enregistrés |
glossaire
Opérateur d'un salon. Reconnaissable au préfixe @ devant son pseudo. Peut gérer les modes du salon, kicker et bannir des utilisateurs.
Droit de parole dans un salon en mode +m (modéré). Préfixe + devant le pseudo. Ne donne pas de droits d'administration.
Expulsion d'un utilisateur d'un salon. Il peut y revenir immédiatement sauf si un ban est également posé. Effectué via /kick.
Interdiction d'accès à un salon, appliquée sur un masque hostmask. Persiste jusqu'à suppression par un op. Posé via /mode #chan +b masque.
Masque d'adresse IP généré automatiquement par InspIRCd à la connexion (mode +x). Protège la vie privée des utilisateurs. Peut être remplacé par un vHost personnalisé via HostServ.
Pseudonyme utilisé pour s'identifier sur le réseau IRC. Unique sur le réseau, modifiable à tout moment avec /nick. Peut être enregistré via NickServ.
Abréviation de "channel" (canal). Salon de discussion commençant par #. On y rejoint avec /join #nom.
Client-To-Client Protocol. Extension permettant l'échange d'informations entre clients : version, ping, heure... Ex : /ctcp pseudo VERSION. Certains clients le bloquent par défaut.
Direct Client-to-Client. Protocole de transfert de fichiers ou de chat direct entre deux utilisateurs IRC, sans passer par le serveur. Plus courant avant HTTPS ; aujourd'hui souvent bloqué par les firewalls.
Internet Relay Chat Operator. Administrateur du réseau IRC dans son ensemble, disposant de pouvoirs étendus (KILL, AKILL, GLINE…). Distinct des opérateurs de salon. S'identifie via /oper. Il n'existe pas de formulaire de candidature : ce statut se gagne avec le temps, à force de présence régulière et de sérieux au sein de la communauté.
Envoi massif et rapide de messages, surchargeant les autres utilisateurs et le serveur. Sanctionné par un kick ou un ban automatique selon la sévérité.
Sujet ou description du salon, visible dans la barre de titre du client et affiché à l'arrivée. Modifiable par les ops avec /topic (si mode +t actif).
/msg NickServ HELP,
/msg ChanServ HELP directement depuis le serveur.