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

Добавление достижений в игру

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

Добавление достижений

Мы постарались сделать добавление достижений максимально удобным. Чтобы добавить достижение нужно перейти в управление достижениями вашего проекта.

Затем нужно кликнуть по кнопке Add achievement и откроется форма добавления.

Рассмотрим все поля по порядку.

  1. Tag — необязательный тег для более удобного выбора достижения. Вы можете выбирать достижения через числовой ID или через тег. Например можно использовать тег COLLECT_COINS_100 с говорящим названием, вместо ID: 17561.

  2. VK mission ID — номер мисси в VK Direct Games. Поле видно, когда есть платформа Вконтакте. Вы можете ввести сюда любое положительное число > 2 соотвествующее номеру миссии. Тогда при разблокировании достижения сразу будет выполнена миссия Вконтакте.

    info

    Необходимо добавить Сервисный ключ в настойках площадки VK, чтобы можно было разблокировать миссию.

  1. Name — Название достижения. Может быть переведено на любой доступный язык. Обязательное поле.
info

Не обязательно заполнять поле на английском, если игра ориентирована только на другой язык. Если у пользователя будет русский язык, то система сначала поищет перевод на русском, а затем английском, если перевод не найден. В это поле сразу можно писать на нужном вам языке.

  1. Description — Описание — как получить достижение. Может быть переведено на любой доступный язык. Необязательное поле.

  2. Rarity — Редкость достижения. Расстановка редкости ложится на ваши плечи. Вы можете отобрать легкие, тяжелые и очень тяжелые достижения и расставить им редкость. Вы можете интерпретировать редкость по своему, экспериментируйте.

  1. Icon — Иконка достижения. Мы рекомендуем загружать иконку размером не менее 256x256. Но запрета на иконки меньшего размера нет, так же как и большего. Это всё на ваше усмотрение.

  1. Icon pack — Готовый набор иконок для достижений. Если у вас нет под рукой иконок, то вы можете без проблем воспользоваться нашим набором. В нем более 60 иконок и со временем список пополняется.

  1. После того как все заполнено жмем кнопку добавить и все готово!

Ниже пример заполненной формы:

Добавление группы достижений

После создания достижения — оно переместилось в группу Несгруппированные. Там хранятся все достижения, которым еще не присвоена группа. Игрок их видит под названием Остальные после всех перечисленных групп.

Чтобы как-то охарактеризовать достижения, а так же иметь возможности их расставлять в приоритете — необходимо объединить их в группу.

Создадим группу. Поля работают аналогично достижению.

Созданная группа:

Теперь можно создавать достижения прямо внутри группы. Или можно переместить достижение в нужную группу с помощью Drag&Drop. Можно также открыть редактирование достижения и вручную выбрать группу для переноса.

Если у вас несколько групп — достижения можно перетаскивать из группы в группу. А сами группы можно сортировать с помощью стрелок.

Просмотр достижений в игре

В игре можно открыть оверлей с достижениями с помощью соответствующего метода.

gp.achievements.open();

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

Вы можете ставить на паузу игру или выключать звук, когда окно с достижениями откроется. Если достижение разблокируется в ходе геймплея, то пользователь захочет нажать на достижение, чтобы посмотреть подробнее. В таком случае лучше приостановить игру. А продолжить при закрытии оверлея.

gp.achievements.on('open', () => {
game.pause();
audio.mute();
});

gp.achievements.on('close', () => {
game.resume();
audio.unmute();
});

Вы можете отрисовывать список достижений самостоятельно в игре, подробнее в документации.

Получение достижений в игре

Разблокировать достижения можно с помощью соответствующего метода. Вы можете передать как ID, так и тег, как удобно.

gp.achievements.unlock({ tag: 'COLLECT_COINS_100' });

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

На странице проекта вы можете видеть 5 последних разблокированных достижений.

Модерация игроков

Властью, данною вам по праву — вы считаетесь полноценным администратором игры. А значит вам решать кому давать достижения, а у кого забирать.

На самом деле управление достижениями игроков позволит решать проблемы с возможными ошибками получения достижений или читерством.

Вы можете найти игрока в списке и открыть его список достижений.

В этом окне можно управлять достижениями игрока. Блокировать или разблокировать их. Имейте ввиду, что через панель управления нельзя засчитать миссию Вконтакте. Только на стороне игрока непосредственно в игре.

tip

Это отличный способ проверять достижения при тестировании игры. Вы можете получить достижение в игре и отменить его в панели.

На этом можно закончить знакомство с достижениями. Желаем вам успехов!

Оставайтесь на связи

С другими разделами документации вы можете ознакомиться здесь. Для начала работы вы можете ознакомиться с нашими туториалами.

Сообщество GamePush в Telegram: @gs_community.

Для ваших обращений e-mail: [email protected]

Желаем вам успехов!