Timed Rewards is a plugin which allows players to claim rewards over set periods of times.
Flat file support.
Activate commands (console & player) on claim.
Entirely configurable (messages, commands, menu, items, and more).
Live updating menu.
PlaceholderAPI support, add your own placeholders to reward lores.
Add permissions to rewards.
Create your own cool down time placeholders (shown in gif below).
Lightweight and easy to use.
The
premium version of this plugin includes MySQL storage, multiple reward menus, vote rewards, sounds and fires on claim, claimed and unclaimed rewards and almost everything can be managed in-game through commands.
Dependencies
Placeholders These are placeholders which are used by other APIs. Current supported placeholder APIs:
PlaceholderAPI
trs_claimed_{reward} - "true" if the reward has been claimed, otherwise "false".
trs_time_remaining_{reward} - the time remaining, in seconds, until the reward can be claimed again.
trs_name_{reward} - the reward display name.
trs_rewards_available - the number of rewards available to claim for the specified menu.
Servers Using this Plugin Here's a list of active servers using Timed Rewards. Message me with your server and I'll add it here. Thanks for the support
# Timed Rewards by ImABradley (Ibiza). # # /Contact # Spigot: https://www.spigotmc.org/members/292138/ # # /Information # Timed Rewards is a plugin much alike Hypixel's 'Delivery Man' # and Mineplex's 'Carl the Creeper' in which players can claim # rewards over set periods of times. # # If you have an invalid setting, the plugin will do its best # to use its default setting without causing any issues. # # If you have any questions, suggestions, features you'd like # to see added or report any bugs, please post them in the # discord server above. # # The premium version of Timed Rewards offers multiple reward # menus, NPCs, unclaimed and claimed items, vote rewards, full # in-game management and much more. For more information, # visit the plugin page: https://www.spigotmc.org/resources/46501/ # for questions, feel free to ask in the Discord Support Server.
# Do not change this number. You will be notified if a new # configuration version is available. config-version: 2
menu:
# Should the inventory close if the player successfully # claims a reward? close-on-claim: true
# The names of external NPCs (such as from Citizens) which # will trigger the rewards menu to open. npcs: - 'Carl the Creeper'
- 'The Delivery Man'
# Sends a message to players when they login if they have unclaimed # rewards in any menu. login-reminder:
# If the login reminder is enabled. enabled: true
# Time in seconds before the message is sent. delay: 3
# The message to send to players when they have at least 1 # unclaimed reward. message: '
{prefix
} &7You have unclaimed rewards! Open the rewards menu to claim them.'
rewards:
# If true then players will be able to type /rewards # <menu_name> to open the rewards menu. # # Default: true enabled: true
# The permission node required to execute /rewards. Leave # blank to allow all users access to the command. # # Note: requires full server restart for changes to take place. permission: ''
# Other aliases for the /rewards command. If you do not # want any aliases, use: aliases: [] # # Note: requires full server restart for changes to take place. aliases: - 'reward'
# Use {prefix} in any of the messages and it will # be replaced with the below. prefix: '&7
[&6TimedRewards&7
]'
command:
no-permission: '
{prefix
} &7You do not have permission for that command.'
unknown: '
{prefix
} &7Unknown command! Type &e/trs help &7for a list of commands.'
invalid: '
{prefix
} &7Invalid usage, use &e/
{args
}&7.'
unknown-reward: '
{prefix
} &7Unknown reward
: &c{reward}&7.'
# /trs reload tr-reload-complete: '
{prefix
} &7TimedRewards was successfully reloaded
(time taken
: &e{time}&7ms).'
# /trs resetclaimtime tr-resetclaimtime-invalid-user: '
{prefix
} &7Invalid user
: &c{player}&7.' tr-resetclaimtime-reset: '
{prefix
} &7Reset the claim time of reward &e
{reward
} &7for &a
{user
}&7.'
# /rewards rewards-disabled: '
{prefix
} &7This command has been disabled.'
config-change-available: '
{prefix
} &7A config change is available. Current
: &c{current} &7New
: &a{new}&7.'
reward-no-permission: '
{prefix
} &7You do not have permission to claim that reward.'
reward-already-claimed: '
{prefix
} &7You have already claimed this reward, come back later!'
reward-cooldown:
# If a reward can be claimed, the format will be replaced with the below. now: '&aNow'
# Here you can define your own placeholders which can be used for # reward item lores. For example, to use the cooldown_digital format # in your unclaimed lore, simply use {cooldown_digital}. # # Placeholders: # {days}, {hours}, {minutes}, {seconds} formats:
cooldown_digital: '&e
{days
}&7d &e
{hours
}&7:&e
{minutes
}&7:&e
{seconds
}'
cooldown_digital_short: '&e
{hours
}&7:&e
{minutes
}&7:&e
{seconds
}'
cooldown_long: '
{days
}d
{hours
}h
{minutes
}m
{seconds
}s'
your_own_custom_one: '
{hours
}h
{minutes
}m
{seconds
}s'
menu:
title: 'Rewards Menu'
size: 45
items: # The reward key, must be unique. reward1: # Slot that the item will appear in the (/rewards) inventory. # Note: slots start at 0 slot: 20
item: # The amount of the item. amount: 1
# The item type, materials can be found here: https://hub.spigotmc.org/javadocs/spigot/org/bukkit/Material.html # Note: material types will vary depending on version. material: ENDER_CHEST
# The amount of damage the item has, this is also used for certain items such as # potions, stained glass, wool, etc. For example, use 'damage: 13' for red wool, # and make sure the material (above) is wool. damage: 0
# The display name of the item, uses & for colours. name: '&aMystery Box Delivery'
# The lore of the item, can add as many lines as you want. lore: - '&7Your free daily Mystery Box.'
- ''
- '&7Time until next claim: {cooldown_digital
}'
- '&cClick to loot!'
# The cooldown, in seconds, until the reward can be claimed again. cooldown: 86400
# The commands to be ran when the item is claimed. Put [PLAYER] before the # command if you want the player to run the command. commands: - '
[CONSOLE
]timedrewards blankmsg
{player
} &7
[&6TimedRewards&7
] &7Thanks for claiming the &edaily &7reward! Come back tomorrow for another.'
# - '[CONSOLE]give {player} diamond 64' # - '[PLAYER]spawn' # The permission node required to claim the reward. Do not include # this line if you don't want the reward to have a permission. #permission: my.permission.node # Optional message to send to players when they don't have permission # for the reward. If this tag is not included and the reward requires # a permission, 'reward-no-permission' in the locale will be used instead. #permission-deny-msg: '&7You do not have permission for the &edaily &7reward!' reward2:
slot: 21
item:
amount: 1
material: ENDER_CHEST
damage: 0
name: '&aMystery Box Delivery'
lore: - '&7Your free daily Mystery Box.'
- ' '
- '&7Requires &aVIP'
- ' '
- '&7Time until next claim: {cooldown_digital
}'
- '&cClick to loot!'
cooldown: 86400
permission: timedrewards.vip
reward3:
slot: 22
item:
amount: 1
material: ENDER_CHEST
damage: 0
name: '&aMystery Box Delivery'
lore: - '&7Your free daily Mystery Box.'
- ' '
- '&7Requires &aVIP&6+'
- ' '
- '&7Time until next claim: {cooldown_digital
}'
- '&cClick to loot!'
cooldown: 86400
permission: timedrewards.vipplus
reward4:
slot: 23
item:
amount: 1
material: ENDER_CHEST
damage: 0
name: '&aMystery Box Delivery'
lore: - '&7Your free daily Mystery Box.'
- ' '
- '&7Requires &bMVP'
- ' '
- '&7Time until next claim: {cooldown_digital
}'
- '&cClick to loot!'
cooldown: 86400
permission: timedrewards.mvp
reward5:
slot: 24
item:
amount: 1
material: ENDER_CHEST
damage: 0
name: '&aMystery Box Delivery'
lore: - '&7Your free daily Mystery Box.'
- ' '
- '&7Requires &bMVP&c+'
- ' '
- '&7Time until next claim: {cooldown_digital
}'
- '&cClick to loot!'
cooldown: 86400
permission: timedrewards.mvpplus