Server Playtime Manager

A mod to manage daily playtime on a server to help avoid people advancing far beyond others and to avoid burnout.

Config

timezone

Specifies which timezone to define midnight from. If players are split accross multiple timezones UTC should be fine as it will still be a 24 hour period.

maxTime

The maximum time in ticks a player can play on the server alone for. At normal tickrates a tick is 50ms.

nonTrackingPeriods

Times when everyone can play together without playtime being tracked.

Example Config

{
  timezone: "Z", // Z means UTC
  maxTime: "72000", // 72000 ticks - 1 hour
  nonTrackingPeriods [
    {
      start_time: "06:00+01:00", // Time is specified as time with offset in accordance with ISO 8601
      end_time: "08:00+01:00"
    } // Creates a non tracking period between 6am UTC+1 and 8am UTC+1
  ]
}

Commands

The mod has some commands to help with settings and managing playtime

playerplaytime query - Must be run by a player. Returns that player's playtime today in seconds (assuming 50 mspt). Doesn't require any permission level.

playerplaytime query [Player] - Returns specified player's playtime today in seconds. Requires permission level 2.

playerplaytime set [Player] [Time] - Sets the specified player's playtime today to the time specified (in ticks). Requires permission level 3.

playerplaytime config reload - Reloads the config file if any changes have been made. Requires permission level 2.

playerplaytime set maxTime [Time] - Sets the maxTime in the config to the number specified. Requires permission level 2.

playerplaytime get maxTime - Returns the maxTime from the config. Requires permission level 2.