Documentation

Tout ce que vous devez savoir pour utiliser BotHost

Démarrage rapide

Apprenez à déployer votre premier bot en quelques minutes.

Node.js / Discord.js

Guides pour les bots JavaScript avec Discord.js.

Python / Discord.py

Guides pour les bots Python avec Discord.py.

Configuration

Paramètres avancés et personnalisation.

Déployer votre premier bot

Étape 1 : Créer un bot

Connectez-vous à votre dashboard et cliquez sur "Déployer un bot". Choisissez un nom et sélectionnez le langage (Node.js ou Python).

Étape 2 : Uploader vos fichiers

Vous avez deux options pour uploader vos fichiers :

  • Via SFTP : Utilisez un client comme FileZilla ou WinSCP
  • Via l'éditeur web : Modifiez directement les fichiers dans le dashboard

Étape 3 : Configurer les variables d'environnement

Ajoutez votre token Discord et autres configurations dans l'onglet "Variables d'env".

DISCORD_TOKEN=votre_token_ici
PREFIX=!
DATABASE_URL=...

⚠️ Important : Ne partagez jamais votre token Discord ! Il donne un accès complet à votre bot.

Étape 4 : Démarrer le bot

Cliquez sur le bouton "Démarrer" dans votre dashboard. Les logs s'afficheront dans la console en temps réel.

Configuration SFTP

L'accès SFTP vous permet de transférer vos fichiers facilement avec des logiciels comme FileZilla ou WinSCP.

Informations de connexion

Retrouvez vos identifiants SFTP dans la page "Paramètres" de votre dashboard :

Hôte : bothost.cloud
Port : 22
Protocole : SFTP
Utilisateur : (voir dans Paramètres)
Mot de passe : (voir dans Paramètres)

Structure des dossiers

Une fois connecté, vous verrez vos dossiers de bots. Chaque bot a son propre dossier contenant tous ses fichiers.

💡 Conseil : Après avoir modifié des fichiers via SFTP, pensez à redémarrer votre bot pour appliquer les changements.

Structure d'un bot Node.js

Voici la structure recommandée pour un bot Discord.js :

mon-bot/
├── index.js          # Point d'entrée
├── package.json      # Dépendances
├── .env              # Variables d'environnement (créé automatiquement)
├── commands/         # Commandes du bot
│   ├── ping.js
│   └── help.js
└── events/           # Événements Discord
    ├── ready.js
    └── messageCreate.js

Exemple de package.json

{
  "name": "mon-bot",
  "version": "1.0.0",
  "main": "index.js",
  "scripts": {
    "start": "node index.js"
  },
  "dependencies": {
    "discord.js": "^14.14.1",
    "dotenv": "^16.0.0"
  }
}

Exemple de index.js minimal

require('dotenv').config();
const { Client, GatewayIntentBits } = require('discord.js');

const client = new Client({
    intents: [
        GatewayIntentBits.Guilds,
        GatewayIntentBits.GuildMessages,
        GatewayIntentBits.MessageContent
    ]
});

client.on('ready', () => {
    console.log(`Bot connecté en tant que ${client.user.tag}`);
});

client.on('messageCreate', message => {
    if (message.content === '!ping') {
        message.reply('Pong! 🏓');
    }
});

client.login(process.env.DISCORD_TOKEN);

Structure d'un bot Python

Voici la structure recommandée pour un bot Discord.py :

mon-bot/
├── main.py           # Point d'entrée
├── requirements.txt  # Dépendances
├── .env              # Variables d'environnement (créé automatiquement)
├── cogs/             # Extensions du bot
│   ├── general.py
│   └── moderation.py
└── utils/            # Utilitaires
    └── helpers.py

Exemple de requirements.txt

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

Exemple de main.py minimal

import os
import discord
from discord.ext import commands
from dotenv import load_dotenv

load_dotenv()

intents = discord.Intents.default()
intents.message_content = True

bot = commands.Bot(command_prefix='!', intents=intents)

@bot.event
async def on_ready():
    print(f'Bot connecté en tant que {bot.user}')

@bot.command()
async def ping(ctx):
    await ctx.send('Pong! 🏓')

bot.run(os.getenv('DISCORD_TOKEN'))