ClientStats [Bukkit/Spigot]

Tested Minecraft Versions:

1.7
1.8
1.9
1.10
1.11
1.12
1.13
1.14
1.15
1.16
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.16.* version support Nov 11, 2020
Add 1.16 and 1.16.1 support Jun 24, 2020
Add 1.15.* version support Feb 2, 2020

Read all 19 updates...

Recent Reviews

FoxCraftGaming

5/5,

Version: 2.11.1b
its a great plugin! could you please add placeholder support for placeholderapi, like %clientstats.version% or something like that. Thanks!

Dec 22, 2020
1. Author's Response
  Thanks for the review! Unfortunately I don't have very much time right now, but I wrote down your idea so maybe one day: https://github.com/MineTheCube/ClientStats/issues/10 :D
Vasquezfr15

5/5,

Version: 2.11.1
thanksss youuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuu
is a god idea. really good ideea

Jun 29, 2020
1. Author's Response
  thank youuuuuu for your review haha!
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