> For the complete documentation index, see [llms.txt](https://xshyotsus.gitbook.io/plugins-wiki/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://xshyotsus.gitbook.io/plugins-wiki/free-plugins/therewards/layouts.md).

# Layouts

## Layouds (Designs)

Here you can find some ready-made designs that you can use in your configuration.

```yaml
inventories:
  streak:
    rewards:
      config:
        slots: 0,9,18,27,28,29,20,11,2,3,4,13,22,31,32,33,24,15,6,7,8,17,26,35,44,53
```

<details>

<summary>Image</summary>

<img src="https://2378482508-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9Q0liUc1cG2fPH7wdw4j%2Fuploads%2Fmxx6DwoDKungJgtkK6M7%2Fimage.png?alt=media&amp;token=3c8e2942-fc31-42f4-af56-c00f991a79ef" alt="" data-size="original">

</details>

***

```yaml
inventories:
  streak:
    rewards:
      config:
        slots: 3,4,5,11,12,13,14,15,19,20,21,22,23,24,25,28,29,30,31,32,33,34,38,39,40,41,42,48,49,50
```

<details>

<summary>Image</summary>

<img src="https://2378482508-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9Q0liUc1cG2fPH7wdw4j%2Fuploads%2FFIM3EjxeL8wKhiSgSCYs%2Fimage.png?alt=media&amp;token=03503c12-29e4-41b8-a807-75506975ee72" alt="" data-size="original">

</details>

***

```yaml
inventories:
  streak:
    rewards:
      config:
        slots: 18,27,36,45,46,47,38,29,20,11,2,3,4,13,22,31,40,49,50,51,42,33,24,15,6,7,8,17,26,35
```

<details>

<summary>Image</summary>

<img src="https://2378482508-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9Q0liUc1cG2fPH7wdw4j%2Fuploads%2FmUlM0agvPKJ7hS0U885V%2Fimage.png?alt=media&amp;token=02f6bc32-eca5-4cc8-81e9-f574348f3879" alt="" data-size="original">

</details>

***

```yaml
inventories:
  streak:
    rewards:
      config:
        slots: 3,4,5,10,11,12,13,14,15,16,19,20,21,22,23,24,25,29,30,31,32,33,38,39,40,41,42,48,49,50
```

<details>

<summary>Image</summary>

<img src="https://2378482508-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9Q0liUc1cG2fPH7wdw4j%2Fuploads%2FLX2PMt8eQ5tNoN6Xb7mx%2Fimage.png?alt=media&amp;token=eafa6bb7-577c-42e1-acdf-2e450c6781f5" alt="" data-size="original">

</details>

***

```yaml
inventories:
  streak:
    rewards:
      config:
        slots: 1,2,4,6,7,10,11,12,13,14,15,16,20,21,22,23,24,29,30,31,32,33,39,40,41,47,48,49,50,51
```

<details>

<summary>Image</summary>

<img src="https://2378482508-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9Q0liUc1cG2fPH7wdw4j%2Fuploads%2FVRMuCqJ5WAMbeeo7hQy6%2Fimage.png?alt=media&amp;token=2d741ba2-bdc6-46bd-b613-b19044098d18" alt="" data-size="original">

</details>

## Create PlayTime and Streak Rewards

In this guide, you'll learn how to configure rewards for the **PlayTime** (time played) and **Streak** (login streak) menus within the **TheRewards** plugin.

### 🎯 Goal

Set up visual and interactive rewards for players based on:

* Time connected to the server (**PlayTime**)
* Daily login streak (**Streak**)

### 📁 Configuration Structure

Rewards are defined inside the `layouts.yml` file, specifically in the sections:

* `inventories.streak.rewards.days`
* `inventories.playtime.rewards.times`

### 🧱 Configure Streak Rewards

#### ➕ Add a new day

```yaml
- day: 1
  rewards:
    name: |
      &7
      &7&8● &fDaily Reward
      &7
    actions:
      - '[command] give {player} minecraft:diamond 1'
      - '[message] &a✔ You have claimed the daily reward for logging in {day} consecutive day(s)'
    requirements:
      - placeholder: "%statistic_hours_played%"
        condition: ">="
        value: "5"
        success: "#4FFD4A ✔ Enough playtime. &7[Completed]"
        fail: "#FC3A3A ✖ You need to play at least 5 hours. &7[Not Completed]"
```

#### 📌 Important Fields

* `day`: Streak day number.
* `actions`: List of commands or messages to execute upon claiming.
* `requirements`: Optional conditions using placeholders.\
  You can omit the `requirements` section if no extra conditions are needed.

### ⏱️ Configure PlayTime Rewards

#### ➕ Add a new playtime reward

```yaml
- play-minutes: 60 # 1 Hour
  rewards:
    name: "&8● &fPlayed 1 Hour"
    actions:
      - '[command] give {player} minecraft:diamond 1'
      - '[message] &a✔ You have claimed the playtime {time}.'
    requirements:
      - placeholder: "%statistic_hours_played%"
        condition: ">="
        value: "5"
        success: "#4FFD4A ✔ Enough playtime. &7[Completed]"
        fail: "#FC3A3A ✖ You need to play at least 5 hours. &7[Not Completed]"
```

#### 📌 Important Fields

* `play-minutes`: Number of minutes required to claim the reward.
* `actions`: List of commands and messages to execute.
* `requirements`: Optional conditions using placeholders.\
  You can add as many reward blocks as you like—just make sure `play-minutes` is an integer greater than the previous one.

### 🎨 Visual Customization

Items in the menu are auto-generated, but you can customize their appearance from:

* `items.available`
* `items.waiting`
* `items.claimed`
* `items.unavailable`

In those sections, you can modify:

* `material`
* `display_name`
* `lore`
* `model_data`
* Custom textures using `basehead-<encoded_value>`

> ℹ️ More info: See the "[Material](/plugins-wiki/general/items-or-custom-items.md#item-or-material)" section on the wiki.

### 📎 Supported Actions

* `[command]`: Runs a command (you can use `{player}` for the player's name).
* `[message]`: Sends a message to the player.
* `[openmenu]`: Opens another TheRewards menu.
* `[close]`: Closes the menu.

> ℹ️ More info: See the "[Actions](/plugins-wiki/free-plugins/therewards/reward.md#actions-on-claim)" section on the wiki.