Documentation

Comment installer XenBot, le régler et s'en servir au quotidien. Chaque commande est décrite avec ses options, telles qu'elles sont installées en ce moment.

Démarrer en cinq minutes

Ajoute le bot à ton serveur. Il faut être administrateur du serveur. Le bot demande la permission Administrateur, dont il a besoin pour créer les salons des parties et gérer leurs accès.
Place son rôle au-dessus des rôles qu'il doit donner. Dans Paramètres du serveur, Rôles : le rôle XenBot doit être plus haut que le rôle « vérifié », le rôle « membre » et les rôles de tes joueurs.
Ouvre le tableau de bord. Connecte-toi avec Discord, choisis ton serveur, et règle dans « Général » les salons de logs. Tout ce qui suit peut aussi se faire par commande.
Désigne tes hosts. /setup-host role add autorise un rôle à créer des parties. Les administrateurs le peuvent toujours.
Crée une première partie. /creer-une-partie, ou l'onglet « Parties » du tableau de bord.

Le tableau de bord et les commandes font la même chose. Les commandes de réglage s'utilisent dans le salon concerné : /setup-reglement dans ton salon de règlement, par exemple.

Régler le serveur

Ces commandes posent les bases : où le bot écrit ses journaux, comment il accueille les nouveaux et ce qu'il vérifie avant de leur ouvrir le serveur. Elles sont réservées aux administrateurs.

Journaux

Quatre journaux séparés, chacun dans le salon de ton choix. Un journal sans salon est simplement désactivé.

/setup-log

Administrateur

Définit le salon où seront envoyés tous les logs du bot

salon: Le salon des logs

/setup-logparti

Administrateur

Définit le salon où seront envoyés tous les logs des parties

salon: Le salon des logs

/setup-logbl

Administrateur

Définit le salon où seront envoyés toutes les logs de black list

salon: Le salon des logs black list

/setup-logticket

Administrateur

Définit le salon où seront envoyés toutes les logs des tickets

salon: Le salon des logs tickets

Arrivée et vérification

Le parcours habituel d'un nouveau membre : il arrive, recopie le code du captcha, accepte le règlement, et obtient l'accès au serveur.

/setup-bienvenue

Administrateur

Définit le salon où seront envoyés les messages de bienvenue

salon: Le salon de bienvenue

/setup-aurevoir

Administrateur

Définit le salon où seront envoyés les messages des joueurs qui quittent le serveur

salon: Le salon d'aurevoir

/setup-captcha

Administrateur

Configure le système de vérification par Captcha

role: Le rôle à donner quand le captcha est réussi

À lancer dans le salon où les nouveaux arrivent. Donne au rôle vérifié l'accès au reste du serveur, et retire cet accès à @everyone.

/setup-reglement

Administrateur

Envoie ton règlement personnalisé avec un bouton d'acceptation

role: Le rôle à donner quand le règlement est accepté
texte: Ton règlement. (Astuce: écris \n pour sauter une ligne)

À lancer dans ton salon de règlement. Écris \n dans le texte pour aller à la ligne.

Vie du serveur

/setup-vocal

Administrateur

Configurer le système de vocaux temporaires

salon-generateur: Le salon vocal où les joueurs doivent cliquer
categorie: La catégorie où les nouveaux salons seront créés

Le bot doit pouvoir gérer les salons et déplacer les membres dans la catégorie choisie.

/setup-suggestions

Administrateur

Configurer le salon des suggestions pour ce serveur

salon: Le salon où les joueurs vont envoyer leurs suggestions

Chaque message posté dans ce salon est remplacé par une suggestion avec deux réactions de vote et un fil de discussion.

/setup-bugs

Administrateur

Configurer le salon des rapports de bugs pour ce serveur

salon: Le salon où les joueurs vont envoyer leurs bugs

Même principe que les suggestions, sans fil de discussion.

/config-profil

Administrateur

Définir le salon autorisé pour la commande /profil sur ce serveur

salon: Le salon où les joueurs pourront voir leur profil

Organiser une partie

Une partie passe par quatre moments. Le bot tient la liste des inscrits, tire au sort quand il y a trop de monde et gère les désistements tout seul.

