❗️The plugin remains fully compatible with data from version 3.0.4 and earlier. Before making any modifications, a backup is automatically created, ensuring a seamless and secure migration to the latest version without data loss.❗️
New Features & Improvements
AFK detection system is here!
Introduced AFK detection capabilities with external plugins integration:
- afk-detection-plugin – Configure which plugin will serve as the AFK detector that PTM will hook into (currently only EssentialsX is supported)
- ignore-afk-time – When enabled, AFK time is excluded from total playtime calculations used throughout the plugin (goals requirements, displays, etc.)
- Enhanced player information display with dedicated AFK time tracking in the new stats GUI
- Added new PAPI placeholders for AFK time monitoring:
%PTM_afk_playtime%,
%PTM_afk_playtime_#%,
%PTM_afk_playtime_<nickname>%,
%PTM_afk_playtime_<nickname>_#%
New customizable stats GUI system
Completely redesigned the stats display system with a flexible, view-based GUI:
- Command restructure: /playtime <target> stats has been converted to /playtimestats <target> with enhanced functionality
- View-based customization: GUI adapts based on the player accessing it and their permission level
- Owner view: Full access to personal statistics when players check their own stats
- Player view: Public statistics display when viewing other players
- Staff view: Enhanced administrative details for users with playtime.others.stats.staff permission
- New permission system: Updated permissions structure for granular access control
- playtime.stats – Access to /playtimestats (/ptstats) | AKA access to personal statistics (enabled by default)
- playtime.others.stats – Access to /playtimestats <target> (/ptstats <target>) | AKA View other players' statistics (disabled by default)
- playtime.others.stats.staff – Enhanced staff view with administrative details
- Console compatibility: Text-based statistics output for console usage with detailed formatting instead of in-game GUI.
- Configuration location: The new stats GUI can be found in Customizations/GUIs/GUIs-config.yml
- Wiki documentation: A detailed guide on the views system and customization tutorial is available in the wiki
Internal placeholder format update
Updated internal placeholder formatting for improved consistency:
- Format change: Internal placeholders have been converted from {placeholders} to %PLACEHOLDER%.
- Do not confuse internal placeholders with PAPI placeholders, which maintain the format %PTM_PLACEHOLDER%.
Bug fixes
- Fixed %PTM_Rank% placeholder showing 0 instead of placeholders.not-in-leaderboard-message config field (again)
- Fixed a case where, if the first_join db field is null for a player, a double join streak increment is given.
- Fixed tab completion for /playtime command