Sélecteurs de cibles

Sélecteurs de cibles sont utilisés dans les commandes pour sélectionner arbitrairement des joueurs et des entités, sans avoir besoin de spécifier un nom de joueur exact ou un UUID. Une ou plusieurs entités peuvent être sélectionnées avec une variable de sélection de cible, et les cibles peuvent être filtrées de la sélection en fonction de certains critères à l'aide des arguments de sélection de cible.

Par exemple, pour changer le mode de jeu de tous les joueurs en mode Créatif, au lieu de spécifier chacun d'eux individuellement :

/création mode de jeu @a

Contenu

• 1 Variables de sélection de cible
• 2 Arguments du sélecteur de cible
• 3 Histoire
• Problèmes 4
• 5

Variables de sélection de cible

Résumé des variables du sélecteur de cible

Une variable de sélection de cible identifie la grande catégorie de cibles à sélectionner. Il existe cinq variables (six dans l'édition Bedrock, sept dans l'édition Education) :

@p Cible le joueur le plus proche de l'exécution de la commande. S'il y a plusieurs joueurs les plus proches, parce qu'ils sont exactement à la même distance, le joueur qui a rejoint le plus récemment le serveur est sélectionné. Dans Bedrock Edition, @p ne cible que les joueurs vivants. @r Cible un joueur aléatoire. Bedrock Edition peut utiliser @r pour cibler des entités non-joueurs via l'argument sélecteur de type ; dans Java Edition, pour sélectionner une entité aléatoire, utilisez plutôt @e[sort=random]. Dans Bedrock Edition, @r ne peut cibler que les entités vivantes. @a Cible tous les joueurs, vivants ou non. @e Cible toutes les entités vivantes (y compris les joueurs) en morceaux chargés. @s Cible l'entité (vivante ou non) qui a exécuté la commande. Il ne cible rien si la commande a été exécutée par un bloc de commande ou une console de serveur. @c‌[Édition Education uniquement] Ciblez uniquement l'agent du joueur. @v‌[Édition Education uniquement] Ciblez tous les agents. Fonctionne uniquement s'il existe plusieurs agents. @initiator‌[Bedrock Edition uniquement] Cible le joueur qui interagit avec un bouton dans un dialogue JSON NPC.

Arguments du sélecteur de cible

Résumé des arguments du sélecteur de cible

Après un sélecteur de cible, des arguments facultatifs peuvent être utilisés pour restreindre l'ensemble de cibles à un groupe qui correspond également à certains critères. Lorsqu'ils sont utilisés avec @a ou @e, les arguments réduisent les cibles de la liste complète à un groupe spécifique. Lorsqu'il est utilisé avec @p ou @r, le joueur le plus proche ou aléatoire est sélectionné dans le groupe. Lorsqu'il est utilisé avec @s, le joueur utilisant la commande n'est ciblé que s'il se trouve dans le groupe restreint.

Les paires argument-valeur apparaissent entre crochets après la variable de sélection cible, séparées par des virgules :

@ [ = , = , ...].

Dans Java Edition, les arguments et les valeurs sont sensibles à la casse. Les espaces sont autorisés autour des crochets, des signes égal et des virgules, sauf dans Java Edition entre la variable cible et le premier crochet. Des virgules doivent être utilisées pour séparer les paires argument-valeur.

S'il existe plusieurs paires argument-valeur, elles doivent toutes être satisfaites pour ajouter une cible potentielle au groupe. (En d'autres termes, ils sont ET-ed ensemble).

Arguments de position [x= ,y= ,z= ] — Définit une position dans le monde à laquelle le sélecteur commence, à utiliser avec l'argument distance, les arguments volume ou l'argument limite. L'utilisation de ces seuls arguments ne limitera pas les entités trouvées et n'affectera que le tri des cibles. Impossible de dupliquer l'un de ces trois arguments. Les composants positionnels sont des doubles, permettant des valeurs comme +12.34, et ils ne sont pas corrigés au centre, ce qui signifie que x=0 n'est pas corrigé à x=0.5. Dans Bedrock Edition, la notation tilde est disponible pour les coordonnées des arguments du sélecteur. Dans Java Edition, ces arguments limitent la recherche d'entités à la dimension courante. Sélection de cibles par distance Filtrez la sélection de cibles en fonction de leurs distances euclidiennes à partir d'un certain point, en recherchant les pieds de la cible (un point au bas du centre de sa hitbox). Si les arguments positionnels ne sont pas définis, le rayon est calculé par rapport à la position d'exécution de la commande. Cet argument limite la recherche d'entités à la dimension courante. Impossible de dupliquer ces arguments. Dans l'édition Java : [distance= ] — Spécifie la plage de distance. Les plages flottantes sont prises en charge pour sélectionner une région spécifique. Seules les valeurs non signées sont autorisées. Dans l'édition Bedrock : [r= ] et [rm= ] — Spécifie la plage maximale et minimale pour rechercher des entités, respectivement. Seules les valeurs non signées sont autorisées. Exemples dans l'édition Java :

