Jeux & API
Description
Guide Utilisateur
Branchez les API de vos jeux sur votre serveur : vos membres lient leur compte, consultent leurs statistiques, suivent l'état des serveurs du jeu et se comparent dans un classement. 23 jeux sont livrés prêts à l'emploi, et vous pouvez en ajouter d'autres vous-même.
Ce que ça fait
- Permet à chaque membre de lier son compte de jeu au serveur.
- Affiche des statistiques de joueur à la demande.
- Publie l'état des serveurs d'un jeu dans un message tenu à jour, et peut renommer un salon vocal compteur.
- Diffuse automatiquement les actualités d'un jeu dans un salon.
- Génère un classement des membres ayant lié leur compte.
- Propose une recherche dans les bases de données de certains jeux.
- Un constructeur permet de brancher n'importe quelle API renvoyant du JSON, sans écrire de code.
Démarrage rapide (Admin)
- Ouvrez le tableau de bord, module Jeux & API, onglet Catalogue.
- Trouvez votre jeu et cliquez sur Activer. Les réglages du jeu s'ouvrent aussitôt.
- Si le jeu est marqué « Clé requise », collez votre clé d'API dans la carte Clé d'API. Quand la mention « Clé TennoCore » s'affiche, une clé est déjà fournie et vous n'avez rien à faire.
- Activez éventuellement les automatisations : Actualités, Statut, Classement — chacune demande un salon et un intervalle.
- Utilisez le bouton Tester pour vérifier que l'API répond, puis Enregistrer.
- Annoncez
/game listà vos membres : ils y voient les jeux disponibles et lient leur compte avec/game link.
Commandes
Toutes les commandes sont accessibles à l'ensemble des membres, et répondent en privé lorsqu'il s'agit d'une liaison de compte.
| Commande | Description |
|---|---|
/game list | Liste les jeux activés sur le serveur, avec ce que chacun sait faire. |
/game link | Ouvre un formulaire pour lier votre compte au jeu choisi. |
/game unlink | Supprime la liaison de votre compte pour ce jeu. |
/game stats | Affiche les statistiques d'un membre (vous-même par défaut). |
/game status | Affiche l'état des serveurs du jeu. |
/game lookup | Recherche un élément dans la base de données du jeu. |
/game leaderboard | Classe les membres du serveur ayant lié leur compte. |
Jeux livrés avec le bot
23 connecteurs sont fournis. Chacun expose une ou plusieurs capacités : Stats joueur, Statut serveurs, Actualités, Recherche.
| Jeu | Capacités | Clé d'API |
|---|---|---|
| Apex Legends | Stats joueur | Requise |
| Brawl Stars | Stats joueur | Requise |
| Chess.com | Stats joueur | Non |
| Clash Royale | Stats joueur | Requise |
| Destiny 2 | Stats joueur | Requise |
| Epic Games – Jeux gratuits | Actualités | Non |
| Fortnite | Stats joueur | Requise |
| Free-To-Game – Sorties F2P | Actualités, Recherche | Non |
| Genshin Impact | Stats joueur | Non |
| Hypixel (Minecraft) | Stats joueur | Requise |
| League of Legends | Stats joueur, Statut serveurs | Requise |
| Lichess | Stats joueur | Non |
| Minecraft – Joueur | Stats joueur | Non |
| Minecraft – Serveur | Statut serveurs | Non |
| osu! | Stats joueur | Requise |
| Pokédex (PokéAPI) | Recherche | Non |
| RAWG – Base de données de jeux | Recherche, Actualités | Requise |
| Roblox | Stats joueur | Non |
| Statut (Statuspage générique) | Statut serveurs | Non |
| Steam – Actus d'un jeu | Actualités | Non |
| Steam – Profil | Stats joueur | Requise |
| Valorant | Stats joueur | Requise |
| Warframe – Monde | Statut serveurs, Actualités | Non |
Réglages depuis le dashboard
Le module se compose de cinq onglets.
- Catalogue — tous les jeux disponibles, filtrables par catégorie ou par nom. Chaque carte indique les capacités du jeu et son besoin de clé. Boutons Activer, Dupliquer (pour partir d'un connecteur existant) et lien vers la documentation de l'API.
- Mes jeux — les jeux activés sur ce serveur : état, automatisations actives, nombre de comptes liés, origine de la clé, dernier incident rencontré. Le bouton Configurer ouvre les réglages :
- Général : jeu actif ou en pause, et rôle attribué automatiquement au membre qui lie son compte.
- Clé d'API : votre clé, stockée chiffrée et jamais réaffichée. Laissez le champ vide pour ne rien changer.
- Paramètres du connecteur : les réglages propres au jeu (identifiant d'application Steam, région…).
- Actualités : salon, intervalle (5 à 1440 minutes, 30 par défaut) et mention éventuelle d'un rôle.
- Statut : salon du panneau, intervalle (10 minutes par défaut), et salon vocal compteur avec le modèle de nom à utiliser.
- Classement : salon, intervalle (60 minutes par défaut) et rappel de la statistique de référence.
- Chaque automatisation dispose d'un bouton Publier maintenant.
- Constructeur — création d'un connecteur maison : informations générales, authentification, champs demandés au membre, étapes d'appel, et description du message à produire. Un banc d'essai lance un véritable appel et affiche l'arborescence de la réponse : cliquez sur une valeur pour copier son chemin et le réutiliser dans l'affichage.
- Joueurs — tous les comptes liés du serveur, avec possibilité de délier un membre.
- Journal — les 50 derniers appels sortants vers les API, avec durée, résultat et détail de l'erreur.
Bon à savoir
- Un jeu doit être activé pour exister. L'autocomplétion des commandes ne propose que les jeux activés, et seulement ceux compatibles avec la commande utilisée : un jeu qui ne fournit que des actualités n'apparaîtra pas dans
/game stats. - La liaison est vérifiée immédiatement.
/game linklance un vrai appel à l'API : si le compte n'est pas trouvé, rien n'est enregistré et le membre reçoit l'erreur renvoyée par le jeu. Un compte lié est donc toujours un compte qui fonctionne. - Le formulaire de liaison est limité à 5 champs, limite imposée par Discord.
- Clés d'API en mode hybride : votre clé prime toujours ; à défaut, la clé globale TennoCore est utilisée quand elle existe. Renseigner la vôtre vous donne votre propre quota. Une clé enregistrée n'est jamais réaffichée dans l'interface.
- Quotas : chaque connecteur définit sa limite d'appels (30 par minute et par serveur en général). Au-delà, le bot répond qu'il faut patienter une minute. Les réponses sont mises en cache quelques minutes, ce qui absorbe les demandes répétées.
- Classement : au plus 40 comptes liés sont interrogés et les 20 premiers affichés. Les appels sont volontairement espacés pour ne pas épuiser le quota du serveur — prévoyez un intervalle large si beaucoup de membres sont liés. Le classement reste vide si le connecteur ne définit pas de statistique de référence.
- Premier passage d'un feed d'actualités : rien n'est publié, le bot enregistre seulement l'historique existant. C'est volontaire, pour ne pas inonder le salon. Les publications commencent au passage suivant.
- Salon vocal compteur : Discord n'autorise que 2 renommages par tranche de 10 minutes. Un intervalle trop court sera silencieusement ignoré par Discord.
/game listaffiche au plus 25 jeux, et l'autocomplétion 25 propositions.- Retirer un jeu efface ses réglages et l'historique des actualités, mais conserve les comptes liés des membres.
- Les messages du module utilisent le nouveau format d'affichage de Discord : chaque champ occupe sa propre ligne, il n'y a pas de mise en colonnes.
- Connecteurs maison : les adresses appelées doivent pointer vers une API publique. Toute adresse interne ou privée est refusée, par sécurité.
- Le journal des appels est conservé 7 jours.
- Le module figure dans la catégorie « En développement » du tableau de bord : son interface peut encore évoluer.