Число (number)

Тип переменной: Целое число

Переменная этого типа предназначена для хранения целых чисел (как положительных, так и отрицательных). Идеально подходит для счёта, рейтингов, идентификаторов и любых других дискретных величин.

Как это работает

После создания переменной типа number (например, с именем score) в контексте person и присвоения ей значения, в логах появится структура:

"var": {
  "person": {
    "score": 125
  }
}

Здесь ёscore— это ваша переменная, а125` — её значение.

Как получить доступ к значению

Путь к числовому значению в реакциях:

${var.person.score}

Важно: При использовании в тексте сообщения число автоматически преобразуется в строку. Для математических операций используйте реакцию AddVarCloud или макрос !{math}.

Как изменять значение

Для работы с числовыми переменными используйте реакции:

SetVarCloud — устанавливает точное значение (заменяет старое). Пример: было 10, стало 5.
AddVarCloud — изменяет значение на указанную величину. Пример: было 10, прибавить 3 → станет 13.

Пример использования

Задача: Создать игровой счёт: за правильный ответ начислять +1 балл.

Шаг 1: Инициализация счёта.

При первом запуске бота (по команде /start) добавьте реакцию SetVarCloud.

Тип: person, Название: user_score, Значение: 0.

Шаг 2: Начисление балла.

В обработчике правильного ответа (например, нажатии на кнопку или команде) добавьте реакцию AddVarCloud.

Тип: person, Название: user_score, Значение: 1.

Шаг 3: Отображение счёта.

В любом сообщении используйте переменную:

Ваш текущий счёт: ${var.person.user_score} очков.

Что можно хранить в числе (number)

Количество баллов, монет, товаров
Возраст пользователя
ID заказа или любого объекта (если он состоит из цифр)
Количество попыток в викторине
Рейтинг или уровень