Skip to main content
Version: 4.15.0

Gamification

Overview​

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 data-filled with the ids for platform achievements (on iOS, Steam, etc.) so that they may automatically be triggered in sync with brainCloud achievements.

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.

Last updated on by Jason Liang