La commande /waypoint permet de gérer les indicateurs de position visibles sur la barre de localisation. Elle offre la possibilité d’afficher les entités actives émettant un point de repère (waypoint), ainsi que de modifier leur apparence, notamment leur couleur ou leur style graphique.
Initialement introduite de manière expérimentale dans la snapshot 25w15a de la version 1.21.6, cette commande est désormais disponible dans le jeu normal depuis la snapshot 25w17a.
Sommaire
À quoi sert la commande /waypoint ?
Cette commande remplit deux fonctions principales :
- Lister les waypoints suivis : Elle permet d’afficher toutes les entités qui émettent un point de repère actif, à condition que certaines conditions soient remplies.
- Modifier l’apparence d’un waypoint : Elle permet de personnaliser la couleur ou le style d’un indicateur, qu’il soit attaché à un joueur, une créature ou un porte armure.
Qu’est-ce qu’un “waypoint transmis” ?
Un waypoint est considéré comme actif et traçable s’il remplit l’un des critères suivants :
- L’entité dispose d’un attribut
waypoint_transmit_rangesupérieur à 0. - Une couleur lui a été attribuée explicitement via
/waypoint modify <entité> color, pendant la session en cours (cet état n’est pas sauvegardé au rechargement du monde).
Seules les entités vivantes peuvent émettre un waypoint, ce qui inclut :
- Les joueurs
- Les mobs
- Les armor stands
Syntaxe de la commande
La commande possède plusieurs variantes :
/waypoint list
Affiche tous les waypoints actifs.
/waypoint modify <entité> color <couleur>
Modifie la couleur de l’indicateur sur la barre de localisation. Doit être l’un des 16 noms de code couleur reconnus (ex. : red, blue, light_purple).
/waypoint modify <entité> color hex <code_hexadécimal>
Permet une personnalisation plus poussée à l’aide d’un code couleur hexadécimal (ex. : FF0000 pour le rouge pur).
bashCopierModifier/waypoint modify <entité> color reset
Réinitialise la couleur à celle choisie aléatoirement par le jeu, ou héritée de l’équipe de l’entité.
/waypoint modify <entité> style set <style>
Change le style visuel du waypoint à partir d’une ressource disponible dans le dossier waypoint_style d’un pack de ressources.
/waypoint modify <entité> style reset
Restaure le style par défaut (minecraft:default).
Paramètres
- <entité> : Nom du joueur, UUID ou sélecteur ciblant une seule entité vivante.
- <couleur> : Nom de couleur standard (ex. :
gold,cyan,green). - <code_hexadécimal> : Code RGB à 6 chiffres (000000 à FFFFFF).
- <style> : Chemin de ressource vers un style personnalisé. L’absence d’un fichier valide se traduit par une icône manquante.
Exemples d’utilisation
Voici quelques cas pratiques pour mieux comprendre l’usage de la commande :
- Lister les waypoints actifs :
/waypoint list
- Colorer le point de repère de “Steve” en doré :
/waypoint modify Steve color gold
- Colorer un creeper en vert vif via un code hexadécimal :
/waypoint modify @e[type=creeper,limit=1] color hex 00FF00
- Réinitialiser la couleur d’un zombie :
/waypoint modify @e[type=zombie,limit=1] color reset
À noter : tout sélecteur utilisé pour cibler une entité doit être limité à un seul résultat, sous peine d’échec.
Comportement et résultats
- Si la commande est complète et que tous les paramètres sont valides, elle s’exécute avec succès.
- En cas d’erreur (paramètre manquant, entité non transmissible, couleur invalide…), la commande échoue.
- Les commandes
/execute store successet/execute store resultrenvoient1pour un succès et0pour un échec.
Conclusion
La commande /waypoint apporte une nouvelle dimension à la visualisation des entités sur la barre de localisation. Elle offre un niveau de personnalisation inédit, aussi bien pour les développeurs de cartes personnalisées que pour les administrateurs de serveurs souhaitant guider les joueurs de façon élégante. En maîtrisant ses différentes syntaxes, vous pourrez créer des systèmes d’orientation dynamiques et visuellement clairs, sans avoir recours à des mods externes.
