❗️The plugin remains fully compatible with data from version 3.1 and later. 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

Database Migration System

Introduced a comprehensive database migration system allowing seamless switching between database types:

• New /playtimemigration command – Manage database migrations, available from console only.
  • Three subcommands available:
    • start <dbtype> – Schedules migration to the specified database type
    • cancel – Cancels any pending migration
    • status – Displays current database type and migration status

Supported database types:

• MySQL (mysql)
• MariaDB (mariadb)
• PostgreSQL (postgresql)
• SQLite (sqlite)

Migration process:

• Migration executes automatically on the next server reload/restart after scheduling
• Automatic backup creation before migration begins
• Existing PlayTimeManager tables in target database are automatically dropped to ensure clean migration
• Important: Target database credentials must be correctly configured in config.yml before server restart (username, password, connection details, etc.)

---

Expanded Time Unit Support

Added three new time units for placeholders, playtime formats, and commands:

• w (weeks) – Display playtime in weekly increments
• mo (months) – Display playtime in monthly increments
• mc (minecraft days) – Display playtime in Minecraft day units (1 Minecraft day = 20 minutes of real playtime)

New configuration option:

• month-value-in-days – Customize how many days equal one month for the mo unit (defaults to 30 days)

These units can be used anywhere time units are supported, including placeholders, playtime format configurations, and command arguments.

---

AFK Detection Integration

JetsAntiAFKPro support – Integrated JetsAntiAFKPro as an additional AFK detector option.

---

Configuration Changes

• distribute-removed-time option is now set to true by default in the default playtime format

Bug fixes

• Fixed %SUBCOMMAND% internal placeholder not being correctly parsed
• Fixed automatic update process from some old versions of the plugin
• Fixed %PTM_rank_<nickname>% placeholder returning nothing when queried for an offline player
• Fixed an issue which prevented players data up to 5 minutes from being saved correctly to the database on server shut down
• Various optimizations

❗️The plugin remains fully compatible with data from version 3.1 and later. Before making any modifications, a backup is automatically created, ensuring a seamless and secure migration to the latest version without data loss. ❗️

Bug fixes

• Fixed a bug where periodic database updates would stop AFK time counting for players who were still AFK, causing inaccurate AFK playtime tracking

❗️The plugin remains fully compatible with data from version 3.1 and later. 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

New update check system

This won't change anything for you, but now there's a homemade update checker instead of relying on Spigot-UpdateChecker. I had to do this cause the latter was no longer maintained by his developer and having Maven warnings after each compile process wasn't something I really liked!

Bug fixes

• Fixed an issue where updating a player’s nickname (when they previously had another nickname) resulted in failure and consequent inconsistent values across database tables. The problem was caused by referencing the wrong column during the updateNickname process.
  • This affects mostly premium servers!
  • This version automatically fixes database incosistencies caused by this problem.
• Fixed GUIs-config update system not preserving intentionally removed view sections (e.g., removed player/staff/owner views are now kept removed after updates)

❗️The plugin remains fully compatible with data from version 3.1 and later. 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

Revamped Goals System with Flexible Scheduling

The goals system has been completely redesigned with individual completion check schedules for each goal:

• Individual scheduling per goal – Each goal now operates independently instead of relying on a single global schedule
• Two scheduling types available:
  • Seconds-based intervals – Traditional timer system (schedules reset on server restart)
  • Cron-based scheduling – Advanced time-based scheduling with automatic restoration after server restarts

Cron scheduling advantages:

• Automatically restored and continue running at defined times after server restarts
• Precise control over when goals are checked (specific times, days, etc.)

Cron scheduling limitations:

• If a scheduled time is missed (due to maintenance or downtime), that execution will be skipped and not retried automatically

Repeatable Goals

Goals can now be set as repeatable, allowing players to:

• Complete the same goal multiple times
• Earn rewards each time the conditions are met

Offline Reward Delivery

Goals now support rewarding players even when they're offline:

• When enabled, players who meet goal requirements while offline automatically receive rewards on their next login
• Current limitation: Only players who were online during the last completion check interval are tracked for reward eligibility
  • Example: If a goal checks daily and a player doesn't join that day, they won't receive rewards for that period—even if conditions were met while offline

New Goal Management Command

Introduced /playtimegoal <goalname> checknow for immediate goal verification:

• Manually trigger a completion check for any goal
• Restarts the goal's check schedule
• Replaces the previous method of using /playtimereload for goal checks

---

Enhanced Playtime Format System

Distribute Removed Time Option

Added Distribute Removed Time configuration field to control how omitted time units are handled:

When enabled:

• Time from hidden larger units is converted and added to the next visible unit
• Example: 1 day, 12 hours, 1 minute with format %h%{hours}, %m%{minutes} displays 36h, 1m
  • The 1 day converts to 24 hours and adds to the existing 12 hours

When disabled:

• Hidden units are simply ignored
• Example: Same playtime displays 12h, 1m
  • The day is hidden without conversion

AFK Detection Integration

AntiAFKPlus support – Integrated AntiAFKPlus as an additional AFK detector option alongside EssentialsX and Purpur

Database System Overhaul & Optimizations

Complete rewrite of the database management system:

• Future database support – Architecture now supports different database types (e.g., MySQL) for future releases
• Async data retrieval – Player data is now fetched completely asynchronously. These async improvements ensure smoother gameplay experiences, faster load times, and better scalability across all database operations
• Enhanced caching system – Improved data optimization for better performance

Configuration Reorganization

Relocated common command-related options to commands.yml for better organization:

• prefix
• playtime-message-self
• playtime-message-others
• Added additional translation options for error-related messages in the commands configuration

Join Streak Rewards GUI Enhancements

Expanded placeholder support in the join streak rewards claiming GUI:

• %PLAYER_NAME%, %REQUIRED_JOINS%, and %JOIN_STREAK% are now usable in:
  • reward-message field
  • description field
  • reward-description field

Support for version 3.0.4 dropped

Now it is no longer possible to update from 3.0.4 directly to 3.6 version. A mid update to 3.5.4 is necessary to then update to future versions.

Bug fixes

• Fixed a rare bug where the onlineUser entry was missing during the join event, causing data inconsistency issues.
• Various fixes and improvements all around

❗️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

Purpur's AFK detection support added

Now you can use Purpur's built-in AFK detection system alongside the existing EssentialsX option. If you want to use Purpur base afk detection, you need to:

• Set player-idle-timeout field greater than 0 (minutes) in server.properties
• Set player.idle-timeout.kick-if-idle field to false in purpur.yml

Bug fixes

• Fixed a critical bug where artificial playtime was getting added to users after each quit event.