Elewyn/Discord-Raid-bot
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
Discord-Raid-bot/README.md
Mickaël 1a530ad2b8
Update README.md
2025-08-13 14:07:16 +02:00

8.2 KiB
Raw Blame History

RTF Discord Bot - Personal Best Tracker

Un bot Discord pour tracker les Personal Best (PB) de votre guilde sur différents boss avec système de clans et gestion des difficultés.

🎮 Fonctionnalités

  • Multi-Boss Support : Hydra (4 difficultés), Chimera (6 difficultés), Clan vs Clan
  • Système de Clans : RTF, RTFC, RTFR avec classements séparés
  • Screenshots automatiques : Stockage et affichage des preuves
  • Base de données SQLite : Stockage persistant et performant
  • Suppression automatique : Anciens screenshots supprimés lors de nouveaux records
  • Interface intuitive : Commandes simples et embeds Discord

📋 Prérequis

Logiciels requis

Dépendances Python

discord.py>=2.3.0
aiohttp>=3.8.0

🏗️ Structure des dossiers sur le NAS

Créez cette structure sur votre QNAP :

/share/Container/discord-bot/
├── bot.py                          # Script principal du bot
├── requirements.txt                # Dépendances Python
├── .env                           # Variables d'environnement
├── docker-compose.yml             # Configuration Docker
├── bot_data.db                    # Base SQLite (créée automatiquement)
├── logs/                          # Logs du bot (optionnel)
└── screenshots/                   # Screenshots des PB
    ├── hydra/
    │   ├── normal/
    │   ├── hard/
    │   ├── brutal/
    │   └── nightmare/
    ├── chimera/
    │   ├── easy/
    │   ├── normal/
    │   ├── hard/
    │   ├── brutal/
    │   ├── nightmare/
    │   └── ultra/
    └── cvc/

🐳 Installation Docker (Recommandée)

1. Créer le fichier requirements.txt

discord.py>=2.3.0
aiohttp>=3.8.0
python-dotenv>=1.0.0

2. Créer le fichier .env

DISCORD_TOKEN=your_bot_token_here
AUTHORIZED_CHANNEL_ID=your_channel_id_here

3. Créer le Dockerfile

FROM python:3.9-slim

WORKDIR /app

