Guide complet

Documentation Hexa

Tout ce que vous devez savoir pour ajouter, configurer et maîtriser Hexa sur votre serveur.

1. Ajouter Hexa à votre serveur

Étapes rapides

  1. Cliquez sur le bouton Ajouter Hexa en haut de cette page ou sur invite
  2. Connectez-vous avec votre compte Discord
  3. Sélectionnez le serveur où ajouter le bot
  4. Acceptez les permissions demandées (voir ci-dessous)
  5. Validez → Hexa apparaît dans votre liste de membres !

Permissions recommandées

Hexa a besoin de permissions élevées pour fonctionner correctement :

  • Administrator (recommandé pour une installation complète)
  • Manage Server, Manage Roles, Manage Channels
  • View Channels, Send Messages, Embed Links
  • Moderate Members, Kick/Ban Members
  • Read Message History, Attach Files

Vous pouvez retirer certaines permissions après installation, mais certaines fonctionnalités (modération, tickets, niveaux) pourraient ne plus marcher.

2. Configuration de base (recommandée)

  1. Exécutez /setup — cela lance un guide interactif qui configure les modules essentiels (bienvenue, logs, modération, niveaux…)
  2. Activez les intents dans le portail développeur Discord :
    • Presence Intent
    • Server Members Intent
    • Message Content Intent (obligatoire pour lire les messages)
  3. Donnez les permissions nécessaires au rôle du bot (ou à @everyone si vous le souhaitez)
  4. Créez un salon logs et configurez-le avec /setup-logs
  5. Testez avec /ping, /help, /setup-all pour vérifier que tout fonctionne

3. Fonctionnalités principales

Modération avancée

Anti-raid, auto-mod, warn/mute/ban/kick, logs détaillés, timeout vocal...

Voir les commandes →

Système de niveaux

XP texte + vocal, rôles automatiques, classement /top, drops d’XP...

Voir les commandes →

Système de tickets

Panels, transcripts, claim/close, catégories personnalisées...

Voir les commandes →

Giveaways & concours

Création facile, multi-gagnants, exigences de rôles, reroll...

Voir les commandes →

Commandes fun

/hug, /kiss, /slap, 8ball, ship, snipe...

Voir les commandes →

Statistiques & logs

/setup-stats, logs de modération, compteurs de salon...

Voir les commandes →

4. Questions fréquentes

Pourquoi Hexa demande-t-il autant de permissions ?

Hexa a besoin de permissions élevées pour réaliser toutes ses fonctionnalités : gestion de rôles (système de niveaux), modération (ban/kick/mute), création/modification de salons (tickets, hubs vocaux), lecture des messages (auto-mod, réactions automatiques), gestion vocale, etc.

Sans ces permissions, beaucoup de commandes ne fonctionneront pas correctement. Après installation, vous pouvez réduire certaines permissions, mais cela désactivera certaines fonctionnalités associées.

Comment activer les intents dans le portail développeur ?

Rendez-vous sur discord.com/developers/applications.
Sélectionnez votre application (exemple : Hexa) → onglet "Bot" → descendez jusqu’à la section "Privileged Gateway Intents" et activez :
Presence Intent (pour le statut en ligne)
Server Members Intent (pour voir les membres, rôles, etc.)
Message Content Intent (obligatoire pour lire les messages et activer l’auto-mod, niveaux texte, etc.)

Sauvegardez. Sans ces intents, le bot ne verra pas les messages ni les membres.

Hexa est-il vraiment gratuit ? Y aura-t-il un jour un Premium payant ?

Oui, Hexa est 100 % gratuit en février 2026 et le restera pour toutes les fonctionnalités de base.

À l’avenir, certaines options très avancées (analytics détaillés, thèmes personnalisés ultra poussés, priorisation des commandes sur gros serveurs, support VIP ultra-rapide) pourraient passer en Premium (abonnement mensuel ou annuel). Mais le cœur du bot (modération, niveaux, tickets, giveaways, fun commands, etc.) restera toujours gratuit.

Comment supprimer toutes les données liées à mon serveur ?

Envoyez un simple email à contact@hexa.bot avec :
• L’ID de votre serveur (clic droit sur icône serveur → Copier ID)
• Votre ID Discord (pour vérification)

Nous supprimerons toutes les configurations, logs, niveaux, tickets, etc. dans un délai de 30 jours maximum. Vous pouvez aussi kicker le bot : cela supprime automatiquement la plupart des données.

Pourquoi le bot ne répond pas à mes commandes ?

Causes fréquentes :
• Le bot n’a pas les permissions nécessaires dans le salon (voir Permissions recommandées)
• Les intents ne sont pas activés dans le portail développeur
• Vous utilisez un préfixe texte alors que le bot est configuré en slash-commands uniquement
• Le bot est hors ligne (rare) → vérifiez le status sur le site ou le serveur support
• Vous n’avez pas les permissions requises pour la commande (ex. : /ban demande Manage Server ou Admin)

Comment configurer les messages de bienvenue / au revoir ?

Utilisez la commande /setup-welcome.
Elle vous guide étape par étape pour :
• Choisir un salon
• Personnaliser le message (avec variables {user}, {server}, {membercount}, etc.)
• Ajouter un rôle auto-attribué
• Configurer le message d’au revoir
• Activer le ghost-ping (ping discret à l’arrivée)

Vous pouvez aussi utiliser /setup-all pour voir les configuraison activé.

Le bot peut-il lire tous les messages de mon serveur ?

Non, pas par défaut.
Hexa ne lit les messages que si :
• Vous avez activé une fonctionnalité qui le nécessite (auto-modération, réactions automatiques, niveaux texte, détection de liens/phishing, etc.)
• Le salon n’est pas exclu via /setup-automod ou /setup-react

Les messages sont traités en temps réel et ne sont jamais stockés de manière permanente (sauf logs de modération activés par l’admin).

Comment rejoindre le serveur de support en cas de problème ?

Cliquez sur ce lien : https://discord.gg/7uJWftATjS (serveur support Hexa)

Une fois dedans :
• Lisez le salon #règles
• Allez dans #support ou ouvrez un ticket
• Fournissez l’ID de votre serveur et décrivez votre problème
L’équipe répond généralement sous 30 minutes à 2 heures en moyenne.

Prêt à configurer Hexa ?

Ajouter Hexa maintenant →