New Features & Improvements

New placeholders

Added new placeholders for converting formatted playtime into a specific time unit:

• %PTM_playtime_#_<nickname>%
• %PTM_lastseen_elapsed_#_<nickname>%
• %PTM_playtime_top_#_<rank>%
• %PTM_lastseen_elapsed_top_#_<rank>%

And a new placeholder to display a player’s LuckPerms prefix in the leaderboard:

• %PTM_lp_prefix_top_<rank>%

Available time units (#): s (seconds), m (minutes), h (hours), d (days), y (years)

Hex colours

Support for hex colours has been added with the following format: &#rrggbb. Mixing legacy colours (e.g. &6), styles (e.g. &l) and hex colours is supported, an example:

&l&#8000FF[&#9B00E6M&#B200D9e&#C600CCm&#D900BFb&#EC00BFe&#FF00B3r] → Displays “[Member]” in bold and gradient hex colours.

New customization options in the config.yml

• prefix : This will set the custom prefix that will appear before all messages generated by the PlayTimeManager plugin
• playtimetop.leaderboard-format: This will set the format for each line in the chat leaderboard.
  • Available placeholders:
  • %POSITION% - Player's position in the leaderboard (1, 2, 3, etc.)
  • %PREFIX% - Player's prefix from LuckPerms
  • %PLAYER_NAME% - Player's username
  • %PLAYTIME% - Player's total playtime formatted
• placeholders.enable-errors: If enabled, errors in placeholders will be displayed otherwise the text in default-message will be shown instead of error messages
• placeholders.default-message : The default message to display when enable-errors is set to false.
• A new placeholder %PREFIX% is available for playtime-self-message and playtime-others-message and, if used, will display the LuckPerms prefix of the specified player.

First join date

Added tracking of players' first server join dates. The system will now automatically record when new players join for the first time. For existing players in the database who joined before this update, their first join date will be set when they next connect to the server after the update is installed.

Playtime <playername> stats

/playtime <playername> lastseen has been replaced with /playtime <playername> stats and requires the permission playtime.others.stats .

Now upon execution this command will display:

• Playtime
• Artificial playtime (modified with add/remove subcommands)
• Join date
• Last seen date
• Time elapsed since last seen date
• Goals achieved

of the specified player.

Playtimetop

Playtimetop is now completely customizable through config.yml, making it more adapt to be shown to players. Now it is no longer needed to specify the number of players to load, as 100 will be default.

Pages are optional and clickable (and hoverable) arrows have been added in chat to scroll the entire leaderboard.

The command has also been optimized.

Playtimepercentage

PlaytimePercentage now supports second and years, furthermore multiple time formats as input is now accepted (e.g. 1y,2m,3s).

Bug Fixes

Fixed the display of a text-wall of attributes when clicking on the barrier of /playtimegoal ’s GUI when no goals exist.

Fixed sound execution upon goal completion for version 1.20

Fixed /playtime * reset command which was refusing to execute when specifying *

Fixed crash when resetting players data