Variables

Le système de variables permet d'insérer dynamiquement des informations contextuelles dans vos messages. Ces variables suivent un format spécifique et peuvent être enrichies avec des paramètres et modificateurs pour personnaliser l'affichage.

Syntaxe générale

Les variables s'utilisent toujours entre accolades {} et suivent l'une des structures suivantes :

  • {variable} : Variable simple
  • {variable:paramètres} : Variable avec paramètres
  • {variable?modifieur} : Variable avec modificateur
  • {variable:paramètres?modifieur} : Variable avec paramètres et modificateur

Exemple :

  • {user.username}
  • {user.created_at:format=DD/MM/YYYY}
  • {level.rank?ordinal}

Paramètres

Les paramètres permettent d'affiner le comportement d'une variable en lui transmettant des informations complémentaires. Ils s'ajoutent après le nom de la variable, chacun étant précédé du symbole deux-points :.

Chaque paramètre suit la structure nom=valeur. Lorsque vous souhaitez utiliser plusieurs paramètres simultanément, ajoutez simplement un nouveau : suivi du paramètre suivant.

Exemple :

  • {level.rank:user_id=123456789012345678}
  • {user.created_at:user_id=123456789012345678:format=DD MMMM YYYY}

Paramètres communs

Cette section regroupe les paramètres utilisés par plusieurs variables. Lorsqu'un paramètre est mentionné plus loin sans explication détaillée, référez-vous à cette section.

user_id

Identifiant Discord d'un utilisateur ciblé par la variable (supporte les mentions <@123>).

  • Type : ID Discord
  • Obligatoire : Selon la variable

role_id

Identifiant Discord d'un rôle.

  • Type : ID Discord
  • Obligatoire : Pour les variables liées aux rôles

Ce paramètre est obligatoire pour toutes les variables de rôle.

channel_id

Identifiant Discord d'un salon.

  • Type : ID Discord
  • Obligatoire : selon la variable

format

Définit le format d'affichage des dates et heures.

  • Valeur par défaut : L (date) ou LT (heure)
  • Valeurs acceptées :
    • relative → affichage relatif (ex : il y a 2 heures)
    • format personnalisé (ex : DD/MM/YYYY, HH:mm)

    La liste des différents formats est disponible sur cette page de la documentation.

VariableExemple formatExemple réponse
stream.start_atLe stream débutera le {stream.start_at:format=DD/MM/YYYY}.Le stream débutera le 31/12/2025.
dateIl est {date:format=DD/MM/YYYY,HH:mm}.Il est .

separator

Caractère(s) utilisés pour séparer plusieurs valeurs.

  • Valeur par défaut : ,

style

Timestamps

Découvrez les différents paramètres de styles

Modificateurs

Les modificateurs permettent de transformer l'affichage des variables. Ils s'ajoutent après le nom de la variable ou après le ou les paramètres, précédés du symbole point d'interrogation ?.

Les modificateurs ne sont pas cumulables sur une même variable.

ModificateurDescriptionExemple
uppercaseTexte en majuscules{user.username?uppercase} → DRAFTBOT
lowercaseTexte en minuscules{server.name?lowercase} → draftbot support
capitalizePremière lettre majuscule{user.username?capitalize} → Draftbot
ordinalNombre ordinal{level.rank?ordinal} → 3ème
maxLength=NLimitation de longueur{title?maxLength=50}
formatNumberFormat de nombre localisé{money?formatNumber} → 1 234

Variables de base

Utilisateur

VariableDescriptionExemple
{user}Mention de l'utilisateur@draftbot
{user.id}Identifiant de l'utilisateur318312854816161792
{user.username}Pseudo du comptedraftbot
{user.globalname}Nom affiché globalDraftBot
{user.nickname}Surnom sur le serveur❕DraftBot
{user.tag}Tag (déprécié)draftbot#0535
{user.rolecount}Nombre de rôles2
{user.created_at}Date de création du compte28/05/2017
{user.joined_at}Date d'arrivée sur le serveur11/03/2018

Paramètres :

  • user_id
  • format

Pour le détail des paramètres, cliquez ici.

Serveur

