Guides / Commands & Data

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

Uma barra de chefão sobrevive a reinícios, mas um título não. Aqui está o padrão criar-e-modificar, os tempos de fade que as pessoas configuram ao contrário 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 são com 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, e depois comandos que o modificam. Pontos em que as pessoas tropeçam:

• A barra fica invisível até ter Jogadores. Criar uma e nunca executar set ... players não produz nada, sem erro.
• Ela persiste no save do mundo. Uma barra criada para um minigame ainda estará lá na próxima sessão. /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 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 aciona a aparição do par. 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 segundos de exibição, um segundo 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 hotbar. Ela ignora times completamente — ela aparece por alguns segundos fixos e desaparece. Reenviá-la a cada tick a mantém permanentemente, 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 esconde sem destruir o estado.

Crie 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.

Construtor de comandos avançados — Control e Debug →