Достижения (Achievements)

Материал из Ren'Py Wiki
Перейти к навигации Перейти к поиску

Модуль достижений в Ren'Py позволяет разработчику предоставлять игроку достижения, сбрасывать их и определять, было ли достижение получено. Он также позволяет записывать прогресс на пути к достижению.

По умолчанию достижение хранит информацию в постоянном файле. Если поддержка Steam доступна и включена, информация о достижении автоматически синхронизируется со Steam.


achievement.Sync()

Действие, вызывающее achievement.sync(). Оно возникнет только, если достижения не синхронизированы.


achievement.clear(name)

Сбрасывает достижение с name.


achievement.clear_all()

Сбрасывает все достижения.


achievement.grant(name)

Предоставляет достижение с name, если оно ещё не было получено.


achievement.has(name)

Возвращает истинное значение, если игрок получил достижение с name.


achievement.progress(name, complete)

Сообщает о прогрессе на пути к достижению с name, если это достижение не было получено. Достижение должно быть определено со значением, необходимым для завершения.
name
Название достижения. Это должно быть название достижения, а не стата.
complete
Целое число, указывающее количество единиц, необходимых для завершения достижения.


achievement.register(name, **kwargs)

Регистрирует достижение. Достижения не обязательно регистрировать, но это позволяет передавать информацию на сервера.
name
Название достижения для регистрации.
Следующие ключевые параметры являются необязательными.
steam
Название для использования в Steam. Если не задано, по умолчанию используется name.
stat_max
Целочисленное значение стата, при котором достижение разблокируется.
stat_modulo
Если прогресс по модулю stat_max равен 0, то прогресс отображается для пользователя. Например, если stat_modulo равен 10, прогресс будет показан пользователю, когда он достигнет 10, 20, 30 и т.д. Если значение не задано, по умолчанию это 0.


achievement.sync()

Синхронизирует зарегистрированные достижения между локальным хранилищем и другими серверами (например, Steam).

Источник[править | править код]

Статья "Achievements" на английском языке.


На главную страницу Официальная документация движка Вернуться к началу статьи