Documentation — Evamix

Introduction

Evamix est un bot Discord conçu pour gérer les sondages de disponibilité pour les matchs et entraînements d'une équipe. Ce guide vous explique comment utiliser toutes les fonctionnalités du bot.

Pour toute question ou assistance, n'hésitez pas à rejoindre notre serveur Discord.

Permissions

Le bot utilise un système de rôles pour contrôler l'accès aux commandes :

Rôle Équipe : Si configuré via /config team-role, seuls les membres avec ce rôle peuvent utiliser les commandes de base
Rôle Manager : Si configuré via /config manager-role, requis pour les commandes de gestion
Admin Discord : Les administrateurs Discord (permission ADMINISTRATOR) peuvent utiliser /config et /init même sans rôle manager configuré

Note : Si aucun rôle n'est configuré, les commandes de base sont accessibles à tous les membres du serveur.

Configuration Initiale

Commande /init

La première fois que vous utilisez le bot, utilisez /init pour configurer le bot via un flux interactif :

Langue : Sélectionnez la langue du serveur (anglais ou français)
Nom et tag de l'équipe : Saisissez le nom complet et le tag court de votre équipe
Salons : Sélectionnez les salons pour les sondages et les demandes de match
Salles : Sélectionnez les salles disponibles pour ce serveur
Rôles : Sélectionnez les rôles manager et équipe (optionnel)

Permission : Admin Discord uniquement

Note : Tous les paramètres sont configurés via des menus interactifs, pas d'arguments à saisir.

Commande /config

Utilisez /config pour modifier la configuration du bot :

/config language : Définir la langue du serveur (flux interactif)
/config team-role : Définir ou supprimer le rôle d'équipe (flux interactif)
/config manager-role : Définir ou supprimer le rôle manager (flux interactif)
/config channel-poll : Définir le salon où publier les sondages match (flux interactif)
/config channel-request : Définir le salon où envoyer les demandes de match (flux interactif)
/config rooms : Configurer les salles disponibles (flux interactif)
/config preferences : Configurer les préférences de créneaux de l'équipe (flux interactif)
/config profile : Définir le nom et le tag de l'équipe (affichés dans les sondages) (flux interactif)
/config view : Afficher la configuration actuelle

Permission : Admin Discord uniquement

Gestion des Matchs

Créer un match

Utilisez /match create pour créer un sondage de disponibilité :

Sélectionnez une salle de pratique
Choisissez le type (Compétition ou Entraînement)
Sélectionnez la date du match
Choisissez l'équipe adverse : la liste propose Mix Eva et les équipes configurées via /init ou /config profile qui ont des salles en commun avec votre équipe (sauf si elles sont en pause via /match break). Le serveur Discord de l'équipe est automatiquement utilisé pour la synchro cross-serveur si l'équipe en a un (pas de serveur pour Mix Eva).
Ajoutez des sessions horaires avec le bouton « Ajouter une session »
Publiez le sondage avec le bouton « Publier »

Permission : Rôle Manager (si configuré)

Note : le miroir automatique du sondage sur le serveur adverse est implémenté. Les votes sont synchronisés entre les deux serveurs.

Lister les matchs

