Commande
/scoreboard
Crée et gère les objectifs du tableau des scores, définit où ils sont affichés, et lit ou modifie les scores des joueurs et d'autres entités.
Syntaxe
| /scoreboard objectives add <objective> <criteria> [<displayName>] |
| /scoreboard objectives list |
| /scoreboard objectives modify <objective> (displayautoupdate <value>|displayname <displayName>) |
| /scoreboard objectives modify <objective> numberformat |
| /scoreboard objectives modify <objective> numberformat blank |
| /scoreboard objectives modify <objective> numberformat (fixed <contents>|styled <style>) |
| /scoreboard objectives modify <objective> rendertype (hearts|integer) |
| /scoreboard objectives remove <objective> |
| /scoreboard objectives setdisplay <slot> [<objective>] |
| /scoreboard players (add <targets>|remove <targets>) <objective> <score> |
| /scoreboard players display name <targets> <objective> [<name>] |
| /scoreboard players display numberformat <targets> <objective> |
| /scoreboard players display numberformat <targets> <objective> blank |
| /scoreboard players display numberformat <targets> <objective> (fixed <contents>|styled <style>) |
| /scoreboard players (enable <targets>|get <target>) <objective> |
| /scoreboard players list [<target>] |
| /scoreboard players operation <targets> <targetObjective> <operation> <source> <sourceObjective> |
| /scoreboard players reset <targets> [<objective>] |
| /scoreboard players set <targets> <objective> <score> |
Arguments
| Argument | Type de valeur | Quoi saisir |
|---|---|---|
| <objective> | Texte | Le nom de l’objectif. Pour objectives add, c'est le nouveau nom, un seul mot sans espaces. Partout ailleurs, ce doit être un objectif existant. |
| <criteria> | Critère de l'objectif | Ce que l'objectif compte : dummy, trigger, deathCount, playerKillCount, totalKillCount, health, food, air, armor, xp, level, teamkill.<color>, killedByTeam.<color>, ou une statistique comme minecraft.custom:minecraft.jump. |
| <displayName> | Composant de texte | Le nom affiché pour l’objectif, écrit sous forme de composant de texte, comme "Kills" ou {text:"Kills",color:"red"}. |
| <value> | Vrai ou faux | true ou false pour displayautoupdate. |
| <contents> | Composant de texte | Le composant de texte affiché à la place du nombre avec numberformat fixed. |
| <style> | Style du texte | Le style de texte utilisé pour le nombre avec numberformat styled, par exemple {color:"gold"}. |
| <slot> | Emplacement d'affichage | L’emplacement d’affichage : list, sidebar, below_name ou sidebar.team.<color>. |
| <targets> | Détenteur de score | Les détenteurs de score à modifier : un sélecteur de cibles, un nom ou * pour tous les détenteurs de score suivis. |
| <score> | Nombre entier | Le nombre à définir (n’importe quel nombre entier), ou la quantité à ajouter ou à retirer (0 ou plus). Au moins 0. |
| <name> | Composant de texte | Le composant de texte affiché à la place du nom du détenteur de score avec players display name. |
| <target> | Détenteur de score | Un seul détenteur de score pour players get et players list. |
| <targetObjective> | Objectif du tableau des scores | L’objectif dont le score est modifié par l’opération players. Ne doit pas être en lecture seule. |
| <operation> | Opération sur le score | L'un de =, +=, -=, *=, /=, %=, <, >, ><. |
| <source> | Détenteur de score | Les détenteurs de score dont les scores servent de seconde valeur dans players operation. |
| <sourceObjective> | Objectif du tableau des scores | L’objectif dont les scores sources sont lus. |
Détails
| Niveau de permission | 2 : opérateurs, mondes avec triche activée, blocs de commande et fonctions |
| Fonctionne dans | Solo avec les cheats activés, serveurs multijoueur, blocs de commande et fonctions. Demande le niveau de permission 2 (maîtres de jeu) : opérateurs, joueurs dans un monde avec triches activées, blocs de commande et fonctions. |
| Résultat | Chaque sous-commande indique ce qu'elle a changé. Résultats numériques : objectives add et objectives remove renvoient le nombre d'objectifs existants ; objectives list renvoie le nombre d'objectifs ; objectives setdisplay et objectives modify renvoient 0. players get renvoie le score ; players set, add, remove et operation renvoient la somme des nouveaux scores de toutes les cibles ; players reset et players display renvoient le nombre de cibles ; players enable renvoie le nombre de cibles au trigger nouvellement activé ; players list renvoie le nombre de détenteurs de score, ou, avec une cible, le nombre de ses scores. |
| objectives add | Crée un objectif avec un nom, un critère et un nom d'affichage facultatif. Le nom est un seul mot sans espace. Sans nom affiché, le nom lui-même est affiché. Échoue avec « Un objectif existe déjà sous ce nom » si le nom est déjà pris. |
| Critères | Critères de base : dummy (modifié uniquement par des commandes), trigger (les joueurs le modifient eux-mêmes avec /trigger), deathCount, playerKillCount, totalKillCount, health, food, air, armor, xp, level. Critères d'équipe : teamkill.<color> et killedByTeam.<color> avec une couleur d'équipe comme red ou dark_blue. Les critères de statistique utilisent la forme minecraft.<type>:minecraft.<id> avec les types broken, crafted, custom, dropped, killed, killed_by, mined, picked_up et used, par exemple minecraft.mined:minecraft.stone ou minecraft.custom:minecraft.jump. |
| Critères en lecture seule | health, food, air, armor, xp et level sont tenus à jour par le jeu. Leurs scores ne peuvent pas être modifiés avec players set, add, remove ni comme cible de operation : « Scoreboard objective ... is read-only ». |
| objectives list et remove | objectives list affiche tous les objectifs. objectives remove supprime un objectif avec tous ses scores. |
| objectives setdisplay | Affiche un objectif dans un emplacement d'affichage. Emplacements : list (la liste des joueurs), sidebar (le côté droit de l'écran), below_name (sous les étiquettes de nom des joueurs) et sidebar.team.<color> pour une barre latérale liée à une couleur d'équipe, avec les couleurs black, dark_blue, dark_green, dark_aqua, dark_red, dark_purple, gold, gray, dark_gray, blue, green, aqua, red, light_purple, yellow et white. Omettre l'objectif vide l'emplacement. Échoue si l'emplacement est déjà vide ou affiche déjà cet objectif. |
| objectives modify | displayname change le nom affiché. rendertype alterne entre integer (nombres) et hearts (icônes de cœur) ; health utilise hearts par défaut, tous les autres integer. numberformat définit l'apparence par défaut de tous les scores de l'objectif. displayautoupdate true ou false active ou désactive la mise à jour automatique de l'affichage de l'objectif. |
| Formats de nombre | blank masque le nombre. fixed <contents> affiche un texte fixe à la place du nombre. styled <style> affiche le nombre avec un style de texte comme {color:"gold",bold:true}. Écrire numberformat sans rien après supprime le format. Les mêmes options existent pour un objectif entier (objectives modify ... numberformat) et pour chaque détenteur de score (players display numberformat). |
| players set, add, remove | set donne à un score n'importe quel nombre entier de -2147483648 à 2147483647. add et remove prennent une quantité de 0 ou plus et modifient le score actuel de cette quantité. Une cible qui n'a pas encore de score commence à 0. |
| players get et list | get affiche le score d'une cible et échoue avec « Can't get value of ... for ...; none is set » s'il n'y en a pas. list sans cible affiche tous les noms suivis ; avec une cible, il affiche tous les scores de cette cible. |
| players reset | Retire le score des cibles dans un objectif, ou tous leurs scores si aucun objectif n'est indiqué. Un score réinitialisé n'est plus défini du tout, ce qui est différent de 0. |
| players enable | Permet aux cibles d'utiliser /trigger une fois sur un objectif avec le critère trigger. Échoue avec « "Enable" fonctionne seulement sur des objectifs de type "trigger" » pour les autres objectifs et avec « Aucun changement. Ce déclencheur est déjà activé » si aucune cible n'a été modifiée. |
| players operation | Modifie le score cible à partir d'un score source. Signes : = donne à la cible la valeur de la source, += ajoute, -= soustrait, *= multiplie, /= divise (arrondi à l'inférieur), %= laisse le reste de la division (jamais négatif pour un diviseur positif), < garde le plus petit des deux, > garde le plus grand, >< échange les deux scores. Diviser par 0 échoue avec « Impossible de diviser par zéro ». Avec plusieurs sources, l'opération est appliquée une fois pour chaque source. |
| players display | display name donne à un détenteur de score un autre nom dans l'affichage du tableau des scores pour un objectif ; sans nom, il est retiré. display numberformat change l'apparence du nombre de ce détenteur dans cet objectif. |
| Détenteurs de score | Les cibles peuvent être des sélecteurs de cible, des noms de joueur ou n'importe quel nom inventé comme #total. * représente tous les détenteurs de score suivis. Un sélecteur qui ne trouve rien échoue avec « Aucun détenteur de score pertinent n'a pu être trouvé ». |
Exemples
/scoreboard objectives add kills playerKillCount "Kills"Crée un objectif nommé kills qui compte les joueurs tués et s'affiche sous le nom Kills.
/scoreboard objectives add points dummyCrée un objectif nommé points qui ne change que par des commandes.
/scoreboard objectives setdisplay sidebar killsAffiche l'objectif kills sur le côté droit de l'écran.
/scoreboard players set @s points 10Définit votre score de points sur 10.
/scoreboard players add @a points 1Ajoute 1 point à chaque joueur en ligne.
/scoreboard players operation @s points += @s killsAjoute votre score kills à votre score points.
/scoreboard objectives modify points numberformat styled {color:"gold"}Affiche tous les nombres de l'objectif de points en or.
/scoreboard players reset @a pointsRetire le score de points de chaque joueur en ligne.
