Heroic Labs Documentation

Subachievements #

Subachievements are used to reward players for completing multiple achievements in Guild Wars 2 by ArenaNet.
Subachievements are used to reward players for completing multiple achievements in Guild Wars 2 by ArenaNet.

Subachievements can be used to enhance the player experience by creating a reward ladder, with each subachievement granting an increasingly valuable reward as the player progresses.

Subachievements belong to a parent achievement and can have their own associated reward, and a “total completion” reward for when all subachievements have been completed. For example, the parent achievement could be “Complete this level” and the subachievements could be “Complete this level with 3 stars”, “Complete this level with 4 stars”, and “Complete this level with 5 stars”.

Example #

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51

{
    "achievements": {
        "adventureGuideVolumeOne": {
            "auto_claim": false,
            "auto_claim_total": false,
            "auto_reset": false,
            "name": "Adventure Guide: Volume One",
            "category": "Adventure Guide",
            "description": "Complete 14 of the 16 Adventure Guide: Volume One achievements.",
            "reset_cronexpr": "* * * * *",
            "duration_sec": 0,
            "count": 0,
            "max_count": 1,
            "reward": {},
            "sub_achievements": {
                "defeatingEnemiesI": {
                  "auto_claim": true,
                  "auto_reset": false,
                  "name": "Defeating Enemies I",
                  "category": "Adventure Guide: Volume One",
                  "description": "Defeat 10 enemies.",
                  "reset_cronexpr": "* * * * *",
                  "duration_sec": 0,
                  "count": 0,
                  "max_count": 1,
                  "reward": {
                    "currencies": {
                      "xp": 1000
                    }
                  },
                },
                "lootingEnemies": { 
                  // ...
                },
                "usingWaypoints": {
                  // ...
                },
                // ...
            },
            "total_reward": {
                "consumables": {
                    "tomeOfKnowledge": 1
                },
                "currencies": {
                    "gold": 1000,
                    "xp": 10000
                }
            }
        }
    }
}