L'annonce. /creer-une-partie crée une catégorie, un salon et l'annonce avec ses boutons. Les joueurs s'inscrivent ; un joueur blacklisté est refusé.
Le tirage. /tirage-uhc retient autant de joueurs qu'il y a de places et met les autres en liste d'attente. Trois salons apparaissent : la liste des joueurs, le salon de la partie, et un salon de confirmation.
La présence. Chaque joueur retenu clique « Présent » ou « Absent ». Un absent est remplacé par le premier de la liste d'attente, et le message de whitelist se met à jour.
Le lancement et la fin. /lancer-uhc donne l'adresse du serveur aux joueurs présents. /fin-uhc nettoie tout.

Depuis le tableau de bord, une partie peut être créée tout de suite, à une date précise, ou automatiquement chaque semaine le même jour.

Qui peut créer des parties

Par défaut, seuls les administrateurs. /setup-host ouvre la création à un rôle ou à un joueur, et fixe quels rôles il a le droit de mentionner : un host autorisé à mentionner « Joueurs » ne pourra pas mentionner @everyone.

/setup-host role add

Administrateur

Autoriser un rôle à créer des parties (Host/Partenaire)

role: Le rôle

/setup-host role remove

Administrateur

Retirer l'accès à un rôle

role: Le rôle

/setup-host role add-ping

Administrateur

Autoriser ce rôle à mentionner un rôle précis

role-host: Le rôle qui crée la partie
role-ping: Le rôle qu'il a le droit de mentionner

/setup-host role remove-ping

Administrateur

Retirer un droit de mention à ce rôle

role-host: Le rôle qui crée la partie
role-ping: Le rôle à lui interdire

/setup-host joueur add

Administrateur

Autoriser un joueur spécifique à créer des parties

user: Le joueur

/setup-host joueur remove

Administrateur

Retirer l'accès à ce joueur

user: Le joueur

/setup-host joueur add-ping

Administrateur

Autoriser ce joueur à mentionner un rôle précis

user: Le joueur qui crée la partie
role-ping: Le rôle qu'il a le droit de mentionner

/setup-host joueur remove-ping

Administrateur

Retirer un droit de mention à ce joueur

user: Le joueur qui crée la partie
role-ping: Le rôle à lui interdire

Les commandes d'une partie

/creer-une-partie

Hosts autorisés

