Генератор боссбаров: что делает каждая команда /bossbar

Проверено на версиях: Java Edition 1.13–26.3. В Bedrock Edition команды /bossbar нет.

Что выдаёт генератор

Для пресета Ritual charge получается так:

/bossbar add cube:ritual_charge {"text":"Ritual charge","color":"white"}
/bossbar set cube:ritual_charge color purple
/bossbar set cube:ritual_charge style notched_10
/bossbar set cube:ritual_charge max 100
/bossbar set cube:ritual_charge value 65
/bossbar set cube:ritual_charge players @a
/bossbar set cube:ritual_charge visible true

Как выбрать max, value и стиль

Боссбар показывает только долю, поэтому сначала решите, что значит одна единица. Для таймера max — длительность события в том, что считает ваш цикл обновления: секундах, если он срабатывает раз в секунду, или тиках, если каждый тик. Для ритуала, который наполняется подношениями, max — число подношений. Для рейда по этапам — число этапов.

Стили с делениями полезны, когда игрокам нужно считать. Выбирайте стиль, у которого число делений делится на ваш max без остатка: при четырёх фазах notched_12 даёт каждой фазе по три деления, а при notched_6 границы фаз попадают между засечками. Для обратного отсчёта и всего непрерывного лучше всего читается progress.

Четыре пресета — заготовки: Ritual charge (65 из 100), Raid phase II (фаза 2 из 4), Evacuation: 3 minutes (осталось 180 из 300 секунд) и Phase break incoming (8 из 12). Перед использованием смените ID, чтобы два события никогда не делили одну шкалу.

Чат, командные блоки или файл функции

• Чат. Вставляйте строки по одной: чат принимает одну команду за раз. Удобно, чтобы примерить вид шкалы до события.
• Командные блоки. По одной строке на блок. Настройку запускайте один раз: импульсные блоки за кнопкой или цепочка, которую стартует один импульсный блок. Не ставьте add в повторяющийся блок: со второго срабатывания команда падает, потому что шкала уже есть, а каждый set с тем же значением тоже возвращает неудачу и ломает условные цепочки.
• Файлы функций. В .mcfunction каждая команда пишется на своей строке без начального слэша. Уберите / из каждой строки генератора, иначе функция не загрузится.

Как менять шкалу по ходу события

Когда шкала уже создана, запускайте только ту строку, которая меняется:

/bossbar set cube:ritual_charge value 80
/bossbar set cube:ritual_charge name {"text":"The circle is complete","color":"gold"}
/bossbar set cube:ritual_charge color yellow

Чтобы шкала следовала за реальным числом, копируйте его из scoreboard каждый тик или каждую секунду:

execute store result bossbar cube:ritual_charge value run scoreboard players get #offerings ritual

Готовый обратный отсчёт на этом приёме разобран в статье про боссбары для событий. Для игроков, которые подключились посреди сцены, снова выполните /bossbar set cube:ritual_charge players @a, например в том же цикле. Если новых игроков нет, команда сообщит о неудаче — это безвредно.

Как убрать шкалу

Свои боссбары хранятся в мире (в level.dat), поэтому забытая шкала останется и после перезапуска сервера. Когда сцена закончилась:

/bossbar remove cube:ritual_charge
/bossbar list

list показывает все оставшиеся шкалы — запускайте после события, чтобы ничего не забыть. Если та же шкала понадобится завтра, visible false спрячет её и сохранит настройки.

Текст заголовка в разных версиях

Генератор пишет название как {"text":"…","color":"white"}. До 1.21.4 игра читает это как JSON. С 1.21.5 текстовые компоненты в командах записываются в SNBT, и такая запись остаётся верной, потому что SNBT допускает ключи в кавычках, — одна и та же строка работает по обе стороны изменения. Короткая форма {text:"…"} без кавычек работает только с 1.21.5. Если форматирование не нужно, подойдёт и обычная строка в кавычках, например "Ritual charge", — в любой версии.

Частые вопросы