Commande /tellraw Minecraft : JSON, événements de clic et exemples

Tout sur /tellraw dans Minecraft 1.21 — format du composant texte JSON, événements click et hover, sélecteurs de cibles et 10 exemples prêts à coller dans des blocs de commande ou la console serveur.

Avant d'expliquer quoi que ce soit — voici cinq commandes /tellraw que tu peux coller maintenant :

/tellraw @a {"text":"Bienvenue sur le serveur !","color":"gold","bold":true}
/tellraw @a [{"text":"[Règles]","color":"red","clickEvent":{"action":"open_url","value":"https://yourserver.com/rules"}},{"text":" Clique pour lire les règles du serveur.","color":"white"}]
/tellraw @a ["",{"text":"Ton solde : ","color":"yellow"},{"score":{"name":"@p","objective":"coins"}},{"text":" pièces","color":"yellow"}]
/tellraw @p {"text":"Tu as trouvé une zone secrète !","color":"aqua","italic":true,"hoverEvent":{"action":"show_text","value":"Collecte les 5 pour ouvrir le coffre-fort."}}
/tellraw @a [{"text":"[Clique ici]","color":"green","underlined":true,"clickEvent":{"action":"run_command","value":"/warp spawn"}},{"text":" pour te téléporter au spawn.","color":"white"}]

Si tout cela a du sens pour toi — parfait, saute directement à la section exemples. Si ça ressemble à quelqu'un qui a lâché un clavier sur l'écran — reste là.

/tellraw est la commande que Minecraft te donne quand /say ne suffit plus. Et /say ne suffit presque jamais dès que tu gères un serveur sérieusement. Tu veux du texte coloré. Tu veux des liens cliquables. Tu veux montrer à un joueur son propre score. /say ne peut rien faire de tout ça. /tellraw si.

J'ai passé plus de temps que je ne voudrais l'admettre à déboguer des composants texte JSON — virgules mal placées, guillemets dans des guillemets, un backslash errant qui a cassé un message de règles sur lequel je travaillais depuis une heure. Ce guide est la référence que j'aurais voulu avoir au début.

À la fin de cette page, tu comprendras le format complet du composant texte JSON, tu sauras comment ajouter du texte cliquable et des info-bulles au survol, tu auras un tableau de toutes les couleurs et styles supportés — et tu repartiras avec 10 commandes prêtes pour la production. Si tu préfères éviter le travail manuel, le générateur /tellraw d'AlaCraft construit le JSON automatiquement et affiche un aperçu en direct pendant que tu tapes.

Qu'est-ce que /tellraw

/tellraw est une commande de chat Minecraft qui envoie un composant texte JSON brut à un ou plusieurs joueurs. Contrairement à /say — qui diffuse du texte simple avec un préfixe <Serveur> — ou /msg — qui envoie un message privé sans formatage — /tellraw te donne un contrôle total : couleur, style, comportement au clic, info-bulles au survol, valeurs de tableau de bord et insertion de noms de joueurs.

La commande fonctionne dans trois contextes :

Chat — en tapant directement si tu es opérateur (niveau de permission 2+)
Blocs de commande — messages automatisés sur minuterie, signal redstone ou déclencheur de joueur
Console / RCON — scripting côté serveur et monitoring

La commande existe depuis Java Edition 1.7.2 et a été étendue dans presque chaque version majeure : événements de clic en 1.8, composant score en 1.9, couleurs hex en 1.16, format SNBT compact en 1.21.5. Sur Bedrock Edition, la commande existe mais supporte un ensemble de fonctionnalités réduit — plus de détails dans le tableau de comparaison ci-dessous.

Format du composant texte JSON

Chaque message /tellraw est un composant texte JSON — soit un objet unique {...}, soit un tableau [...] d'objets. La forme minimale fonctionnelle :

/tellraw @a {"text":"Bonjour !","color":"gold","bold":true}

