# Energy Modifiers

**URL:** https://heroiclabs.com/docs/hiro/concepts/energy/energy-modifiers/
**Keywords:** energy modifiers, hiro
**Categories:** hiro, energy-modifiers, energy

---

<figure class="float-right" style="max-width: 35%; border: 20px solid transparent; text-align: center;">
  <img 
    src="{{< fingerprint_image "/images/pages/hiro/concepts/energy/unlimited-life-bfmm.png" >}}" 
    style="width: 100%;"
  >
  <figcaption> Unlimited Life in Bud Farm Muchie Match by East Side Games </figcaption>
</figure>

# 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.

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

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

{{< table name="gdk.concepts.economy.reward-energy-modifier" >}}


To see how an "Energy Modifier" block can be used within a reward, please check [Rewards](../../economy/rewards/).

### Allowed operators 

{{< table name="gdk.concepts.economy.reward-energy-modifier-operators" >}}