ClientStats [Bungee] 2.8.5

Track how many players joined and their versions

  1. MTC
    Tested Minecraft Versions:
    • 1.7
    • 1.8
    • 1.9
    • 1.10
    • 1.11
    • 1.12
    Source Code:
    The plugin is in beta. Please report any bugs in the discussion !
    Want to run this on Bukkit/Spigot? Here you are!


    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)


    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.

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

    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

    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.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 = ProxyServer.getInstance().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 :)

Recent Updates

  1. Add 1.12.2
  2. Add 1.12.1 & bug fix
  3. Add 1.12 and latest snapshots

Recent Reviews

  1. Gurugs12
    Version: 2.8.5
    Nice Plugin, but you can add a lot of features:
    - MySQL for all time stats
    - More diffrent stats, for exemple: wich servers are the most used or average player ammount
    - Webinterface for nice management (i know thats need a lot of time)

    Thank you for your work! <3
  2. xXTheCreepyBoyXx
    Version: 2.8.5
    Good plugin and developer but if you add MySQL Support will be add the 5 Stars! Come on guy you can :)
  3. ssamjh
    Version: 2.8.5
    Very nice plugin.

    It is extremely useful to see the most popular version of MC on your server. It has helped us make many decisions as to remove support for older versions.
    1. MTC
      Author's Response
      Glad to know that it helped!
  4. 8Marc8
    Version: 2.8.3
    Here are the ★★★★★ for your fast update.
    I use the plugin for my network since January and it's really useful.
    1. MTC
      Author's Response
      Thanks for the ★! haha
  5. AliMahmutoglu
    Version: 2.8.3
    Plugin is very very beautiful, but ı found bungeecord console error! please fixed

    [SEVERE] Haz 08, 2017 2:17:25 PM net.md_5.bungee.event.EventBus post
    WARNING: Error dispatching event PostLoginEvent(player=CroseBoy_99) to listener [email protected]18
    at fr.onecraft.clientstats.bungee.BungeePlugin$1.getProtocol(
    at fr.onecraft.clientstats.common.core.AbstractAPI.getProtocol(
    at fr.onecraft.clientstats.common.core.AbstractAPI.registerJoin(
    at fr.onecraft.clientstats.common.core.EventListener.onPlayerJoin(
    at fr.onecraft.clientstats.bungee.dispatcher.EventDispatcher.on(
    at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method)
    at sun.reflect.NativeMethodAccessorImpl.invoke(Unknown Source)
    at sun.reflect.DelegatingMethodAccessorImpl.invoke(Unknown Source)
    at java.lang.reflect.Method.invoke(Unknown Source)
    at net.md_5.bungee.event.EventHandlerMethod.invoke(
    at net.md_5.bungee.api.plugin.PluginManager.callEvent(
    at net.md_5.bungee.connection.InitialHandler$6$
    at io.netty.util.concurrent.SingleThreadEventExecutor.runAllTasks(
    at io.netty.util.concurrent.SingleThreadEventExecutor$
    at Source)
    1. MTC
      Author's Response
      I'll send you a PM right now ;)
  6. Dorian349
    Version: 2.8.3
    Thanks so much for the 1.12 support :D
    Amazing plugin ! /////////////////////////////////////////////
    1. MTC
      Author's Response
      Thanks! :D
  7. MyKayros
    Version: 2.8.0
    He would be cool if one could put this information on a site, otherwise great the plugin;) good luck for the continuation.
    1. MTC
      Author's Response
      Thanks, but I don't have so much time to make this kind of feature.. It won't happen shortly, but it is planned ;)
  8. Braditanium
    Version: 2.8.0
    Very useful, and overall just fun stats to see for server owners, especially finding peak play times and how long players stay on the server.
    1. MTC
      Author's Response
      Thanks :)
      Indeed, that's exactly what the plugin is made for!
  9. Gabo963
    Version: 2.7.6
    Incredible plugin, 5 star, but can I add a custom version in the config? for example I've added huzuni in the config for check the cheater in the server
    1. MTC
      Author's Response
      This isn't possible, as Huzuni doesn't send anything to server to indicate that it is being used..
      But thanks for the review :)
  10. Inamine
    Version: 2.7.6
    This works perfectly and will be an awesome resource to help me track what versions are more popular with my players. I also really like the Max online players part that tracks the highest amount of players! Thanks for making this!
    1. MTC
      Author's Response
      And thanks to you for your great review :D