Documentation
Mately LFG Bot
Tout ce qu'il faut savoir pour installer, configurer et utiliser le bot Discord LFG de Mately sur ton serveur. Le bot est en version bêta active — certaines fonctionnalités évoluent régulièrement.
Qu'est-ce que Mately LFG ?
Un bot Discord qui transforme n'importe quel salon en espace LFG structuré, connecté à l'application Mately.
Mately LFG Bot permet aux membres d'un serveur Discord de publier des annonces de recherche de coéquipiers directement depuis Discord, via un formulaire guidé. Chaque annonce est automatiquement diffusée sur mately.gg et l'application Mately, atteignant des joueurs au-delà du serveur.
Comment ça fonctionne
1. L'admin installe le bot
Il choisit les jeux et les salons LFG lors de la configuration initiale.
2. Le joueur crée une annonce
Un formulaire guidé avec des menus, publié en 10 secondes sans quitter Discord.
3. Mately diffuse l'annonce
Visible sur le serveur Discord et sur Mately auprès de 70 000+ joueurs.
Ce que le bot gère automatiquement
- Création et suppression des annonces (les annonces expirées sont retirées automatiquement)
- Création du salon vocal Discord si le joueur en fait la demande
- Envoi de notifications privées aux parties concernées (relances, rappels)
- Liaison entre le compte Discord du joueur et son compte Mately
Le bot est en version bêta active. Certaines fonctionnalités sont encore en développement, notamment le dashboard de gestion et la modification des jeux après installation.
Prérequis
Pour les admins de serveur
- Être administrateur du serveur Discord
- Avoir un compte Mately actif
- Avoir au moins un salon prévu pour le LFG
- Disposer d'un lien d'invitation vers le serveur
Pour les joueurs
- Être membre du serveur Discord concerné
- Lier son compte Discord à Mately pour créer ou rejoindre une annonce
- La liaison ne se fait qu'une seule fois, à la première utilisation
La liaison permet de diffuser l'annonce auprès des 70 000+ joueurs Mately, de retrouver l'historique des groupes, de recevoir les notifications et d'éviter le spam. La création d'un compte Mately est gratuite et prend moins d'une minute.
Ajouter le bot à ton serveur
Pas de commandes admin à retenir, pas de fichier de config. Le bot guide l'admin pas à pas.
Tu dois être administrateur du serveur Discord et avoir lié ton compte Mately avant de commencer.
Ajouter le bot à ton serveur
Clique sur le bouton d'invitation. Une fenêtre Discord s'ouvre : sélectionne ton serveur et autorise le bot via OAuth. Il apparaît immédiatement dans la liste des membres.
Recevoir le message de bienvenue
Le bot t'envoie automatiquement un message privé avec les instructions et un lien vers le tutoriel d'installation complet.
Lancer /install dans ton serveur
Tape /install dans n'importe quel salon. Cette commande est visible uniquement par les administrateurs et démarre la configuration guidée.
Choisir les jeux de ta communauté
Un menu s'affiche avec les +300 jeux disponibles. Sélectionne ceux sur lesquels ton serveur fait du LFG.
Associer un salon LFG à chaque jeu
Pour chaque jeu sélectionné, choisis le salon Discord dédié. Tu peux associer plusieurs salons à un même jeu (ex : ranked et casu séparés).
Choisir où les salons vocaux seront créés
Indique dans quelle catégorie Discord les salons vocaux temporaires doivent être générés automatiquement quand un joueur en fait la demande.
Un message fixe avec le bouton « + Créer une annonce » apparaît dans chaque salon LFG configuré. Tes membres peuvent déjà l'utiliser.
Installation complète du bot Mately LFG
Durée : ~2 min — Contenu : ajout du bot via l'invitation Discord → autorisation OAuth → lancement de /install → sélection des jeux → association des salons LFG → choix de la catégorie vocale → première annonce publiée
Configuration du serveur
Bonnes pratiques pour les salons LFG
- Nomme les salons de façon explicite :
#lfg-valorant,#lfg-fortnite… - Épingle le salon LFG pour que les membres le trouvent rapidement.
- Pour une communauté multi-jeux, crée un salon par jeu pour garder la lisibilité.
- Pour un jeu avec plusieurs modes (ranked / casu), tu peux créer deux salons et les associer tous deux au même jeu.
Informer tes membres
- Les anciens salons LFG en texte libre peuvent être archivés.
- Pour créer une annonce : cliquer sur le bouton dans le salon, aucune commande à taper.
- La liaison du compte Discord à Mately n'est demandée qu'une seule fois, à la première utilisation.
Une interface de gestion est en cours de développement : modification des jeux et salons, statistiques du serveur, gestion des notifications.
Permissions demandées
Voici la liste complète des permissions accordées au bot lors de l'installation.
| Permission | Pourquoi |
|---|---|
| Voir les salons | Pour détecter et utiliser les salons LFG configurés. |
| Envoyer des messages | Pour publier les annonces et le message fixe dans les salons LFG. |
| Intégrer des liens / embeds | Pour afficher les annonces avec leur mise en forme visuelle. |
| Joindre des fichiers | Pour joindre des visuels aux messages du bot si nécessaire. |
| Lire l'historique des messages | Pour retrouver et gérer les messages publiés par le bot dans les salons. |
| Utiliser des emojis externes | Pour afficher les emojis Mately dans les messages et annonces. |
| Gérer les messages | Pour supprimer les annonces expirées ou complètes automatiquement. |
| Gérer les webhooks | Pour créer et gérer les webhooks utilisés pour les publications d'annonces. |
| Gérer les salons | Pour configurer les salons LFG en lecture seule et gérer les salons vocaux temporaires. |
| Gérer les rôles | Pour attribuer automatiquement les rôles liés aux annonces si configurés. |
| Se connecter aux salons vocaux | Pour créer et gérer les salons vocaux temporaires associés aux annonces. |
| Déplacer des membres | Pour déplacer automatiquement les joueurs dans le vocal créé pour leur groupe. |
| Créer des invitations instantanées | Pour générer des liens d'invitation vers le serveur à destination des joueurs Mately externes. |
| Ajouter des réactions | Pour ajouter des réactions aux messages du bot dans certains flux d'interaction. |
| Créer des threads publics | Pour créer des threads associés aux annonces si le format le requiert. |
| Créer des threads privés | Pour les échanges privés entre joueurs liés à une annonce. |
| Envoyer des messages dans les threads | Pour que le bot puisse intervenir dans les threads qu'il crée. |
| Gérer les threads | Pour archiver ou supprimer les threads liés aux annonces terminées. |
| Gérer les événements | Pour créer des événements Discord associés aux sessions de jeu planifiées. |
| Mentionner @everyone / @here | Réservé à certaines annonces importantes. Configurable côté serveur. |
Créer une annonce LFG
Tout se passe dans le salon LFG de ton serveur. Aucune commande à retenir.
Cliquer sur « + Créer une annonce »
Le message fixe du bot est toujours présent dans le salon LFG avec ce seul bouton.
Lier son compte Discord à Mately
Si le compte Discord n'est pas encore lié à Mately, un message guide l'utilisateur. Cette étape n'arrive qu'une seule fois, à la première utilisation.
Remplir le formulaire guidé
Via menus déroulants : mode de jeu, nombre de joueurs souhaités, vocal Discord, rang, mode de candidature (ouvert ou sur validation)…
L'annonce est publiée
Elle apparaît dans le salon Discord et sur mately.gg. Un message privé confirme la publication avec un lien direct pour la modifier ou suivre les candidatures.
Créer une annonce LFG en quelques secondes
Contenu : clic sur « + » dans le salon LFG → formulaire guidé avec menus déroulants (jeu, rang, nombre de joueurs, mode, vocal) → annonce publiée dans le salon + confirmation en MP
Rejoindre une annonce
Les annonces actives s'affichent dans le salon LFG. Les annonces complètes sont barrées et le bouton Rejoindre disparaît automatiquement.
Mode ouvert
Clique sur Rejoindre. Tu reçois immédiatement un message privé avec le lien du vocal Discord, le lien de l'annonce sur Mately et l'accès au chat de groupe.
Mode sur candidature
Clique sur Rejoindre, écris un message au propriétaire (niveau, disponibilité…). Il reçoit ton profil et répond en un clic.
Rejoindre une annonce en mode ouvert
Contenu : annonce visible dans le salon LFG → clic sur « Rejoindre » → confirmation immédiate en MP avec lien vocal Discord et lien vers l'annonce
Parcours joueur selon le profil
Compte Mately déjà lié
Clic sur le bouton, formulaire, annonce publiée en 10 secondes. Zéro friction.
Première utilisation
Un message guide vers la liaison du compte Discord à Mately (~1 min). Une fois validé, clic sur « Je suis vérifié » et le flux reprend. Cette étape n'arrive qu'une seule fois.
Joueur Mately externe au serveur
Un joueur Mately qui rejoint une annonce depuis l'app reçoit automatiquement une invitation vers le serveur Discord concerné.
Sans serveur Discord
Les joueurs Mately peuvent rejoindre des annonces directement depuis l'app ou le site, sans être membres du serveur au préalable.
Application Mately
L'application Mately enrichit l'expérience LFG au-delà de ce que Discord seul permet.
Modifier une annonce
Depuis l'app, tu peux modifier ton annonce active : critères, titre, mode de candidature, sans avoir à la recréer.
Plus de critères de recherche
Des filtres avancés (disponibilité, style de jeu, plateformes…) disponibles uniquement dans l'app pour affiner les mises en relation.
Parcourir les profils
Voir le profil complet des joueurs et leur historique de groupes avant d'accepter ou de rejoindre une annonce.
Notifications d'annonces
Reçois les notifs liées à tes propres annonces, mais aussi celles des annonces des autres joueurs correspondant à tes critères — y compris en dehors de ton serveur Discord, pour trouver des coéquipiers que tu n'aurais jamais croisés autrement.
Notifications automatiques
Le bot envoie des messages privés Discord aux joueurs dans plusieurs situations pour fluidifier la mise en relation.
Relances créateur
Si une annonce reste sans candidat après un certain délai, le bot relance le créateur avec des suggestions pour gagner en visibilité.
Relances candidat
Si une candidature reste sans réponse, le bot notifie le candidat et lui propose de candidater à d'autres annonces en parallèle.
Rappels propriétaire
Si des candidatures sont en attente depuis trop longtemps, le bot rappelle au propriétaire d'annonce de les traiter pour ne pas perdre en visibilité.
Les messages privés Discord doivent être activés pour recevoir les notifications du bot : Paramètres Discord > Confidentialité et sécurité > Autoriser les messages privés des membres du serveur.
Commandes slash
Le bot fonctionne principalement via des boutons et menus. Les commandes slash sont réservées à quelques actions spécifiques.
| Commande | Qui | Description |
|---|---|---|
| /install | Admin | Lance la configuration guidée. Disponible uniquement pour l'administrateur qui a ajouté le bot. |
| /configmately | Admin | Réinitialise la configuration du bot sans désinstallation. Permet de relancer /install pour reconfigurer depuis le début. |
| /helpMately | Tous | Affiche le guide d'utilisation complet : créer une annonce, rejoindre, gérer ses candidatures, résoudre les problèmes courants. |
| /diagnostic | Tous | Lance un test automatique pour vérifier si le bot est correctement configuré : salons, permissions, connexion Mately. |
Limites et quotas
Les limites actuelles en version bêta, susceptibles d'évoluer.
| Limite | Valeur | Notes |
|---|---|---|
| Annonces par utilisateur en 24h | Illimité | À partir de la 3e annonce en moins de 24h, l'annonce n'est plus partagée à la communauté Mately. Elle reste visible sur le serveur Discord uniquement. Les utilisateurs Mately Premium ne sont pas soumis à cette restriction. |
| Annonces actives simultanées (même jeu) | 1 | Une nouvelle annonce ferme automatiquement l'annonce précédente active sur le même jeu. |
| Durée d'expiration d'une annonce | 2h par défaut | Une annonce non complète expire après 2 heures et est supprimée automatiquement du salon. |
| Nombre de joueurs par annonce | 1 à 10 | Configurable à la création via le formulaire guidé. |
| Jeux configurables par serveur | Sans limite | Modifiable uniquement en réinitialisant le bot avec /configmately puis /install (dashboard à venir). |
| Salons LFG par jeu | Plusieurs | Tu peux associer plusieurs salons au même jeu (ex : ranked, casu). |
Les restrictions liées au plan premium Mately (application mobile) s'appliquent également aux annonces créées depuis Discord. Un utilisateur Mately Free est soumis aux mêmes restrictions dans les deux interfaces.
Jeux supportés
Lors de l'installation, l'admin choisit les jeux de son serveur parmi les +300 jeux de la bibliothèque Mately.
Signale-le sur le Discord Support et on l'ajoute sous 48h.
FAQ
/install et tu choisis tes salons LFG. C'est prêt en 2 minutes, sans commandes admin à retenir ni fichier de configuration.Dépannage
Pour tout problème de fonctionnement : vérifie les points spécifiques ci-dessous, puis lance /diagnostic. Si le diagnostic est positif mais que le problème persiste, lance /configmately pour réinitialiser la configuration, puis relance /install pour reconfigurer le bot.
- Vérifie que le bot est bien présent dans la liste des membres du serveur.
- Vérifie que le bot a accès au salon où tu tapes la commande.
- Vérifie les permissions accordées au bot (voir section Permissions).
Lance /diagnostic pour obtenir un rapport automatique.
/configmately pour réinitialiser la configuration, puis relance /install. Si le bot n'est plus dans le serveur, réajoute-le avant de relancer /install.- Vérifie que le salon est bien celui configuré lors de l'installation.
- Vérifie que le bot dispose de la permission « Envoyer des messages » dans ce salon spécifiquement.
- Le message fixe avec le bouton « + Créer une annonce » doit être visible dans le salon.
Lance /diagnostic pour vérifier la connexion entre le salon et la configuration du bot.
/configmately puis relance /install pour reconfigurer les salons.- Vérifie que le joueur a finalisé la création de son compte Mately, validation de l'email incluse.
- Vérifie que ses messages privés Discord sont activés : Paramètres > Confidentialité et sécurité > Autoriser les messages privés des membres du serveur.
- Le joueur peut cliquer sur « Je suis vérifié » dans le message du bot pour relancer la vérification de son compte.
Lance /diagnostic pour vérifier la connexion entre le bot et Mately.
/configmately puis relance /install.- Vérifie que le jeu concerné est bien sélectionné dans la configuration du bot.
- Vérifie que l'utilisateur n'a pas dépassé 2 annonces actives dans les 24 dernières heures (à partir de la 3e, elles ne sont plus partagées à la communauté sans Premium Mately).
Lance /diagnostic pour tester la connexion entre le serveur et Mately.
/configmately puis relance /install.- Le joueur doit activer les messages privés : Paramètres Discord > Confidentialité et sécurité > Autoriser les messages privés des membres du serveur.
- Vérifie que le joueur n'a pas bloqué le bot.
Lance /diagnostic pour vérifier l'état général du bot.
/configmately puis relance /install.- Vérifie que le bot dispose des permissions « Gérer les salons » et « Se connecter aux salons vocaux » sur le serveur.
- Vérifie que le joueur a bien sélectionné l'option vocal lors de la création de son annonce.
- Vérifie que la catégorie Discord choisie pour les vocaux lors de l'étape 6 de l'installation est toujours accessible par le bot.
Lance /diagnostic pour vérifier les permissions vocales du bot.
/configmately puis relance /install pour reconfigurer la catégorie vocale.Support
Discord Support
Rejoins notre serveur et ouvre un ticket dans le salon dédié. Notre équipe répond en quelques heures.
Données et confidentialité
Mately LFG Bot collecte uniquement les données nécessaires à son fonctionnement.
Données utilisées
- Identifiant Discord de l'administrateur configurateur
- Identifiant et pseudo Discord des joueurs qui publient ou rejoignent une annonce
- Contenu des annonces (jeu, rang, mode, nombre de joueurs)
- Identifiant du serveur Discord
Données non collectées
- Messages échangés dans les salons Discord
- Messages privés entre membres
- Données de connexion Discord
- Aucune donnée n'est partagée avec des tiers
Dernières mises à jour
Historique des versions du bot Discord Mately LFG.
/install, /helpMately, /diagnostic, /configmately