setup-augmentations

name	setup-augmentations
description	Add integrations to puzzmo.json with leaderboard configuration using deeds

Setup Augmentations

Add an integrations field to puzzmo.json that configures leaderboards and other meta-game features using the deeds defined in the previous step.

Steps

1. Add the integrations field to the existing puzzmo.json:

   {
     "$schema": "https://dev.puzzmo.com/schema/puzzmo-file-schema.json",
     "game": {
       "displayName": "Your Game",
       "slug": "GAMESLUG",
       "teamID": "TEAMID"
     },
     "integrations": {
       "leaderboards": [
         {
           "displayName": "Fastest Time",
           "stableID": "game-GAMESLUG:time",
           "order": "Lower=better",
           "deedID": "time",
           "formatString": "[time]"
         },
         {
           "displayName": "High Score",
           "stableID": "game-GAMESLUG:points",
           "order": "Higher=better",
           "deedID": "points",
           "formatString": "%@"
         }
       ]
     },
     "output": {
       "dir": "dist"
     }
   }
   

2. Replace GAMESLUG with the actual game slug (the directory name, lowercased).

3. Add leaderboards for each meaningful deed. The stableID format MUST be game-[gameslug]:[deed-id].

4. Choose appropriate formatString values:

   • "[time]" - Converts seconds to MM:SS format
   • "%@" - Shows the number with locale formatting
   • "%@ moves" - Appends a unit
   • "%@%" - Shows as percentage

5. Set order appropriately:

   • "Lower=better" for time, moves, errors
   • "Higher=better" for score, accuracy, streaks

Success Criteria

• puzzmo.json has an integrations field with valid configuration
• At least 2 leaderboards are configured
• All stableID values follow the game-slug:deed-id format
• formatString values are appropriate for each metric