Награды Берлоги (0.5)

Аутентификация токеном TalentOAuth пользователем Таланта. Передается в заголовке Authorization: Bearer в формате JWT.

Аутентификация токеном игрока Берлоги. Передается в заголовке Authorization.

Пагинация может быть представлена как параметром offset, так и параметром after. Параметр offset позволяет указать кол-во объектов для пропуска из читаемой выборки. В after указывается идентификатор, объекты с идентификатором равном или менее указанному будут исключены из выборки.

Предпочтительно, когда есть возможность, использовать after. Так же надо учитывать, что допустимое значение для offset имеет ограничения.

Традиции Берлоги. Прогресс по ним растет за счет игровых активностей.

Инструменты Берлоги. Прогресс по ним зависит от баллов компетенций Конструктора Калькуляторов пользователя Таланта, авторизованного для игрока.

Прогресс пользователя по традициям и инструментам.

Награды, выдаваемые за прогресс по традициям и инструментам.

Полученные пользователем награды за достижение пороговых баллов, сохраненных в прогрессе пользователя.

Испытания для игровых активностей.

Агрегатные (они же комплексные) испытания, вычисляются для групп игровых активностей.

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

Для вычисления балла цели используется объявленная для нее формула. Формула записывается одной строкой из последовательности арифметических операций.

Формат записи формул (по расширенной форме Бэкуса - Наура):

Формула = Операнд, {Операция}

Операция = Оператор, {ОпцПробел}, Операнд
Оператор = "+" | "-" | "*" | "/"
ОпцПробел = " " | "\t"
Операнд = ГруппаОпераций | Число | ИмяПеременной | АгрегатнаяФункция

ГруппаОпераций = "(", {ОпцПробел}, Операнд, {{ОпцПробел}, Операция}, {ОпцПробел}, ")"

Число = ["-"], Цифра, {Цифра}, [".", Цифра, {Цифра}]
Цифра = "0" | ... | "9"

ИмяПеременной = ПростоеИмя | Префикс, "|", ПростоеИмя | Префикс, "|", РасширенноеИмя
Префикс = "a" | "c" | "m"
ПростоеИмя = ЛатБуква, {ЛатБуква | Цифра | "." | "_"}
РасширенноеИмя = "[", СимволРасширенногоИмени, {СимволРасширенногоИмени}, "]"
СимволРасширенногоИмени = ЛатБуква | Цифра | "." | "_" | " " | "\t" | "+" | "-" | "*" | "/"

АгрегатнаяФункция = ИмяФункции, "{", РасширенноеИмя, "}"
ИмяФункции = "sum" | "min" | "max" | "avg" | "mean" | "count"

Префикс в имени переменной указывает на то, к чему она относится:

• a - свойства активности
• m - метрики активности
• c - числовые свойства контекста, к которому относится активность

Переменные без префиксов указывают не на активности и их свойства, а на результаты целей. Соответствующие имена должны быть заполнены в целях, а использовать их можно только в формуле испытания.

Пример формулы цели:

(( (max{m|duration} / count{*}) / mean{m|health} ) * 100) + (max{c|level} * 10)

Пример формулы испытания (с двумя целями, объявляющими указанные имена переменных):

match_rating + (max_bonus_level * 10)

Для целей назначаются агрегатные формулы, но и для самого испытания можно назначить формулу. Это будет итоговая формула, вычисляющая финальный балл на основе результатов вычислений в целях. В итоговой формуле нельзя использовать агрегатные функции. В качестве имен доступны только имена переменных указанные в целях. Итоговая формула опциональна только при наличии одной цели, иначе - для публикации испытания потребуется ее заполнить.

Перед записью формулы можно выполнить ее валидацию отдельной операцией.