Héberger ton propre bot avec Hurix (Bot personnalisé)

Tes membres voient « Hurix » partout… alors que tu rêves d'un bot à l'image de ton serveur. Avec le Bot personnalisé, tu crées ta propre application Discord, tu donnes son token au dashboard, et Hurix la fait tourner pour toi : ton nom, ton avatar, ton statut, et même des slash commands rien qu'à lui. Tu n'as rien à installer ni à héberger.

1. Comprendre le principe

• Ton bot personnalisé fait tourner Hurix sur un seul serveur : celui que tu choisis à sa création. Tu le règles depuis le même dashboard, avec les mêmes modules.
• Invité ailleurs par erreur, il ne déclenche aucun module sur les autres serveurs.
• Tu peux créer un bot par serveur, dans la limite de ton quota (le nombre de bots personnalisés auxquels ton compte a droit).
• En plus des commandes de Hurix, ton bot peut avoir ses propres slash commands, utilisables uniquement sur son serveur.

2. Obtenir un quota

Dans le menu de gauche du dashboard, rubrique de ton espace, clique sur Bot personnalisé (badge Premium). Le quota s'affiche en haut à droite de la page, par exemple Quota · 0 / 1 bot.

Ton quota vient de deux sources, qui s'additionnent :

• les offres Premium qui incluent des bots personnalisés : le nombre de bots compris dans chaque offre est indiqué sur la page Premium ;
• un quota accordé par un administrateur de Hurix.

Sans quota, la page affiche Aucun quota accordé : « Tu n'as pas encore de quota de bots personnalisés. Contacte un administrateur pour t'en faire accorder. » Avec un quota, mais sans bot, elle affiche « Aucun bot personnalisé pour le moment. » et le bouton Ajouter un bot.

3. Créer ton application sur le portail Discord

Ton bot est une application Discord qui t'appartient. Crée-la une fois pour toutes :

1. Va sur le Discord Developer Portal et clique sur New Application (« Nouvelle application » si ton portail est en français : les noms français sont indiqués entre parenthèses dans la suite). Donne-lui le nom de ton bot.
2. Dans l'onglet General Information (« Informations générales »), ajoute une icône et une description si tu veux.
3. Ouvre l'onglet Bot :
   • choisis le nom et l'avatar du bot : ce sont eux que Discord affiche à tes membres ;
   • clique sur Reset Token (« Réinitialiser le token »), puis copie le token. Discord ne te le montre qu'une seule fois : garde-le de côté pour l'étape 5.
4. Toujours dans l'onglet Bot, partie Privileged Gateway Intents, active les trois interrupteurs, puis clique sur Save Changes :
   • Presence Intent
   • Server Members Intent
   • Message Content Intent

4. Inviter ton bot sur ton serveur

Le dashboard ne génère pas de lien d'invitation pour ton bot : tu le crées sur le portail.

1. Ouvre l'onglet OAuth2, puis URL Generator (« Générateur d'URL OAuth2 »).
2. Dans Scopes (« Champs d'application »), coche bot et applications.commands (sans ce dernier, les slash commands n'apparaissent pas).
3. Dans Bot Permissions (« Permissions du bot »), coche Administrator (« Administrateur »), ou au minimum les permissions dont tes modules ont besoin (gérer les rôles, les salons, les messages…).
4. Copie le lien généré en bas, ouvre-le et choisis ton serveur.

5. Ajouter le bot sur le dashboard

Retourne dans Bot personnalisé et clique sur Ajouter un bot. La fenêtre Ajouter un bot personnalisé s'ouvre :

1. Serveur : choisis le serveur de ton bot (une recherche Rechercher un serveur… t'aide si tu en as beaucoup). Seuls les serveurs que tu gères (propriétaire, Administrateur ou Gérer le serveur) et qui n'ont pas encore de bot personnalisé sont proposés. Ce choix est définitif.
2. Nom du bot : le nom qui identifie ton bot sur le dashboard (100 caractères max).
3. Avatar (facultatif) : PNG ou JPG, 5 Mo max, carré de préférence.
4. Token du bot : colle le token copié à l'étape 3. Il est flouté pendant la saisie ; l'icône en forme d'œil l'affiche ou le masque.
5. Règle la présence et l'apparence si tu veux (voir l'étape 6), puis clique sur Créer le bot.

L'Aperçu à droite te montre ton bot et un exemple d'embed pendant que tu remplis le formulaire.

Au moment de la création, Hurix vérifie ton token auprès de Discord :

• Token refusé : « Token du bot invalide ou refusé par Discord. » Recopie-le, ou génère-en un nouveau avec Reset Token (« Réinitialiser le token »).
• Intent manquant : « Active Presence Intent, Server Members Intent, Message Content Intent sur ton application dans le Discord Developer Portal (onglet Bot), puis réessaie. » Le message ne cite que les intents qui manquent : active-les sur le portail, enregistre, puis reclique sur Créer le bot.

Si tout est bon, tu vois « Bot "Mon super bot" créé et démarré. » et la page de ton bot s'ouvre.

6. Personnaliser ton bot

La page de ton bot est découpée en cartes :

• Identité : le Nom du bot et l'Avatar affichés sur le dashboard. Le nom et l'avatar que voient tes membres sur Discord sont ceux de l'onglet Bot du portail : mets les mêmes des deux côtés pour t'y retrouver.
• Présence :
  • Statut du bot : En ligne, Inactif, Ne pas déranger ou Hors ligne ;
  • Activité du bot : Aucune, Joue à, Écoute, Regarde, En compétition ou Statut personnalisé, avec un texte de 128 caractères max (par exemple Minecraft ou À ton service). Sans texte, aucune activité n'est affichée.