Utilisez les commandes suivantes pour voir les matchs (uniquement ceux liés à ce serveur : créés ici ou dont ce serveur est l'adversaire enregistré) :

/match next : Liste les prochains matchs
/match past : Liste les anciens matchs
/match list : Liste tous les matchs

Permission : Rôle Équipe ou Manager (si configuré)

Supprimer ou annuler un match

Utilisez les commandes suivantes pour gérer les matchs :

/match delete : Supprime définitivement un match (sans notification)
/match abort : Marque le match comme annulé, notifie l'équipe ; le match reste enregistré avec ce statut
/match poll : Republie les messages du sondage d'un match si ceux-ci ont été supprimés manuellement dans Discord par erreur. Les messages (header et sessions) sont recréés dans le salon configuré pour les sondages.

Les matchs, votes et statuts (planifié, terminé, annulé) sont stockés et persistés sur le serveur du bot.

Permission : Rôle Manager (si configuré)

Pool d'adversaires (manager)

Les équipes sont automatiquement enregistrées dans le pool d'adversaires lorsqu'elles sont configurées via /init ou /config profile. Pour gérer la disponibilité de votre équipe :

/match break : Pause — l'équipe n'est plus proposée comme adversaire (tant que /match engage n'a pas été utilisé).
/match engage : Fin de pause — l'équipe redevient sélectionnable. Si elle n'était pas en pause, message d'erreur.

Permission : Rôle Manager (si configuré)

💡 Retirer une équipe du pool

Pour retirer complètement une équipe du pool, il suffit de retirer le bot du serveur Discord. L'équipe sera automatiquement archivée et ne sera plus proposée comme adversaire. Le nettoyage s'effectue automatiquement environ 1 heure après le retrait du bot.

Voter sur un sondage

Une fois qu'un sondage est publié, vous pouvez voter sur chaque session :

✅ Inscrit : Vous êtes inscrit pour cette session sur la plateforme EVA.gg
🟢 Présent : Vous serez présent
🟡 Peut-être : Vous n'êtes pas sûr
❌ Non disponible : Vous ne serez pas disponible

Limite : Maximum 4 personnes par équipe par session pour "Inscrit" et "Présent" (donc 8 personnes au total si deux équipes participent).

Permission : Rôle Équipe (si configuré)

Commandes /team

/team list

Utilisez /team list pour lister les équipes qui ont des salles en commun avec votre équipe, avec leurs préférences de créneaux.

Cette commande affiche uniquement les équipes qui partagent au moins une salle avec votre serveur, ce qui permet de voir quelles équipes sont disponibles pour organiser des matchs.

Permission : Rôle Équipe ou Manager (si configuré)

/team list-all

Utilisez /team list-all pour lister toutes les équipes enregistrées dans le système, avec leurs préférences de créneaux.

Cette commande affiche toutes les équipes, même celles qui n'ont pas de salles en commun avec votre équipe.

Vous pouvez utiliser l'option preferences pour afficher ou masquer les préférences de créneaux (par défaut : affichées).

Permission : Rôle Équipe ou Manager (si configuré)

Notifications

Le bot envoie automatiquement des notifications :

Rappels de réponse : Quotidiennement, si vous n'avez pas voté sur toutes les sessions d'un sondage
Rappels de match : 24h et 1h avant un match si vous avez voté "Présent" ou "Inscrit" à au moins une session

Vous pouvez tester les notifications avec /notification test (Rôle Manager ou Admin Discord).

Résumé des Permissions

Tableau récapitulatif des permissions :

Commande	Rôle Équipe	Rôle Manager	Admin Discord
`/match create`	❌	✅ (si configuré)	❌
`/match next/past/list`	✅ (si configuré)	✅ (si configuré)	❌
`/match delete/abort/poll`	❌	✅ (si configuré)	❌
`/match break`, `/match engage`	❌	✅ (si configuré)	❌
`/config *`	❌	❌	✅ (uniquement)
`/config *`	❌	❌	✅ (uniquement)
`/init`	❌	❌	✅ (uniquement)
`/notification test`	❌	✅ (si configuré)	✅
Votes sur sondages	✅ (si configuré)	❌	❌

Conseils et Astuces

Configurez les rôles dès le début avec /init pour sécuriser l'accès
Les équipes sont automatiquement ajoutées lorsque les serveurs configurent leur équipe
Utilisez /match list pour voir tous les matchs passés et à venir
Les notifications sont envoyées automatiquement, pas besoin de les déclencher manuellement

Support

Pour toute question ou problème, vous pouvez rejoindre notre serveur Discord ou contacter l'administrateur du serveur Discord où le bot est installé.