ClientStats [Bukkit/Spigot]

Tested Minecraft Versions:

1.7
1.8
1.9
1.10
1.11
1.12
1.13
1.14
1.15
Source Code:

https://github.com/MineTheCube/ClientStats
The plugin is in beta. Please report any bugs in the discussion!
Want to run this on Bungee? Here you are!

.

Description
Did you ever asked yourself how many players joined your server since startup? And what is the most used version? The average playtime? Then this plugin is what you need!

To use version detection, your server has to accept multiple versions of Minecraft, but it's not mandatory. To accept different versions, you can use one of these:
- ViaVersion (use latest)
- ProtocolSupport (use latest)
- Spigot protocol hack (1.7/1.8)

Installation
No configuration is needed, just drag and drop the file ClientStats.jar into your plugins folder. A config will be created, that you can edit to change all the messages as your needs.

Commands
The base command is /clientstats, but there are shorter alias: /cstats, /cs or /scs.

Command list:
/cstats stats - Statistics of the day
/cstats version - Versions of player who joined
/cstats online - Versions of currently online players
/cstats player [player] - Version of a player
/cstats reset - Reset tracked stats
/cstats reload - Reload configuration
/cstats - Display theses commands

Permissions
You only need the following permission to access to every commands of the plugin: clientstats.admin

Also, to be excluded from statistics, you need to have this permission: clientstats.exempt

But you can give only access to some parts with these permissions:
- clientstats.cmd.stats
- clientstats.cmd.version
- clientstats.cmd.online
- clientstats.cmd.player
- clientstats.cmd.reset
- clientstats.cmd.reload

Developper API
Use ClientStats API to access to stats, or get protocol/version name of a player. After adding ClientStats.jar to your build path, fetch API like that:

Code (Java):

// Get ClientStatsAPI
ClientStatsAPI cstats = ClientStats.getApi();
// Check if it is useable
if (cstats != null && cstats.isVersionDetectionEnabled()) {
// Get a player
Player p = Bukkit.getPlayer("Notch");
// Get his protocol version (e.g.: 47)
int protocolVersion = cstats.getProtocol(p.getUniqueId());
// Get the version name (e.g.: "1.8 - 1.8.9")
String versionName = cstats.getVersionName(protocolVersion);
}

See Github project for sources and API.

Bugs & suggestions
Do NOT use reviews for bugs or suggestions, but please post it in discussion with many details as needed
.
AdriGamer2950, Capricho, kraken_ and 11 others like this.

Recent Updates

Add 1.15.* version support Feb 2, 2020
Full 1.13 and 1.14 support Sep 22, 2019
Add 1.12.2 Sep 18, 2017

Read all 17 updates...

Recent Reviews

soufreur78

5/5,

Version: 2.9.0
Très bon plugin permettant d'obtenir de précieuses informations sur nos joueurs. Le développeur est vraiment compétent et répond rapidement !
Very good plugin to get some informations about our players. The developer is really competent and helpful

Jan 28, 2020
1. Author's Response
  Well I'm glad to know that everything is working for you! Thanks for the review tho :)
_SHO_

5/5,

Version: 2.9.0
Thanks for the long-awaited update..............................................

Sep 23, 2019
1. Author's Response
  You're welcome, and sorry for the delay!
Roadhog360

5/5,

Version: 2.8.5
Great plugin. Keeps track of how many players use new and old versions!
Could I make a request in PMs? PM me if so.

Feb 16, 2018
1. Author's Response
  Thanks! You can submit suggestions in the discussion, PMs or in an issue on GitHub :)
KMinecraftPL

5/5,

Version: 2.8.5
Brilliant! I need these features! My only and last question is: I want to use it with Skript plugin (& it's add-ons), so if for example player joins from 1.12 they get an apple, if from 1.8 they get a diamond etc.? If not, please, could you make a Skript addon for this plugin soon? I'll love you for that. ~NorteX (a.k.a. KMinecraftPL IGN)

Feb 6, 2018
1. Author's Response
  Thanks for the review :)
  For the suggestion, send me PM so we can talk about this!
EshanK711

5/5,

Version: 2.8.5
Great plugin! Very helpful with all its features! Just needs that database but other then that its perfect!

Jan 2, 2018
1. Author's Response
  Thank you very much for this review! I appreciate it a lot :)
SirCodeBrahs

5/5,

Version: 2.8.5
This plugin has a lot of statistics which I need to track how popular my server is to each and every player. To see what version they like best, so I thank you for this.

Oct 25, 2017
1. Author's Response
  You're welcome!
kraken_

5/5,

Version: 2.8.4
Wow, that gave a LOT more information than I expected. I am impressed, thank you!

Sep 12, 2017
1. Author's Response
  And thank you for the like on all my updates! :)
Shane1199

5/5,

Version: 2.8.4
Amazing plugin! Great for statistics and to know what version you may switch to in the future. Been using it since the start.

Sep 12, 2017
1. Author's Response
  Thanks for reviewing! :D
Tedzi

5/5,

Version: 2.8.4
I've used this plugin in the past, and it's great for tracking statistics specially if you are thinking about changing versions. Good work.

Aug 4, 2017
1. Author's Response
  Thank you for the review!
A248

5/5,

Version: 2.8.3
Thank you!

Very useful for finding out which versions your playerbase likes the most, and how many players you could lose from dropping support for a specific version.

Keep up the good work. I hope you make more excellent plugins in the future.

Jul 20, 2017
1. Author's Response
  Thanks for using ClientStats!