Comando
/scoreboard
Crea y gestiona objetivos del marcador, define dónde se muestran, y lee o cambia las puntuaciones de jugadores y otras entidades.
Sintaxis
| /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> |
Argumentos
| Argumento | Tipo de valor | Qué escribir |
|---|---|---|
| <objective> | Texto | El nombre del objetivo. Con objectives add es el nombre nuevo, una sola palabra sin espacios. En el resto de casos debe ser un objetivo existente. |
| <criteria> | Criterio del objetivo | Lo que cuenta el objetivo: dummy, trigger, deathCount, playerKillCount, totalKillCount, health, food, air, armor, xp, level, teamkill.<color>, killedByTeam.<color> o una estadística como minecraft.custom:minecraft.jump. |
| <displayName> | Componente de texto | El nombre que se muestra para el objetivo, escrito como componente de texto, por ejemplo "Kills" o {text:"Kills",color:"red"}. |
| <value> | Verdadero o falso | true o false para displayautoupdate. |
| <contents> | Componente de texto | El componente de texto que se muestra en lugar del número con numberformat fixed. |
| <style> | Estilo del texto | El estilo de texto que se usa para el número con numberformat styled, por ejemplo {color:"gold"}. |
| <slot> | Ranura de visualización | El espacio de visualización: list, sidebar, below_name o sidebar.team.<color>. |
| <targets> | Poseedor de puntuación | Los poseedores de puntuación que se cambian: un selector de objetivos, un nombre o * para todos los poseedores de puntuación registrados. |
| <score> | Número entero | El número que se establece (cualquier número entero), o la cantidad que se suma o se quita (0 o más). Al menos 0. |
| <name> | Componente de texto | El componente de texto que se muestra en lugar del nombre del poseedor de puntuación con players display name. |
| <target> | Poseedor de puntuación | Un solo poseedor de puntuación para players get y players list. |
| <targetObjective> | Objetivo del marcador | El objetivo cuya puntuación cambia con la operación players. No debe ser de solo lectura. |
| <operation> | Operación de puntuación | Uno de =, +=, -=, *=, /=, %=, <, >, ><. |
| <source> | Poseedor de puntuación | Los poseedores de puntuación cuyas puntuaciones se usan como segundo valor en players operation. |
| <sourceObjective> | Objetivo del marcador | El objetivo del que se leen las puntuaciones de origen. |
Detalles
| Nivel de permiso | 2: operadores, mundos con trucos activados, bloques de comandos y funciones |
| Funciona en | Un jugador con trucos activados, servidores multijugador, bloques de comandos y funciones. Necesita el nivel de permiso 2 (maestros de juego): operadores, jugadores en un mundo con trucos activados, bloques de comandos y funciones. |
| Resultado | Cada subcomando informa de lo que cambió. Resultados numéricos: objectives add y objectives remove devuelven cuántos objetivos existen ahora; objectives list devuelve cuántos objetivos hay; objectives setdisplay y objectives modify devuelven 0. players get devuelve la puntuación; players set, add, remove y operation devuelven la suma de las puntuaciones nuevas de todos los objetivos; players reset y players display devuelven cuántos objetivos hay; players enable devuelve cuántos objetivos tienen un trigger recién activado; players list devuelve cuántos poseedores de puntuación hay, o, con un objetivo, cuántas puntuaciones tiene. |
| objectives add | Crea un objetivo con un nombre, un criterio y un nombre visible opcional. El nombre es una sola palabra sin espacios. Sin nombre visible se muestra el propio nombre. Falla con «Ya existe un objetivo con este nombre» si el nombre ya está en uso. |
| Criterios | Criterios básicos: dummy (solo cambia con comandos), trigger (los jugadores lo cambian ellos mismos con /trigger), deathCount, playerKillCount, totalKillCount, health, food, air, armor, xp, level. Criterios de equipo: teamkill.<color> y killedByTeam.<color> con un color de equipo como red o dark_blue. Los criterios de estadística usan la forma minecraft.<type>:minecraft.<id> con los tipos broken, crafted, custom, dropped, killed, killed_by, mined, picked_up y used, por ejemplo minecraft.mined:minecraft.stone o minecraft.custom:minecraft.jump. |
| Criterios de solo lectura | health, food, air, armor, xp y level se mantienen actualizados por el juego. Sus puntuaciones no se pueden cambiar con players set, add, remove ni como destino de operation: «Scoreboard objective ... is read-only». |
| objectives list y remove | objectives list muestra todos los objetivos. objectives remove elimina un objetivo junto con todas sus puntuaciones. |
| objectives setdisplay | Muestra un objetivo en una ranura de visualización. Ranuras: list (la lista de jugadores), sidebar (el lado derecho de la pantalla), below_name (bajo las etiquetas de nombre de los jugadores) y sidebar.team.<color> para una barra lateral ligada al color de un equipo, con los colores black, dark_blue, dark_green, dark_aqua, dark_red, dark_purple, gold, gray, dark_gray, blue, green, aqua, red, light_purple, yellow y white. Si se omite el objetivo, se vacía la ranura. Falla si la ranura ya está vacía o ya muestra ese objetivo. |
| objectives modify | displayname cambia el nombre mostrado. rendertype alterna entre integer (números) y hearts (iconos de corazón); health usa hearts por defecto y todos los demás integer. numberformat define el aspecto por defecto de todas las puntuaciones del objetivo. displayautoupdate true o false activa o desactiva la actualización automática de la visualización del objetivo. |
| Formatos de número | blank oculta el número. fixed <contents> muestra un texto fijo en lugar del número. styled <style> muestra el número con un estilo de texto como {color:"gold",bold:true}. Escribir numberformat sin nada detrás quita el formato. Las mismas opciones existen para un objetivo entero (objectives modify ... numberformat) y para poseedores de puntuación individuales (players display numberformat). |
| players set, add, remove | set da a una puntuación cualquier número entero de -2147483648 a 2147483647. add y remove toman una cantidad de 0 o más y cambian la puntuación actual en esa cantidad. Un objetivo que aún no tiene puntuación empieza en 0. |
| players get y list | get muestra la puntuación de un objetivo y falla con «Can't get value of ... for ...; none is set» si no hay ninguna. list sin objetivo muestra todos los nombres registrados; con un objetivo muestra todas sus puntuaciones. |
| players reset | Elimina la puntuación de los objetivos en un objetivo de marcador, o todas sus puntuaciones si no se indica ninguno. Una puntuación restablecida ya no está establecida en absoluto, lo que es distinto de 0. |
| players enable | Permite que los objetivos usen /trigger una vez en un objetivo con el criterio trigger. Falla con «La función «enable» solo sirve con objetivos de tipo «trigger»» para otros objetivos y con «Nada ha cambiado. Ese activador ya está activado» si no se cambió ningún objetivo. |
| players operation | Cambia la puntuación de destino usando una puntuación de origen. Signos: = asigna al objetivo el valor de la fuente, += suma, -= resta, *= multiplica, /= divide (redondeando hacia abajo), %= deja el resto de la división (nunca negativo con un divisor positivo), < conserva el menor de los dos, > conserva el mayor, >< intercambia las dos puntuaciones. Dividir entre 0 falla con «No se puede dividir por cero». Con varias fuentes, la operación se aplica una vez por cada fuente. |
| players display | display name da a un poseedor de puntuación otro nombre en la visualización del marcador para un objetivo; si se omite el nombre, se quita. display numberformat cambia el aspecto del número de ese poseedor en ese objetivo. |
| Poseedores de puntuación | Los objetivos pueden ser selectores de objetivo, nombres de jugador o cualquier nombre inventado como #total. * representa a todos los poseedores de puntuación registrados. Un selector que no encuentra nada falla con «No se han encontrado marcadores de puntuación relevantes». |
Ejemplos
/scoreboard objectives add kills playerKillCount "Kills"Crea un objetivo llamado kills que cuenta las bajas de jugadores y se muestra como Kills.
/scoreboard objectives add points dummyCrea un objetivo llamado points que solo cambia mediante comandos.
/scoreboard objectives setdisplay sidebar killsMuestra el objetivo kills en el lado derecho de la pantalla.
/scoreboard players set @s points 10Establece tu puntuación de points en 10.
/scoreboard players add @a points 1Añade 1 punto a cada jugador conectado.
/scoreboard players operation @s points += @s killsSuma tu puntuación de kills a tu puntuación de points.
/scoreboard objectives modify points numberformat styled {color:"gold"}Muestra todos los números del objetivo de puntos en dorado.
/scoreboard players reset @a pointsElimina la puntuación de puntos de cada jugador conectado.
