UltimateRewards Wiki
  • Getting started
    • Support
  • Addons
  • Configs
    • Player Levels
    • Referrals
    • Loginstreak
  • USAGE
    • Installation
    • Commands
  • configuration
    • Rewards
      • Creating Reward
      • Reward Types
        • Afk Reward
          • World Afk Reward
          • Area Afk Reward
          • Region Afk Reward
        • Advent Calendar
        • Pickable Reward
        • Time Reward
        • Time Fixed Reward
        • Streak Reward
        • Streak Fixed Reward
        • Vote Reward
        • Renewable Vote Reward
        • Per Vote Reward
        • Streak Vote Reward
        • Play Time Reward
        • Renewable Play Time Reward
        • Referral Reward
        • Renewable Referral Reward
        • Purchasable Reward
        • Re-Purchasable Reward
        • One Time Reward
        • Time Limited Reward
        • Custom Reward
        • Multiple Custom Reward
        • Coupon Reward
        • Discord Reward
      • Reward Settings
      • Reward Actions
      • Reward Features
        • Auto Claim
        • Notifications
        • Reward NPC
        • Discord Support
        • Reward Requirements
        • Reward Variants
        • Selectable Rewards
        • Randomization
          • Execution Chances
          • Random Placeholders
        • AFK Checkers
        • Leaderboards
    • Menus
      • Basics
      • Example of GUIs
      • Setting Menu
    • Schedules & Timers
  • Colors & Models
  • Placeholders
  • API
    • Events
    • Examples
    • Setting up own playtime calculator
  • Policies
    • TOS
Powered by GitBook
On this page
  • Setuping the reward
  • General Settings
  • Cooldown Settings
  • Availability Settings
  • Item and Display Settings
  • Reward Actions
  • Variants (Optional)
  • Linking (displaying) a reward in the menu
  1. configuration
  2. Rewards

Creating Reward

Last updated 4 months ago

Setuping the reward

Rewards are located in the rewards folder, where each reward corresponds to one file. The file name then denotes the identifier of the reward.

General Settings

The tutorial is explained for the , note that each reward type has its own properties in addition to the - you can set these properties for each of the .

  1. Enable Reward Claiming

    enabled: true
    • enabled: Set to true to allow rewards to be claimable.

  2. Reward Type

    type: time_reward
    • type: Specifies the type of reward. All reward type are listed . Use time_reward for time-based rewards.

  3. Reward Tag

    tag: Time Reward
    • tag: A label for the reward, used for identification.

  4. (Optional) Reward Command

    command: timereward
    • command: The command by which the reward can be claimed, /timereward in this case.

Cooldown Settings

  1. Cooldown Duration

    cooldown: 24
    • cooldown: Number of units before the reward can be claimed again.

  2. Cooldown Unit

    unit: hours
    • unit: Unit of time for the cooldown (e.g., hours, minutes).

  3. General Cooldown Display Format

    cooldown-general-format: "%hours% hours"
    • cooldown-general-format: Format for displaying the general cooldown time.

  4. Specific Cooldown Display Format

    cooldown-format: '%hours%:%minutes%:%seconds%'
    • cooldown-format: Format for displaying the cooldown in reward GUIs.

Availability Settings

  1. (Optional) Available After First Join

    available-after-first-join: false
    • available-after-first-join: Set to true to make the reward available immediately after a player's first join.

  2. (Optional) Live Reminder

    live-reminder-enabled: true
    • live-reminder-enabled: Notifies players when the reward is available.

  3. (Optional) Required Inventory Slots

    required-slots: 3
    • required-slots: Number of free inventory slots required to claim the reward.

  4. (Optional) Permission Requirement

    permission: ultimaterewards.exampleTimeReward
    • permission: Permission node required for the player to claim the reward.

