Update README.md
This commit is contained in:
Mickaël
GitHub
parent
175be88ace
commit
1a530ad2b8
1 changed files with 282 additions and 60 deletions
342
README.md
342
README.md
|
|
@ -1,76 +1,298 @@
|
||||||
|
# RTF Discord Bot - Personal Best Tracker
|
||||||
|
|
||||||
# Discord Bot Setup Guide
|
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.
|
||||||
|
|
||||||
This guide explains how to create, configure, and run a Discord bot that responds to commands in a specific channel and reads data from a Google Sheet.
|
## 🎮 Fonctionnalités
|
||||||
|
|
||||||
---
|
- **Multi-Boss Support** : Hydra (4 difficultés), Chimera (6 difficultés), Clan vs Clan
|
||||||
## Step 1: Create Your Bot on Discord
|
- **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
|
||||||
|
|
||||||
1. **Go to the Discord Developer Portal**
|
## 📋 Prérequis
|
||||||
Visit [Discord Developer Portal](https://discord.com/developers/applications).
|
|
||||||
|
|
||||||
2. **Create a New Application**
|
### Logiciels requis
|
||||||
Click on **"New Application"** and give your bot a name (e.g., "MyBot").
|
- **Python 3.9+**
|
||||||
|
- **Container Station** (QNAP) ou **Docker**
|
||||||
|
- **Discord Bot Token** ([Discord Developer Portal](https://discord.com/developers/applications))
|
||||||
|
|
||||||
3. **Add a Bot to the Application**
|
### Dépendances Python
|
||||||
Once the application is created, click on **"Bot"** in the left menu and then click **"Add Bot"**.
|
```
|
||||||
|
discord.py>=2.3.0
|
||||||
4. **Copy the Authentication Token**
|
aiohttp>=3.8.0
|
||||||
Under "TOKEN", click on **"Copy"** to copy your **token** (keep it safe and don't share it!).
|
|
||||||
|
|
||||||
---
|
|
||||||
## Step 2: Install Python Dependencies
|
|
||||||
|
|
||||||
If you don't have Python installed, download it here: [Python](https://www.python.org/downloads/).
|
|
||||||
|
|
||||||
Then, install the required libraries via pip:
|
|
||||||
|
|
||||||
```bash
|
|
||||||
pip install discord.py pandas gspread oauth2client
|
|
||||||
```
|
```
|
||||||
|
|
||||||
- `discord.py`: for interacting with the Discord API.
|
## 🏗️ Structure des dossiers sur le NAS
|
||||||
- `pandas`: for manipulating the Google Sheets data.
|
|
||||||
- `gspread` and `oauth2client`: for accessing Google Sheets (if your file is private).
|
|
||||||
---
|
|
||||||
|
|
||||||
## Step 5: Add Your Authorized Channel ID
|
Créez cette structure sur votre QNAP :
|
||||||
|
|
||||||
- Replace `AUTHORIZED_CHANNEL_ID = 123456789012345678` with the ID of the channel where you want to allow the command.
|
```
|
||||||
- To get the channel ID, enable **Developer Mode** in Discord (User Settings > Advanced > Developer Mode), then **right-click** your channel and select **"Copy ID"**.
|
/share/Container/discord-bot/
|
||||||
|
├── bot.py # Script principal du bot
|
||||||
---
|
├── requirements.txt # Dépendances Python
|
||||||
## Step 6: Obtain Your Google Sheet URL
|
├── .env # Variables d'environnement
|
||||||
|
├── docker-compose.yml # Configuration Docker
|
||||||
1. If your Google Sheet is **public**: Go to your Google Sheets file, then click on **"File" > "Publish to the web"** and copy the URL.
|
├── bot_data.db # Base SQLite (créée automatiquement)
|
||||||
2. If your Google Sheet is **private**, you will need to configure a **Google API key** and use it with `gspread` (this requires additional setup).
|
├── logs/ # Logs du bot (optionnel)
|
||||||
|
└── screenshots/ # Screenshots des PB
|
||||||
For a **public file**, the URL will look like this:
|
├── hydra/
|
||||||
`https://docs.google.com/spreadsheets/d/YOUR_FILE_ID/edit#gid=0`
|
│ ├── normal/
|
||||||
|
│ ├── hard/
|
||||||
Replace `"YOUR_GOOGLE_SHEET_URL"` with your actual URL in the code.
|
│ ├── brutal/
|
||||||
|
│ └── nightmare/
|
||||||
---
|
├── chimera/
|
||||||
## Step 8: Run Your Bot
|
│ ├── easy/
|
||||||
|
│ ├── normal/
|
||||||
1. **Save your `bot.py` file** and make sure your Discord token is correct.
|
│ ├── hard/
|
||||||
2. **Run the bot** using the following command in your terminal:
|
│ ├── brutal/
|
||||||
|
│ ├── nightmare/
|
||||||
```bash
|
│ └── ultra/
|
||||||
python bot.py
|
└── cvc/
|
||||||
```
|
```
|
||||||
|
|
||||||
---
|
## 🐳 Installation Docker (Recommandée)
|
||||||
## Step 9: Invite the Bot to Your Server
|
|
||||||
|
|
||||||
1. Go to the Discord Developer Portal and in **"OAuth2"** -> **"URL Generator"**.
|
### 1. Créer le fichier `requirements.txt`
|
||||||
2. Check the required **permissions** like `bot` and `messages.read` to allow your bot to read and send messages.
|
```txt
|
||||||
3. Copy the generated URL and open it in your browser to invite your bot to your Discord server.
|
discord.py>=2.3.0
|
||||||
|
aiohttp>=3.8.0
|
||||||
|
python-dotenv>=1.0.0
|
||||||
|
```
|
||||||
|
|
||||||
|
### 2. Créer le fichier `.env`
|
||||||
|
```env
|
||||||
|
DISCORD_TOKEN=your_bot_token_here
|
||||||
|
AUTHORIZED_CHANNEL_ID=your_channel_id_here
|
||||||
|
```
|
||||||
|
|
||||||
|
### 3. Créer le `Dockerfile`
|
||||||
|
```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`
|
||||||
|
```yaml
|
||||||
|
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](https://discord.com/developers/applications)
|
||||||
|
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)
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# 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
|
||||||
|
```sql
|
||||||
|
-- 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
|
||||||
|
```bash
|
||||||
|
# Via Docker
|
||||||
|
docker logs rtf-discord-bot
|
||||||
|
|
||||||
|
# Via Container Station
|
||||||
|
Container Station → Votre container → Logs
|
||||||
|
```
|
||||||
|
|
||||||
|
### Sauvegarde
|
||||||
|
```bash
|
||||||
|
# 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
|
||||||
|
|
||||||
---
|
---
|
||||||
## Summary
|
|
||||||
|
|
||||||
- **The bot only responds** in a specific channel (using the channel ID).
|
**Développé pour la communauté RTF** 🎮
|
||||||
- It **ignores** the command in other channels.
|
|
||||||
- It **reads data** from the **Google Sheet** only when the `!siege` command is called.
|
|
||||||
---
|
|
||||||
|
|
|
||||||
Loading…
Reference in a new issue