⚔️ TrustRoyale

TrustRoyale est le Bot officiel de la ☆. Resistance Family 🛠️

• Suivez en temps réel les statistiques de nos clans
• Analysez vos performances et celles des autres joueurs
• Optimisez votre stratégie

TrustRoyale se compose :

1. d'une application web accessible sur https://trustroyale.vercel.app ;
2. d'un bot Discord (commandes /) permettant de lancer diverses analyses depuis notre serveur Discord.

🚀 Utilisation de l'application web

1. Rendez-vous sur https://trustroyale.vercel.app (version anglaise ou française disponibles)
2. Choisissez le mode Player ou Clan en haut.
3. Saisissez le tag du joueur ou du clan (le # est ajouté automatiquement) puis cliquez sur Analyze.
4. L'interface affiche :
   • fiche d'aperçu (nom, tag, trophées, etc.) ;
   • indicateurs d'activité et graphiques (logs de bataille/guerre) ;
   • score de fiabilité en pourcentage suivant les données disponibles ;
   • etc.

Un bouton étoile permet d'enregistrer le tag en « favori » ; la liste des favoris se retrouve sous la barre de recherche.

🤖 Utilisation du Bot Discord

Commencer par taper / dans le chat pour voir la liste des commandes disponibles.

Liste des commandes :

1. /trust : analyse la fiabilité d'un joueur. Options : tag:#TAG
2. /stats : affiche les statistiques GDC détaillées d'un membre de la famille. Options : tag:#TAG
3. /trust-clan : liste tous les membres peu fiables d'un clan de la famille. Options : clan:N
4. /late : liste les joueurs en retard sur leurs decks de la journée (avant le reset). Options : clan:N
5. /late-ping : variante de /late qui ping les membres liés à Discord quand leur ID est connu. Commande réservée aux membres du staff définis dans AUTHORIZED_PING_IDS. Options : clan:N
6. /chelem : liste les joueurs ayant fait 16/16 decks toutes les semaines d'une saison (par défaut : la dernière saison terminée). Options : clan:N [season:X]
7. /promote : liste les joueurs ayant atteint ≥ 2600 pts la semaine précédente. Options : clan:N
8. /top-players : liste les meilleurs joueurs de la famille pour la période précédente. Options : number:[3|5|10] period:[week|season]
9. /demote : liste les joueurs n’ayant pas fait tous leurs combats GDC la semaine précédente. Options : clan:N
10. /fail : affiche les joueurs qui ont manqué une journée de GDC hier pour un clan. Options : clan:N
11. /discord-link : lie son compte Clash à son Discord. Options : tag:#TAG (tag2 et tag3 optionnels pour comptes multiples)
12. /discord-check : vérifie quels membres d'un clan sont présents sur le serveur Discord. Options : clan:N
13. /family : affiche un résumé des clans de la famille. Options : aucune
14. /clan : affiche la fiche récapitulative d'un clan (membres, trophées GDC, ligue, statut, fiabilité). Options : clan:N ou tag:#TAG
15. /recap : récap GDC de la saison passée — 10 moins bons scoreurs de La Resistance, 10 meilleurs de Les Resistants. Options : saison:[-1|-2] (défaut -1)
16. /blacklist : gère la Liste Noire (réservé aux membres ayant un rôle commençant par STAFF). Sous-commandes : ajoute tag:#TAG [raison], retire tag:#TAG, consulte (pseudo, tag, clan actuel, clan d'avant, raison)

Remarque : l'installation de ce bot n'est réalisable que par displaynone.

Configuration Discord utile :

• AUTHORIZED_GUILD_IDS limite les serveurs pouvant utiliser le bot.
• AUTHORIZED_PING_IDS limite l'usage de /late-ping aux membres du staff autorisés.

📮 Notifications Discord automatiques

En plus des commandes du Bot, plusieurs scripts permettent de publier automatiquement des messages dans les channels Discord des clans :

1. Nouveautés : détecte les arrivées, départs et changements de rôle des membres par comparaison entre deux snapshots. Post automatique dans le channel Discord du clan.
2. Résumé GDC : poste un résumé de la journée de GDC qui vient de se terminer dans chaque channel clan. Poste un résumé de la semaine lorsque le dernier jour de la GDC est terminé.
3. Joueurs inactifs : alerte quotidienne listant les membres non connectés depuis plusieurs jours.
4. Pronostics : lance le vote pour le champion à venir, puis annonce les résultats.

Pour ne pas parasiter les discussions du salon principal, ces messages peuvent être redirigés vers un thread dédié au sein du salon du clan, réservé aux posts automatiques. Ce fonctionnement est testé pour l'instant uniquement sur le clan 2 (les clans 1 et 3 restent inchangés) ; voir CONTRIBUTING.md pour l'étendre.

---

📌 Astuces

• Les favoris sont stockés localement dans votre navigateur : ils ne sont pas partagés entre appareils.
• Le lien de partage de l'analyse (https://trustroyale.vercel.app/?mode=...) peut être copié et envoyé à d'autres membres du clan.

---

�🛠 Pour les développeurs

Voir CONTRIBUTING.md pour la documentation technique, le setup local et les formules de calcul.

---

📝 Captures

Vue Clan générale :

Vue Clan section membres :

Vue Joueur générale :

Vue Joueur score :