La clé "text" contient le contenu. Toutes les autres propriétés sont optionnelles :

Propriété	Valeurs	Effet
`"text"`	n'importe quelle chaîne	Le contenu à afficher
`"color"`	nom de couleur ou `"#RRGGBB"`	Couleur du texte
`"bold"`	`true` / `false`	Gras
`"italic"`	`true` / `false`	Italique
`"underlined"`	`true` / `false`	Souligné
`"strikethrough"`	`true` / `false`	Barré
`"obfuscated"`	`true` / `false`	Obscurci (caractères aléatoires)
`"font"`	`minecraft:default`, `minecraft:uniform`, `minecraft:alt`	Police (Java 1.16+)
`"insertion"`	n'importe quelle chaîne	Texte inséré dans la barre de chat au Shift+clic

Minecraft /tellraw supporte 16 couleurs nommées. Celles-ci sont différentes des codes § utilisés dans le MOTD du serveur — ici tu écris le nom de la couleur comme une chaîne :

Nom de couleur	Équivalent §	Hex
`"black"`	`§0`	#000000
`"dark_blue"`	`§1`	#0000AA
`"dark_green"`	`§2`	#00AA00
`"dark_aqua"`	`§3`	#00AAAA
`"dark_red"`	`§4`	#AA0000
`"dark_purple"`	`§5`	#AA00AA
`"gold"`	`§6`	#FFAA00
`"gray"`	`§7`	#AAAAAA
`"dark_gray"`	`§8`	#555555
`"blue"`	`§9`	#5555FF
`"green"`	`§a`	#55FF55
`"aqua"`	`§b`	#55FFFF
`"red"`	`§c`	#FF5555
`"light_purple"`	`§d`	#FF55FF
`"yellow"`	`§e`	#FFFF55
`"white"`	`§f`	#FFFFFF

Depuis Java 1.16, tu peux aussi utiliser des couleurs hex arbitraires : "color":"#4A90D9".

💡 Astuce : Les couleurs hex ne fonctionnent qu'en Java 1.16+. Si ton serveur cible des versions plus anciennes ou a besoin de compatibilité Bedrock, reste avec les 16 couleurs nommées.

Pour combiner différentes couleurs ou styles dans un seul message, utilise un tableau. Le premier élément est conventionnellement une chaîne vide "" qui sert d'ancre de réinitialisation du formatage :

/tellraw @a ["",{"text":"[Annonce] ","color":"red","bold":true},{"text":"Maintenance du serveur dans 30 minutes.","color":"white"}]

Sélecteurs de cibles

Le premier argument après /tellraw est la cible — qui reçoit le message :

Sélecteur	Cibles
`@a`	Tous les joueurs en ligne
`@p`	Joueur le plus proche de la source de la commande
`@s`	L'entité exécutant la commande
`@a[team=Red]`	Tous les joueurs de l'équipe Red
`@a[gamemode=survival]`	Tous les joueurs en mode survie
`@a[tag=vip]`	Tous les joueurs portant le tag `vip`
`nomdujoueur`	Un joueur spécifique par nom d'utilisateur exact

Pour les messages de diffusion serveur, @a est presque toujours le bon choix. Pour le feedback personnel après une action, utilise @s ou @p.

Événements de clic et de survol

C'est là que /tellraw se distingue de toutes les autres commandes de chat. Tu peux attacher des actions de clic et des info-bulles au survol indépendamment à n'importe quel segment de texte.

clickEvent

"clickEvent":{"action":"run_command","value":"/warp spawn"}

Action	Effet	Notes
`run_command`	Exécute la commande en tant que joueur cliquant	Le joueur a besoin de la permission pour la commande
`suggest_command`	Colle la valeur dans la barre de chat du joueur	Le joueur appuie lui-même sur Entrée
`open_url`	Ouvre une URL dans le navigateur par défaut	Affiche un dialogue de confirmation de sécurité
`copy_to_clipboard`	Copie la valeur dans le presse-papiers	Java 1.15+ seulement
`change_page`	Change de page dans un livre inscriptible	Livres seulement

