# 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="/files/249v8pOrOafKQp8wYubQ" 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="/files/hT7VKK1Y6EDiLEjkAmrp" 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="/files/qeiqzvVwtPl21iU7Lk01" 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="/files/Bz8vTYiR3bpqVk7PCNSK" 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="/files/HR6WwFRZnD3em1JUUnjI" 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](/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](/free-plugins/therewards/reward.md#actions-on-claim)" section on the wiki.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.xshyo.us/free-plugins/therewards/layouts.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.