Chat #7

# Objectives in Hawk *This guide is drawn from the [Objectives](https://tripledotstudios.atlassian.net/wiki/spaces/KB/pages/4124508203) documentation in the Knowledge Base.* --- ## What are Objectives? **Objectives** are a type of activity used in progression events within Hawk (Tripledot's LiveOps system). In an Objective, players work toward one or more goals with specific targets. When they reach these targets, they receive rewards. ### Understanding Activities In Hawk, **Activities** are the building blocks of events. They define what players do during an event and what rewards they earn. Activities can take several forms: - **Objectives** - Goal-based progression with targets and rewards (covered in this guide) - **Client Leaderboards** - Competitive ranking activities - **Collection Sets** - Item collection challenges - **Dynamic Races** - Race-style competitions - **Leagues** - Tiered competitive play Activities are configured within events and use templates to define their behavior and parameters. --- ## Configuration Overview  Configuring an Objective involves two main steps: 1. **Configuring an Objective Template** (Mandatory - requires Hawk team assistance) 2. **Specifying the Objective Details** (You configure this yourself) --- ## Step 1: Configuring an Objective Template **Before you begin**, you must request an Objective Template from the Hawk team. You cannot create objectives without a template. ### Template Requirements - Work with your Client Development Team, Business Analysts, and Product Managers to define the parameters for your template - The template comprises parameters that the Client Team will receive from Hawk in JSON format - Agreement on parameters must be reached before requesting template configuration For more details, see the [Activity Templates](https://tripledotstudios.atlassian.net/wiki/spaces/KB/pages/4124409886/Parameters+and+Activity+Templates#Activity-Templates) guide. --- ## Step 2: Specifying Objective Details ### Basic Configuration 1. Navigate to **Events > Objectives** in your game 2. Click **[+Add Objective]** 3. Configure the following fields: | Field | Description | Required | Notes | |-------|-------------|----------|-------| | **Name** | Identifying name for your objective | Yes | Internal reference | | **Availability** | Status of the objective | Yes | Options: Pre-live or Live | | **Objective Template** | Template defining the objective behavior | Yes | Must select from existing templates or request a new one | | **Parameters** | Configuration values from the template | Varies | Depends on the selected template | ### Adding Final Rewards 4. Click **[+Add]** next to **Final Rewards** 5. Select the reward(s) for completing the entire objective 6. You can add multiple rewards **Note**: Selectable rewards are Game Items. To create new ones, navigate to Game Server > Your Application > Game Items. ### Adding Objective Goals **Objective Goals** are progress thresholds that players must complete to reach the final reward. Each goal includes: - A **target** (required) - The numeric value players must reach - **Rewards** (optional) - Items awarded when this goal is completed - **Parameters** (optional) - Settings that differentiate goals (e.g., difficulty, special tile frequency) **To add goals:** 7. Click **[+Add Goal]** 8. Configure the following: | Field | Description | Required | Notes | |-------|-------------|----------|-------| | **Target** | The threshold value for this goal | Yes | Numeric value | | **Goal Template** | Pre-configured template for this goal | No | See Activity Templates guide | | **Rewards** | Items earned on completion | No | Can add multiple rewards | | **Localisation Keys** | Translation keys for UI text | No | For multi-language support | 9. Click **[Save]** when finished **Requirements**: At least one Objective Goal is mandatory. You can add as many goals as needed. --- ## Using Objectives in Events Once configured, you can select Objectives as an activity type when creating or editing events: 1. While configuring an event, select **"Objectives"** as the activity type 2. Use the **Activity Configuration** dropdown to choose from your configured objectives For more information on event configuration, see [Configuring Events](https://tripledotstudios.atlassian.net/wiki/spaces/KB/pages/3583279198/Configuring+Events). --- ## Requesting New Templates ### Objective Templates To request a new Objective Template, contact the Hawk team. You must: - Define required parameters with your Client Development Team, Business Analysts, and Product Managers - Reach agreement on all parameters before requesting configuration - Understand that templates will deliver parameters to the Client Team in JSON format ### Goal Templates Goal Templates are optional and can make individual goals within an objective unique. Request these from the Hawk team following the same process as Objective Templates. See the [Parameters and Activity Templates](https://tripledotstudios.atlassian.net/wiki/spaces/KB/pages/4124409886/Parameters+and+Activity+Templates) guide for comprehensive details on template configuration. --- ## What's Not Covered This documentation focuses on the configuration mechanics of Objectives. The following topics are not covered here: - Specific parameter definitions for different game types (these are defined in collaboration with your teams) - Client-side implementation details for rendering objectives - Analytics and performance tracking for objectives - Advanced parameter customization beyond template selection - Integration with other Hawk features like [Recurring Events](https://tripledotstudios.atlassian.net/wiki/spaces/KB/pages/4124311574/Recurring+Events) or [A/B Experiments](https://tripledotstudios.atlassian.net/wiki/spaces/KB/pages/3319988247/A+B+Experiments+in+Hawk) For additional Hawk documentation, visit the [Hawk Guides](https://tripledotstudios.atlassian.net/wiki/spaces/KB/pages/2916679818) page.