PlayTimeManager

!(https://i.imgur.com/cMGDraE.png "PlayTime Logo") <div align="center"> <a href="https://discord.gg/yRHpgsjtRK"> <img src="https://i.imgur.com/Vd5Rfxy.png" alt="Discord"> </a> <a href="https://github.com/TheGaBr0/PlayTimeManager/wiki"> <img src="https://i.imgur.com/PU7u3HM.png" alt="Wiki"> </a> </div> <br> Hello and welcome to PlayTimeManager! I initially created this plugin for the server on which I am currently a developer. We don't have thousands or hundreds of players, but we had to find a way to track players' playtime to promote one whenever it reaches a certain amount. I looked around on the web, but I couldn't find any plugin that was able to satisfy our issue: we needed a playtime plugin, somewhat efficient, that could automatically execute a specific task like promoting a player through Luckperms. Well, that's what this plugin is supposed to do! <br> <br> I thought this could be useful to other server administrators as well, so I decided to share it on Spigot! If interest arises, I'll keep it updated happily :) --- !(https://i.imgur.com/NwhTysY.png "Landing page") ## Examples of usage <div align="center"> <img src="https://i.imgur.com/0zAmQde.gif" alt="Formatted Playtime Example" width="45%"> <img src="https://i.imgur.com/saWMotz.gif" alt="Playtime Stats Example" width="45%"> </div> ## Commands, permissions, placeholders and tutorials Ready to get started? The comprehensive (https://github.com/TheGaBr0/PlayTimeManager/wiki) contains everything you need including detailed command references, permission configurations, placeholder listings, and step-by-step setup tutorials. --- <details> <summary>Features and Use cases</summary> ## Core Functionalities - **Support for both offline and online servers** - Works seamlessly regardless of your server's authentication mode - **Fast, efficient data access with smart caching** - Optimized performance for lightweight operation - **Automatic updates that preserve your settings across versions** - Automated update process without losing configurations - **PlaceholderAPI and LuckPerms integrations** - Full compatibility with popular server management plugins - **Hex colors and legacy style support** - Complete color customization options for all text elements - **Fully customizable formatting, messages, and GUIs** - Tailor every aspect to match your server's theme - **Dynamic Leaderboards** - Real-time player ranking system based on playtime - **AFK Detection Support** - Accurate playtime tracking that excludes idle time - **Multi-language Support** - Player-facing messages can all be localized - **Multiple database backend support** - Choose between SQLite, PostgreSQL, MySQL, and MariaDB with seamless data migration between database types - **Flexible time format system** - Track and display playtime in years, months, weeks, days, hours, minutes, seconds, and Minecraft days (20-minute cycles) - **Vanish Stealth Mode** - Fully vanish-aware integration that prevents vanished players from being exposed by the plugin. ## Use Cases - **Automatic Staff Promotions** - Promote players to staff ranks after specific playtime - **VIP Rewards** - Grant special perks to dedicated players - **Server Statistics** - Display engagement metrics - **Player Retention** - Encourage longer play sessions with time-based goals - **Community Building** - Foster competition through leaderboards - **Server Analytics** - Track player engagement and activity patterns - **Join Streak Rewards** - Reward players for consecutive daily logins and playtime </details>

!(https://i.imgur.com/cMGDraE.png "PlayTime Logo")

Hello and welcome to PlayTimeManager! I initially created this plugin for the server on which I am currently a developer. We don't have thousands or hundreds of players, but we had to find a way to track players' playtime to promote one whenever it reaches a certain amount. I looked around on the web, but I couldn't find any plugin that was able to satisfy our issue: we needed a playtime plugin, somewhat efficient, that could automatically execute a specific task like promoting a player through Luckperms. Well, that's what this plugin is supposed to do!

I thought this could be useful to other server administrators as well, so I decided to share it on Spigot! If interest arises, I'll keep it updated happily :)

!(https://i.imgur.com/NwhTysY.png "Landing page")

## Examples of usage

## Commands, permissions, placeholders and tutorials Ready to get started? The comprehensive (https://github.com/TheGaBr0/PlayTimeManager/wiki) contains everything you need including detailed command references, permission configurations, placeholder listings, and step-by-step setup tutorials.

Features and Use cases

## Core Functionalities - Support for both offline and online servers - Works seamlessly regardless of your server's authentication mode - Fast, efficient data access with smart caching - Optimized performance for lightweight operation - Automatic updates that preserve your settings across versions - Automated update process without losing configurations - PlaceholderAPI and LuckPerms integrations - Full compatibility with popular server management plugins - Hex colors and legacy style support - Complete color customization options for all text elements - Fully customizable formatting, messages, and GUIs - Tailor every aspect to match your server's theme - Dynamic Leaderboards - Real-time player ranking system based on playtime - AFK Detection Support - Accurate playtime tracking that excludes idle time - Multi-language Support - Player-facing messages can all be localized - Multiple database backend support - Choose between SQLite, PostgreSQL, MySQL, and MariaDB with seamless data migration between database types - Flexible time format system - Track and display playtime in years, months, weeks, days, hours, minutes, seconds, and Minecraft days (20-minute cycles) - Vanish Stealth Mode - Fully vanish-aware integration that prevents vanished players from being exposed by the plugin.

## Use Cases - Automatic Staff Promotions - Promote players to staff ranks after specific playtime - VIP Rewards - Grant special perks to dedicated players - Server Statistics - Display engagement metrics - Player Retention - Encourage longer play sessions with time-based goals - Community Building - Foster competition through leaderboards - Server Analytics - Track player engagement and activity patterns - Join Streak Rewards - Reward players for consecutive daily logins and playtime