Achievements #
Achievement systems are a great tool for game designers to use to create a sense of progression and reward for players. It can be used to unlock new content, provide a sense of accomplishment, and reward players for their progress.
An “achievement” represents a player task which can be completed and, on completion, can unlock a reward. The reward can be in-game currency, collectables, energy, energy modifiers, or consumables.
Achievements can be configured to repeat on a schedule, or to repeat automatically when the player completes the task. They can also be one-off achievements which are only completed once.
For increased player engagement and larger sense of progression, achievements can be configured to have a precondition. This means that the achievement cannot be completed until one or more other achievements have been completed.
Achievements can also be configured to have any number of sub achievements. Sub achievements are nested, hierarchical achievements that can be used for progressive rewards.
Customization Parameters #
The following JSON represents the customization parameters you can use to configure the default user experience for the achievements system.
|
|
The JSON schema defines an achievements
object which must contain an individual object for each achievement you wish to define in the system. You can configure as few or as many achievements and sub-achievements as needed for your desired gameplay.
Property | Type | Description |
---|---|---|
achievements | string:Achievement | A map of all achievements. |
Each individual achievement is keyed by id and may define the following:
Achievement #
Property | Type | Description |
---|---|---|
auto_claim | bool | Whether the achievement reward should be given automatically upon completion. |
auto_claim_total | bool | Whether the achievement total reward should be given automatically upon completing this and all sub-achievements. |
auto_reset | bool | Whether the achievement should reset after completion. |
category | string | The category name for this achievement. |
count | int64 | The initial count towards progress for this achievement. |
description | string | The description for this achievement. |
reset_cronexpr | string | The reset interval in CRON format. |
duration_sec | int64 | How long (in seconds) this achievement is available for progression after creation. Used for limited time achievements. |
max_count | int64 | The number of times this achievement can be progressed before it can be claimed. |
name | string | The display friendly name of this achievement. |
precondition_ids | []string | Achievement IDs the user must have completed to qualify for starting this achievement. |
reward | Reward | The rewards a user should receive once they complete this achievement. |
total_reward | Reward | The rewards a user should receive once they have completed this achievement and all sub achievements. |
sub_achievements | string:SubAchievement | A map of nested achievements. |
additional_properties | string:string | A map of key value pairs that can contain additional context. |