PlayerPlayTime
Track players playtime, reward them for it, and easily see the top playtimes.
• Fully configurable
• EXTREMELY lightweight plugin
• Reward players for their playtime
• Playtime Top GUI
• Playtime Reward GUI
• MySQL support
• PlaceholderAPI support
• Per-file configuration
This plugin can be used as-is, but it's
highly recommended to setup rewards
specifically tailored to your server.
Commands »
Aliases:
pt, playertime, onlinetime, timeplayed, ot
Permissions »
• playtime.reload
Access to reload sub-command.
• playtime.clearrewards
Access to clearrewards sub-command.
Images »
(/playtime)
(/playtime top)
(/playtime rewards)
(/playtime clearrewards (player))
PlaceholderAPI »
Placeholders:
%playtime_playtime%
Description: Displays the playtime of the player viewing the placeholder.
%playtime_(name)_playtime%
Example: %playtime_RexlessTazz_playtime%
Description: Displays the playtime of the specified player.
%playtime_top_(spot)_name%
Example: %playtime_top_1_name%
Description: Displays up to the top 10 spots username.
%playtime_top_(spot)_time%
Example: %playtime_top_1_time%
Description: Displays up to the top 10 spots playtime.
Configurable files »
[SPOILER="config.yml"][code]# config.yml</div>
<div data-redactor="1">settings:</div>
<div data-redactor="1"> # Which time units to display in formatted playtime.</div>
<div data-redactor="1"> # Valid units: day, hour, minute, second.</div>
<div data-redactor="1"> # Comment out 'second' if you don't want seconds to appear.</div>
<div data-redactor="1"> Time-Format-Units:</div>
<div data-redactor="1"> - day</div>
<div data-redactor="1"> - hour</div>
<div data-redactor="1"> - minute</div>
<div data-redactor="1"> - second # comment this out if you don't want seconds</div>
<div data-redactor="1"> </div>
<div data-redactor="1"> # What labels to use for each unit.</div>
<div data-redactor="1"> # These strings are appended to the number of days, hours, etc.</div>
<div data-redactor="1"> Time-Formats:</div>
<div data-redactor="1"> Day: " day"</div>
<div data-redactor="1"> Hour: " hour"</div>
<div data-redactor="1"> Minute: " minute"</div>
<div data-redactor="1"> Second: " second"</div>
<div data-redactor="1"> </div>
<div data-redactor="1"> # Whether to automatically append an "s" to the labels when plural (e.g., "2 days" instead of "2 day").</div>
<div data-redactor="1"> Append-Formats-With-An-S: true</div>
<div data-redactor="1"> </div>
<div data-redactor="1"> Rewards-Cleared:</div>
<div data-redactor="1"> # When an admin clears a player's rewards, should the player be informed in chat?</div>
<div data-redactor="1"> Tell-Target-All-Their-PlayTime-Rewards-Were-Cleared: true</div>
<div data-redactor="1"> </div>
<div data-redactor="1"> Use-existing-playtime: true</div>
<div data-redactor="1"> # Use the data found in the world file for the players data that provides a playtime for the player.</div>
<div data-redactor="1"> # With this disabled, PlayTime uses its internal system that starts tracking upon the plugin being installed.</div>
<div data-redactor="1"> </div>
<div data-redactor="1">update-check:</div>
<div data-redactor="1"> # Automatically check for plugin updates on SpigotMC.</div>
<div data-redactor="1"> enabled: true</div>
<div data-redactor="1"> </div>
<div data-redactor="1"> # Permission required to see the update notification.</div>
<div data-redactor="1"> permission: playtime.update</div>
<div data-redactor="1"> </div>
<div data-redactor="1"> # Message shown to admins when an update is available.</div>
<div data-redactor="1"> # Placeholders: %latest% = latest version, %current% = your version.</div>
<div data-redactor="1"> message: "&bᴘʟᴀʏᴛɪᴍᴇ &e♦ &fA new version, &b%latest%&f, is available. You're running &e%current%&f."</div>
<div data-redactor="1"> </div>
<div data-redactor="1">mysql:</div>
<div data-redactor="1"> enabled: false</div>
<div data-redactor="1"> host: localhost</div>
<div data-redactor="1"> port: 3306</div>
<div data-redactor="1"> database: playtime</div>
<div data-redactor="1"> username: root</div>
<div data-redactor="1"> password: password</div>
<div data-redactor="1"> table: playtime_data</div>
<div data-redactor="1"> </div>
<div data-redactor="1">guis:</div>
<div data-redactor="1"> Top:</div>
<div data-redactor="1"> # Title of the GUI that shows the top playtimes.</div>
<div data-redactor="1"> Title: '&fᴛᴏᴘ &bᴘʟᴀʏᴛɪᴍᴇꜱ'</div>
<div data-redactor="1"> </div>
<div data-redactor="1"> # How many players to display in the Top Playtimes GUI.</div>
<div data-redactor="1"> How-Many-Players-To-Display-In-The-GUI: 10</div>
<div data-redactor="1"> </div>
<div data-redactor="1"> # How to format each player's name line in the Top GUI.</div>
<div data-redactor="1"> # Placeholders: %position% = rank number, %player% = player name.</div>
<div data-redactor="1"> Players-Name: '&b#%position% &7» &b%player%'</div>
<div data-redactor="1"> </div>
<div data-redactor="1"> # How to format the playtime shown for each player in the Top GUI.</div>
<div data-redactor="1"> # Placeholder: %playtime% = formatted playtime.</div>
<div data-redactor="1"> Players-Playtime: '&7%playtime%'</div>
<div data-redactor="1"> </div>
<div data-redactor="1"> Rewards:</div>
<div data-redactor="1"> # Title of the GUI that shows available and claimed rewards.</div>
<div data-redactor="1"> Title: '&bᴘʟᴀʏᴛɪᴍᴇ &fʀᴇᴡᴀʀᴅꜱ'[/code][/SPOILER]
[SPOILER="messages.yml"][code]# messages.yml</div>
<div data-redactor="1">prefix: "&bᴘʟᴀʏᴛɪᴍᴇ &e♦ &f"</div>
<div data-redactor="1"> </div>
<div data-redactor="1">messages:</div>
<div data-redactor="1"> playtime:</div>
<div data-redactor="1"> self:</div>
<div data-redactor="1"> - "%prefix%&fYou've played for &b%playtime%&f."</div>
<div data-redactor="1"> - "%prefix%&fTimes Joined: &b%joins%"</div>
<div data-redactor="1"> - "%prefix%&fFirst Joined: &b%date-joined%"</div>
<div data-redactor="1"> other:</div>
<div data-redactor="1"> - "%prefix%&b%player% &fhas played for &b%playtime%&f."</div>
<div data-redactor="1"> - "%prefix%&b%player% &fjoined &b%joins% &ftimes."</div>
<div data-redactor="1"> - "%prefix%&b%player% &ffirst joined on &b%date-joined%&f."</div>
<div data-redactor="1"> not-found:</div>
<div data-redactor="1"> - "%prefix%&cNo &fplaytime data found for &b%target%&f."</div>
<div data-redactor="1"> reloaded: "%prefix%&aConfiguration reloaded."</div>
<div data-redactor="1"> top-header: "%prefix%Opening top playtimes..."</div>
<div data-redactor="1"> no-permission: "%prefix%&cYou do not have permission to do that."</div>
<div data-redactor="1"> player-only: "%prefix%&cOnly players can run this command."</div>
<div data-redactor="1"> invalid-player: "%prefix%&cPlayer not found."</div>
<div data-redactor="1"> invalid-usage: "%prefix%&cInvalid usage."</div>
<div data-redactor="1"> rewards-were-cleared: "%prefix%Your playtime reward data has been &creset&f." # in the config.yml, the setting: "Tell-Target-All-Their-PlayTime-Rewards-Were-Cleared" must be set to "true" for the target to receive this message.</div>
<div data-redactor="1"> cleared-players-rewards: "%prefix%All reward data for &b%player% &fhas been &ccleared&f."</div>
<div data-redactor="1"> player-not-on-the-confirm-list: "%prefix%That players' PlayTime rewards aren't pending clear. &7(&e/pt clearrewards %player%&7)"</div>
<div data-redactor="1"> constant-rewards-cant-be-cleared: "%prefix%&bConstant &frewards can't be reset. The rewards are intended to always be able to be redone."</div>
<div data-redactor="1"> per-session-rewards-were-cleared: "%prefix%&6Per-session &frewards were &ccleared &ffor &b%player%&f."</div>
<div data-redactor="1"> unique-rewards-were-cleared: "%prefix%&aUnique &frewards were &ccleared &ffor &b%player%&f."</div>
<div data-redactor="1"> invalid-reward-type: "%prefix%&cInvalid &freward type. Use: &aunique &for &6per-session"</div>
<div data-redactor="1"> players-data-already-in-confirm-list: "%prefix%The reward data for &b%player% &fis already pending confirmation. &7(&e/pt clearrewards %player% confirm&7)"</div>
<div data-redactor="1"> hover-message:</div>
<div data-redactor="1"> message-in-chat: "%prefix%You need to confirm clearing &lALL &fof &b%player%s' &freward data. &7(&a&lClick to confirm&7)"</div>
<div data-redactor="1"> hover: "&fClick to confirm clearing of &b%player%s' &freward data."</div>
<div data-redactor="1"> clear-rewards-breakdown:</div>
<div data-redactor="1"> - "%prefix%Usage: &e/pt clearrewards (player) [reward-type]"</div>
<div data-redactor="1"> - " &7(required) [optional]"</div>
<div data-redactor="1"> - ""</div>
<div data-redactor="1"> - "&fValid reward types: &aunique &f& &6per-session"</div>
<div data-redactor="1"> help:</div>
<div data-redactor="1"> - "%prefix%&e/playtime &7- &fView your playtime."</div>
<div data-redactor="1"> - "%prefix%&e/playtime (player) &7- &fView another player's playtime."</div>
<div data-redactor="1"> - "%prefix%&e/playtime rewards &7- &fView rewards for playtime milestones."</div>
<div data-redactor="1"> - "%prefix%&e/playtime clearrewards (player) [reward-type] &7- &fClear all or a specified type of reward data for a player."</div>
<div data-redactor="1"> - "%prefix%&e/playtime top &7- &fView top playtimes."</div>
<div data-redactor="1"> - "%prefix%&e/playtime reload &7- &fReload plugin configuration."[/code][/SPOILER]
[SPOILER="rewards.yml"][code]# rewards.yml</div>
<div data-redactor="1"># Constant rewards repeat every X seconds of TOTAL playtime.</div>
<div data-redactor="1"># Each reward entry requires:</div>
<div data-redactor="1"># interval: seconds (integer)</div>
<div data-redactor="1"># command: command to run (use %player% as placeholder)</div>
<div data-redactor="1"># message: (optional) message to send to the player</div>
<div data-redactor="1">constant:</div>
<div data-redactor="1"> two_hours:</div>
<div data-redactor="1"> material: DIAMOND</div>
<div data-redactor="1"> name: "&b%interval%"</div>
<div data-redactor="1"> lore:</div>
<div data-redactor="1"> - "&7Earn a reward every &b%interval%&7."</div>
<div data-redactor="1"> - ""</div>
<div data-redactor="1"> - "&fReward: &a%reward%"</div>
<div data-redactor="1"> - "&fType: &bConstant"</div>
<div data-redactor="1"> interval: 7200 # 2 hours</div>
<div data-redactor="1"> command: "eco give %player% 100"</div>
<div data-redactor="1"> message: "&bᴘʟᴀʏᴛɪᴍᴇ &e♦ &fYou received &a$100 &ffor reaching 2 hours played!"</div>
<div data-redactor="1"> gui-interval: "2 hours"</div>
<div data-redactor="1"> reward-desc: "$100"</div>
<div data-redactor="1"> permissions-required: []</div>
<div data-redactor="1"> </div>
<div data-redactor="1"># Unique rewards are given ONCE when total playtime reaches the threshold.</div>
<div data-redactor="1">unique:</div>
<div data-redactor="1"> one_day:</div>
<div data-redactor="1"> unique:</div>
<div data-redactor="1"> material: EMERALD</div>
<div data-redactor="1"> name: "&a%interval%"</div>
<div data-redactor="1"> lore:</div>
<div data-redactor="1"> - "&7Earn a special reward for"</div>
<div data-redactor="1"> - "&7hitting a specific milestone."</div>
<div data-redactor="1"> - ""</div>
<div data-redactor="1"> - "&fReward: &a%reward%"</div>
<div data-redactor="1"> - "&fType: &aUnique"</div>
<div data-redactor="1"> achieved:</div>
<div data-redactor="1"> material: LIME_WOOL</div>
<div data-redactor="1"> name: "&aAchieved - %interval%"</div>
<div data-redactor="1"> lore:</div>
<div data-redactor="1"> - "&7You've already achieved this reward."</div>
<div data-redactor="1"> - ""</div>
<div data-redactor="1"> - "&fReward: &a%reward%"</div>
<div data-redactor="1"> - "&fType: &aUnique"</div>
<div data-redactor="1"> at: 86400 # 24 hours</div>
<div data-redactor="1"> command: "give %player% diamond 5"</div>
<div data-redactor="1"> message: "&bᴘʟᴀʏᴛɪᴍᴇ &e♦ &b24 hour &fmilestone reached! Enjoy &b5 diamonds&f."</div>
<div data-redactor="1"> gui-interval: "1 day"</div>
<div data-redactor="1"> reward-desc: "5x diamonds"</div>
<div data-redactor="1"> permissions-required:</div>
<div data-redactor="1"> - playtime.rewards.unique1</div>
<div data-redactor="1"> - playtime.rewards.rank1</div>
<div data-redactor="1"> </div>
<div data-redactor="1"># Per-session rewards can be earned once per calendar day</div>
<div data-redactor="1"># when the player's playtime for that day reaches the interval.</div>
<div data-redactor="1">per-session:</div>
<div data-redactor="1"> daily_half_hour:</div>
<div data-redactor="1"> material: GOLD_INGOT</div>
<div data-redactor="1"> name: "&6%interval%"</div>
<div data-redactor="1"> lore:</div>
<div data-redactor="1"> - "&7Come back every day and"</div>
<div data-redactor="1"> - "&7play for at least &b%interval%&7!"</div>
<div data-redactor="1"> - ""</div>
<div data-redactor="1"> - "&fReward: &a%reward%"</div>
<div data-redactor="1"> - "&fType: &6Per-session"</div>
<div data-redactor="1"> achieved:</div>
<div data-redactor="1"> material: LIME_WOOL</div>
<div data-redactor="1"> name: "&aAchieved - %interval%"</div>
<div data-redactor="1"> lore:</div>
<div data-redactor="1"> - "&7You've already achieved this reward."</div>
<div data-redactor="1"> - ""</div>
<div data-redactor="1"> - "&fReward: &a%reward%"</div>
<div data-redactor="1"> - "&fType: &aUnique"</div>
<div data-redactor="1"> interval: 1800 # 30 minutes in a single day</div>
<div data-redactor="1"> command: "crate key give %player% daily 1"</div>
<div data-redactor="1"> message: "&bᴘʟᴀʏᴛɪᴍᴇ &e♦ &fThank you for playing &b30 minutes &ftoday! — Here’s a daily key!"</div>
<div data-redactor="1"> gui-interval: "30 minutes"</div>
<div data-redactor="1"> reward-desc: "1x Daily Key"</div>
<div data-redactor="1"> permissions-required:</div>
<div data-redactor="1"> - playtime.rewards.per-session1</div>
<div data-redactor="1"> - playtime.rewards.rank1[/code][/SPOILER]
Support »
The quickest way to get support for any of my resources
would be to join my Resource Discord.
Note »
Please DO NOT leave bad reviews for any issues
that you have. Please simply PM me or leave it
in the discussion tab. Thank you. 
That and reviews are highly appreciated!
The PlayerPlayTime Team
