1 Release 1 Tag

RSS Feed

• 1.0.0 3d1989ea0f

  Compare

  @1.0.0 Stable

  cut0x released this 2025-10-18 06:10:43 +00:00 | 1 commits to main since this release

  🏰 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

  Downloads

  • Source Code (ZIP)
  • Source Code (TAR.GZ)