Energy Modifiers

Overview #

Energy modifiers temporarily change the limits set by a game’s energy system. In Hiro, energy modifiers are part of reward definitions.

Energy systems assign a set amount of energy or stamina that players spend to unlock or play content. Games automatically refill energy over time according to predefined rules—for example, restoring one “Life” every 30 minutes. Energy modifiers let you adjust these refill rules.

Use cases #

• Infinite energy for a limited time — for example, giving players one hour of unlimited energy after a store purchase or achievement reward.
• Double the refill rate — for example, reducing the refill time from 30 minutes to 15 minutes.
• Increase max energy capacity — for example, Season Pass owners may have 8 lives instead of 5 for the duration of the season.

Configuration #

Energy modifiers are configured within reward definitions. Any system capable of granting rewards—such as Economy, Achievements, or Event Leaderboards—can grant an energy modifier.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11

{
  "energy_modifiers": [
    {
      "id": "stamina",
      "operator": "infinite",
      "duration_sec": {
        "min": 21600
      }
    }
  ]
}

The following table lists all fields available in an energy modifier:

To see how an “Energy Modifier” block can be used within a reward, please check Rewards.

Allowed operators #