![[IMG]](http://proxy.spigotmc.org/fdb4dc6e057f5862c7358cddd7c123425015b90c?url=https%3A%2F%2Fspigot.therealdan.dev%2Ftimeplayed%2Fbanners%2FTimePlayed.png)
TimePlayed keeps track of how often and long your players are playing on your server, you can use this to gain accurate understanding of how often both your players and staff are actually playing on your server and keep a record of their play time.
/TimePlayed Online opens a UI showing playtime information for all online players.
![[IMG]](http://proxy.spigotmc.org/50c86aba1f22378a0c57396fa4a83347c71f7ac4?url=https%3A%2F%2Fspigot.therealdan.dev%2Ftimeplayed%2Fgifs%2Fonline_players.gif)
/TimePlayed [Player] works for both online and offline players, and has some more in-depth information on that users playtime.
Spoiler: /TimePlayed [Player]
/TimePlayed [Player] opens an overview for that player showing a head entry for each year in which that player has playtime tracked:
![[IMG]](//proxy.spigotmc.org/a84ee7628919a065b30ae204fe5a44ae2c681e7f?url=https%3A%2F%2Fspigot.therealdan.dev%2Ftimeplayed%2Fimages%2F2021.png)
Selecting a year entry will open up a menu corresponding to that year, showing a list of entries for each month within that year:
![[IMG]](//proxy.spigotmc.org/0c2d640d3833b6b1cfd4d173c406682d2da90878?url=https%3A%2F%2Fspigot.therealdan.dev%2Ftimeplayed%2Fimages%2Fjanuary_2021.png)
And finally, selecting a month entry will open up a menu corresponding to that month, showing a list of entries for each day within that month:
![[IMG]](//proxy.spigotmc.org/86b8aa1117d1596cd73910493b9c952aa89fcf41?url=https%3A%2F%2Fspigot.therealdan.dev%2Ftimeplayed%2Fimages%2Fdecember_2020.png)
![[IMG]](http://proxy.spigotmc.org/a84ee7628919a065b30ae204fe5a44ae2c681e7f?url=https%3A%2F%2Fspigot.therealdan.dev%2Ftimeplayed%2Fimages%2F2021.png)
Selecting a year entry will open up a menu corresponding to that year, showing a list of entries for each month within that year:
![[IMG]](http://proxy.spigotmc.org/0c2d640d3833b6b1cfd4d173c406682d2da90878?url=https%3A%2F%2Fspigot.therealdan.dev%2Ftimeplayed%2Fimages%2Fjanuary_2021.png)
And finally, selecting a month entry will open up a menu corresponding to that month, showing a list of entries for each day within that month:
![[IMG]](http://proxy.spigotmc.org/86b8aa1117d1596cd73910493b9c952aa89fcf41?url=https%3A%2F%2Fspigot.therealdan.dev%2Ftimeplayed%2Fimages%2Fdecember_2020.png)
/TimePlayed All opens a UI showing the playtime stats for every player captured by TimePlayed (Since it was installed).
![[IMG]](http://proxy.spigotmc.org/c6df5ccab9df964d4077cf363cff91da5ff23cbd?url=https%3A%2F%2Fspigot.therealdan.dev%2Ftimeplayed%2Fimages%2Fall_players.png)
/TimePlayed Active opens a UI showing the playtime stats for the most active players. 'Most active' is determined by two values set in the config, the timeframe to capture only players who have played recently, and the minimum_time to capture players who have played for at least the minimum amount of time. The default settings for these are 7 days and 1 hour, respectively, so this UI shows players who have played for at least 1 hour within the last 7 days.
![[IMG]](http://proxy.spigotmc.org/32370251969664f320067ad3013ad74b3b4dc0c3?url=https%3A%2F%2Fspigot.therealdan.dev%2Ftimeplayed%2Fbanners%2FConfiguration.png)
TimePlayed will run fine the moment you download it. However there are some options in the config.yml you can change.
Spoiler: config.yml
Code (Text):
Colors:
Primary: "&6"
Secondary: "&f"
Permissions:
Required_For_Command:
Timeplayed_Online: false
Timeplayed_Self: false
Timeplayed_Other: true
Timeplayed_Active: true
Timeplayed_All: true
Active:
Timeframe: 604800000 // milliseconds (7 days)
Minimum_Time: 3600000 // milliseconds (1 hour)
Primary: "&6"
Secondary: "&f"
Permissions:
Required_For_Command:
Timeplayed_Online: false
Timeplayed_Self: false
Timeplayed_Other: true
Timeplayed_Active: true
Timeplayed_All: true
Active:
Timeframe: 604800000 // milliseconds (7 days)
Minimum_Time: 3600000 // milliseconds (1 hour)
![[IMG]](http://proxy.spigotmc.org/b41d238c70e664fc41373c0bdb59040ab71fd5b1?url=https%3A%2F%2Fspigot.therealdan.dev%2Ftimeplayed%2Fbanners%2FDevelopers.png)
TimePlayed has a fairly solid API which you can hook into to get access to a number of handy methods.
Code (Text):
TimePlayedAPI timePlayedAPI = TimePlayed.getAPI();
Spoiler: TimePlayedAPI interface
Code (Text):
interface TimePlayedAPI {
ITimeData getTimeData(UUID uuid);
List<ITimeData> getActive();
List<ITimeData> getActive(boolean orderByPlaytime);
List<ITimeData> getAll();
boolean isAFK(OfflinePlayer player);
}
ITimeData getTimeData(UUID uuid);
List<ITimeData> getActive();
List<ITimeData> getActive(boolean orderByPlaytime);
List<ITimeData> getAll();
boolean isAFK(OfflinePlayer player);
}
Spoiler: ITimeData interface
ITimeData represents the stored playtime data for a single player
Code (Text):
interface ITimeData {
UUID getOwner();
long getTimePlayedWithin(long start, long end);
int totalSessions();
List<ISession> getSessions();
long getTotalPlaytime();
String getFriendlyTotalPlaytime();
long getAveragePlaytime();
String getFriendlyAveragePlaytime();
long getFirstLogin();
String getFriendlyFirstLogin();
long getLastLogin();
String getFriendlyLastLogin();
}
UUID getOwner();
long getTimePlayedWithin(long start, long end);
int totalSessions();
List<ISession> getSessions();
long getTotalPlaytime();
String getFriendlyTotalPlaytime();
long getAveragePlaytime();
String getFriendlyAveragePlaytime();
long getFirstLogin();
String getFriendlyFirstLogin();
long getLastLogin();
String getFriendlyLastLogin();
}
Spoiler: ISession interface
ISession represents a single playtime session
Code (Text):
interface ISession {
boolean contains(long timestamp);
long getStart();
long getEnd();
boolean hasEnd();
long getLength();
String getFriendlyLength();
}
boolean contains(long timestamp);
long getStart();
long getEnd();
boolean hasEnd();
long getLength();
String getFriendlyLength();
}
![[IMG]](http://proxy.spigotmc.org/ddf7202116356a7d1b24815cdbc46106b74f502d?url=https%3A%2F%2Fspigot.therealdan.dev%2Ftimeplayed%2Fbanners%2FPermissions.png)
timeplayed.command.timeplayed.* Access to all timeplayed commands
timeplayed.command.timeplayed.online Access to /TimePlayed Online
timeplayed.command.timeplayed.self Access to /TimePlayed [Player] for self
timeplayed.command.timeplayed.other Access to /TimePlayed [Player] of other players
timeplayed.command.timeplayed.active Access to /TimePlayed Active
timeplayed.command.timeplayed.all Access to /TimePlayed All
Quick facts
- Edition: Minecraft Java
- File type: .jar
- Minecraft version listed: 1.16
- How to install: Install the matching mod loader (Forge, Fabric or NeoForge) for your Minecraft version. → Download the .jar. → Put it in the .minecraft/mods folder and launch that loader profile.
- Where to get it: Opens on Spigot — not every file is mirrored on our own servers.
Install steps are the general flow for this file type — How to install Minecraft Java mods & modpacks walks through it step by step.
TimePlayed is a free Minecraft Java mod. Compatible with Minecraft 1.16. Downloaded 4,242 times (via Spigot). Download it and open it directly in the game.