TNTRun Timed Rewards icon

TNTRun Timed Rewards -----

Reward players in-game based on survival time playing TNTRun_reloaded | Placeholders | Leaderboards



Minimum Java Version: ________Java 21

TNTRun Timed Rewards
Reward players based on the time spent playing TNTRun_reloaded

2021-03-04_17.35.45.png

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.

ttr5.png

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
 

ttr placeholders.PNG

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.

[​IMG]


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.
Resource Information
Author:
----------
Total Downloads: 18
First Release: Mar 18, 2021
Last Update: Jun 4, 2024
Category: ---------------
All-Time Rating:
1 ratings
Version -----
Released: --------------------
Downloads: ------
Version Rating:
----------------------
-- ratings