Créer une partie UHC (Crée le dossier, le salon et l'annonce)

mode-de-jeu: Ex: Loup Garou, Taupe Gun...
type: Ex: FFA, To2, To3...
date: Ex: 25 Décembre
horaire: Ex: 21h00
nombre-slots: Ex: 30
role-acces: Le rôle qui pourra voir et rejoindre la partie
cohost facultatif: Pseudo du Co-Host (Optionnel)
lien-video facultatif: Lien YouTube (Optionnel)
lien-doc facultatif: Lien du Doc (Optionnel)

Garde l'identifiant donné en réponse : les trois commandes suivantes le demandent. Pour ouvrir la partie à tout le serveur, choisis @everyone comme rôle d'accès.

/tirage-uhc

Administrateur

Tire au sort et crée les salons de la partie

id-message: L'ID du message d'annonce
places: Nombre de joueurs max
amis facultatif: Mentionne les joueurs forcés (ex: @ami1 @ami2)

À lancer dans un salon de la catégorie de la partie : les trois salons y sont créés. Les joueurs passés dans « amis » doivent être inscrits.

/lancer-uhc

Administrateur

Lance la partie UHC et donne l'IP aux joueurs confirmés

id-message: L'ID du message d'annonce de la partie
ip: L'IP du serveur Minecraft

Seuls les joueurs qui ont cliqué « Présent » sont mentionnés.

/fin-uhc

Administrateur

Termine la partie UHC et supprime TOUT le dossier (Catégorie)

id-message: L'ID du message d'annonce de la partie

Supprime la catégorie entière. Chaque joueur présent gagne 100 XP.

/partie-simple

Hosts autorisés

Annonce une partie UHC rapide (Format texte brut)

nom-mode: Ex: LGUHC L'éveil de la meute
type: Ex: MEETUP, FFA, To2...
ouverture: Ex: 00h10 max
slots: Ex: 25
ping-role: Le rôle à mentionner (ex: Notifs Public)
cohost facultatif: Sélectionne le Co-Host
lien-video facultatif: Lien YouTube
lien-gdoc facultatif: Lien du GDoc

Pour une partie ouverte sans inscription : l'annonce est publiée dans le salon où tu tapes la commande.

/add-role

Administrateur

Ajouter un rôle pour que ces personnes puissent voir la partie

role: Le rôle à ajouter à la partie

Blacklist

Chaque serveur tient la liste des joueurs qu'il ne veut plus voir dans ses parties. Un joueur listé est refusé à l'inscription, avec la raison indiquée.

Par pseudoLe pseudo Minecraft donné à l'inscription, sans tenir compte des majuscules.

Par UUIDL'identifiant Mojang du compte. Un joueur qui change de pseudo reste reconnu.

Par compte DiscordSi le compte est connu, le joueur est refusé même avec un autre compte Minecraft.

Quand un joueur blacklisté tente de s'inscrire avec un nouveau pseudo ou un nouveau compte Discord, le bot rattache ce nouveau compte à la sanction d'origine et l'indique dans le journal de la blacklist.

N'inscris que des faits que tu peux justifier. Une personne listée peut demander à consulter, corriger ou faire retirer son entrée : vois la page Confidentialité.

/bl addjoueur

Administrateur

Ajouter une personne dans la black list

joueur-minecraft: Le pseudo minecraft du joueur à ajouter
raison: La raison principale du bannissement Freekill · Cheat · Comportement · Sanglier · Non-respect des règles · Killcave · Troll · Autre (Préciser dans détails)
details facultatif: Détails supplémentaires ou raison personnalisée
joueur-discord facultatif: Le pseudo discord du joueur à ajouter

Le pseudo est vérifié auprès de Mojang pour retrouver son UUID. Ajouter le compte Discord permet de reconnaître le joueur même s'il change de compte Minecraft.

/bl removejoueur

Administrateur

Enlever une personne de la black list

joueur-minecraft: Le pseudo minecraft du joueur à enlever
raison: La raison du retrait

Ne retire que l'entrée de ton serveur. Si un partenaire a aussi listé ce joueur, il reste refusé chez toi tant que la liaison existe.

/search-bl

Rôle choisi

Chercher si un joueur est dans la blacklist

joueur-minecraft: Le pseudo minecraft à rechercher
joueur-discord facultatif: Le pseudo discord à rechercher (optionnel)

Cherche dans ta liste et dans celles de tes partenaires. La réponse n'est visible que par toi.

/suggest-bl

Rôle choisi

Proposer l'ajout d'un joueur à la blacklist du serveur

joueur-minecraft: Le pseudo minecraft à signaler
raison: La raison principale du signalement Freekill · Cheat · Comportement · Sanglier · Non-respect des règles · Killcave · Troll · Autre (Préciser dans détails)
details facultatif: Détails supplémentaires ou preuves
joueur-discord facultatif: Le pseudo discord du joueur

La proposition arrive dans le tableau de bord, onglet Propositions. Rien n'est ajouté tant qu'un administrateur ne l'a pas acceptée.

Serveurs partenaires

Deux serveurs peuvent mettre leurs listes en commun. L'un envoie une demande, l'autre l'accepte : chacun voit alors la liste de l'autre et l'applique à ses inscriptions.

Ce qu'un partenaire peut faireVoir ta liste, la chercher, et copier une entrée dans la sienne.

Ce qu'il ne peut pas faireModifier ou retirer tes entrées. Chaque serveur ne touche qu'à sa propre liste.

Défaire la liaisonÀ tout moment, d'un côté comme de l'autre. Les listes redeviennent séparées aussitôt.

/bl addserver

Administrateur

Ajouter un serveur pour partager la blacklist

id-serveur: L'ID du serveur à lier

L'identifiant d'un serveur se copie avec un clic droit sur son icône, mode développeur activé dans Discord.

/bl removeserver

Administrateur

Enlever un serveur de notre blacklist commune

id-serveur: L'ID du serveur à retirer

/bl accepterserver

Administrateur

Accepter la demande de liaison de blacklist d'un serveur

id-serveur: L'ID du serveur qui a fait la demande

/bl refuserserver

Administrateur

Refuser la demande de liaison de blacklist d'un serveur

id-serveur: L'ID du serveur qui a fait la demande

/bl searchserver

Administrateur

Voir si vous partagez la blacklist avec ce serveur

id-serveur: L'ID du serveur à rechercher

/bl listserver

Administrateur

Afficher la liste des serveurs liés à votre blacklist

Lien avec Minecraft

Sur un serveur Minecraft équipé du plugin XenBot, un joueur peut prouver que son compte Discord et son compte Minecraft sont à lui. Trois choses en découlent.

Le joueur tape /link en jeu. Il reçoit un code à six caractères, valable dix minutes.
Il tape /lier sur Discord avec ce code. Les deux comptes sont reliés.
C'est tout. /delier sur Discord ou /unlink en jeu retire le lien quand il veut.

InscriptionUn joueur relié s'inscrit en un clic, sans taper son pseudo. Personne d'autre ne peut s'inscrire sous ce pseudo.

Blacklist en jeuLa blacklist des serveurs Discord d'un host s'applique à ses parties en jeu. Un joueur qu'il a lui-même mis en whitelist passe quand même.

WhitelistAprès le tirage, une commande en jeu ajoute à la whitelist les joueurs retenus.

Classement et statsAprès chaque partie classée, le serveur envoie l'ELO, les victoires et les kills : ils se consultent sur Discord.

Rôle du gradeUn joueur relié reçoit sur Discord le rôle qui correspond à son grade en jeu, et le perd si son grade change.

AnnoncesLe lancement et la fin de chaque partie du serveur sont publiés dans le salon choisi.

/lier

Tout le monde

Relie ton compte Discord à ton compte Minecraft

code: Le code obtenu en jeu avec /link

Le code s'obtient en jeu avec /link. Il sert une seule fois et expire au bout de dix minutes.

/delier

Tout le monde

Retire le lien entre ton compte Discord et ton compte Minecraft

/classement

Tout le monde

Affiche le classement ELO du serveur Minecraft

mode facultatif: Le mode de jeu (le plus joué par défaut) UHC classique · Loup-Garou UHC · Solo Leveling UHC

/stats

Tout le monde

Affiche les stats en jeu d'un joueur sur le serveur Minecraft

joueur facultatif: Un membre qui a relié son compte (toi par défaut)
pseudo facultatif: Ou un pseudo Minecraft

Commandes en jeu

/linkDonne le code à saisir sur Discord.

/unlinkRetire le lien avec Discord.

/blacklistOuvre ta blacklist : les joueurs que tu as bannis en jeu, ceux de ton Discord et ceux de tes partenaires, avec leur tête. Un clic sur un joueur ouvre sa fiche (raison, détails, qui l'a ajouté, quand) et permet de le retirer. Elle est à toi et s'applique à toutes tes parties, en cours ou non.

PropositionsDans le même panneau : les joueurs que tes membres proposent avec /suggest-bl, regroupés par joueur et triés par nombre de personnes. Tu vois qui propose et pourquoi, puis tu acceptes ou refuses. Comme sur Discord, seul un administrateur du serveur modifie sa blacklist ; celle d'un partenaire ne se touche pas.

/blacklist add · removeAjoute ou retire un joueur sans ouvrir le panneau.

/host whitelist discordAjoute à la whitelist les joueurs tirés au sort de la dernière partie Discord du host.

Le salon des annonces et le rôle de chaque grade se règlent dans le tableau de bord, section « Minecraft », visible sur le serveur Discord officiel du serveur Minecraft.

Un host voit en jeu les listes des serveurs Discord où son compte relié est administrateur ou host désigné.

Tickets

Un menu déroulant dans le salon de ton choix. Chaque option ouvre un salon privé dans la catégorie que tu lui as associée. À la fermeture, une retranscription est envoyée au joueur et au journal des tickets.

/ticket setup

Administrateur

Configurer le système de tickets

category: La catégorie où créer les tickets

/ticket add_category

Administrateur

Ajouter une option dans le menu des tickets

nom: Nom du ticket (ex: Support, Plainte)
categorie: Catégorie Discord où le créer
description facultatif: Description affichée dans le menu
emoji facultatif: Emoji affiché dans le menu (ex: 🐛)

/ticket send

Administrateur

Envoyer le message de création de ticket avec les catégories

titre: Le titre du panneau
message facultatif: Le message personnalisé

Le titre et le message du menu se règlent plus finement depuis le tableau de bord.

/ticket remove_all

Administrateur

Supprimer TOUTES les catégories configurées

Modération et profils

Chaque membre a un profil : XP gagnée en écrivant et en jouant, niveau, parties jouées, bannissements.

/ban

Modérateur

Bannir un joueur, le pénaliser en XP et générer un rapport

joueur: Le joueur à bannir
raison: La raison du bannissement
duree: Durée de la sanction (Pénalité d'XP) 7 Jour (-500 XP) · 2 Semaine (-1000 XP) · 1 Mois (-2000 XP) · Permanent (Reset Total XP)
messages facultatif: Supprimer l'historique de ses messages ? Ne rien supprimer · Dernières 24h · Derniers 7 jours

Le joueur reçoit la raison en message privé. La durée choisie fixe la pénalité d'XP affichée sur son profil.

/unban

Modérateur

Débannir un joueur du serveur

id-joueur: L'ID Discord du joueur à débannir
raison: La raison du débannissement

/clear

Modérateur

Supprime un nombre précis de messages dans ce salon

nombre: Le nombre de messages à supprimer (entre 1 et 100)

Discord refuse de supprimer en masse les messages de plus de quatorze jours.

/profil

Tout le monde

Affiche tes statistiques, ton niveau et ton rang UHC

joueur facultatif: Voir le profil d'un autre joueur (Optionnel)

/gererprofil add-xp

Administrateur

Ajouter de l'expérience au joueur

joueur: Donner le nom du joueur
nombre: Le nombre que vous voulez enlever

/gererprofil remove-xp

Administrateur

Enlever de l'expérience au joueur

joueur: Donner le nom du joueur
nombre: Le nombre que vous voulez enlever

/gererprofil add-game

Administrateur

Ajouter une game au joueur à son nombre de partie jouer

joueur: Donner le nom du joueur
nombre: Le nombre que vous voulez enlever

/gererprofil remove-game

Administrateur

Enlever une game au joueur à son nombre de partie jouer

joueur: Donner le nom du joueur
nombre: Le nombre que vous voulez enlever

Questions fréquentes

Le bot est-il gratuit ?

Oui, entièrement. Il n'y a pas de version payante.

Pourquoi le bot demande-t-il la permission Administrateur ?

Pour créer les catégories et salons des parties, régler qui les voit, donner des rôles et bannir. Il ne lit pas les messages au-delà de ce que décrit la page Confidentialité.

Un joueur conteste sa présence sur la blacklist. Que faire ?

C'est le serveur qui a posé l'entrée qui décide : retire-la avec /bl removejoueur si elle n'est pas justifiée. Le joueur peut aussi nous écrire pour exercer ses droits sur ses données.

Mes partenaires peuvent-ils effacer ma blacklist ?

Non. Un partenaire voit ta liste et l'applique, mais seul ton serveur peut la modifier.

Un joueur peut-il s'inscrire sans relier son compte Minecraft ?

Oui : il tape son pseudo à l'inscription. S'il tape un pseudo déjà relié à un autre compte Discord, il est refusé.

Que deviennent mes données si je retire le bot ?

Les réglages et la blacklist du serveur sont conservés trente jours au cas où tu le réinstalles, puis effacés automatiquement.

Comment voir ou supprimer ce que le bot sait de moi ?

Sur la page Mes données, après connexion avec Discord.

Dépannage

Une commande ne répond pasVérifie que le bot est en ligne et qu'il voit le salon. Si le message « Une erreur est survenue » s'affiche, réessaie puis signale-le-nous.

Le rôle n'est pas donnéLe rôle XenBot doit être placé au-dessus du rôle à donner dans la liste des rôles du serveur.

Les commandes n'apparaissent pasAprès l'ajout du bot, Discord peut mettre quelques minutes à les afficher. Recharge Discord avec Ctrl+R.

Le serveur n'apparaît pas dans le tableau de bordIl faut y être administrateur. Si tu viens de le devenir, déconnecte-toi du site puis reconnecte-toi.

« Ce pseudo est relié à un autre compte »Quelqu'un a relié ce pseudo Minecraft à son Discord. Si c'est le tien, fais /link en jeu puis /lier.

Toujours bloqué ? Écris-nous depuis la page Contact ou passe sur le serveur Discord.