Атрибуты участников

Атрибуты участников — хранилище данных, используемое для хранения какой-либо информации, относящейся к конкретному участнику.

Они представлены методом getAttribute и свойством attributes у типа Member.

Внимание

В рамках выполнения одного шаблона сообщения допускается обращение максимум к 5 атрибутам участников.

Активный бонус на сервере увеличивает этот лимит до 10 атрибутов.

Сохранение данных

Для сохранения каких-либо данных в атрибуты следует использовать метод update:

---

{% do member.getAttribute('example').update('Hello World!') %}

Вы можете увеличить или уменьшить числовое значение атрибута на указанное число, используя методы increment и decrement:

---

Увеличение значения:

{% do member.getAttribute('example').increment(1) %}

Уменьшение значения:

{% do member.getAttribute('example').decrement(1) %}

Информация

Если вы хотите хранить какие-то данные, не привязанные к конкретному участнику, вы можете использовать атрибуты самого бота. Доступ к ним можно получить через предопределённую переменную bot вместо member.

Запрос данных

Атрибуты хранятся бессрочно и доступ к ним можно получить следующими способами:

---

{{ member.getAttribute('example').value }}

Очистка данных

Для очистки атрибута следует использовать метод clear:

---

{% do member.getAttribute('example').clear() %}

Вы можете очистить атрибуты с указанным ключом у всех участников с помощью метода clearAttributes у типа данных Guild:

{% do guild.clearAttributes('example') %}

Если вы хотите очистить вообще все атрибуты на сервере, воспользуйтесь методом clearAllAttributes у типа данных Guild:

{% do guild.clearAttributes() %}