GBUtils.TimePlayed
GB.TimePlayed
GB.TimePlayed
Tracks how much time your players have spent playing on your server, and announce it when they join and leave.
Features
- Announce how much time a player have spent on your server
- In total
- Current session
- Configurable join, leave and query messages
Installation
- Download the latest version, from here
- Copy to your plugins/ folder
- Restart your server
- Edit the plugins/GB.TimePlayed/config.yml file to setup the plugin
- Restart server to reload changes
Screenshot
A player has just joined
Configuration
All entries under config.announcements is the text used when announcing events to the server.
- config.announceOn.logon:
- Announces "announcements.logon" or "announcements.newPlayer" when a player logs on
- config.announceOn.logoff:
- Announces "announcements.logoff" when a player disconnects
- config.announcements.newPlayer:
- If config.announceOn.logon is enabled, sent to entire server when a player logs on, and he hasn't played here before
- config.announcements.logon:
- If config.announceOn.logon is enabled, sent to entire server when a player logs on, and he has played here before
- config.announcements.logoff:
- If config.announceOn.logoff is enabled, sent to entire server when a player logs off
- config.announcements.userQuerySession:
- Sent to the querying player, when he uses /gbt session
- config.announcements.userQueryTotal:
- Sent to the querying player, when he uses /gbt total
Tokens
The following tokens can be used in any of the text entries in the config.announcements section.
- %PLAYER%
- The players name
- %PLAYERDISPLAY%
- The players displayname
- %TOTALTIME%
- Total time player has played on server
- %TOTALLOGONS%
- The number of times the player has logged on
- %SESSIONTIME%
- Total time player has played this session (Only makes sense in logoff announcements, will be 0 in logon)
Color codes
You can use standard colorcodes in your announcements
Code | Color |
---|---|
&0 | Black |
&1 | Dark blue |
&2 | Dark green |
&3 | Dark aqua |
&4 | Dark red |
&5 | Dark purple |
&6 | Gold |
&7 | Gray |
&8 | Dark gray |
&9 | Blue |
&A | Green |
&B | Aqua |
&C | Red |
&D | Light purple |
&E | Yellow |
&F | White |
User commands
The following commands are available to the players.
- /gbtimeplayed session
- Reports to the player how long he has played on your server, in the current session
- /gbtimeplayed total
- Reports to the player how long he has played on your server, in total.
- /gbtimeplayed help
- Shows ingame help
Alternate command
You can use /gbt instead of /gbtimeplayed
Changelog
v1.0.7
- Updated to craftbukkit-1.2.5-R3.0
v1.0.6
- Updated metrics to revision 5
v1.0.5
- Updated to craftbukkit-1.2.5-R1.0
v1.0.4
- Updated to craftbukkit-1.2.4-R1.0
v1.0.3
- Handled not logging players login-time, for whatever reason. This plugin will not work if time is not logged, but at least it gives a more meaningful error, instead of throwing an exception.
v1.0.2
- SEVERE error on logoff should be fixed now
v1.0.1
- Fixed colorcodes to work 100% of the time
v1.0
- First release
Are you going to update this plugin to 1.2.4?