# Installer les dépendances système
RUN apt-get update && apt-get install -y \
    sqlite3 \
    && rm -rf /var/lib/apt/lists/*

# Copier les fichiers de configuration
COPY requirements.txt .
RUN pip install --no-cache-dir -r requirements.txt

# Copier le code source
COPY bot.py .

# Créer les dossiers nécessaires
RUN mkdir -p screenshots/hydra/normal screenshots/hydra/hard screenshots/hydra/brutal screenshots/hydra/nightmare \
    screenshots/chimera/easy screenshots/chimera/normal screenshots/chimera/hard screenshots/chimera/brutal screenshots/chimera/nightmare screenshots/chimera/ultra \
    screenshots/cvc

# Variables d'environnement
ENV PYTHONUNBUFFERED=1

CMD ["python", "bot.py"]

4. Créer le docker-compose.yml

version: '3.8'

services:
  discord-bot:
    build: .
    restart: unless-stopped
    env_file:
      - .env
    volumes:
      - ./screenshots:/app/screenshots
      - ./bot_data.db:/app/bot_data.db
      - ./logs:/app/logs
    environment:
      - TZ=Europe/Paris
    container_name: rtf-discord-bot
    
    # Optionnel: Limits des ressources
    deploy:
      resources:
        limits:
          memory: 256M
        reservations:
          memory: 128M

⚙️ Configuration

1. Obtenir le Token Discord

  1. Aller sur Discord Developer Portal
  2. Créer une nouvelle Application
  3. Dans "Bot" → "Token" → Copier le token
  4. Dans "Bot" → "Privileged Gateway Intents" → Activer "Message Content Intent"

2. Obtenir l'ID du Channel

  1. Dans Discord, activer le Mode Développeur (Paramètres → Avancé)
  2. Clic droit sur votre channel → "Copier l'identifiant"

3. Inviter le bot sur votre serveur

Générez une URL d'invitation avec ces permissions :

  • Send Messages
  • Read Message History
  • Attach Files
  • Use External Emojis
  • Add Reactions

URL : https://discord.com/api/oauth2/authorize?client_id=YOUR_BOT_ID&permissions=378944&scope=bot

🚀 Déploiement sur QNAP

Via Container Station (Recommandé)

  1. Installer Container Station via App Center
  2. Créer le dossier /share/Container/discord-bot/
  3. Copier tous les fichiers dans ce dossier
  4. Modifier le fichier .env avec vos tokens
  5. Container Station → "Create" → "Create Application via docker-compose"
  6. Sélectionner votre docker-compose.yml
  7. Démarrer le container

Via SSH (Alternative)

# Se connecter au QNAP
ssh admin@IP_DE_VOTRE_QNAP

# Naviguer vers le dossier
cd /share/Container/discord-bot/

# Installer les dépendances (si Python est installé)
pip3 install -r requirements.txt

# Lancer le bot (test)
python3 bot.py

# Créer un service auto-start
# Via Interface QNAP : Panneau de contrôle → Applications → Autorun
# Ajouter : cd /share/Container/discord-bot && python3 bot.py &

📊 Base de données SQLite

Structure automatique

Le bot crée automatiquement les tables nécessaires :

  • Table users : PB de tous les boss et difficultés
  • Table pb_history : Historique complet des records

Colonnes principales

-- Hydra
pb_hydra_normal, pb_hydra_normal_screenshot, pb_hydra_normal_date
pb_hydra_hard, pb_hydra_hard_screenshot, pb_hydra_hard_date
pb_hydra_brutal, pb_hydra_brutal_screenshot, pb_hydra_brutal_date
pb_hydra_nightmare, pb_hydra_nightmare_screenshot, pb_hydra_nightmare_date

-- Chimera (6 difficultés similaires)
pb_chimera_easy, pb_chimera_normal, pb_chimera_hard, 
pb_chimera_brutal, pb_chimera_nightmare, pb_chimera_ultra

-- CvC
pb_cvc, pb_cvc_screenshot, pb_cvc_date

🎯 Utilisation des commandes

Soumettre un PB

!pbhydra brutal 1500000    (+ screenshot attachée)
!pbchimera ultra 2000000   (+ screenshot attachée)
!pbcvc 1800000             (+ screenshot attachée)

Voir des PB

!pbhydra nightmare         (votre PB)
!pbchimera easy Alice      (PB d'Alice)
!mystats                   (tous vos PB)

Classements

!top10hydra brutal         (global)
!rtfhydra nightmare        (clan RTF)
!rtfcchimera ultra         (clan RTFC)

🔧 Maintenance

Logs

# Via Docker
docker logs rtf-discord-bot

# Via Container Station
Container Station → Votre container → Logs

Sauvegarde

# Sauvegarder la base de données
cp bot_data.db bot_data_backup_$(date +%Y%m%d).db

# Sauvegarder les screenshots
tar -czf screenshots_backup_$(date +%Y%m%d).tar.gz screenshots/

Nettoyage

Les anciens screenshots sont automatiquement supprimés quand un nouveau PB est établi.

🛠️ Résolution de problèmes

Le bot ne répond pas

  • Vérifier que le AUTHORIZED_CHANNEL_ID est correct
  • Vérifier que le bot a les bonnes permissions
  • Consulter les logs pour les erreurs

Screenshots non sauvegardées

  • Vérifier les permissions du dossier screenshots/
  • S'assurer que l'image est dans un format supporté (PNG, JPG, etc.)

Erreurs de base de données

  • Vérifier les permissions en écriture sur bot_data.db
  • En cas de corruption : supprimer le fichier (il sera recréé)

📈 Performances

Optimisation pour 50+ utilisateurs

  • SQLite : Parfait jusqu'à 100+ utilisateurs simultanés
  • Screenshots : ~2MB par image, nettoyage automatique
  • RAM : ~128MB en utilisation normale
  • CPU : Minimal (événements Discord uniquement)

🔒 Sécurité

  • Token Discord dans .env (jamais dans le code)
  • Bot limité à un seul channel
  • Pas d'accès SSH ou système depuis le bot
  • Screenshots stockées localement (contrôle total)

📝 Notes importantes

  1. Clans détectés automatiquement : [RTF] Username ou [RTF]Username
  2. Anciens screenshots supprimés automatiquement lors de nouveaux PB
  3. Classements vides affichent un message informatif
  4. Format des dates : MM/DD/YYYY at HH:MM AM/PM
  5. Émojis modifiables dans BOSS_CONFIG et CLAN_CONFIG

🚀 Extensions possibles

  • Ajout de nouveaux boss
  • Statistiques avancées (moyennes, progressions)
  • Export des données en Excel
  • Interface web pour visualiser les stats
  • Notifications automatiques de nouveaux records

Développé pour la communauté RTF 🎮