Functionality

The plugin tracks players' playtime and automatically assigns them roles via the LuckPerms permissions system based on accumulated time. Roles are configured in the configuration file.

Key features:

• Playtime tracking: The plugin stores players' login/logout times and summarizes the total time in the playtime.yml file.
• Automatic role assignment: The playtime of online players is checked every 5 minutes and the corresponding roles are assigned.
• Role check upon login: When a player logs in, their playtime is immediately checked and roles are assigned.
• /playtime command: Allows players to view their playtime or (with the playtimeroles.admin permission) the playtime of other players.

Commands:

• /playtime - Show your playtime
• /playtime <player> - Show the playtime of the specified player (requires playtimeroles.admin)

Permissions:

• playtimeroles.playtime - Access to the /playtime command
• playtimeroles.admin - View other players' playtimes

Configuration

config.yml

This file contains role settings. Each role has a name and a required time in the format:

• h - hours
• m - minutes
• s - seconds

Example configuration:

roles:
  - role: "novice"
    time: "1m"
  - role: "experienced" 
    time: "10h"
  - role: "veteran"
    time: "50h"

How the plugin works

1. When enabled: Loads the configuration, initializes the 'playtime.yml' file to store playtime data, and registers events and the command.
2. Player tracking: Stores the login time upon login, and calculates and stores the session time upon logout. 3. Role Checking: Periodically (every 5 minutes) and upon login, it checks the total playtime of each player and assigns roles via the LuckPerms API.
3. Data Saving: Playtime is saved in playtime.yml in milliseconds by player UUID.

The plugin requires LuckPerms to be installed to work with roles and works on Paper/Spigot servers with API 1.21.