VariableDescriptionExemple
{server}Nom du serveurDraftBot Support
{server.id}Identifiant du serveur422112414964908042
{server.name}Nom du serveurDraftBot Support
{server.description}Description du serveurServeur officiel et Support de DraftBot
{server.membercount}Nombre total de membres65536
{server.humancount}Nombre de membres humains65535
{server.botcount}Nombre de bots1
{server.rolecount}Nombre de rôles69
{server.channelcount}Nombre de salons20
{server.boosts.level}Niveau de boosts du serveur2
{server.boosts.count}Nombre de boosts du serveur27
{server.created_at}Date de création du serveur10/03/2018

Paramètres :

  • format

Pour le détail des paramètres, cliquez ici.

Salon

VariableDescriptionExemple
{channel}Mention du salon#bavardage➖🐱
{channel.id}Identifiant du salon700375095297835096
{channel.name}Nom du salonbavardage➖🐱
{channel.created_at}Date de création16/04/2020
{channel.parent}Mention du salon parent#▬▬▬ Communauté ▬▬▬
{channel.parent.id}ID du salon parent700370977019658332
{channel.parent.name}Nom du salon parent▬▬▬ Communauté ▬▬▬
{channel.parent.created_at}Date de création parent16/04/2020

Paramètres :

  • channel_id
  • format

Pour le détail des paramètres, cliquez ici.

Rôle

VariableDescriptionExemple
{role}Mention du rôle@Equipe
{role.id}ID du rôle698990778084491314
{role.name}Nom du rôleEquipe
{role.color}Couleur hexadécimale#FD9A60
{role.position}Position du rôle5
{role.membercount}Nombre de membres13
{role.created_at}Date de création12/04/2020

Paramètres :

  • role_id
  • format

Pour le détail des paramètres, cliquez ici.

Temporalité

VariableDescriptionExemple
{date}Date actuelle28/05/2017
{time}Heure actuelle11:01
{timestamp}Timestamp Discord1495962098

Paramètres :

  • format (date et time)
  • style (timestamp)

Pour le détail des paramètres, cliquez ici.

Variables par modules

Économie

VariableDescriptionExemple
{money}Argent1 234
{money.record}Record d'argent5 678
{money.currency_icon}Icône de la devise💰
{money.rank}Position dans le classement3
{money.next_user}Membre au dessus dans le classement@DraftBot
{money.next_user.id}Identifiant du membre au dessus dans le classement318312854816161792
{money.next_user.money}Quantité d'argent du membre au dessus dans le classement2 500
{money.next_user.money_diff}Différence d'argent avec le membre au dessus dans le classement2 500
{money.to_position:position=N}Argent nécessaire pour atteindre la position N dans le classement1 200

Paramètres :

  • user_id

Pour le détail des paramètres, cliquez ici.

Niveaux

VariableDescriptionExemple
{level}Niveau25
{level.rank}Position dans le classement5
{level.next_user}Membre au dessus dans le classement@DraftBot
{level.next_user.id}Identifiant du membre au dessus dans le classement318312854816161792
{level.next_user.level}Niveau du membre au dessus dans le classement27
{level.next_user.level_diff}Différence de niveaux avec le membre au dessus dans le classement2
{level.next_user.xp}Quantité d'expérience du membre au dessus dans le classement15 000
{level.next_user.xp_diff}Différence d'expérience avec le membre au dessus dans le classement2 500
{level.to_position:position=N}Niveaux nécessaires pour atteindre la position N dans le classement5,000
{xp}Expérience totale12 500
{xp.current_level}Expérience du niveau actuel250
{xp.next_level}Expérience nécessaire pour atteindre le niveau suivant750
{xp.to_level:level=N}Expérience nécessaire pour atteindre le niveau N15 000
{xp.to_position:position=N}Expérience nécessaire pour atteindre la position N dans le classement5,000

Paramètres :

  • user_id

Pour le détail des paramètres, cliquez ici.

Récompenses de niveaux

VariableDescriptionExemple
{reward}Récompense reçueRôle VIP
{reward.level}Niveau de la récompense reçue10
{reward.next_level}Niveaux avant la prochaine récompense5
{reward.next_xp}Expérience avant la prochaine récompense2 500

Les variables de niveaux sont aussi disponibles dans les messages de récompenses de niveaux.

Tickets

VariableDescriptionExemple
{number}Numéro de ticket42

