Stats v5.3.6-BETA

Track your players and gather interesting statistics about them!

  1. Lolmewn
    Native Minecraft Version:
    Legacy (< 1.13)
    Tested Minecraft Versions:
    • 1.13
    • 1.14
    Source Code:
    https://gitlab.com/lolmewn/stats-plugin/
    Stats - made by Lolmewn

    This is the newest release for Stats. Version 5 is built completely from the ground up and already contains exciting new features.
    Website coming soon!

    Supported Stats
    Right now the following Stats are supported and tracked for everyone:
    - Blocks broken (including location, type & timestamp)
    - Blocks placed (including location, type, tool & timestamp)
    - Playtime (including world)
    - Kills (including world, victimType, victimName & weapon)
    - Deaths (including location & cause)
    - Arrows shot (including world)
    - Beds entered (including world)
    - Buckets emptied (including world & type)
    - Commands performed (including world)
    - Damage taken (including world & type)
    - Eggs thrown (including world)
    - Fish caught (including world & type)
    - Food consumed (including world & type)
    - Items crafted (including world & type)
    - Items dropped (including world & type)
    - Items picked up (including world & type)
    - Times kicked (including world)
    - Last join (including world)
    - Last quit (including world)
    - Move (including world & type)
    - PVP (including world, victimType, victimName & weapon)
    - PVP streak (including world)
    - Times sheared (including world & type)
    - Times joined (including world)
    - Tools broken (including world & type)
    - Trades performed (including world, item & price)
    - Words said (including world)
    - XP gained (including world)

    If any stat is missing/not working properly, let me know here: https://gitlab.com/lolmewn/stats-plugin/issues

    Setting up the plugin
    Simply drop the jar in the plugins folder. On first startup, the plugin will generate a config.yml, in which you have to put your MySQL Database credentials. Then restart your server and you're ready to go!

    Seeing your Stats
    You can use /stats to view your individual Stats (hover over a value to see more detailed information).
    In the future, websites can be built to read the database and show statistics on a webpage.

    Signs (from v5.3.2)
    Simply put down a sign with [Stats] on the first line, and it'll start the configuration process for that sign. Please note that you need the permission node stats.sign.place, and to remove a Stats sign, you need permission node stats.sign.break.

    You can either display a Single, multiple or a random stat on the sign. Furthermore, you can specify a single, multiple, a random or all online players to show up on the sign. Please note that some stats do not show up when using random stats for all players, such as Last join, Last quit and PVP kill streak. They don't really make sense.

    Disclaimer
    This build is mostly intended for new users of Stats. This build will not convert old data (Stats 2 / Stats 3) data into Stats 5 data (yet). Watch for updates on when this is supported.
    Furthermore, all gathered statistics are sent to a global server which will be used to display statistics on a website, just like with Stats 2. Will we reach 219 years of playtime again?


    Below is info on Stats 3, the previous version of the plugin. It can still be used, but will not be developed for anymore.
    Stats 3 details below


    This plugin is licensed GPLv3

    NOTICE: I'm looking for a new maintainer for the plugin. I unfortunately cannot give this project the love that it so desperately needs. If you're interested, hit me up on Telegram (t.me/lolmewn) or send me an email (lolmewn[at]gmail.com)

    Plugin description
    Stats is an advanced statistics gathering plugin, currently focussed on player statistics. Information such as PVP kills, blocks broken, playtime and much more. You can store this data as simple files, or store them in a MySQL database. The benefit of using the database is that you can also use any web-end out there to display your players' statistics on your website.

    How to install
    To install the plugin, simply drag-and-drop the Stats.jar into your 'plugins' folder.
    When you start the server, a "Stats" folder will be created, containing a config file.
    For a detailed description on the config file, click here.
    The most important option is "storage", which can be set to either "flatfile" or "mysql" by default.
    If you choose MySQL, there is another file (mysql.yml). Fill in your MySQL details there. That's all!

    If you're installing a web-end as well, please read the instructions for said web-end on how to install it.
    A list of web-ends compatible with Stats 3:

    List of available Stats
    This is a list of all available stats. Please note that there might be more stats in your environment, as other plugins can add their own stats to the plugin. For those stats, please see the documentation of the plugin providing them.

    |Stat name|Description|Available Metadata|
    |Arrows|Amount of arrows shot (not hit!)|world|
    |Beds entered|Self-explanatory|world|
    |Blocks broken|Self-explanatory|world, name, data (see here for more info)|
    |Blocks placed|Self-explanatory|world, name, data (see here for more info)|
    |Buckets emptied|Self-explanatory|world|
    |Buckets filled|Self-explanatory|world|
    |Commands done|Amount of commands done|world|
    |Damage taken|Self-explanatory|world, cause|
    |Death|Amount of times died|world, cause|
    |Eggs thrown|Self-explanatory|world|
    |Fish caught|Self-explanatory|world|
    |Items crafted|Self-explanatory|world, name|
    |Items dropped|Self-explanatory|world, name|
    |Items picked up|Self-explanatory|world, name|
    |Joins|Amount of times joined the server|None|
    |Kill|Amount of kills gotten|world, (name of) weapon, entityType|
    |Last join|Last time (in milliseconds epoch time) joined the server|world|
    |Last seen|Last time (in milliseconds epoch time) left the server|world|
    |Money|**Not yet functional**|world|
    |Move|Amount of blocks moved|world, type (0 = walking, 1 = boat, 2 = minecart, 3 = pig, 4 = on a pig in a minecart, 5 = horse, 6 = flying)|
    |Omnomnom|Amount of food eaten|world|
    |PVP|PVP kills gotten|world, victim (UUID of the other player), time (in milliseconds epoch time), (name of) weapon|
    |PVP streak|Current kill-chain, gets reset when killed|world|
    |PVP top streak|Highest PVP streak ever achieved - may be moved to Highscores in the future|world|
    |Playtime|Time in seconds played on the server|world|
    |Shears|Amount of sheeps sheared|world|
    |Teleports|Amount of times teleported|world|
    |Times kicked|Self-explanatory|world|
    |Tools broken|Self-explanatory|world, name|
    |Trades|Amount of times traded with a villager|world|
    |Votes|**Only works when Votifier is enabled**. If the player name is not found, the vote is ignored|None|
    |Words said|Amount of words said|world|
    |Times changed world|Self-explanatory|None|
    |Xp gained|Amount of XP gained in total|world|

    Tickets and Source
    Found a bug? Want a new feature? Want to see how Stats is built?
    You can find all and more here: https://bitbucket.org/Lolmewn/stats/overview
    ethem00, gameout, hou19960228 and 7 others like this.