• @e[distance=10] — Ciblez toutes les entités à exactement dix pâtés de maisons.
• @e[distance=8..16] — Ciblez toutes les entités à plus de huit blocs, mais à moins de 16 blocs (inclus).

Exemples dans l'édition Bedrock :

• @e[rm=10,r=10] — Cible toutes les entités à exactement dix pâtés de maisons.
• @e[rm=8,r=16] — Ciblez toutes les entités de 8 à 16 pâtés de maisons.

Sélection des cibles par volume [dx= ,dy= ,dz= ] — Filtrer la sélection de cibles en fonction de leur différence x, y-différence et z-différence à partir d'un certain point, tel que mesuré par les hitbox des entités dans Java Edition ou par leurs pieds dans Bedrock Edition. Impossible de dupliquer l'un de ces trois arguments. Cela peut être interprété comme la création d'un volume rectangulaire défini par une position initiale ( , , ) et le vecteur diagonal ( , , ), puis en sélectionnant toutes les entités dont les hitbox sont au moins partiellement contenues par ce volume dans Java Edition, ou dont les pieds se trouvent dans ce volume dans Bedrock Edition. Si les arguments positionnels sont omis, la sélection est interprétée comme provenant de la position d'exécution de la commande. Toutes les valeurs sont autorisées, y compris les nombres signés et fractionnaires. Notez que dx,dy,dz spécifient des différences signées par rapport à la coordonnée donnée. Ils ne spécifient pas de coordonnées distinctes et ne s'étendent pas non plus dans les directions positive et négative. De plus, lorsqu'un argument de volume est présent, le reste est supposé égal à zéro, sauf indication contraire. Exemples dans l'édition Java :

• @e[x=1,dx=4,y=2,dy=5,z=3,dz=6] — Sélectionnez toutes les entités dont la hitbox entre en collision avec la région de bloc (1~5, 2~7, 3~9 ) (ou, mathématiquement parlant, la région qui est {(x,y,z)∈R3|x∈[1.0,5.0),y∈[2.0,7.0),z∈[3.0,9.0)}).
• @e[x=1,y=2,z=3,dx=0,dy=0,dz=0] — Sélectionnez toutes les entités dont la hitbox contient le point (1,2,3).

Exemples dans l'édition Bedrock :

• @e[x=1,dx=4,y=2,dy=5,z=3,dz=6] — Sélectionnez toutes les entités dont les pieds se trouvent dans la région du bloc (1~5, 2~7, 3~9 ).
• @e[x=1,y=2,z=3,dx=0,dy=0,dz=0] — Sélectionnez toutes les entités dont les pieds contiennent le point (1, 2, 3).

Il est possible de combiner la sélection par distance et la sélection par volume, auquel cas la commande sélectionne des cibles uniquement dans le chevauchement des deux régions (dans un certain rayon du point initial du volume et non en dehors du volume défini). Sélection des cibles par scores [scores={ = ,...}] — Filtre la sélection des cibles en fonction de leurs scores dans les objectifs spécifiés. Tous les objectifs testés se trouvent dans un seul objet, avec une liste d'arguments de score individuels entre accolades par la suite. Les valeurs à l'intérieur des accolades prennent en charge les plages d'entiers. Impossible de dupliquer cet argument.

• @e[scores={myscore=10}] — Sélectionnez toutes les entités avec un score objectif myscore d'exactement dix.
• @e[scores={myscore=10..12}] — Sélectionnez toutes les entités avec un score en myscore objectif compris entre dix et 12 (inclus).
• @e[scores={myscore=5..}] — Sélectionnez toutes les entités avec un score objectif myscore de cinq ou plus.
• @e[scores={myscore=..15}] — Sélectionnez toutes les entités avec un score objectif myscore de 15 ou moins.
• @e[scores={foo=10,bar=1..5}] — Sélectionnez toutes les entités avec un score objectif foo d'exactement dix, et un score objectif bar compris entre un et cinq (inclus).

Dans l'édition Bedrock, ! peut être utilisé pour inverser la sélection.

