🏰 Clash Royale Discord Bot

Un bot Discord avancé intégrant l'API officielle Clash Royale pour gérer automatiquement les classements, félicitations et synchronisations de profils.

✨ Fonctionnalités Principales

🎯 Synchronisation de Profils

Commande /sync : Associe automatiquement un profil Clash Royale à un utilisateur Discord
Vérification des rôles requis avant synchronisation
Validation en temps réel via l'API officielle Clash Royale
Protection contre les doublons de profils

🏆 Système de Classement

Classement Top 10 automatiquement mis à jour dans le salon dédié
Mise à jour programmée toutes les heures
Interface visuelle avec médailles et icônes de trophées
Statistiques du serveur (moyenne, total des trophées)
Commande /ranking avec sous-commandes :
- top : Affiche le top 10
- me : Votre position personnelle
- update : Mise à jour forcée (admin)

🎉 Félicitations Automatiques

Détection automatique des paliers de 1000 trophées
Messages personnalisés selon le niveau atteint
Réactions automatiques sur les messages
Envoi dans le salon de félicitations configuré
Gestion des doublons (pas de spam)

🚀 Installation Rapide

1. Prérequis

Node.js 16+ (recommandé : 18+)
npm ou yarn

2. Installation

git clone <repository-url>
cd clashroyale-bot
npm install

3. Configuration

# Copier le fichier de configuration
cp .env.exemple .env

# Éditer le fichier .env avec vos tokens et IDs
nano .env

4. Lancement

npm start

⚙️ Configuration

Copiez .env.exemple vers .env et remplissez toutes les valeurs selon votre serveur Discord et votre token API Clash Royale.

Variables principales :

DISCORD_TOKEN : Token de votre bot Discord
CLASH_ROYALE_TOKEN : Token API Clash Royale (Supercell)
GUILD_ID : ID de votre serveur Discord
RANKING_CHANNEL_ID : Salon pour le classement automatique
CONGRATULATIONS_CHANNEL_ID : Salon pour les félicitations
CLASH_ROYALE_ROLE_ID : Rôle requis pour utiliser les commandes

🗂️ Structure

src/
├── handlers/          # Chargement automatique des modules
├── commands/          # Commandes slash Discord
├── events/           # Événements Discord
├── services/         # Logique métier (API, classements, etc.)
└── utils/            # Base de données et utilitaires

📋 Commandes

/sync id:TAG - Synchroniser son profil Clash Royale
/ranking top - Top 10 du serveur
/ranking me - Votre position
/ranking update - Mise à jour forcée (admin)

🔄 Automatisations

Classement : Mis à jour automatiquement toutes les heures
Félicitations : Détection des paliers de 1000 trophées toutes les 30 minutes
Logs colorés : Monitoring en temps réel avec système de couleurs

Développé par l'équipe Neptunia • Bot opérationnel 24/7

2.9 KiB Raw Blame History