Me
How to configure version updates
Enki
# How to Configure Version Updates
Version updates allow you to manage game client updates and incentivize players to upgrade. The system offers two distinct approaches:
## Update Options
Version updates provides **2 configuration options**:
1. **App Updates** (soft updates) - Players can update at their convenience
2. **Force Updates** (for old clients only) - Mandatory updates for outdated clients
---
## Configuring App Updates
Follow these steps to set up an app update:
1. **Log into Harmony** and navigate to your game
2. Go to **Version Updates > App Updates** to view existing configurations
3. Click **[+New]** to create a new app update
4. Configure the following details:
- **Name** - A descriptive identifier for the update
- **Status** - Current state of the configuration
- **Priority** - Importance level of the update
- **Availability** - Choose between test or live environment
- **Active/Inactive status** - Enable or disable the configuration
5. **Select the update type** from the dropdown menu
6. **Add Rewards** (optional) - Incentivize players to update by offering rewards
- Click on the folder image and hover to see reward contents
- Configure specific rewards to motivate player updates
7. **Configure Rules** - Set up rules that determine which players receive this update configuration
8. **Save** your configuration
---
## Configuring Force Updates
Force Updates allow you to mandate updates for older client versions:
1. Navigate to **Version Updates > Force Update**
2. Click **[+New]** to create a new force update
3. **Select availability** - Choose between test or live environment
4. **Create rules** - Set up rules to determine which players receive the force update
5. **Save** your configuration
---
## Key Difference: Previous vs. Current Version
| Aspect | Previous Version | Current Version |
|--------|-----------------|-----------------|
| **Behavior** | Game Server sent an error code (3001) blocking player progression | Game Server sends an `/init` call with `update_required` parameter |
| **Player Impact** | Players were immediately blocked | Behavior is configurable client-side |
| **Response Format** | `{ "code": 3001, "message": "Update is required" }` | Returns full progress data with `update_required` object containing type and rewards |
The current version provides more flexibility by allowing client-side configuration of update behavior while still delivering necessary update information through the standard `/init` call.