hoverEvent

"hoverEvent":{"action":"show_text","value":"Ceci ouvre le monde spawn."}

Action	Effet
`show_text`	Info-bulle texte apparaît au survol
`show_item`	Carte d'objet avec données NBT
`show_entity`	Informations sur l'entité (UUID, nom, type)

⚠️ Attention : run_command exécute la commande en tant que joueur cliquant, pas en tant que serveur. Toute commande nécessitant une permission de niveau OP échouera silencieusement pour les joueurs non-OP — pas d'erreur, rien ne se passe. Utilise suggest_command quand tu veux que le joueur puisse vérifier ou annuler avant l'exécution.

Combiner les deux événements sur le même composant texte :

/tellraw @a {"text":"[Voter pour le serveur]","color":"green","underlined":true,"clickEvent":{"action":"open_url","value":"https://yoursite.com/vote"},"hoverEvent":{"action":"show_text","value":"Le vote prend 30 secondes et rapporte 3 diamants !"}}

Java vs Bedrock — ce qui fonctionne vraiment où

Avant de passer une heure à construire un message avec événement de clic, vérifie si ton serveur tourne sur Java ou Bedrock :

Fonctionnalité	Java 1.20+	Java 1.21.5+	Bedrock
Texte coloré basique	✅	✅	✅
Gras / italique / souligné	✅	✅	✅
Couleurs hex (`"#RRGGBB"`)	✅	✅	❌
`clickEvent` (toutes les actions)	✅	✅	❌
`hoverEvent` (toutes les actions)	✅	✅	❌
Composant score	✅	✅	❌
Composant selector	✅	✅	❌
Format SNBT compact	❌	✅	❌
Composant translate	✅	✅	Partiel

⚠️ Attention : Si tu gères un serveur crossplay avec Geyser et Floodgate, conçois tes messages /tellraw pour les capacités de Bedrock. Les événements de clic et de survol sont ignorés silencieusement sur Bedrock — pas d'erreur, juste du texte mort.

Note sur le format SNBT en Java 1.21.5 : À partir de 1.21.5, Minecraft accepte un format SNBT compact. Tu peux écrire {text:"Salut",color:gold} au lieu de {"text":"Salut","color":"gold"}. Le JSON standard fonctionne toujours. La plupart des générateurs en ligne n'ont pas encore été mis à jour — sois vigilant avec l'ancienne documentation.

Dix exemples prêts à l'emploi

