**Introduction**

In this guide you’ll learn how to configure version updates and provide rewards to players for updating their game.

Version updates offers 2 options to update the game:

- App Updates (soft updates)

- Force Updates (old clients only)

* * *

# Configuring App Updates

1. Log on to Harmony.

2. In your game, navigate to **Version Updates \> App Updates**. You’ll see a list of the already existing entities. To create a new one, click **[+New].**

3. Add a name, status, priority, availability (test/live) and status (active/inactive).

4. Then, select from the dropdown the type of update:

5. In order to motivate players to update their game, you can offer **Rewards**. To configure Rewards:

To see the contents inside the rewards, hover over the folder image.

4. Configure rules to send your configuration to players and then save your configuration.


You can read more about rules [here](#).

| #### 📖 **What’s the difference between the old Force Update and the new one?** |

| --- |

| In the previous version of this feature, Game Server sent an error code, instead of sending an empty /init call, thus blocking the player from continuing the game. In this new version, Game Server will send an /init call with the parameter `update_required` and the type of update. The behaviour of the force update can be configured client-side. |

| **Previous version:** { "code": 3001, "message": Update is required } | **Current version:** "progress": { "version": 0, "install_id": null, "xp": 0, "level": 0, "balance": 0, "hard_balance": 0, "minimum_supported_version": "updated_at": 0 } "update_required": { "type": "force", "rewards": [] }, "progression_events": { "url": "https://game-server-staging-cdn. tripledotapi. com/api/v4/journeys?application_id=4; level_banks_mapping°5B376%5D=246;os_family=android; timestamp=1674139145" } "activation_events": { "url": "https://game-server-staging-cdn. tripledotapi. com/api/v4/activation_journeys?application_id=4; level_banks_mapping%5B1119%5D=276; level_banks_mapping®5B524%5D=139;os_family=android; timestamp=3348279710" |

* * *

# Configuring Force Updates (available for old clients only)

Force Updates allow you to assign a set of rules to force update the game. 

1. To configure a new Force Update, navigate to **Version Updates \> Force Update** and click **[+New].**

2. Select the availability of your force update (test/live), and create your rules to send the force updates to players.

3. Configure rules to send your configuration to players.

4. Save your configuration.