Stats 3

Stats - made by Lolmewn

Looking for the Stats 2 documentation? You can still find it here.

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.

Installation instructions

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:

Made one, too? Let me know!

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 nameDescriptionAvailable Metadata
ArrowsAmount of arrows shot (not hit!)world
Beds enteredSelf-explanatoryworld
Blocks brokenSelf-explanatoryworld, name, data (see here for more info)
Blocks placedSelf-explanatoryworld, name, data (see here for more info)
Buckets emptiedSelf-explanatoryworld
Buckets filledSelf-explanatoryworld
Commands doneAmount of commands doneworld
Damage takenSelf-explanatoryworld, cause
DeathAmount of times diedworld, cause
Eggs thrownSelf-explanatoryworld
Fish caughtSelf-explanatoryworld
Items craftedSelf-explanatoryworld, name
Items droppedSelf-explanatoryworld, name
Items picked upSelf-explanatoryworld, name
JoinsAmount of times joined the serverNone
KillAmount of kills gottenworld, (name of) weapon, entityType
Last joinLast time (in milliseconds epoch time) joined the serverworld
Last seenLast time (in milliseconds epoch time) left the serverworld
MoneyNot yet functionalworld
MoveAmount of blocks movedworld, type (0 = walking, 1 = boat, 2 = minecart, 3 = pig, 4 = on a pig in a minecart, 5 = horse, 6 = flying)
OmnomnomAmount of food eatenworld
PVPPVP kills gottenworld, victim (UUID of the other player), time (in milliseconds epoch time), (name of) weapon
PVP streakCurrent kill-chain, gets reset when killedworld
PVP top streakHighest PVP streak ever achieved - may be moved to Highscores in the futureworld
PlaytimeTime in seconds played on the serverworld
ShearsAmount of sheeps shearedworld
TeleportsAmount of times teleportedworld
Times kickedSelf-explanatoryworld
Tools brokenSelf-explanatoryworld, name
TradesAmount of times traded with a villagerworld
VotesRemoved since 3.1.1-RC due to incompatibility. If the player name is not found, the vote is ignoredNone
Words saidAmount of words saidworld
Times changed worldSelf-explanatoryNone
Xp gainedAmount of XP gained in totalworld


Some commands require special permissions to be executed. Here is a list with all permission nodes:

NodeDefault valueDescription
stats.viewtrueAccess to /stats
stats.view.otherstrueAccess to /stats <player>
stats.customopGives access to nodes stats.add and stats.create
stats.addopAccess to /stats add
stats.createopAccess to /stats create
stats.adminopAccess to /stats admin
stats.resetopGives access to nodes stats.reset.self and stats.reset.others
stats.reset.allopAccess to /stats reset all
stats.setopAccess to /stats set
stats.sign.placeopCan create [Stats] signs

More info soon


If you feel like giving something back to me, you can donate to me. All income from donations will be spent on coffee or similar.
I'm accepting donations through:

  • Bitcoins on address 1QC19kut8nuMJNAsMZ3QneKuW2a8f5QgQG
  • Dogecoins on address DKN8Lrm4KfC7Jh9M2KopjPkwcRfA7Ak3zj
  • Paypal, either via email lolmewn(at) or via this link

