Count your blocks and get ranks!


Please post a ticket, if you encounter any issue!


This plugin will count many things, your players are doing and display them on a website:


Players can track their stats server-independent and can compete on a more global level. Later on, players can use the site to show it as a portfolio and proof of work/experience!

Players can view their statistics ingame with "/ranks".
You can change and localize all output of the plugin in locale.dat
For adding a sign with your name:

  • Line 0:[Ranks]
  • Line 1:yourname
  • Line 2:Will be Block-Break
  • Line 3:Will be Block-Place



All plugin settings can be configured in config.yml.

Here is the default configuration as of Version 2.1.11:

#Bukkit deletes comments if you change something, this it the default-configuration!
#enable the plugin?
enabled: true

#enable stats-tracking
#if false, this renders the plugin useless!
stats-tracking: true
#auto-updates the plugin. Old versions will not be supported after some time!
auto-update: true
#if you prefer to give me usage-informations, please enable this. Has no effect on the plugin!
enable-metrics: true

#prints out optional data
verbose: false
#prints out debugging informations
debug: false

#here you can select your method of storage
#MySQL is prefered, if false, sqlite will be used!
Use MySQL: false

#If used, here you can set your mysql-login!
  MySQL-Database: DB
  MySQL-Hostname: localhost
  MySQL-User: user
  MySQL-Password: pw

You can see how the plugin interprets this configuration in the image below:


Stats tracking

This plugin depends on tracking your data. And i want to make this process as transparent as possible!

Below you can find all things i will track and for what they are used. If you have any question, feel free to drop me a pm!

All public view-able data can be seen at http://mcranks.org and there you can see, how your data will be displayed! If you have set enabled or stats-tracking to false in the config.yml nothing will be tracked by my plugin!

NameSince VersionUsed forvisibility
Server IP2.0.1Fraud protectionprivate
Broken blocks per Player and Block type2.0.1Stats trackingpublic
Placed blocks per Player and Block type2.0.1Stats trackingpublic
Online Players2.0.3Stats tracking online timepublic
Plugin Version (server<->BukkitDev)2.0.3Update Checkingon your server
Player Movement2.0.4Stats tracking Blocks walkedpublic
Experience gained per Player2.0.4Stats trackingpublic
Downloading newest ranking2.0.5Ingame commandson your server
Killed entities per Player2.1.15Stats trackingpublic
Damaged entities per Player2.1.15Stats trackingpublic


SQLite in its nature is much slower than MySQL, so if you have a server with many players, you should consider using MySQL!

My plugin has to track many events that are happening on your server. It also has to upload all this data. This task can bring in many performance issues if implemented poorly (I/O in main thread etc.). I am trying to create a plugin, that in no way will impact the performance of any server you run it on. But there will be things i did not thought about, so if your server has issues with my plugin, please post a ticket explaining the problem.

Rest assured, that no networking is done on the Bukkit main thread and stats are highly cached, so it is normal for them to take some time, until they are viewed on the server.

Plugin Metrics

Also, beginning with version 2.1.1 there will be PluginMetrics included. The data collected by Metrics can be viewed at http://mcstats.org/ and you can always opt-out by changing enable-metrics to false in config.yml!


What is exactly read/sent by Metrics? (Copy from the metrics website)

It is not possible for Metrics to control the plugin in any way except for plugin-specific code the plugin author implements. Nothing is downloaded, so what you get is what the plugin author implemented.

The following data is read from the server in some way or another:

  • File Contents of plugins/Plugin Metrics/config.yml (created if not existent)
  • Players currently online (not max player count)
  • Server version string (the same version string you see in /version)
  • Plugin version of the metrics-supported plugin
  • Mineshafter status - it does not properly propagate Metrics requests however it is a very simple check and does not read the filesystem

The following data is sent to http://mcstats.org:

  • Metrics revision of the implementing class
  • Server's GUID
  • Players currently online (not max player count)
  • Server version string (the same version string you see in /version)
  • Plugin version of the metrics-supported plugin
  • Any custom data the supporting plugin implements. This is variable and I am not responsible for this however usually it is just plugin-specific data (e.g for LWC, the database type: MySQL or SQLite, and Locale used (english, german)).

Update checking:

This plugin will automatically check for updates and keep your version up to date. You can disable this in the config by setting auto-update to false. But since api-features will change, after some time, old versions will not work anymore! So please update!

View on the future

If you dislike this change, go ahead and download my 1.1.0 Release and you have the last offline-version of my plugin.

