97 lines
2.9 KiB
Markdown
97 lines
2.9 KiB
Markdown
# 🏰 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 |