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

PreviousPlaceholderAPI SupportNextReward

Last updated