Guias / Comandos e dados

Barras de chefão e títulos: estado persistente, tempos e a divisão valor/máximo

Uma barra de chefão sobrevive a reinícios, um título não. Veja o padrão de criar e modificar, os tempos de entrada e saída que costumam ser invertidos e como controlar uma barra de progresso.

2026-06-19

Ambos exibem texto na tela, e é aí que a semelhança termina. Títulos são "disparar e esquecer"; barras de chefão são objetos persistentes que você precisa gerenciar.

Barras de chefão têm estado

/bossbar add my:timer {"text":"Time left"}
/bossbar set my:timer players @a
/bossbar set my:timer max 600
/bossbar set my:timer value 600
/bossbar set my:timer color red
/bossbar set my:timer style notched_10

Um ID, depois comandos que o modificam. Pontos em que as pessoas se atrapalham:

• A barra fica invisível até ter jogadores. Criar uma e nunca executar set ... players não produz nada, sem erro.
• Ela persiste no salvamento do mundo. Uma barra criada para um minigame ainda estará lá na próxima sessão. Use /bossbar remove quando terminar, ou elas se acumulam.
• value e max são separados, e a barra mostra value / max. Definir apenas value em uma barra cujo máximo ainda é 100 resulta em um preenchimento sem sentido.

Cores: pink white red orange yellow green blue purple. Estilos: progress notched_6 notched_10 notched_12 notched_20.

Controlando uma contagem regressiva

/bossbar set my:timer value 599

uma vez por segundo a partir de uma função repetitiva é todo o mecanismo. Não há um temporizador embutido. Ler o valor de volta também é útil:

/execute store result score @s Left run bossbar get my:timer value

bossbar get suporta value, max, players e visible, o que torna uma barra de chefão uma variável global funcional quando você quer que o jogador a veja.

Títulos são transitórios

/title @a times 10 70 20
/title @a subtitle {"text":"Get ready"}
/title @a title {"text":"Round 2"}

Três coisas nessa ordem, e a ordem importa:

1. times primeiro. Definir depois do título não tem efeito no título já exibido.
2. subtitle antes de title. O subtítulo sozinho não exibe nada; enviar o título é o que faz o par aparecer. Invertido, o primeiro aparece sem subtítulo.

times é fadeIn stay fadeOut em ticks — 20 ticks por segundo. 10 70 20 é meio segundo de entrada, três e meio de exibição, um de saída. As pessoas definem 1 1 1 e se perguntam por que nada aparece: três ticks no total é um flash.

A barra de ação é separada

/title @a actionbar {"text":"Saved"}

A linha acima da barra de atalhos. Ela ignora times completamente — ela aparece por alguns segundos fixos e desaparece. Reenviá-la a cada tick a mantém permanentemente, o que é a maneira padrão de executar um HUD personalizado.

Limpando

/title @a clear remove o que está sendo exibido; /title @a reset também restaura os tempos padrão. Para barras de chefão, /bossbar set my:timer visible false oculta sem destruir o estado.

Construa barras de chefão, títulos e o restante dos comandos de controle e depuração a partir de um formulário no Construtor de Comandos Avançados — Controle e Depuração.

Gerador de comandos avançados — controle e depuração →