Copie ces commandes directement dans un bloc de commande ou ta console serveur. Remplace les valeurs de placeholder (noms de serveur, URLs, noms d'objectifs de tableau de bord) par les tiennes.

1. Message de bienvenue avec nom du joueur

/tellraw @a [{"text":"► ","color":"gold"},{"text":"Bienvenue, ","color":"yellow"},{"selector":"@p"},{"text":" ! Bonne partie.","color":"yellow"}]

2. Lien Discord cliquable

/tellraw @a [{"text":"[Discord] ","color":"blue","bold":true,"underlined":true,"clickEvent":{"action":"open_url","value":"https://discord.gg/yourcode"},"hoverEvent":{"action":"show_text","value":"Rejoins notre communauté Discord"}},{"text":" Viens chatter avec nous !","color":"gray"}]

3. Rappel des règles du serveur

/tellraw @a ["",{"text":"─────────────────────\n","color":"dark_red"},{"text":"  ⚠ Rappel des règles\n","color":"red","bold":true},{"text":"Pas de grief · Pas de triche · Respecte tout le monde\n","color":"white"},{"text":"─────────────────────","color":"dark_red"}]

4. Affichage du solde en direct depuis le tableau de bord

/tellraw @a [{"text":"Tes pièces : ","color":"yellow"},{"score":{"name":"@p","objective":"coins"}},{"text":" ✦","color":"gold"}]

5. Info-bulle au survol — indice caché

/tellraw @p {"text":"[?] Survole pour un indice","color":"aqua","italic":true,"hoverEvent":{"action":"show_text","value":"Le coffre est derrière la troisième cascade côté est."}}

6. Bouton boutique avec suggestion de commande

/tellraw @a [{"text":"[Ouvrir la boutique]","color":"green","bold":true,"underlined":true,"clickEvent":{"action":"suggest_command","value":"/shop"},"hoverEvent":{"action":"show_text","value":"Parcourir la boutique du serveur"}},{"text":" — nouveaux articles chaque semaine !","color":"gray"}]

7. Rappel de vote avec lien externe

/tellraw @a [{"text":"[VOTE] ","color":"gold","bold":true},{"text":"Aide le serveur à grandir ! ","color":"yellow"},{"text":"[Voter maintenant →]","color":"aqua","underlined":true,"clickEvent":{"action":"open_url","value":"https://minecraft-server-list.com/server/your-id/vote/"}}]

8. Broadcast du staff

/tellraw @a [{"text":"[STAFF] ","color":"dark_aqua","bold":true},{"text":"Un événement commence dans 10 minutes à ","color":"aqua"},{"text":"/warp event","color":"yellow","italic":true},{"text":". Ne le manque pas !","color":"aqua"}]

9. Avertissement de redémarrage

/tellraw @a [{"text":"⚠ ","color":"red"},{"text":"REDÉMARRAGE DU SERVEUR","color":"red","bold":true},{"text":" dans 5 minutes. Trouve un endroit sûr.","color":"white"}]

10. Copier l'IP du serveur dans le presse-papiers

/tellraw @a [{"text":"IP du serveur : ","color":"gray"},{"text":"play.yourserver.net","color":"aqua","underlined":true,"clickEvent":{"action":"copy_to_clipboard","value":"play.yourserver.net"},"hoverEvent":{"action":"show_text","value":"Clique pour copier l'adresse IP"}}]

💡 Astuce : Plutôt que de taper ces commandes à la main, utilise le constructeur de commande /tellraw d'AlaCraft — compose des messages visuellement, configure les événements via des champs de formulaire et copie la commande finie en un clic.

Six erreurs courantes

❌ Erreur 1 : Guillemets non échappés dans les chaînes de texte

Les chaînes JSON utilisent les guillemets doubles comme délimiteurs. Un guillemet dans ton texte de message doit être échappé avec un backslash. {"text":"Il a dit "bonjour""} casse le parseur JSON à chaque fois sans message d'erreur utile.

Correction : {"text":"Il a dit \"bonjour\""}

❌ Erreur 2 : Utiliser des événements de clic sur Bedrock

Le /tellraw de Bedrock Edition ignore silencieusement clickEvent. Il n'y a pas d'erreur — le texte apparaît, le clic ne fait rien. Beaucoup d'administrateurs de serveur ne le découvrent qu'après des plaintes de joueurs que les boutons « ne fonctionnent pas ».

Correction : Teste sur l'édition réelle que ton serveur utilise avant d'annoncer des fonctionnalités interactives aux joueurs.

❌ Erreur 3 : Omettre la chaîne de réinitialisation vide dans les tableaux

Avec les tableaux, omettre le "" initial peut causer des « fuites » de formatage — particulièrement le gras et l'italique — d'un composant à l'autre de façon inattendue.

Correction : Commence toujours tes tableaux avec une chaîne vide : ["", {...}, {...}]

❌ Erreur 4 : Taper de longues commandes directement dans le chat

La saisie dans le chat a une limite stricte de 256 caractères. Les commandes /tellraw complexes dépassent régulièrement cette limite. Minecraft tronque silencieusement la fin de ta saisie, cassant le JSON sans avertissement.

Correction : Mets les longues commandes dans un bloc de commande. Les blocs de commande supportent jusqu'à 32 767 caractères.

❌ Erreur 5 : run_command ciblant des commandes de niveau OP

Si clickEvent avec run_command pointe vers une commande nécessitant une permission d'opérateur, les joueurs non-OP qui cliquent obtiendront un échec silencieux. La commande s'exécute en tant que joueur, pas en tant que serveur.

Correction : Lie run_command uniquement aux commandes que tes joueurs ont déjà la permission d'exécuter. Pour les actions privilégiées, utilise un nœud de permission de plugin ou suggest_command.

❌ Erreur 6 : Crochets non appariés ou chaînes non fermées

Chaque { a besoin d'un }. Chaque [ a besoin d'un ]. Chaque " a besoin de sa paire. Le parseur JSON de Minecraft est implacable — un seul caractère manquant rejette toute la commande, parfois avec une erreur vague et parfois silencieusement.

Correction : Écris des commandes complexes dans VS Code avec la coloration syntaxique JSON, ou utilise le générateur /tellraw d'AlaCraft qui valide en temps réel et signale les erreurs.

Quand utiliser /tellraw — arbre de décision

Toutes les situations ne nécessitent pas le traitement JSON complet. Passe ces questions en revue :

Le message a-t-il besoin de couleurs, de formatage ou d'interactivité ? — Non → Utilise /say (pas de JSON requis, fonctionne immédiatement) — Oui → Continuer
Est-ce un message privé à un joueur spécifique ? — Oui → /tellraw <nomdujoueur> avec JSON, ou simplement /msg <nomdujoueur> pour du texte simple — Non → Continuer
Doit-il apparaître comme un grand titre en superposition sur l'écran ? — Oui → /title @a title {"text":"..."} (même format JSON, rendu en plein écran) — Non → Continuer
A-t-il besoin d'événements de clic, d'info-bulles au survol ou de valeurs de tableau de bord ? — Oui → /tellraw est le bon outil — Non → Considère /say avec des codes § si ta plateforme les supporte (syntaxe plus simple)
Se déclenchera-t-il automatiquement selon un calendrier ou un déclencheur ? — Oui → Mets le /tellraw dans un bloc de commande sur un circuit d'horloge, ou utilise un planificateur de plugin comme EssentialsX ou CMI — Non → Lance-le manuellement depuis la console ou le chat
Est-ce un serveur Bedrock ou un setup crossplay ? — Oui → Limite-toi aux couleurs et aux flags de formatage de base, abandonne les événements de clic et de survol

Tester ton /tellraw avant de le mettre en ligne

Ne découvre jamais un JSON cassé devant tous tes joueurs. Un workflow de validation rapide :

Monde créatif solo — boucle la plus rapide : activer les triche, coller dans le chat, ajuster, répéter. Aucun joueur affecté.
Te cibler toi-même d'abord — utilise /tellraw @s pour que seul toi voies la sortie de test pendant que tu itères.
Aperçu avant d'exécuter — le générateur /tellraw d'AlaCraft rend un aperçu de chat en direct avant que tu copies la commande.
Lire le message d'erreur — si Minecraft rejette la commande, cherche : guillemets non échappés, virgules manquantes entre les éléments de tableau, accolades ou crochets non fermés.
Tester les événements de clic en jeu — les générateurs ne peuvent pas simuler les clics ; vérifie toujours les actions run_command et open_url dans une vraie session de jeu avant de les activer sur un serveur de production.

✅ Note : Lors des tests dans un bloc de commande, attache un bouton plutôt qu'un circuit d'horloge. Un /tellraw cassé sur une horloge répétitive de 20 ticks remplit le chat de tous les joueurs de messages d'erreur. Construis et teste d'abord, puis passe à l'horloge seulement quand tu es sûr que ça fonctionne.

Générateur /tellraw d'AlaCraft — ce qu'il fait

Si écrire du JSON à la main n'est pas ton idée d'un après-midi productif — ce n'est pas le mien non plus — le générateur /tellraw d'AlaCraft gère la structure automatiquement :

Composer visuel — ajoute des segments de texte, choisis des couleurs dans une palette, bascule gras/italique/souligné avec des cases à cocher
Éditeur de clic et de survol — configure clickEvent et hoverEvent via des menus déroulants et des champs texte, sans connaître le JSON
Aperçu en direct — vois exactement comment le message apparaîtra dans le chat de Minecraft avant de copier quoi que ce soit
Copie en un clic — copie la commande complète /tellraw @a {...}, prête à coller dans un bloc de commande ou la console
Plusieurs cibles — bascule entre @a, @p, @s, ou un nom de joueur spécifique
Validation en temps réel — le générateur met en évidence les erreurs JSON au fur et à mesure que tu tapes

Pas de compte, pas d'inscription, pas d'installation. Ouvre la page, construis ton message, copie, colle.

FAQ

Est-ce que /tellraw peut formater du texte dans Minecraft Bedrock Edition ? Partiellement. Bedrock Edition supporte les 16 couleurs nommées et les flags de mise en forme gras/italique/souligné. Mais clickEvent, hoverEvent, les couleurs hex ("#RRGGBB"), les composants score et selector ne sont pas supportés. Pour les fonctionnalités complètes de /tellraw, tu as besoin de Java Edition.

Quelle est la différence entre /tellraw et /say ? /say diffuse du texte simple et non formaté avec un préfixe <Serveur> ou <nomdujoueur> — pas de couleurs, pas d'interactivité, et aucun moyen de supprimer le préfixe. /tellraw envoie du texte formaté en JSON sans préfixe, avec un contrôle total des couleurs, support des clics et survols, et injection de données de tableau de bord en temps réel. Utilise /say pour les annonces rapides d'opérateur ; utilise /tellraw pour tout ce qui doit avoir l'air soigné.

Comment afficher le nom d'un joueur dans un message /tellraw ? Utilise le composant selector : {"selector":"@p"} insère le nom d'affichage du joueur le plus proche. Dans un tableau : ["Bienvenue, ", {"selector":"@p"}, " !"]. Le sélecteur se résout au moment de l'exécution de la commande, donc il affiche toujours le bon nom.

Peut-on utiliser /tellraw dans un bloc de commande ? Oui — et pour les messages longs, un bloc de commande est essentiellement la seule option pratique. La saisie dans le chat est limitée à 256 caractères ; les blocs de commande acceptent jusqu'à 32 767. Configure le bloc en mode Impulsion, Inconditionnel, Nécessite Redstone, et déclenche-le avec un bouton ou un levier.

Quelle est la limite de caractères pour /tellraw ? 256 caractères lorsque tapé directement dans le chat. 32 767 caractères dans un bloc de commande. Même des messages multi-segments complexes avec des événements de clic et de survol dépassent rarement 600 à 800 caractères, donc les blocs de commande sont plus que suffisants pour tout ce qui est réel.

Comment afficher une valeur de tableau de bord dans un message /tellraw ? Utilise le composant score : {"score":{"name":"@p","objective":"coins"}}. Cela lit la valeur de l'objectif de tableau de bord coins pour le joueur ciblé au moment de l'exécution de la commande. Tu peux le combiner avec d'autres composants texte dans un tableau pour construire une ligne complète comme « Tes pièces : 347 ✦ ».

Est-ce que /tellraw supporte plusieurs lignes dans un message ? Oui. Utilise \n dans une chaîne de texte pour insérer un saut de ligne : {"text":"Ligne un\nLigne deux"}. Sur la plupart des versions actuelles de serveur, cela fonctionne de manière fiable dans le chat. Teste-le sur ta version de serveur spécifique avant de l'utiliser en production.