Item and Display Settings

  • Available Item Display

    available-item: CHEST_MINECART
    available-display-name: '&a&lTIME REWARD'
    available-lore:
      - '&7Can be obtained every &f%cooldown%'
      - ' '
      - '&7Contains:'
      - '&e ➪ 1x Diamond'
      - '&e ➪ 3x Gold Ingot'
      - '&e ➪ 6x Iron Ingot'
      - ' '
      - '&b► Click to claim'
    • available-item: Item displayed when the reward is claimable.

    • available-display-name: Display name for the available reward item.

    • available-lore: Lore description for the available reward item.

  • Unavailable Item Display

    unavailable-item: MINECART
    unavailable-display-name: "&7&lTIME REWARD"
    unavailable-lore:
      - '&7Available in:'
      - '&7%cooldown%'
    • unavailable-item: Item displayed when the reward is under cooldown.

    • unavailable-display-name: Display name for the unavailable reward item.

    • unavailable-lore: Lore description for the unavailable reward item.

  • No Permission Item Display

    no-permission-item: BARRIER
    no-permission-display-name: "&c&l&mTIME REWARD"
    no-permission-lore:
      - "&c ✕ Locked, requires"
      - "&c   %permission% permission"
    • no-permission-item: Item displayed when the player lacks permission.

    • no-permission-display-name: Display name for the no-permission reward item.

    • no-permission-lore: Lore description for the no-permission reward item.

  1. Commands Executed on Reward Claim

    actions:
      80:
        - '[console] give %player% diamond 1'
        - '[console] give %player% gold_ingot 3'
        - '[console] give %player% iron_ingot 6'
        - '[console] say %player% claimed their %type% reward!'
        - '[title] &aClaimed'
        - '[subtitle] &aReward %type%'
        - '[message] &7Enjoy your claimed reward | New line!'
      20:
        - '[console] give %player% diamond 1'
        - '[console] give %player% gold_ingot 3'
        - '[console] give %player% iron_ingot 6'
        - '[console] say %player% claimed their %type% reward!'
        - '[title] &aClaimed'
        - '[subtitle] &aReward %type%'
        - '[message] &7Enjoy your claimed reward | New line!'
        - '[message] &a&lYou have been extra lucky today! Received 5 more diamonds!'
        - '[console] give %player% diamond 5'
      • 80: Set of actions with 80% execution chance.

      • 20: Actions with a 20% execution chance.

  1. Reward Variants

    variants:
      premium:
        permission: ultimaterewards.timeRewardExample.premium
        available-display-name: "&6&lPREMIUM TIME REWARD"
        available-lore:
          - '&7Can be obtained every &f%cooldown%'
          - ' '
          - '&7Contains:'
          - '&e ➪ 3x Diamonds'
          - '&e ➪ 12x Gold Ingots'
          - '&e ➪ 24x Iron Ingots'
          - ' '
          - '&6► Click to claim premium reward'
        actions:
          80:
            - '[console] give %player% diamond 3'
            - '[console] give %player% iron_ingot 12'
            - '[console] give %player% gold_ingot 24'
            - '[console] say %player% claimed their %type% reward!'
            - '[title] &aClaimed'
            - '[subtitle] &aReward %type%'
            - '[firework] colors:{FF0000;00FF00;0000FF},type:BALL_LARGE,power:3'
            - '[sound] BLOCK_CHEST_OPEN,volume:0.2,pitch:1'
          20:
            - '[console] give %player% diamond 3'
            - '[console] give %player% iron_ingot 12'
            - '[console] give %player% gold_ingot 24'
            - '[console] say %player% claimed their %type% reward!'
            - '[title] &aClaimed'
            - '[subtitle] &aReward %type%'
            - '[firework] colors:{FF0000;00FF00;0000FF},type:BALL_LARGE,power:3'
            - '[sound] BLOCK_CHEST_OPEN,volume:0.2,pitch:1'
            - '[message] &6&lYou have been extra lucky today! | Received 10 more diamonds!'
            - '[console] give %player% diamond 10'
    • variants: Optional reward variants based on player permissions.

      • premium: Example variant with specific permissions and actions.

Linking (displaying) a reward in the menu

Each reward can be assigned a position in the spcific menu. In the case of rewards that have more than one position (Advent Calendar, Streak Rewards, Pickable Reward, etc...) you can specify individual sub-rewards.

Each reward type has its own states, these can be found by viewing the .

actions: List of actions and commands executed when a reward is claimed. Find out more about the chances at

The created and set reward can be displayed in the menu. The file is used for this purpose.

individual reward types
Reward Actions
randomization
Variants (Optional)
guis.yml
Time Reward
reward types
here
shared properties