This change is the first one in a series of bigger changes! I stated, that i want this plugin to be more a stats/ranks-plugin than simple counting of blocks. Your rank is now server-independent! And i will track more things like, kills, deaths, distance walked, exp collected, objects crafted, drops collected etc. I think, there are many things worth counted. And server-owners can give People rewards/permissions based on how high their rank is.


  • Counts several statistics
  • Dynamic scoring based on all players
  • Will auto-check on startup for new updates!
  • Players can view their score ingame
  • You can place signs who will display your Rank to all Players passing by


  • Rise custom levels (and get something from it)
  • Add new things to track
  • Overhaul Website to get detailed statistics!


none of today

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

  • Avatar of Kostronor Kostronor Feb 21, 2014 at 07:58 UTC - 0 likes

    @Naverholten: Go

    simply look inside the configuration file? Or look at the main page of this plugin, where you should be at the moment ;)

    My Plugins: Ranks - fastgrow - command-iconomy - vip - delayedcommands BFAK:12282,44e015bcf803893eddb44a07a659b20a19581f36720679af78f03e462ee2c03f

  • Avatar of Naverholten Naverholten Feb 21, 2014 at 00:08 UTC - 0 likes

    @Kostronor: Go

    How would I go about changing the sqlite to mysql?

  • Avatar of Kostronor Kostronor Feb 19, 2014 at 06:57 UTC - 0 likes

    @Naverholten: Go

    Hey, thanks for the bug report! The flooding message is already fixed in 2.1.2 so you can use this version.

    To your Stacktrace: The plugin was designed around mysql but it seems, most people use sqlite over it. Because sqlite is slow, i am using a different thread to update things, but if the database cannot keep up with the new events, this will accumulate over time! Switching to mysql will solve this issue, in the meantime I will try to find a way to ignore updates the server cannot handle!

  • Avatar of Naverholten Naverholten Feb 19, 2014 at 00:56 UTC - 0 likes

    Hey so i recently had a server crash and i believe it was this plugin that caused it, although im not entirely sure as i can't interpret the crash report well enough, for a few days (since i installed the plugin) ive been getting a "material not unique" error with a few more lines beneath it and it floods my server console with it every few seconds, it didnt seem to cause any problems so i left it alone, although i got this today and i am assuming its your plugin as I havent had any problems with my server like this until now..

    1st half of crash report:


    2nd half of crash report:


  • Avatar of Kostronor Kostronor Feb 18, 2014 at 23:00 UTC - 0 likes

    @KingFaris10: Go

    I am making sure that it is not! Protection plugins have much more things they need to log and they are working. You won't notice my plugin...

  • Avatar of KingFaris10 KingFaris10 Feb 18, 2014 at 22:57 UTC - 0 likes

    Isn't this very server-intensive? I'm not sure, but if it's logging so many things...


  • Avatar of Kostronor Kostronor Feb 16, 2014 at 12:23 UTC - 0 likes

    @SomaKhaos: Go

    Hey there,

    please use a ticket for support!

    i have my server running R03 with mysql and i am having no errors...

    please please write a ticket... And include your startup log with one minute time ahead!

  • Avatar of SomaKhaos SomaKhaos Feb 16, 2014 at 04:43 UTC - 0 likes

    Hey there

    I really want to use this plugin, but it doesn't work for me :(

    I have an Bukkit Server on 1.7.2 R0.3 and the plugin doesn't count any of my breaks or places of blocks. And using my MySQL Database

    In the Database i can see, there are changes and there he counts every block break and place, but it is not showed up in-game.

    And the only thing your website is showing me are my online time and my distance

    are there any permissions for this plugin, or how does it work?

    I can't get it to work

    Last edited Feb 16, 2014 by SomaKhaos
  • Avatar of Kostronor Kostronor Feb 10, 2014 at 08:59 UTC - 0 likes

    @JaackMC: Go

    Hey TheChunkWorld, Thanks for telling me that! I will look at it and see if there is something obviously wrong, can you provide me with a test-server if it could be a problem with your server? http://dev.bukkit.org/bukkit-plugins/ranks/create-ticket/?comment=2021128

    Edit: Version 2.1.7 should fix your issues!

    If someone else is encountering bugs, laggs or errors, please open a ticket!

    Last edited Feb 10, 2014 by Kostronor
  • Avatar of JaackMC JaackMC Feb 09, 2014 at 22:41 UTC - 0 likes

    Crashes servers easily. Everything is fine until you run /ranks then it lags out.

    Laminated Wood Mod Tiles Mod

    Minecraft Server: creative-mc.com

    Website: DeadSetCreative


Date created
Mar 17, 2013
Last update
Mar 21, 2014
Development stage
  • enUS
All Rights Reserved
Curse link
Recent files