Minimum Java Version:
________Java 21
TNTRun Timed Rewards
Reward players based on the time spent playing TNTRun_reloaded
Description
TNTRunTimedRewards links with the TNTRun_reloaded plugin and records the amount of time players spend playing TNTRun in each arena. The players longest survival time for an arena is also recorded. Players can receive monetary rewards based on the time they play/survive in an arena. The time settings and amount of money can be set independently for each TNTRun_reloaded arena.
Doublejumps can also be rewarded in-game in place of money.
Leaderboards can be created using placeholders based on the total amount of time spent playing in an arena and/or the longest survival time in an arena.
The first reward is given to all active players after the number of seconds that is set in the config (known as the
delay time).
The player's balance shown in the scoreboard will update at the same time. A delay of zero seconds will reward the players immediately the arena starts.
Subsequent rewards can be given to the remaining active players at the specified interval defined in the config (known as the
repeat time). A repeat of zero seconds will not give any repeat rewards.
If the TNTRun_reloaded arena has a currency specified, then TNTRunTimedRewards can be configured to reward the currency item in place of money. This requires TNTRun_reloaded version 9.20+.
The reward messages and amount rewarded are displayed on the Action Bar. The text and colour of both are configurable.
By default, no timed rewards are set set as they can be individually configured for each TNTRun_reloaded arena. To enable TNTRunTimedRewards for an arena, first register the arena name, then set the initial delay (seconds), the repeat reward delay (seconds), if required, and the amount of the reward.
To remove an arena from TNTRunTimedRewards, simply use the "
/ttr delete [arena]" command and no further timed rewards will be issued for that arena.
Dependencies
From version 1.8 this plugin requires a minimum of Java 21. and Minecraft/Spigot 1.20.6+.
Version 1.7 supports Minecraft/Spigot 1.17.1 - 1.20.4 with a minimum of Java 17.
Version 1.6 of this plugin will work with servers running a minimum of Java 16 and Minecraft/Spigot 1.16.5+. It is compatible with TNTRun_reloaded v9.12+.
The legacy version of the plugin, v1.1, is supported on Minecraft/Spigot 1.13.2 through to 1.16.5. It is compatible with TNTRun_reloaded v9.9 to v9.1.
TNTRun_reloaded 9.12+
Vault
An Economy plugin that supports Vault
PlaceholderAPI (optional, required for placeholders)
Holographic Displays (optional, required for holograms)
Holographic Extension (optional, required to use placeholders with Holographic Displays v2.x)
Protocollib (optional, required for Holographic Extension)
Commands
/ttr register [arena] - register the arena name for TNTRun Timed Rewards
/ttr unregister [arena] - delete the arena name for TNTRun Timed Rewards and remove all stats
/ttr setdelay [arena] - set the number of seconds before the reward is given
/ttr setrepeat [arena] - set the number of seconds after the first reward that subsequent rewards are given
/ttr setamount [arena] - set the amount of money to be rewarded
/ttr list [arena] - list the TNTRun Timed Rewards settings for the arena
/ttr enable [arena] - enable timed rewards for the registered arena
/ttr disable [arena] - disable timed rewards for the registered arena
/ttr togglestats [arena] - enable or disable the recording of time stats for the arena
/ttr reload - reload the TNTRun Timed Rewards config
/ttr stats [arena] - display player's time stats for arena
/ttr info - display plugin info
Placeholders
The placeholders require the PlaceholderAPI plugin and will return an individual player's playing times as a number of seconds, and as a formatted time in hours, minutes and seconds.
The examples below are using HolographicDisplays to display the placeholder values.
Code (Text):
%tntruntimedrewards_totalseconds% : time player has played TNTRun_reloaded (seconds)
%tntruntimedrewards_totaltime% : time player has played TNTRun_reloaded (HH:MM:SS)
%tntruntimedrewards_seconds_<arena>% : time player has played in arena (seconds)
%tntruntimedrewards_time_<arena>% : time player has played in arena (HH:MM:SS)
%tntruntimedrewards_longestseconds_<arena>% : player's longest survival in arena (seconds)
%tntruntimedrewards_longesttime_<arena>% : player's longest survival in arena (HH:MM:SS)
%tntruntimedrewards_version% : version of TNTRunTimedRewards
%tntruntimedrewards_currentreward% : current running total of rewards won in arena
%tntruntimedrewards_lb_totaltime_player_<position>_<arena>% : player at position in leaderboard for arena
%tntruntimedrewards_lb_totaltime_score_<position>_<arena>% : value at position in leaderboard for arena
%tntruntimedrewards_lb_longest_player_<position>_<arena>% : player at position in longest time leaderboard
%tntruntimedrewards_lb_longest_score_<position>_<arena>% : value at position in longest time leaderboard
Configuration
Code (YAML):
# Configuration file for TNTRun Timed Rewards
#
Display:
actionbar:
enabled
: true
playSound
: true
Sound:
enabled
: true
sound
: ENTITY_PLAYER_LEVELUP
volume
: 5
pitch
: 1.0
CheckForUpdate
: true
# Below is an example of 2 arenas after being registered and configured.
#Arenas:
# arena1:
# enabled: true
# stats: true
# delay: 60
# repeat: 30
# amount: 20.0
# useArenaCurrency: false
# rewardDoublejumps: false
# arena2:
# enabled: true
# stats: true
# delay: 45
# repeat: 10
# amount: 10.0
# rewardDoublejumps: false
Installation
Download TNTRunTimedRewards.jar
Copy to your 'plugins' folder
Restart your server - this will create the default
config.yml
Issues
Join our Discord server to discuss any issues.
Please don't use the review section to ask for help or additional features. Use one of the options listed above and provide as much information as possible. If something's not working, then you've probably configured it wrongly, and it's just not possible to diagnose and resolve a problem in the review space, and the "review" you leave helps no-one.