ZenFN BOT

🤖 ZENFN – BOT DISCORD FORTNITE C2S6
Résumé des fonctionnalités & spécifications techniques

1. 🎯 Présentation générale
ZenFN est un bot Discord polyvalent développé en Python avec la bibliothèque discord.py. Il est conçu pour animer et gérer des communautés autour de l’univers Fortnite (saison C2S6), mais ses fonctionnalités de modération et d’administration sont génériques et adaptables à tout serveur.

2. ⚙️ Architecture & Stockage
Langage : Python 3.8+

Framework : discord.py (commandes slash / et commandes préfixe +)

Base de données : Aucune base de données externe. Toutes les données sont stockées localement dans des fichiers JSON (dossier zenfn_data).

Gestion des permissions : Utilisation des permissions Discord natives (@app_commands.default_permissions).

3. 🎮 Fonctionnalités "Jeu / Comptes"
Commande Description
/create-account Crée un compte joueur (pseudo, email zenfnX@zenfn.fn, mot de passe généré, 500 V-Bucks).
/my-profile Affiche le profil du joueur : pseudo, email, niveau, V-Bucks, stats (victoires, éliminations).
/rank Affiche le niveau XP d’un membre.
/leaderboard Affiche le classement des 10 meilleurs membres en XP/niveau.
Système d’XP :

Gain aléatoire de 15 à 25 XP par message (cooldown de 60s).

Passage de niveau automatique (100 XP nécessaires par niveau).

Récompenses de rôles possibles à certains niveaux (configurable).

4. 🛡️ Modération avancée
Commande Description
/ban, /kick, /mute, /unmute Sanctions classiques (le mute crée un rôle "Muted" avec restrictions).
/clear Supprime entre 1 et 100 messages.
/clearall Clone le salon et supprime l'original (pour un reset complet).
/warn, /warnings, /unwarn Système d’avertissements (avec historique, modérateur, date).
/derank, /rankup, /massrole Gestion des rôles (retirer, ajouter, ajout groupé par mentions).
Filtre anti-insultes Détection et suppression automatique des mots interdits (configurable avec /badword).
5. 🎫 Tickets de support
Panneau de ticket via /ticket-panel (admin).

Création d’un salon privé (ticket-{userID}) avec un système de prise en charge (bouton "Prendre en charge") et de fermeture automatique.

Gestion des permissions : seul l’utilisateur, les admins et le staff ont accès.

6. 🎉 Animations & Giveaways
Commande Description
/giveaway Lance un giveaway (durée paramétrable, ex: 10m, 1h, 45s).
/reroll Tire un nouveau gagnant pour un giveaway terminé.
/reactionrole Associe une réaction (émoji) à un rôle sur un message spécifique.
7. 🎨 Personnalisation du serveur
Commande Description
/setwelcome Configure le message, l’image (bannière) et l’auto-rôle à attribuer à l’arrivée d’un membre.
/setleave Configure le message et l’image pour le départ d’un membre.
/testwelcome Simule un message de bienvenue pour tester la configuration.
Compteur vocal Met à jour automatiquement le nom d’un salon vocal avec le nombre de membres (toutes les 10 min).
8. 📦 Sauvegarde & Logs
Commande Description
/backup, /backuplist, /backupdelete Sauvegarde la structure du serveur (channels, nom) et gère les archives.
/modlog Définit un salon pour envoyer les logs de modération (ban, kick, warn, suppression auto).
9. ❓ Aide & Configuration
/helpe : Affiche la liste complète des commandes disponibles.

/badword add/remove/list : Gère la liste des mots interdits.

+sync (commande préfixe) : Resynchronise les commandes slash (réservé au propriétaire).

10. 🔐 Sécurité & Confidentialité (lié aux pages web)
Données collectées : ID Discord, messages, réactions, paramètres du serveur.

Stockage : 100 % local (fichiers JSON). Aucune donnée n’est envoyée à un serveur externe.

Non-partage : Aucune donnée personnelle n’est vendue ou partagée avec des tiers.

Droit à l’oubli : Possibilité de demander la suppression des données via le support.

11. 🧩 Points techniques notables
Gestion d’erreurs : Le bot vérifie l’existence des canaux, des rôles et des messages avant d’agir.

Automatismes :

Vérification périodique des giveaways terminés (toutes les 30s).

Mise à jour automat