Layouts

Layouds (Designs)

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

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

Image

---

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

Image

---

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

Image

---

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

Image

---

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

Image

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

- 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

- 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" 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" section on the wiki.