SpigotVIP TimePlayed [API] [SQL] ARCHIVE

Tested Minecraft Versions:

• 1.8
• 1.9
• 1.10
• 1.11
• 1.12

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 will open the following UI, showing playtime infomation about all online players;


/TimePlayed Active will open a UI that lists your most active players (Played within last week, ordered by Total play time).



/TimePlayed [Player] works for both online and offline players, and has some more in-depth information on that users playtime.



/TimePlayed Group [Group] will open a UI based of a grouping system you can use, specify as many groups as you want in the config.yml and then give your users the permission timeplayed.groups.<group>, then run the command above and it will open a UI containing all the players will that permission node.

/TimePlayed All will open a UI that shows the TimePlayed stats for every player captured by TimePlayed (Since it was installed).



Edit the rewards.yml to send players messages and/or run commands for reaching certain amounts of total-playtime, average-playtime, playing X amount of times or a mixture of each.

- Add as many rewards as you want
- Add as many messages per reward as you need
- Add as many commands per reward as you need
- Both messages and commands support the %player% variable
- Commands are run through console
- Each reward is only handed out once per player

The default rewards.yml has 3 rewards;
- Reach 1 minute total-playtime and receive an apple
- Login 3 times and receive 3 apples
- Login 3 times and play for an average of 1 minute and receive a diamond




TimePlayed has a fairly solid API which you can hook into to get access to various methods. TimePlayed customers are welcome to lend their private developers the TimePlayed.jar but only so they can access this API.
Code (Text):
TimePlayed.getApi();
// Returns the API

TimePlayed.getApi().getTotalTimeString(player);
// Returns the playtime of the player, in a user readable format




TimePlayed will run fine the moment you download it. However there are some options in the config.yml you can change.






Groups
Groups can be setup which are used with the /TimePlayed Group [Group] command.
- Add a group under Groups: in the config.yml
- Give the users you want in that group the permission timeplayed.groups.<group>
- Thats the group setup
- However each user in that group will need to login at least once after it has been setup before they will show in the UI


Note: Permissions are also listed in the config.yml

timeplayed.commands.* All TimePlayed command permissions
timeplayed.commands.timeplayed Permission to view own timeplayed stats via /TimePlayed
timeplayed.commands.timeplayed.other Permission to view other users stats via /TimePlayed [Player]
timeplayed.commands.timeplayed.online Permission to view all online players live stats via /TimePlayed Online
timeplayed.commands.timeplayed.all Permission to view all players stats via /TimePlayed All
timeplayed.commands.timeplayed.groups.* Permission to view any group via /TimePlayed Groups [Group]
timeplayed.commands.timeplayed.groups.<group> Permission to view specific groups via /TimePlayed Groups [Group]
timeplayed.cangrab Permission to be able to grab heads from any of the /TimePlayed UIs
timeplayed.groups.<group> Adds user to the group, which will display them in the /TimePlayed Group [Group] UI (Make sure to also specify groups in the config.yml)
Images

1.