Suggestions

VariableDescriptionExemple
{title}Titre de la suggestionSystème de questionnaire
{count}Nombre de suggestions en cours3
{max}Nombre maximum de suggestions5

Récompenses de suggestions

VariableDescriptionExemple
{reward}Récompense reçue100 💰
{target.type}Type de statutacceptées
{target.count}Nombre de suggestions10

Commandes personnalisées

Commandes personnalisées - Les Arguments

Vous pouvez voir les différents arguments des Commandes personnalisées sur cette page.

Anniversaires

VariableDescriptionExemple
{birthday}Date de naissance15 mars
{birthday.next}Prochain anniversaireDans 2 mois
{age}Âge de l'utilisateur25 ans

Paramètres :

  • user_id

Pour le détail des paramètres, cliquez ici.

Les variables d'économie et de niveaux sont aussi disponibles dans les commandes personnalisées.

Starboards

VariableDescriptionExemple
{emoji}Emoji du starboard⭐
{emoji.count}Nombre de réactions15
{message.url}Lien du messagehttps://discord.com/...

Signalements

VariableDescriptionExemple
{target}Membre signalé@draftman
{target_message.url}Lien du message signaléhttps://discord.com/...
{reason}Motif du signalementSpam

Anniversaire

VariableDescriptionExemple
{user}Membre(s) fêtant leur anniversaire@John, @Jane
{role}Rôle temporaire d'anniversaire@Anniversaire
{gifts}Récompenses données500 💰, Rôle VIP

Statistiques

VariableDescriptionExemple
{count}Statistique du salon1 250

Cette variable doit obligatoirement être présente dans le format du salon de statistiques.

Salons vocaux temporaires

VariableDescriptionExemple
{index}Numérotation du salon5
{random_word}Mot aléatoire prédéfinitrampoline
{custom_word}Mot aléatoire personnalisélicorne

Route de l'infini

VariableDescriptionExemple
{number}Nombre indiqué4956
{discussion}Discussion du membre (s'il y en a une)bientôt les 5k

Récompenses route de l'infini

VariableDescriptionExemple
{number}Nombre indiqué4956
{reward}Récompense gagnée lors du passage d'un palier5 000 💰

Calendrier de l'avent

VariableDescriptionExemple
{day}Numéro du jour de la case ouverte15
{gift}Cadeau reçu dans la case ouverte10 000 💰
{streak.count}Nombre actuel d'ouvertures consécutives7
{streak.record}Record d'ouvertures consécutives du membre15

Ouvertures consécutives du calendrier

VariableDescriptionExemple
{day}Numéro du jour de la case ouverte15
{streak.count}Nombre actuel d'ouvertures consécutives7
{streak.record}Record d'ouvertures consécutives du membre15
{streak.reward}Nom de la récompense obtenueRôle "Fidèle"

Variables de notifications sociales

YouTube

VariableDescriptionExemple
{video.author}Nom de la chaîneDraftBot
{video.title}Titre de la vidéoComment utiliser DraftBot
{video.url}Lien de la vidéohttps://youtube.com/...

Twitch

VariableDescriptionExemple
{stream.author}Nom de la chaîneStreamerName
{stream.title}Titre du liveLive de développement
{stream.game}Jeu en liveJust Chatting
{stream.url}Lien du livehttps://twitch.tv/...
{stream.start_at}Date de débutil y a 2 heures
{stream.tags}Tags du livefrançais, développement

Paramètres :

  • format
  • separator

Pour le détail des paramètres, cliquez ici.

Reddit

VariableDescriptionExemple
{post.subreddit}Nom du subredditr/discord
{post.title}Titre du postQuestion sur DraftBot
{post.description}Description du postComment configurer...
{post.url}Lien du posthttps://reddit.com/...

Flux RSS

VariableDescriptionExemple
{feed.name}Nom du fluxBlog DraftBot
{feed.url}Lien du fluxhttps://draftbot.fr/...
elbaguettodraftproducts
NavigationAccueilCommandesPremiumFAQDocuments légaux
CommunautéDocumentationSupport DiscordÉquipeTwitter / X
Voir aussiCréditsBlagues APIDraftMan.frSP4RT4
Copyright © 2018 - 2026 DraftBotAll rights reserved.
FR / EN