Search
K

Quests Implementation

In order for us to set up a Quest for a game within the Treasure Platform, the following details will need to be collected (see here for a Google Sheets template to provide quests in bulk).
  1. 1.
    Quest Name
  2. 2.
    Name of the associated game
  3. 3.
    Quest Description: A non-technical definition of what a player needs to do to achieve this quest (73 character limit is preferred).
  4. 4.
    Technical Quest Criteria: Technical information and definition of criteria. Please provide quest status info for a walletAddress using one of the following methods:
    1. 1.
      [Option 1] Provide us contract info (contract address + function call parameters) to indicate whether a user with walletAddress has completed the quest.
    2. 2.
      [Option 2] Provide us an API endpoint
      1. 1.
        Example API endpoint
      2. 3.
        You choose the questId (we'll make sure there are no naming collisions). A good convention is to name your quest after your game, like the-beacon-0001 .
// Response format.
interface Response {
walletAddress: string;
completed: boolean;
numerator: number;
denominator: number;
}
// Example response JSON.
{
"walletAddress": "0x1234....",
"completed": false,
"numerator": 4,
"denominator": 10
}
Here, numerator and denominator are used by our frontend to display partial progress (e.g., defeat 10 bosses, where the current walletAddress has defeated 4 /10 so far).
  1. 5.
    Required Items: (an optional field as some quests might not require that the user own a specific token/gamepiece to complete the quest) will display via tool tip with link to required asset
  2. 6.
    CTA Link: The URL that the player will need to navigate to to work on said quest
  3. 7.
    Badge (optional): to accompany this specific quest. See the Badge Design Guide and the Technical Implementation Guide for more details.
  4. 8.
    Quest Mechanics: To help us normalize rewards please provide approximate scores in the following categories:
    1. 1.
      Friction Score: On a scale of 1-10 with 10 being most friction, how much friction does a player need to go through in order to complete this quest?
    2. 2.
      Difficulty Score: On a scale of 1-10 with 10 being most difficult, how much skill does a player need to complete this quest?
    3. 3.
      Time Required: On average, how much time (in hrs) will a player need to commit to complete this quest?