Comando
/scoreboard
Cria e gerencia objetivos do placar, define onde são mostrados e lê ou altera as pontuações de jogadores e outras entidades.
Sintaxe
| /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 | O que digitar |
|---|---|---|
| <objective> | Texto | O nome do objetivo. Com objectives add, é o novo nome, uma palavra sem espaços. Em todos os outros casos, deve ser um objetivo existente. |
| <criteria> | Critério do objetivo | O que o objetivo conta: dummy, trigger, deathCount, playerKillCount, totalKillCount, health, food, air, armor, xp, level, teamkill.<color>, killedByTeam.<color> ou uma estatística como minecraft.custom:minecraft.jump. |
| <displayName> | Componente de texto | O nome mostrado para o objetivo, escrito como componente de texto, como "Kills" ou {text:"Kills",color:"red"}. |
| <value> | Verdadeiro ou falso | true ou false para displayautoupdate. |
| <contents> | Componente de texto | O componente de texto mostrado no lugar do número com numberformat fixed. |
| <style> | Estilo do texto | O estilo de texto usado para o número com numberformat styled, por exemplo {color:"gold"}. |
| <slot> | Espaço de exibição | O espaço de exibição: list, sidebar, below_name ou sidebar.team.<color>. |
| <targets> | Detentor de pontuação | Os detentores de pontuação a alterar: um seletor de alvos, um nome ou * para todos os detentores de pontuação registrados. |
| <score> | Número inteiro | O número a definir (qualquer número inteiro), ou a quantidade a adicionar ou remover (0 ou mais). Pelo menos 0. |
| <name> | Componente de texto | O componente de texto mostrado no lugar do nome do detentor de pontuação com players display name. |
| <target> | Detentor de pontuação | Um único detentor de pontuação para players get e players list. |
| <targetObjective> | Objetivo do placar | O objetivo cuja pontuação é alterada pela operação players. Não pode ser somente leitura. |
| <operation> | Operação de pontuação | Um de =, +=, -=, *=, /=, %=, <, >, ><. |
| <source> | Detentor de pontuação | Os detentores de pontuação cujas pontuações são usadas como segundo valor em players operation. |
| <sourceObjective> | Objetivo do placar | O objetivo do qual as pontuações de origem são lidas. |
Detalhes
| Nível de permissão | 2: operadores, mundos com trapaças ativadas, blocos de comando e funções |
| Funciona em | Um jogador com cheats ativados, servidores multijogador, blocos de comando e funções. Exige o nível de permissão 2 (mestres de jogo): operadores, jogadores em um mundo com trapaças ativadas, blocos de comando e funções. |
| Resultado | Cada subcomando informa o que alterou. Resultados numéricos: objectives add e objectives remove retornam o número de objetivos que existem agora; objectives list retorna o número de objetivos; objectives setdisplay e objectives modify retornam 0. players get retorna a pontuação; players set, add, remove e operation retornam a soma das novas pontuações de todos os alvos; players reset e players display retornam o número de alvos; players enable retorna o número de alvos cujo trigger foi ativado agora; players list retorna o número de detentores de pontuação registrados, ou, com um alvo, o número de pontuações desse alvo. |
| objectives add | Cria um objetivo com um nome, um critério e um nome de exibição opcional. O nome é uma única palavra sem espaços. Sem nome de exibição, o próprio nome é mostrado. Falha com "Já existe um objetivo com esse nome" se o nome já está em uso. |
| Critérios | Critérios básicos: dummy (alterado apenas por comandos), trigger (os jogadores o alteram por conta própria com /trigger), deathCount, playerKillCount, totalKillCount, health, food, air, armor, xp, level. Critérios de equipe: teamkill.<color> e killedByTeam.<color> com uma cor de equipe como red ou dark_blue. Os critérios de estatística usam a forma minecraft.<type>:minecraft.<id> com os tipos broken, crafted, custom, dropped, killed, killed_by, mined, picked_up e used, por exemplo minecraft.mined:minecraft.stone ou minecraft.custom:minecraft.jump. |
| Critérios somente de leitura | health, food, air, armor, xp e level são mantidos atualizados pelo jogo. Suas pontuações não podem ser alteradas com players set, add, remove nem como alvo de operation: "Scoreboard objective ... is read-only". |
| objectives list e remove | objectives list mostra todos os objetivos. objectives remove apaga um objetivo junto com todas as suas pontuações. |
| objectives setdisplay | Mostra um objetivo em um espaço de exibição. Espaços: list (a lista de jogadores), sidebar (o lado direito da tela), below_name (abaixo das etiquetas de nome dos jogadores) e sidebar.team.<color> para uma barra lateral ligada à cor de uma equipe, com as cores black, dark_blue, dark_green, dark_aqua, dark_red, dark_purple, gold, gray, dark_gray, blue, green, aqua, red, light_purple, yellow e white. Omitir o objetivo limpa o espaço. Falha se o espaço já estiver vazio ou já mostrar esse objetivo. |
| objectives modify | displayname muda o nome exibido. rendertype alterna entre integer (números) e hearts (ícones de coração); health usa hearts por padrão e todos os demais integer. numberformat define a aparência padrão de todas as pontuações do objetivo. displayautoupdate true ou false liga ou desliga a atualização automática da exibição do objetivo. |
| Formatos de número | blank oculta o número. fixed <contents> mostra um texto fixo no lugar do número. styled <style> mostra o número com um estilo de texto como {color:"gold",bold:true}. Escrever numberformat sem nada depois remove o formato. As mesmas opções existem para um objetivo inteiro (objectives modify ... numberformat) e para cada detentor de pontuação (players display numberformat). |
| players set, add, remove | set dá a uma pontuação qualquer número inteiro de -2147483648 a 2147483647. add e remove aceitam uma quantidade de 0 ou mais e mudam a pontuação atual por ela. Um alvo que ainda não tem pontuação começa em 0. |
| players get e list | get mostra a pontuação de um alvo e falha com "Can't get value of ... for ...; none is set" se não houver nenhuma. list sem alvo mostra todos os nomes rastreados; com um alvo mostra todas as pontuações desse alvo. |
| players reset | Remove a pontuação dos alvos em um objetivo, ou todas as pontuações deles quando nenhum objetivo é indicado. Uma pontuação redefinida deixa de estar definida, o que é diferente de 0. |
| players enable | Permite que os alvos usem /trigger uma vez em um objetivo com o critério trigger. Falha com "A função enable só funciona em objetivos do tipo trigger" para outros objetivos e com "Nada mudou. Esse gatilho já está ativado" se nenhum alvo foi alterado. |
| players operation | Altera a pontuação de destino usando uma pontuação de origem. Sinais: = define o alvo como a fonte, += soma, -= subtrai, *= multiplica, /= divide (arredondado para baixo), %= deixa o resto da divisão (nunca negativo para um divisor positivo), < mantém o menor dos dois, > mantém o maior, >< troca as duas pontuações. Dividir por 0 falha com "Você não pode dividir por zero". Com várias fontes, a operação é aplicada uma vez para cada fonte. |
| players display | display name dá a um detentor de pontuação outro nome na exibição do placar para um objetivo; sem o nome, ele é removido. display numberformat muda a aparência do número desse detentor nesse objetivo. |
| Detentores de pontuação | Os alvos podem ser seletores de alvo, nomes de jogadores ou qualquer nome inventado, como #total. * representa todos os detentores de pontuação rastreados. Um seletor que não encontra nada falha com "Nenhum detentor relevante da pontuação encontrado". |
Exemplos
/scoreboard objectives add kills playerKillCount "Kills"Cria um objetivo chamado kills que conta jogadores mortos e é exibido como Kills.
/scoreboard objectives add points dummyCria um objetivo chamado points que só muda por meio de comandos.
/scoreboard objectives setdisplay sidebar killsMostra o objetivo kills no lado direito da tela.
/scoreboard players set @s points 10Define sua pontuação de points como 10.
/scoreboard players add @a points 1Adiciona 1 ponto a cada jogador online.
/scoreboard players operation @s points += @s killsSoma a sua pontuação de kills à sua pontuação de points.
/scoreboard objectives modify points numberformat styled {color:"gold"}Mostra todos os números do objetivo de pontos em dourado.
/scoreboard players reset @a pointsRemove a pontuação de pontos de cada jogador online.