• @e[scores={myscore=!10}] — Exclut toutes les entités avec un score objectif myscore d'exactement dix.
• @e[scores={myscore=!10..15}] — Exclut toutes les entités avec un score en myscore objectif compris entre dix et 15 (inclus).

: Tableau de bord § Objectifs Sélection des cibles par balise Filtrer la sélection des cibles en fonction des balises du tableau de bord de l'entité. Plusieurs arguments de balise sont autorisés et tous les arguments doivent être remplis pour qu'une entité soit sélectionnée. [tag= ] — Inclut uniquement les cibles avec la balise spécifiée. [tag=! ] — Exclut toutes les cibles avec la balise spécifiée. [tag=] — Inclut uniquement les cibles avec exactement zéro balise. [tag=!] — Exclut toutes les cibles qui ont au moins une balise. : Commandes/tag Sélection des cibles par équipe‌[Édition Java uniquement] Filtrez la sélection des cibles en fonction des équipes. Les arguments testant l'égalité ne peuvent pas être dupliqués, alors que les arguments testant l'inégalité le peuvent. [équipe= ] — Inclut uniquement les cibles dans l'équipe donnée. [équipe=! ] — Exclut toutes les cibles de l'équipe donnée. [team=] — Inclut uniquement les cibles qui ne font pas partie d'une équipe. [team=!] — Exclut toutes les cibles qui ne font pas partie d'une équipe. : Commandes/équipe Limitation et tri de la sélection des cibles Limiter le nombre de cibles sélectionnables pour un sélecteur de cibles. Lors de l'utilisation des variables @p et @r, cet argument est par défaut un. Leur appliquer l'argument de limitation peut augmenter le nombre de cibles les plus proches ou aléatoires sélectionnées. Lors de l'application de cet argument à @a ou @e, cet argument ne renvoie qu'un nombre limité de cibles. Impossible de dupliquer ces arguments. Dans l'édition Java : [limit= ,sort=(nearest|furthest|random|arbitrary)] — Limite le nombre de cibles et spécifie la priorité de sélection.

• sort=nearest — Trier par distance croissante. (Par défaut pour @p)
• sort=furthest — Trier par distance décroissante.
• sort=random — Trier au hasard. (Par défaut pour @r)
• sort=arbitrary — Trier par heure de création. (Par défaut pour @e, @a)

Dans l'édition Bedrock : [c= ] — Limitez le nombre de cibles. Pour @p, @a et @e, [c= ] sélectionne uniquement le nombre spécifié de cibles en augmentant la distance par rapport à la position du sélecteur. Lorsque c est négatif, cela inversera l'ordre de ciblage (par exemple, @p[c=-1] ciblera le joueur le plus éloigné). Le tri inverse ne fonctionne pas avec @r. Exemples dans l'édition Java :

• @a[limit=3,sort=nearest] ou @p[limit=3] — Sélectionnez les trois joueurs les plus proches.
• @a[limit=4,sort=furthest] — Sélectionnez les quatre joueurs les plus éloignés.
• @a[limit=2,sort=random] ou @r[limit=2] — Sélectionnez deux joueurs, choisis au hasard.

Exemples dans l'édition Bedrock :

• @a[c=3] — Sélectionnez les trois joueurs les plus proches.
• @a[c=-4] — Sélectionnez les quatre joueurs les plus éloignés.
• @r[c=2] — Sélectionnez deux joueurs vivants, choisis au hasard.

Sélection des cibles par niveau d'expérience Filtrez la sélection des cibles en fonction des niveaux d'expérience de l'entité. Cela filtre naturellement toutes les cibles non-joueurs. Impossible de dupliquer ces arguments. Dans l'édition Java : [niveau= ] — Spécifie la plage de niveaux. Les plages d'entiers sont prises en charge pour sélectionner une plage de valeurs. Dans l'édition Bedrock : [l= ] et [lm= ] — la plage de niveaux maximum et minimum à rechercher, respectivement. Exemples dans l'édition Java :

• @a[level=10] — Sélectionnez tous les joueurs qui ont exactement dix niveaux.
• @a[level=8..16] — Sélectionnez tous les joueurs qui ont entre huit et 16 niveaux (inclus).

Exemples dans l'édition Bedrock :

• @a[lm=10,l=10] — Sélectionnez tous les joueurs qui ont exactement dix niveaux.
• @a[lm=8,l=16] — Sélectionnez tous les joueurs qui ont entre huit et 16 niveaux (inclus).

