Guide d’utilisation — GameRank Discord Bot
Bot de listing pour ta page GameRank : classement des votes, infos serveur, rappels de vote.
Pourquoi les rappels ? Sans relance, les joueurs oublient de revoter après le cooldown d’1 h. Active les rappels (panneau /config + bouton « Gérer le rappel » après un vote) pour tenir ta boucle de votes vivante.
12 commandes slash (noms en français). Tape / dans Discord pour les voir.
Première configuration (admin)
- Invite le bot sur ton serveur Discord (permission de gérer les salons recommandée).
- Sur game-rank.com, ouvre ta page serveur et copie :
- l’URL (ex.
https://game-rank.com/serveurs/mon-serveur) - le token de la page (secret — ne le partage pas)
- l’URL (ex.
- Dans Discord, lance :
/config url:https://game-rank.com/serveurs/ton-slug token:TON_TOKEN
Sans option salon, le bot crée #classement-votes, y poste le classement et active le classement auto.
Tu peux aussi lancer /config sans options : un panneau interactif s’ouvre (langue, token, lien, salon classement, rappels, ban de pseudos).
Qui peut quoi ?
| Rôle | Commandes |
|---|---|
| Tout le monde | /help, /bot-info, /informations, /statistiques, /liste-avis, /classement, /last-classement, /voter |
| Admin / Gérer le serveur | /config, /panel-serveur, /reset |
| Gérer les messages | /effacer-message |
Tant que /config n’a pas lié la page, les commandes « page » demandent de configurer d’abord.
Commandes détaillées
/help
Liste courte des commandes et leur rôle.
/bot-info
Version du bot, latence Discord, nombre de serveurs, lien GameRank.
/config — admin
Lie (ou met à jour) la page GameRank de ce serveur Discord.
| Option | Obligatoire | Description |
|---|---|---|
url | avec token | URL de la page (/serveurs/{slug} ou /serveurs/{slug}/voter) |
token | avec url | Token secret de la page GameRank |
salon | non | Salon texte pour le classement auto ; sinon création de #classement-votes |
Sans options → panneau de configuration :
- Langue — messages bot FR / EN
- Paramètres — modifier token ou URL
- Classement auto — salon + activer / désactiver la mise à jour auto
- Rappels — salon lié aux rappels (si utilisé)
- Pseudo ban — exclure des noms du classement affiché
Le token n’est jamais affiché en clair (masqué).
Si le classement auto échoue (API, salon inaccessible…), le bot envoie une alerte dans le salon Discord « mises à jour de la communauté » (sinon le salon classement) et désactive le classement auto. Tu le réactives via le panneau /config.
/panel-serveur — admin
Résumé de la page liée : nom, slug, jeu, salon auto, token masqué, langue.
/reset — admin
Efface toute la configuration GameRank de ce serveur Discord (page, salon, rappels liés, etc.). À refaire ensuite avec /config.
/informations
Fiche de la page GameRank (nom, description, votes, clics, accès, slots, etc.).
| Option | Description |
|---|---|
invitation | Lien d’invitation Discord optionnel à afficher |
/statistiques
Stats de la page (votes, clics, rang, joueurs, pic…).
| Option | Description |
|---|---|
periode | Période demandée (ex. mois) si l’API le permet |
/liste-avis
Derniers avis / notes publiés sur la page GameRank.
/classement
Classement des votes du mois en cours, avec boutons :
- Voter — ouvre la page de vote GameRank
- État de mon vote — dispo ou prochain vote
- Gérer le rappel — MP quand tu pourras revoter
/last-classement
Même chose pour le mois précédent.
/voter
État de ton vote + lien pour voter sur GameRank.
/effacer-message — gérer les messages
Supprime un message du bot (ex. ancien classement).
| Option | Obligatoire | Description |
|---|---|---|
message_id | oui | ID du message Discord à supprimer |
Active le mode développeur Discord pour copier l’ID d’un message.
Parcours joueur typique
- Admin a fait
/config /classementou le message auto dans#classement-votes- Bouton Voter ou commande
/voter - Optionnel : bouton Gérer le rappel pour un MP au prochain vote
Permissions bot recommandées
- Voir les salons / Envoyer des messages / Intégrer des liens
- Gérer les salons (création de
#classement-votes) - Lire l’historique des messages (édition du message de classement auto)
Pour les alertes d’erreur classement auto : accès au salon mises à jour de la communauté du serveur (réglages Discord → Communauté).
Problèmes fréquents
| Symptôme | Que faire |
|---|---|
| Aucune commande slash | Attendre la propagation globale (jusqu’à ~1 h), redémarrer le client Discord, vérifier que le bot est en ligne |
| « Configure d’abord ta page » | Admin : /config avec URL + token |
| Token invalide | Retrouver le token sur la page GameRank, le remettre via /config ou le panneau |
| Pas de classement auto | Panneau /config → Classement auto activé + salon valide |
| Classement auto coupé après erreur | Lire l’alerte dans le salon community / classement, corriger, réactiver dans /config |
Liens
- Site : game-rank.com
- Catalogue / plugins : game-rank.com/plugins
- Aide in-Discord :
/help