Квесты в игре: ежедневные задания и награды

Что видит игрок

• Циклы вкладками: ежедневные, еженедельные, достижения, с таймером до следующего цикла.
• Полосы прогресса у каждого задания и окно с подробностями и всеми целями.
• Кнопку «Забрать всё» для выполненных заданий.
• Трек очков с сундуками, которые открываются по мере набора очков.
• Значок на вкладке, когда есть выполненные задания.

Как устроены квесты

• Цикл - набор заданий с расписанием: ежедневный, еженедельный, постоянный или событие на время. Цикл может идти фазами одна за другой, например сезон из восьми недель, у каждой недели свои задания и свой трек очков.
• Квест - одна или несколько целей, у каждой цели свой счётчик («победить 20 монстров»), и награда. Можно требовать, чтобы перед ним был выполнен другой квест: так строятся цепочки.

Наград три вида, и все работают одновременно:

1. Награда за квест - когда все цели выполнены.
2. Сундуки на треке очков - забранный квест добавляет очки цикла, сундук открывается при наборе нужного числа.
3. Бонус за группу - когда выполнено заданное число квестов одной группы.

Откуда берётся прогресс

Для разработчиков

Квесты работают через client.quest из @idosgames/core. Прогресс отправляется по имени счётчика, а не по квесту: сервер сам раздаёт его всем активным заданиям, которые слушают этот счётчик.

// В месте действия: победа над монстром
await client.quest.addQuestProgress('monsters_defeated', 1)

// Экран заданий: прогресс игрока, циклы обновляются сами
const state = await client.quest.getUserQuestState()

// Забрать награду выполненного квеста
const claim = await client.quest.claimQuestReward('daily_win_20', 'daily')
if (!claim.ok) return showError(claim.error)

• Через addQuestProgress можно двигать только цели с источником «игра». Цели, которые сервер считает сам, этот вызов отклонит.
• Не отправляйте значение «с запасом»: если у цели задан максимум за один вызов, превышение блокирует аккаунт игрока.
• Начисленные награды уже применены к балансам в кэше SDK, перечитывать баланс не нужно.

Подробное описание полей - в навыке quest-system, его отдаёт MCP-сервер SDK.