# Selectable Rewards

The player has the option to select their preferred reward from a list of available reward options. Once a reward is chosen, a cooldown is automatically applied to the other reward variants. This mechanic encourages strategic decision-making, as the player must consider the consequences of their choice and the timing of future opportunities to claim the other rewards.

{% hint style="info" %}
This can be used for every type of reward except for streak reward types
{% endhint %}

#### Example

<figure><img src="/files/qOkFjCTpunQOi17Msazj" alt=""><figcaption></figcaption></figure>

```yaml
enabled: true
type: time_reward
tag: Time Reward
cooldown: 24
cooldown-general-format: "%hours% hours"
cooldown-format: '%hours%:%minutes%:%seconds%'
available-after-first-join: false
live-reminder-enabled: true
required-slots: 3
permission: ultimaterewards.exampleTimeReward
available-item: CHEST_MINECART
available-display-name: '&a&lFIRST TIME REWARD'
available-lore:
  - '&7Can be obtained every &f%cooldown%'
  - ' '
  - '&7Contains:'
  - '&e ➪ 16x Gold Ingot'
  - ' '
  - '&e► Click to claim'
unavailable-display-name: "&7&lTIME REWARD"
unavailable-lore:
  - '&7Available in:'
  - '&7%cooldown%'
unavailable-item: MINECART
no-permission-item: BARRIER
no-permission-display-name: "&c&l&mTIME REWARD"
no-permission-lore:
  - "&c ✕ Locked, requires"
  - "&c   %permission% permission"
actions:
  100:
    - '[console] give %player% gold_ingot 16'
    - '[console] say %player% claimed their %type% reward!'
    #    - '[actionbar] &aSuccessfully claimed!' # Action bar can be used only from 1.12 versions!
    - '[title] &aClaimed'
    - '[subtitle] &aReward %type%'
    - '[message] &7Enjoy your claimed reward | New line!'
  20:
    - '[message] &a&lYou have been extra lucky today! Received 5 more diamonds!'
    - '[console] give %player% diamond 5'
variants:
  second:
    permission: ultimaterewards.timeRewardExample.second
    available-display-name: "&6&lSECOND TIME REWARD"
    available-lore:
      - '&7Can be obtained every &f%cooldown%'
      - ' '
      - '&7Contains:'
      - '&e ➪ 24x Iron Ingots'
      - ' '
      - '&e► Click to claim'
    actions:
      100:
        - '[console] give %player% iron_ingot 24'
        - '[console] say %player% claimed their %type% reward!'
        #    - '[actionbar] &aSuccessfully claimed!' # Action bar can be used only from 1.12 versions!
        - '[title] &aClaimed'
        - '[subtitle] &aReward %type%'
        - '[firework] colors:{FF0000;00FF00;0000FF},type:BALL_LARGE,power:3'
        - '[sound] BLOCK_CHEST_OPEN,volume:0.2,pitch:1'
  third:
    permission: ultimaterewards.timeRewardExample.third
    available-display-name: "&b&lTHIRD TIME REWARD"
    available-lore:
      - '&7Can be obtained every &f%cooldown%'
      - ' '
      - '&7Contains:'
      - '&e ➪ 2x Diamonds'
      - ' '
      - '&e► Click to claim'
    actions:
      100:
        - '[console] give %player% diamond 2'
        - '[console] say %player% claimed their %type% reward!'
        #    - '[actionbar] &aSuccessfully claimed!' # Action bar can be used only from 1.12 versions!
        - '[title] &aClaimed'
        - '[subtitle] &aReward %type%'
        - '[firework] colors:{FF0000;00FF00;0000FF},type:BALL_LARGE,power:3'
        - '[sound] BLOCK_CHEST_OPEN,volume:0.2,pitch:1'
```

In guis.yml:

```yaml
timeRewards:
  title: Time Rewards Menu
  sound: ANVIL_FALL
  rows: 4
  content:
    '11': exampleTimeReward:default
    '13': exampleTimeReward:second
    '15': exampleTimeReward:third
    '31':
      item: BARRIER
      name: '&cBack'
      lore:
      - '&7Return to the main menu'
      action: '[open] main'
```


---

# 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://ultimaterewards.athelion.eu/configuration/rewards/reward-features/selectable-rewards.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.