• Apparence : la Couleur principale (une couleur proposée ou un code #RRGGBB) et le Pied des embeds (laisse vide pour ne rien afficher, 255 caractères max).
• Token : pour relier une autre application Discord (voir l'étape 7).

L'Aperçu Discord suit tes réglages en direct. Dès que tu modifies quelque chose, la barre du bas apparaît : clique sur Enregistrer. Le statut et l'activité changent tout de suite sur Discord, sans redémarrer le bot.

7. Changer de token

Dans la carte Token, colle un nouveau token puis clique sur Enregistrer. Laisse le champ vide pour garder le token actuel.

Le nouveau token est vérifié comme à la création (token valide et trois intents activés), puis ton bot redémarre avec lui. Le serveur du bot, lui, ne change pas.

8. Ajouter des commandes rien qu'à ton bot

Sous les cartes, Commandes personnalisées te permet de créer des slash commands propres à ce bot, utilisables uniquement sur son serveur. Clique sur Nouvelle commande :

• Nom de la commande : minuscules, chiffres, - ou _, 32 caractères max (par exemple salut pour /salut) ;
• Description : ce que fait la commande ;
• Alias (facultatif) : d'autres noms, séparés par des virgules (5 max) ;
• Structure de la commande : Réponse simple, ou Sous-commandes ;
• Arguments : texte, entier, nombre, oui/non, utilisateur, salon ou rôle, à réutiliser dans la réponse avec {nom} ;
• Type de réponse : Message, Embed ou Container, avec des variables à insérer en un clic, comme {user} ou {server} ;
• Réponse éphémère : visible uniquement par la personne qui utilise la commande ;
• Commande activée : désactive-la pour la retirer sans la supprimer.

Le nombre de commandes par bot dépend de ton offre : le compteur x / y commandes te montre où tu en es.

9. Relancer ton bot

Ton bot ne répond plus, ou tu viens de corriger un réglage sur le portail ? Clique sur Relancer, en haut de la page. Seul ce bot redémarre : Hurix et tes autres bots ne sont pas touchés. L'état se met à jour quelques secondes plus tard.

• En ligne : ton bot tourne.
• Arrêté : ton bot ne tourne pas. L'état est aussi affiché en rouge sur sa pastille.

10. Fin de l'abonnement

Quand ton abonnement se termine (après l'éventuel délai de grâce laissé pour un paiement en retard), ton quota baisse :

• tes bots en trop sont arrêtés, pas supprimés : leurs réglages, leur token et leurs commandes sont gardés ;
• si tu as plusieurs bots, ce sont les plus anciens qui restent actifs, dans la limite de ton nouveau quota ;
• tes bots arrêtés s'affichent Arrêté sur la page, et Relancer ne les redémarre pas ;
• dès que tu te réabonnes, ils repartent tout seuls.

11. Supprimer ton bot

Clique sur l'icône corbeille à côté de Relancer. Pour confirmer, tape le nom du bot dans la fenêtre Supprimer ce bot ? : il est arrêté et supprimé définitivement, avec ses commandes personnalisées et son token. C'est irréversible.

Ton application, elle, existe toujours sur le portail Discord : supprime-la là-bas aussi si tu n'en as plus besoin, ou retire simplement le bot de ton serveur.

🔒 Protéger ton token

Le token, c'est la clé de ton bot : avec lui, n'importe qui peut le contrôler.

• Ne le partage jamais : ne le colle que dans le champ Token du bot du dashboard.
• Sur le dashboard, il est stocké chiffré et n'est jamais réaffiché : le champ reste vide après l'enregistrement.
• Tu penses qu'il a fuité ? Clique sur Reset Token (« Réinitialiser le token ») sur le portail : l'ancien ne marche plus. Colle le nouveau dans la carte Token et enregistre.

Astuces et erreurs fréquentes

• Le bouton « Ajouter un bot » n'apparaît pas : soit ton quota est plein (« Limite atteinte : supprime un bot avant d'en créer un autre. »), soit tous les serveurs que tu gères ont déjà un bot personnalisé.
• « Un bot personnalisé existe déjà pour ce serveur. » : il ne peut y en avoir qu'un par serveur.
• « Ce serveur n'est pas un serveur que vous gérez. » : il te faut la permission Gérer le serveur ou Administrateur sur ce serveur (ou en être le propriétaire).
• « Vous ne gérez plus le serveur de ce bot personnalisé. » : tes droits sur le serveur ont été retirés. Tu ne peux plus modifier ni relancer le bot, mais tu peux toujours le supprimer.
• « Impossible de vérifier le token auprès de Discord. » : Discord n'a pas répondu à temps. Réessaie dans un instant.
• « Le bot est injoignable pour le moment, réessaie dans un instant. » : la relance n'a pas pu être transmise. Réessaie un peu plus tard. Tu peux relancer un bot jusqu'à 6 fois par minute.
• Ton bot est « Arrêté » juste après sa création : vérifie que les trois intents sont toujours activés et que le token n'a pas été régénéré sur le portail, puis clique sur Relancer.
• Les slash commands n'apparaissent pas : vérifie que le bot a été invité avec le scope applications.commands. Discord peut aussi mettre quelques minutes à les afficher.
• Les commandes s'affichent en double : Hurix et ton bot sont tous les deux sur le serveur, et chacun propose ses commandes. Retire Hurix du serveur une fois ton bot en ligne.
• Le nom ou l'avatar ne change pas sur Discord : ils se règlent dans l'onglet Bot du portail Discord.

Envie de commandes perso aussi sur Hurix ? Découvre le tutoriel Créer tes commandes personnalisées.