> For the complete documentation index, see [llms.txt](/llms.txt)

# Idle Rewards

Accrues and grants rewards that build up while the player is away.




**About this demo**

The demo signs in automatically with an anonymous account. The account is shared across every demo in the showroom, so items and currency you get in one demo carry over to the others. Loading takes a moment. If the frame is too small, open the demo in a new tab.

## Overview

This demo uses GS2-Idle to work out and grant the rewards that build up while the player is away. Every 5 minutes away is worth 5 coins, every 12th interval (once an hour) is worth 50 instead, and the count stops at 8 hours. Buttons move your clock forward so hours away happen at once, and the coins you receive land in a GS2-Money2 wallet.

## How to try it

1. Read the **Rule** under **Idle rewards**. **Idle time** shows how long you have been away out of the 8-hour cap, **To receive** shows the coins you could take now, and **Next reward** counts down to the next payout.
1. Press **Advance one hour** to move your clock on GS2 forward one hour. **Demo clock** moves ahead, and **To receive** gains an hour's worth: 11 intervals of 5 coins plus 50, for 105 coins.
1. Press **Receive**; the coins go into **Free balance** under **Where the coins land**, and the idle count starts again from zero. Minutes short of a full 5-minute interval are dropped.
1. Press **Advance eight hours** to reach the 8-hour cap; **Idle time** reads **(full: receive to start counting again)**, and moving the clock further does not add to **To receive**.

The advance buttons change your account's time offset. The account is shared by every showroom demo in the same browser, so the moved clock carries over to the other demos too.

## GS2 services used

- [GS2-Idle](/microservices/idle/): A GS2-Idle category defines the 5-minute interval, the 480-minute cap and the twelve interval rewards, and works out and grants what each player's time away has earned.
- [GS2-Money2](/microservices/money2/): Receiving the idle reward deposits free currency into a GS2-Money2 wallet (slot 0), which is shown as **Free balance**.

## Use it in GS2 Studio

In GS2 Studio's Simple mode, open **Add features** and press **Add** on **Idle Rewards** to bring this feature into your own project. To point at the package directly, choose **Add from GitHub** and enter the package below.

```text
https://github.com/gs2io/gs2-studio-package/tree/main/foundation-economy-idle/packages/foundation-economy-idle
```

- Owner: `gs2io`
- Repository: `gs2-studio-package`
- Subdirectory: `foundation-economy-idle/packages/foundation-economy-idle`

## Source code

- Demo project: <https://github.com/gs2io/gs2-studio-package/tree/main/foundation-economy-idle/live-demo>
- Feature package: <https://github.com/gs2io/gs2-studio-package/tree/main/foundation-economy-idle>



