Renewable Play Time Reward

The play-time based renewable reward system operates on players accumulating hours within a game or platform. As they reach certain play-time thresholds, they unlock specific rewards. After claiming one, the play-time counter resets, and players must accumulate another required hours to access the next reward. This cycle continues, encouraging consistent engagement and gameplay to continually earn and re-earn rewards.

Example configuration

# Decides if rewards will be claimable.
enabled: true
type: renewable_play_time_reward
#
# Reward tag
#
tag: Renewable Play Time Reward
#
# (Optional) Permission which player must have to be
# able to obtain this reward.
#
permission: ultimaterewards.exampleRenewablePlayTimeReward
#
# Required play time to achieve this reward.
#
required-time: 60
# Format that replaces the %requiredTime% placeholder in the rewards menu
format: "%minutes% minute(s)"
#
# Based on what the time played will evolve, options:
#   LOCAL (the time played is different for each server)
#   GLOBAL (time is calculated cross-server)
#
tracking: LOCAL
# NOTE THAT ITEM & SOUND NAMES ARE SLIGHTLY DIFFERENT BETWEEN >1.12 & 1.13< VERSIONS!
# SO MAKE SURE YOU ARE USING VALID ITEM NAMES (DEFAULT ONE ARE USED FROM 1.13+ VERSIONS)
# OTHERWISE WILL BE REPLACED BY STONE IF INVALID NAME IS IN USE.
#
# When player achieves required play time,
# this version of reward item is displayed in the inventory:
#
available-item: "LIME_DYE"
available-display-name: "&a&lRENEWABLE PLAY TIME REWARD"
available-lore:
  - "&7You have played"
  - "&7enough time to be able"
  - "&7obtain this reward!"
  - " "
  - "&b► Click to claim!"
#
# Whereas player doesn't have enough played time,
# this version of reward item is displayed in the inventory:
#
unavailable-item: "RED_DYE"
unavailable-display-name: "&c&lRENEWABLE PLAY TIME REWARD"
unavailable-lore:
  - "&7You need to spend enough"
  - "&7hours to be able obtain"
  - "&7this reward!"
  - " "
  - "&4► Requires another %requiredHours%"
#
# When player doesn't have permission for this reward,
# the following properties will be shown.
#
no-permission-item: BARRIER
no-permission-display-name: "&c&l&mRENEWABLE PLAY TIME REWARD"
no-permission-lore:
  - "&c ✕ Locked, requires"
  - "&c   %permission% permission"
#
# Commands list that will be executed after player
# obtains this reward.
# All available actions can be found at
# https://revivalo.gitbook.io/ultimaterewards/
#
# Format: () - optional value | [] - required value
#   [<actionType>] (<chance>):<command>
#
# Examples:
#   - [console] 50:give %player% diamond 1
#       - this command will have a 50%
#         execution chance due to its property value
#
#   - [message] "&aYou have claimed your %type% reward!"
#       - this action will send the player a message
#         with the defined content
#
# You can also use the random placeholders
# from the randoms.yml file and use them in commands.
# Example:
#   - give %player% iron_ingot %exampleRandom%
#       - the placeholder will be replaced by
#         a random number from the defined interval in randoms.yml
#
actions:
  - '[console] give %player% diamond 1'
  - '[console] say %player% claimed his %type% reward!'
  #  - '[actionbar] &aSuccessfully claimed!' # Action bar can be used only from 1.12 versions!
  - '[title] &aClaimed'
  - '[subtitle] &aReward %type%'
  - '[sound] BLOCK_CHEST_OPEN'