: Commandes/expérience Sélection de cibles par mode de jeu Filtrer la sélection de cibles par mode de jeu. Cela filtre naturellement toutes les cibles non-joueurs. Les arguments testant l'égalité ne peuvent pas être dupliqués, alors que les arguments testant l'inégalité le peuvent. Dans l'édition Java : [gamemode= ] — Inclut uniquement les joueurs dans le mode de jeu donné. [mode de jeu=! ] — Exclut tous les joueurs dans le mode de jeu donné. Dans l'édition Bedrock : [m= ] — Inclut uniquement les joueurs dans le mode de jeu donné. [m=! ] — Exclut tous les joueurs dans le mode de jeu donné. Valeurs autorisées pour sont spectateur,‌[JE seulement] survie, créatif, aventure. Dans Bedrock Edition, les valeurs abrégées s et 0, c et 1, et a et 2 peuvent être utilisées respectivement pour le mode Survie, le mode Créatif et le mode Aventure. : Commandes/mode de jeu Sélection des cibles par nom Filtrez la sélection des cibles par nom. Les valeurs étant des chaînes, les espaces ne sont autorisés que si des guillemets sont appliqués. Cela ne peut pas être un composé de texte JSON. Les arguments testant l'égalité ne peuvent pas être dupliqués, alors que les arguments testant l'inégalité le peuvent. [nom= ] — Inclut uniquement les cibles portant le nom donné. [nom=! ] — Exclut toutes les cibles portant le nom donné. Sélection de cibles par rotation verticale Filtrez la sélection de cibles en fonction de la rotation de l'entité le long de l'axe de tangage, mesurée en degrés. Les valeurs vont de -90 (vers le haut) à 0 (à l'horizon) à +90 (vers le bas). Impossible de dupliquer ces arguments. Dans l'édition Java : [x_rotation= ] — Spécifie la plage de rotation x. Les plages flottantes sont prises en charge pour sélectionner une plage spécifique d'angles. Dans l'édition Bedrock [rx= ] et [rxm= ] — Spécifie la rotation x maximale et minimale, respectivement. Exemples dans l'édition Java :

• @e[x_rotation=0] — Sélectionnez toutes les entités qui regardent directement l'horizon.
• @e[x_rotation=30..60] — Sélectionnez toutes les entités qui regardent entre 30° et 60° (inclus) sous l'horizon.
• @e[x_rotation=..0] — Sélectionnez toutes les entités qui regardent ou au-dessus de l'horizon.

Exemples dans l'édition Bedrock :

• @e[rxm=0,rx=0] — Sélectionne toutes les entités qui regardent directement l'horizon.
• @e[rxm=30,rx=60] — Sélectionne toutes les entités qui regardent entre 30° et 60° (inclus) sous l'horizon.
• @e[rx=0] — Sélectionnez toutes les entités qui regardent ou au-dessus de l'horizon.

Sélection de cibles par rotation horizontale Filtrez la sélection de cibles en fonction de la rotation de l'entité le long de l'axe de lacet, mesurée dans le sens des aiguilles d'une montre en degrés depuis le sud (ou la direction Z positive). Les valeurs varient de -180 (face plein nord) à -90 (face plein est) à 0 (face plein sud) à +90 (face plein ouest) à +180 (face plein nord à nouveau). Impossible de dupliquer ces arguments. Dans l'édition Java : [y_rotation= ] — Spécifie la plage de rotation y. Les plages flottantes sont prises en charge pour sélectionner une plage d'angles spécifique. Dans l'édition Bedrock : [ry= ] et [rym= ] — Spécifie les valeurs de rotation y maximale et minimale, respectivement. Exemples dans l'édition Java :

• @e[y_rotation=0] — Sélectionnez toutes les entités orientées plein sud.
• @e[y_rotation=-90..0] — Sélectionnez toutes les entités faisant face à 90° entre plein est et plein sud (inclus).
• @e[y_rotation=0..180] — Sélectionnez toutes les entités qui ne font pas du tout face à l'est.

Exemples dans l'édition Bedrock :

• @e[rym=0,ry=0] — Sélectionnez toutes les entités orientées plein sud.
• @e[rym=-90,ry=0] — Sélectionnez toutes les entités faisant face à 90° entre plein est et plein sud (inclus).
• @e[rym=0,ry=180] — Sélectionnez toutes les entités qui ne font pas du tout face à l'est.

Sélection des cibles par type Filtrez la sélection des cibles en fonction de l'identifiant de l'entité. Le type d'entité donné doit être un ID d'entité ou une étiquette de type d'entité valide‌[édition Java uniquement] utilisé pour identifier différents types d'entités en interne. L'espace de noms peut être omis si l'ID se trouve dans l'espace de noms minecraft. Les ID d'entité ou les balises sont sensibles à la casse. Les arguments testant l'égalité ne peuvent pas être dupliqués, contrairement aux arguments testant l'inégalité. [tapez= ] — Inclut uniquement les cibles du type d'entité ou de la balise spécifié. [tapez=! ] — Exclut toutes les cibles du type d'entité ou de la balise spécifié. Sélection de cibles par famille‌[Bedrock Edition uniquement] Filtrez la sélection de cibles en fonction du composant de comportement type_family de l'entité. Les valeurs par défaut utilisées par le pack de comportement vanille incluent entre autres des termes plus larges comme mob et inanimé, ainsi que des familles plus spécifiques comme zombie et squelette, et des familles à mob unique comme wandering_trader et creeper. Plusieurs arguments de famille sont autorisés et tous les arguments doivent être remplis pour qu'une entité soit sélectionnée. [famille= ] — Inclut uniquement les cibles de la famille de types spécifiée. [famille=! ] — Exclut toutes les cibles de la famille de types spécifiée.

• @e[family=skeleton] — Sélectionnez tous les squelettes, les squelettes flétris et les errants.
• @e[family=mob,family=!monster] — Sélectionnez tous les monstres qui ne sont pas aussi des monstres (par exemple des vaches, des poulets, des cochons, mais pas des zombies ou des squelettes).
• @e[family=monster,family=undead] — Sélectionnez tous les monstres qui sont également morts-vivants (ce qui inclut les monstres comme les zombies et les squelettes, mais pas les creepers ou les endermen).

Sélection de cibles par données NBT‌[Édition Java uniquement] Filtrez la sélection de cibles en fonction des données NBT de l'entité. Les données NBT sont écrites dans leur format SNBT. Plusieurs arguments nbt sont autorisés et tous les arguments doivent être remplis pour qu'une entité soit sélectionnée. Voir NBT format#Testing NBT tags pour plus d'informations à ce sujet. Notez que cet argument de sélecteur doit être utilisé avec précaution, car l'accès aux données NBT est un processus lourd pour le CPU. [nbt= ] — Inclut uniquement les cibles avec les données NBT spécifiées. [nbt=! ] — Exclut toutes les cibles avec les données NBT spécifiées.

• @a[nbt={OnGround:true}] — Sélectionnez tous les joueurs au sol.
• @e[type=sheep,nbt={Color:0b}] — Sélectionnez tous les moutons teints en blanc.
• @e[type=item,nbt={Item:{id:"minecraft:slime_ball"}}] — Sélectionne toutes les entités d'objets slime ball.
• @e[nbt={Tags:[a,b]}] est le même que @e[tag=a,tag=b]. Ce dernier est plus simple et réduit la charge CPU.

Sélection de cibles par avancements‌[Édition Java uniquement] Filtrez la sélection de cibles en fonction des avancements de l'entité. Cela filtre naturellement toutes les cibles non-joueurs. Toutes les avancées sont dans un seul objet, avec une liste d'ID d'avancement individuels entre les accolades par la suite. Les valeurs sont vraies ou fausses. Pour les avancements avec un critère, le test pour ce critère donne toujours les mêmes résultats que le test pour l'avancement. Impossible de dupliquer cet argument. [avancées={ = }] — Inclut uniquement les joueurs avec les avancements et les valeurs spécifiés. [avancées={ ={ = }}] — Inclut uniquement les joueurs avec les critères d'avancement spécifiés.

• @a[advancements={story/smelt_iron=true}] — Inclut uniquement les joueurs qui ont terminé l'avancement minecraft:story/smelt_iron.
• @a[advancements={story/form_obsidian=false}] — Inclut uniquement les joueurs qui n'ont pas terminé l'avancement minecraft:story/form_obsidian.
• @a[advancements={story/follow_ender_eye=true}] est le même que @a[advancements={story/follow_ender_eye={in_stronghold=true}}].

: Commandes/avancement Sélection des cibles par prédicat‌[Édition Java uniquement] Filtrer la sélection des cibles par prédicats. Les valeurs données doivent être un prédicat valide représenté par un emplacement de ressource. Plusieurs arguments de prédicat sont autorisés et tous les arguments doivent être remplis pour qu'une entité soit sélectionnée. [prédicat= ] — Inclut uniquement les cibles qui correspondent au prédicat spécifié. [prédicat=! ] — Exclut toutes les cibles qui correspondent au prédicat spécifié.

Histoire

Questions

Les problèmes liés aux « sélecteurs de cibles » sont maintenus sur le traqueur de bogues. Signalez les problèmes là-bas.

• Commandes
• Format d'entité