Перейти к содержимому
Руководство 05

Счётчики

Отслеживайте всё, что случается больше одного раза: смерти, объятия, активации наград. Настройте способ подсчета один раз, и бот запомнит его навсегда.

В этом руководстве
8 мин чтения

01Счётчики: числа, которые помнят

с первого взглядаОдин токен, {counter:name}, прибавляет 1 и выводит итог. Счёт сохраняется от стрима к стриму.

Счётчик: именованное число, которое бот помнит от стрима к стриму. Напишите {counter:смерти} в ответе команды, и при каждом использовании бот прибавляет 1 к счётчику «смерти» и выводит новый итог прямо в ответе. Никаких таблиц и ручного подсчёта, только один токен.

Два вызова одной команды !смерть, один счётчик, который помнит оба.
Счётчикам нужны баллы лояльности Счётчики хранятся в модуле «Баллы лояльности». Сначала включите его, иначе {counter:…} останется обычным текстом в чате.

02Четыре способа считать

с первого взглядаВесь канал, по пользователям, по командам или оба варианта. Выберите один при создании: он останется таким.

У каждого счётчика ровно одна область. Она выбирается при создании и остаётся неизменной. Область отвечает на один вопрос: кому принадлежит это число?

ОбластьКлючевое словоЧто считается
Весь канал(по умолчанию)Один общий итог: все прибавляют к одному числу.
По пользователямuserУ каждого зрителя своё число.
По команде или наградеcommandОбщий итог для одной команды или награды, все зрители вместе.
По пользователям и команде или наградеuser+commandУ каждого зрителя отдельное число для каждой команды или награды.

Весь канал

Все прибавляют к одному общему числу. Это идеально для счёта, который принадлежит самому стриму, а не конкретному зрителю, например для счётчика смертей.

Неважно, кто напишет !смерть, общий итог канала продолжает расти.

По пользователям

У каждого зрителя есть личное число, которое никто другой не трогает. Подходит для личных серий: сколько объятий кто-то раздал, сколько раз он обыграл вас в игре.

Одна команда, два зрителя, два полностью раздельных счёта.

По команде или награде

Самая новая область: один общий итог для команды или награды за баллы канала, где все зрители прибавляют к одному общему числу. Идеально для вопроса «сколько всего раз активировали эту награду?»

Два разных зрителя, итог награды всё равно продолжает расти.

По пользователям и команде или награде

Объединяет оба варианта: у каждого зрителя отдельное число для каждой команды или награды, которая использует этот счётчик. Привяжите один счётчик к двум командам, и у каждого зрителя будет свой счёт по каждой команде, а не один общий на обе.

Счёт MikanMeerkat для !обнять и его счёт для !highfive не смешиваются, даже при одном счётчике.
Задаётся при создании Область счётчика нельзя изменить после создания. Выбрали неверно? Удалите счётчик (!counter delete имя или в панели управления) и создайте заново. Старые значения не сохраняются.

03Управление счётчиками из чата

с первого взглядаСоздавайте, прибавляйте, задавайте, сбрасывайте, удаляйте или просто спрашивайте, не выходя из чата.

Вы и ваши модераторы можете создавать и вести счётчики, не выходя из чата, всё через !counter:

КомандаЧто она делает
!counter create <имя> [область]Создаёт счётчик. Ключевое слово области: user, command или user+command; опустите его, чтобы счётчик считал для всего канала.
!counter add <имя> [количество]Прибавляет 1 или указанное количество. Отрицательные числа вычитают.
!counter set <имя> <значение>Задаёт итог напрямую.
!counter reset <имя>Обнуляет счётчик. Для счётчика по пользователям или по командам это удаляет все сохранённые значения.
!counter delete <имя>Полностью удаляет счётчик.
!counter listПоказывает все счётчики канала и их область.
!counter <имя>Показывает текущее значение так, как его видит чат.
Создание счётчика и его увеличение от начала до конца, без панели управления.
Область «по команде» из чата !counter create гидратация command создаёт счётчик, который считается по команде, в одну строку. Его можно вставить в ответ команды или привязать к награде за баллы канала, как {counter:гидратация}.
Попробуйте: прибавьте к счётчику

04Панель управления и награды за баллы канала

с первого взглядаСтраница «Счётчики» для прямого управления и то, как награда к ней привязывается.

Страница Счётчики показывает все счётчики канала. Их можно создавать, менять и удалять кликами, а не набором команд.

  • Имя: та же строка, которую вы написали бы в {counter:…}.
  • Область: задаётся при создании.
  • Краткое напоминание о том, откуда можно увеличивать счётчики.
Панель «Новый счётчик»: задайте имя, выберите область, готово. У существующих строк есть кнопки +/- для счётчиков всего канала или таблица значений для остальных.

Привязать счётчик к награде за баллы канала

Каждая награда «Баллы канала» может вести собственный счётчик прямо в редакторе награды: введите имя счётчика (нового или существующего), выберите его область, и каждая активация награды будет его увеличивать. Используйте {counter} в ответе чата для награды, чтобы показать новый итог.

  • По умолчанию выключено: большинству наград он не нужен.
  • «По пользователям и награде» часто лучший выбор: каждый зритель ведёт свой счёт активаций этой награды.
Блок счётчика в редакторе награды: переключатель, имя и те же четыре области.
Попробуйте в конструкторе Конструктор команд поможет назвать счётчик и выбрать его область, а затем вернёт готовый токен {counter:…}. Открыть конструктор команд