Recent Reviews

  1. Nico1813
    Nico1813
    4/5,
    Version: v5.3.6-BETA
    Does it works with 1.15 and 1.16?
    .
    1. Lolmewn
      Author's Response
      It should! Let me know if you run into any problems.
  2. Anderson66
    Anderson66
    2/5,
    Version: v5.3.6-BETA
    Plugin works but has memory leak. I created an issue on github 3 weeks ago but nothing changed :/ On the big server the plugin can destroy your GarbageCollections causing a lot of Full Pauses
  3. Scottbass
    Scottbass
    5/5,
    Version: v5.3.6-BETA
    Nice plugin,
    I deleted my last review because I realised what I was asking was already implemented.
    But I still think some translation files could be really nice. If you add that I could give you my french translation so you could share it.
    1. Lolmewn
      Author's Response
      Please create a ticket on my gitlab so I don't forget!
  4. TheTaskerko
    TheTaskerko
    5/5,
    Version: v5.3.6-BETA
    Pretty nice plugin, I was expecting a bit bigger config, I was surprised when I saw few lines of config file :D. But I think there should be option for "update interval" in config. After all I like it!
    1. Lolmewn
      Author's Response
      What would this option do? I'm open for suggestions to make the plugin even better!
  5. AshuGuptaGamer
    AshuGuptaGamer
    5/5,
    Version: v5.3.6-BETA
    Please update it 1.15.2, It not working in it. here is the error:

    [14:03:48 WARN]: Unexpected exception while parsing console command "stats"
    org.bukkit.command.CommandException: Cannot execute command 'stats' in plugin Stats v5.3.6 - plugin is disabled.
    at org.bukkit.command.PluginCommand.execute(PluginCommand.java:37) ~[patched_1.15.2.jar:git-Paper-143]
    at org.bukkit.command.SimpleCommandMap.dispatch(SimpleCommandMap.java:159) ~[patched_1.15.2.jar:git-Paper-143]
    at org.bukkit.craftbukkit.v1_15_R1.CraftServer.dispatchCommand(CraftServer.java:752) ~[patched_1.15.2.jar:git-Paper-143]
    at org.bukkit.craftbukkit.v1_15_R1.CraftServer.dispatchServerCommand(CraftServer.java:714) ~[patched_1.15.2.jar:git-Paper-143]
    at net.minecraft.server.v1_15_R1.DedicatedServer.handleCommandQueue(DedicatedServer.java:469) ~[patched_1.15.2.jar:git-Paper-143]
    at net.minecraft.server.v1_15_R1.DedicatedServer.b(DedicatedServer.java:431) ~[patched_1.15.2.jar:git-Paper-143]
    at net.minecraft.server.v1_15_R1.MinecraftServer.a(MinecraftServer.java:1112) ~[patched_1.15.2.jar:git-Paper-143]
    at net.minecraft.server.v1_15_R1.MinecraftServer.run(MinecraftServer.java:934) ~[patched_1.15.2.jar:git-Paper-143]
    at java.lang.Thread.run(Thread.java:748) [?:1.8.0_241]
    1. Lolmewn
      Author's Response
      Check your logs, there is an earlier error causing the plugin to disable itself (probably mysql misconfigured)
  6. Beasty_Buildes
    Beasty_Buildes
    5/5,
    Version: v5.3.6-BETA
    I love the plugin but may I ask what are the placeholders for the playtime I can't seem to find them!
  7. Ruptic
    Ruptic
    4/5,
    Version: v5.3.6-BETA
    The only thing that I suggest is having PlaceHolder support! It is very needed in my opinion.
  8. DragonKingSwe
    DragonKingSwe
    4/5,
    Version: v5.3.6-BETA
    really good plugin. but please update to 1.15.1 so that i can use it on my server now that I've updated it to 1.15!
    1. Lolmewn
      Author's Response
      Does it not work on 1.15? I think it should, but let me know if it doesn't!
  9. Jowcey
    Jowcey
    5/5,
    Version: v5.3.6-BETA
    Excellent Plugin, very well programmed which makes it super easy to add your own stats if you know basic java and sql :)
    1. Lolmewn
      Author's Response
      Thanks <3
  10. MauriceLPs
    MauriceLPs
    3/5,
    Version: v5.3.6-BETA
    Its a good Plugin. But does have this Plugin an in-built API too? I want to retrieve Data though it in my Plugins. If this is solved, 5/5 Stars.
    1. Lolmewn
      Author's Response
      Sort of, but they're not documented. If you look through the source, specifically the Listener classes for data addition or the Command handler class for data retrieval, I'm sure your plugins will be able to get the data out.