PlayTimeManager Plugin pre Minecraft 1.20.1, 1.21.1

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 :)

Examples of usage

Commands, permissions, placeholders and tutorials

Ready to get started? The comprehensive 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
• MiniMessage, 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