Skip to main content
Version: 5.7.0

Gamification

brainCloud's Gamification features provide server-side support common metagame elements, including:

  • Experience Points (XP) and Levels
  • Achievements
  • Milestones
  • Quests
  • Stats Events

These features build upon the Statistics APIs and a concept of Player Rewards.

Player Rewards

brainCloud provides an ability to reward players for completing meta-goals: leveling up, completing a milestone and/or completing quests. Rewards can consist of:

  • Achievements
  • Experience Points
  • Currencies
  • User Statistics
  • Global Statistics

XP Levels

brainCloud can manage experience points (XP) and levels, and reward the player for levelling up.

A player's XP starts at 0, and is incremented using methods of the Player Statistics service. A list of player XP levels can be read from the client using ReadXPLevelsMetaData.

Achievements

Achievements can be triggered manually, or as the result of player rewards. Achievements can be awarded directly using the AwardAchievements API. There are also API calls for retrieving the full list of achievements, and the list of achievements that have already been awarded for the player.

Milestones

Milestones are used to define conditions under which rewards are to be delivered. Milestones must first be unlocked before they can be completed and then awarded.

Milestones

Quests

Quests are essentially compound Milestones. The completion status of the Quest is derived from the completion status of the Tasks (i.e. embedded Milestones) that it is composed of.

Quests

API Summary

General

Achievements

Milestones

Milestone Management

The Milestone Management APIs are available from cloud-code only.

Quests

Quest Management

The Quest Management APIs are available from cloud-code only.

Resetting Milestone/Quest Status (useful when debugging)

The Rest APIs are available from cloud-code only.