# 🏰 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
```bash
Node.js 16+ (recommandé : 18+)
npm ou yarn
```

### 2. Installation
```bash
git clone <repository-url>
cd clashroyale-bot
npm install
```

### 3. Configuration
```bash
# Copier le fichier de configuration
cp .env.exemple .env

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

### 4. Lancement
```bash
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