Créer tes commandes personnalisées

Une commande !regles qui affiche le règlement, un /c tag:ip qui donne l'adresse du serveur de jeu, un !calin @ami pour s'amuser… 🛠️ Avec les Commandes personnalisées, tu crées tes propres commandes en quelques clics, sans aucune ligne de code.

1. Activer le module

Sur le dashboard, choisis ton serveur et ouvre Commandes perso. (rubrique Modules du menu de gauche). Active le module avec l'interrupteur en haut de la page.

La page compte quatre onglets : Commandes, Groupes, Réglages et Aide et variables.

2. Choisir le type de commande

Dans l'onglet Commandes, clique sur l'un des deux boutons :

• Commande slash : les membres tapent /c, choisissent ta commande dans la liste proposée par Discord, puis valident. La commande est utilisable tout de suite après sa création, sans attente.
• Commande préfixée : les membres écrivent le préfixe suivi du tag, par exemple !regles. Le préfixe par défaut est !.

3. Remplir la fiche de la commande

• Groupe : pour ranger la commande (voir l'étape 6).
• Nom : nom interne, visible seulement dans le dashboard.
• Tag : ce que tapent les membres. En minuscules, sans espace : lettres, chiffres, - ou _, 32 caractères au plus.
• Description : affichée dans Discord à côté du tag. Obligatoire pour une commande slash.
• Cooldown (secondes) : le délai entre deux utilisations par un même membre. Laisse vide pour reprendre celui du groupe ou celui par défaut.
• Commande active : décoche pour la mettre en pause.

Arguments : clique sur Ajouter un argument pour que la commande accepte des valeurs (jusqu'à 10). Chaque argument a un Nom, un Type (Texte, Nombre, Membre, Salon ou Rôle), une Valeur par défaut et peut être Obligatoire. La ligne Utilisation te montre comment la taper, par exemple :

!calin <membre>
/c tag:calin args:<membre>

4. Écrire la réponse

Dans Réponse, choisis le format :

• Message : un texte simple.
• Embed : Titre, Description, Couleur, Image (URL), Vignette (URL), Auteur, Footer, et un Texte au-dessus (optionnel).
• Container : une mise en page en blocs (Texte, Séparateur, Image, Boutons) avec une Couleur d'accent.

Un Aperçu te montre le résultat. Tu peux glisser ces variables dans ta réponse :

• {user} : mention du membre · {user.name} : son nom affiché · {user.tag} : son nom d'utilisateur Discord · {user.id} : son identifiant
• {server} : nom du serveur · {server.count} : nombre de membres · {server.id} : identifiant du serveur
• {channel} : mention du salon · {channel.name} : nom du salon · {channel.id} : identifiant du salon
• {args} : tout ce qui suit la commande
• {arg:nom} : la valeur de l'argument « nom » (une mention pour un membre, un salon ou un rôle)

Exemple pour !calin :

{user} fait un gros câlin à {arg:membre} 🤗

Deux options selon le type :

• Réponse éphémère (commandes slash) : seul le membre qui lance la commande voit la réponse.
• Réactions sur le message du membre (commandes préfixées) : jusqu'à 5 emojis ajoutés au message qui a lancé la commande, seuls ou en plus de la réponse.

Clique sur Enregistrer : la commande est créée immédiatement.

5. Utiliser la commande

• Slash : tape /c, commence à écrire le tag, choisis la commande dans la liste puis valide. Ajoute les arguments dans l'option args si besoin.
• Préfixée : écris simplement !tag suivi des arguments, comme !calin @Alex.

Si un argument manque ou n'a pas le bon type, HurixBot rappelle au membre comment utiliser la commande.

6. Groupes, permissions et cooldowns

Réglages (pense à Enregistrer dans la barre en bas de l'écran) :

• Préfixe : de 1 à 5 caractères (!, ?, $…).
• Cooldown par défaut (secondes) : 3 secondes au départ.
• Rôles administrateurs : ils utilisent toutes les commandes partout, sans cooldown.
• Rôles autorisés / Rôles interdits et Salons autorisés / Salons interdits : qui peut utiliser les commandes, et où. Vide = tout le monde, partout.

Les règles s'appliquent dans cet ordre : rôle administrateur (tout est permis), puis rôles et salons interdits, puis rôles et salons autorisés.

Groupes : clique sur Nouveau groupe pour ranger tes commandes par thème (modération, fun, infos…). Un groupe peut avoir son propre cooldown et remplacer les réglages généraux de rôles et de salons pour ses commandes. Par exemple, un groupe « Staff » réservé à ton équipe.

Le cooldown appliqué est celui de la commande, sinon celui de son groupe, sinon le cooldown par défaut.

Astuces et erreurs fréquentes

• « Nom ou tag invalide » : le tag doit être en minuscules, sans espace (lettres, chiffres, - ou _), 32 caractères au plus.
• La commande préfixée ne répond pas : vérifie le préfixe, que la commande est active et que le salon ou le rôle du membre n'est pas interdit.
• Rien ne se passe sur un message filtré : un message bloqué ou sanctionné par l'AutoMod ne déclenche jamais de commande.
• Tu peux créer jusqu'à 200 commandes et 25 groupes par serveur.
• L'onglet Aide et variables récapitule toutes les variables : clique sur l'une d'elles pour la copier.

Pour aller plus loin : pour une réponse automatique à un simple mot, sans commande, découvre le tutoriel Réagir automatiquement à certains mots.