StardustLootBot est un bot Discord de collection de cartes personnalisées.
Il permet aux utilisateurs de droper, claim, échanger et consulter des cartes, avec gestion de rareté, familles, notifications.

• Création de cartes personnalisées : Les administrateurs peuvent créer des cartes avec !create <nom> <image> <rarete> <famille>.
• Drop de cartes : Les utilisateurs peuvent droper des cartes aléatoires avec !drop (limite de drops par période).
• Claim : Permet de réclamer une carte droppée avec !claim <id> ou directement en cliquant sur la carte.
• Liste des cartes : Affiche la collection d’un utilisateur avec navigation (!list [@membre]).
• Notifications : Les utilisateurs peuvent être notifiés lorsqu’une carte spécifique apparaît.
• Échanges : Système d’échange de cartes entre utilisateurs.
• Gestion de la rareté : Les cartes ont différents niveaux de rareté.
• Sauvegarde automatique : Les données sont stockées dans des fichiers JSON.

1. Cloner le projet

   git clone https://github.com/Wolran/StardustLootBot.git
   cd StardustLootBot

2. Installer les dépendances

   pip install -r requirements.txt

3. Configurer le fichier .env

   BOT_TOKEN=ton_token_discord
   

4. Lancer le bot

   python bot.py

• !drop : Faire apparaître une carte.
• └->!claim <id> : Réclamer une carte droppée.
• !discard <id> : Rendre une carte à la pioche (la perd).
• !list [@membre] : Voir la collection d’un membre.
• !listrareté : Voir toutes les raretés disponibles.
• !rareté <nom> : Voir toutes les cartes d’une rareté spécifique.
• !listfamille : Voir toutes les familles disponibles.
• !famille <nom> : Voir toutes les cartes d’une famille.
• !info <nom> <famille> : Voir les infos d’une carte.
• └->!infoid <id> : Voir les infos d’une carte par id.
• !notify <id> : S’abonner aux notifications pour une carte spécifique.
• └->!unnotify <id> : Se désabonner des notifications pour une carte.
• !listnotify [@membre] : Voir les cartes pour lesquelles l’utilisateur est notifié.
• ├->!give <id> <@utilisateur> : Donner une carte à un autre utilisateur.
• └->!swap <id1> <id2> : Proposer un échange entre deux cartes avec un autre utilisateur.
• !help : Afficher l’aide et les commandes disponibles.

• !create <nom> <image> <rarete> <famille> : Créer une nouvelle carte (image doit être une URL directe).
• !delete <id> : Supprimer une carte spécifique.
• !update <id> <nom> <image> <rarete> <famille> : Mettre à jour les données des cartes (recharge les fichiers JSON).
• !cards_claim : Afficher le nombre de cartes deja réclamées.
• !cards_left : Afficher le nombre de cartes restantes à droper.

• bot.py : Code principal du bot.
• .env : Fichier de configuration pour le token du bot.
• requirements.txt : Liste des dépendances Python.
• data/ : Dossier contenant les fichiers de données.
  • cards.json : Données des cartes disponibles.
  • user_cards.json : Cartes possédées par chaque utilisateur.
  • notified_users.json : Utilisateurs à notifier pour certaines cartes.

• Ajoutez vos propres cartes dans cards.json (nom, image, rank, famille, etc.).
• Ajoutez vos propres cartes dans grâce à !create <nom> <image_url> <rarete> <famille> (image doit être une URL directe).
• Les images doivent être accessibles publiquement (URL directe, format JPG/PNG/GIF).

Pour toute question ou suggestion, contactez moi sur discord @wolran_dev ou ouvrez une issue sur le dépôt GitHub.

StardustLootBot — Un projet Discord pour collectionneurs de cartes