You must login to post a comment. Don't have an account? Register to get one!

  • Avatar of puckman1971 puckman1971 Oct 18, 2016 at 01:30 UTC - 0 likes

    Does anyone know where I can find documentation for the plugin? The info here seems to be incomplete. For example I'm using the sign feature as the web frontend has problems but I dont know the syntax. I found out that [Stats] statname and username works but what if I want the top 10 or something like that?

  • Avatar of Lolmewn Lolmewn Oct 11, 2016 at 22:18 UTC - 0 likes

    @coldice4: Go

    I guess you're right. Anyway, IDs with names can be found here: - List with names is here:

    Waiting to see what's going to become of BukkitDev. May or may not switch to a replacement if it completely dies off (which is what I presume to happen really).

  • Avatar of coldice4 coldice4 Oct 11, 2016 at 17:13 UTC - 0 likes

    @Lolmewn: Go

    Well I couldn't find anything, only that Bukkit/Spigot uses a different map than minecraft

  • Avatar of Lolmewn Lolmewn Oct 10, 2016 at 19:52 UTC - 0 likes

    @coldice4: Go

    No, but they are widely available on the internet.

  • Avatar of coldice4 coldice4 Oct 10, 2016 at 13:50 UTC - 0 likes

    Thanks for this awesome plugin. Works flawlessly on my 1.10 Spigot Server. But I have a question, do you have a file to map the block names saved in the database to their block ids?

  • Avatar of Lolmewn Lolmewn Oct 02, 2016 at 10:36 UTC - 0 likes

    @Metisuneatn: Go

    Check out the updated documentation.

    @KoffeSwed: Go

    Thanks, this feedback helps improve the plugin. </sarcasm>

  • Avatar of KoffeSwed KoffeSwed Sep 11, 2016 at 19:46 UTC - 0 likes

    Plugin seems to be broken. :/

  • Avatar of Metisuneatn Metisuneatn Aug 09, 2016 at 05:09 UTC - 0 likes

    I've been trying to use /stats set but I can't seem to get the block place value. The stats list doesn't work for me, just wondering what to type for the block place? I keep getting block break

  • Avatar of Lolmewn Lolmewn Aug 07, 2016 at 10:29 UTC - 0 likes

    @ChimpGamer: Go

    There is already a ticket for this, I am still looking for a fix.

  • Avatar of ChimpGamer ChimpGamer Aug 06, 2016 at 06:33 UTC - 0 likes

    getting this error: [08:49:29] [Server thread/ERROR]: null Could not check if conversion was done properly at nl.lolmewn.stats.mysql.MySQLStorage.fixConversionError( [?:?] at nl.lolmewn.stats.mysql.MySQLStorage.lambda$enable$77( [?:?] at [spigot.jar:git-Spigot-798f32d-0cd0397] at org.bukkit.craftbukkit.v1_9_R2.scheduler.CraftScheduler.mainThreadHeartbeat( [spigot.jar:git-Spigot-798f32d-0cd0397] at net.minecraft.server.v1_9_R2.MinecraftServer.D( [spigot.jar:git-Spigot-798f32d-0cd0397] at net.minecraft.server.v1_9_R2.DedicatedServer.D( [spigot.jar:git-Spigot-798f32d-0cd0397] at net.minecraft.server.v1_9_R2.MinecraftServer.C( [spigot.jar:git-Spigot-798f32d-0cd0397] at [spigot.jar:git-Spigot-798f32d-0cd0397] at [?:1.8.0_91] Caused by: com.mysql.jdbc.exceptions.jdbc4.MySQLSyntaxErrorException: COLLATION 'latin1_general_cs' is not valid for CHARACTER SET 'utf8' at sun.reflect.NativeConstructorAccessorImpl.newInstance0(Native Method) [?:1.8.0_91] at sun.reflect.NativeConstructorAccessorImpl.newInstance( [?:1.8.0_91] at sun.reflect.DelegatingConstructorAccessorImpl.newInstance( [?:1.8.0_91] at java.lang.reflect.Constructor.newInstance( [?:1.8.0_91] at com.mysql.jdbc.Util.handleNewInstance( [spigot.jar:git-Spigot-798f32d-0cd0397] at com.mysql.jdbc.Util.getInstance( [spigot.jar:git-Spigot-798f32d-0cd0397] at com.mysql.jdbc.SQLError.createSQLException( [spigot.jar:git-Spigot-798f32d-0cd0397] at com.mysql.jdbc.MysqlIO.checkErrorPacket( [spigot.jar:git-Spigot-798f32d-0cd0397] at com.mysql.jdbc.MysqlIO.checkErrorPacket( [spigot.jar:git-Spigot-798f32d-0cd0397] at com.mysql.jdbc.MysqlIO.sendCommand( [spigot.jar:git-Spigot-798f32d-0cd0397] at com.mysql.jdbc.MysqlIO.sqlQueryDirect( [spigot.jar:git-Spigot-798f32d-0cd0397] at com.mysql.jdbc.ConnectionImpl.execSQL( [spigot.jar:git-Spigot-798f32d-0cd0397] at com.mysql.jdbc.ConnectionImpl.execSQL( [spigot.jar:git-Spigot-798f32d-0cd0397] at com.mysql.jdbc.StatementImpl.executeQuery( [spigot.jar:git-Spigot-798f32d-0cd0397] at org.apache.commons.dbcp2.DelegatingStatement.executeQuery( [?:?] at org.apache.commons.dbcp2.DelegatingStatement.executeQuery( [?:?] at nl.lolmewn.stats.mysql.MySQLStorage.fixConversionForDeath( [?:?] at nl.lolmewn.stats.mysql.MySQLStorage.fixConversionError( [?:?] ... 8 more

    Last edited Aug 06, 2016 by ChimpGamer


Date created
Aug 19, 2012
Last update
Sep 27, 2016
Development stage
GNU General Public License version 3 (GPLv3)
Curse link
Stats 3
Reverse relationships
Recent files



Optional dependency
Achievements Reloaded