This update brings some major changes to Heads Leaderboards. But don't worry, it's still backwards compatible with your old leaderboards!! :) The first change you will notice is that the leaderboard.yml is gone and replaced with a Leaderboards directory containing a separate file for each leaderboard. Everything else is related to MySQL leaderboards. In the new yml's for the leaderboards you will notice plenty of new options. First, Database is now a variable for each leaderboard. This will allow you to connect different leaderboards to different databases. Solving one of the most requested features. Second, you will notice a variable for usingUUID. When set to true, you can use a UUID column instead of playernames and the plugin will plugin the playername from Mojang. Third, you will notice the variable for multiStat. When enabled and setup this will allow you to show two stats on one table. For instance you could have a pvp leaderboard that shows both Kills and Deaths of the leaders. The leaderboard will still be sort by the first stat.


FFS - Head's Leaderboards Finally Supports Flat File Storage. You don't have MySQL, NO WORRIES. Supports both JSON and YML filetypes. Supports files named by UUID or PlayerName.

Version 3.6 has continued to build Flat File support by adding the ability to use sqlite flat file databases (like ScoreboardStats uses, ie. ".db" files). You can do this by creating a SQL leaderboard and enabling flatFileDB in the leaderboard.yml. You will also have to set the path to the db file in the leaderboard.yml. This is the path from the server directory including the filename. (ie. For ScoreboardStats this would be: \plugins\scoreboardstats\scoreboardstats.db) **

One point about using .db files is that you still need to know the table and column names. To find these you can use a SQlite DB Browser

What does this Plugin Do?

This plugin allows you to create sign leaderboards (with heads) using data in a MySQL database OR Flat File Storage. This plugin does not track any player data!! It merely gives you another way to display the data stored in your MySQL database OR store by minecraft or other plugins in Flat File Storage (Such as Kills, Wins, etc...).


  1. Copy the Jar file to your plugins directory.
  2. Edit the created config or use the Setup command to enter the required information for the MySQL database.
  3. Enable the plugin using the Enable command or by updating the config.
  4. Create your leaderboard(s).
  5. Edit the leadarboards.yml or use the Setup command to enter the required information for your leaderboard.
  6. Enable your leaderboard using the Enable command.
  7. Create leaderboard signs and place heads above them.

Basic Tutorial (Needs to Be Updated - Coming Soon)

Advanced Tutorial

Customizing Signs Tutorial

Commands and Permissions

/hlb setupStart the setup utility to enter the Database information in Config.ymlhlb.commands
/hlb enableEnables or disables the pluginhlb.commands
/hlb create <leaderboard> <leaderboard type>Creates a new leaderboard named <leaderboard> of the type <leaderboard type>. Leaderboard type bust be either "sql" for MySQL or "ffs" for Flat File Storagehlb.commands
/hlb delete <leaderboard>Deletes the leaderboard named <leaderboard>hlb.commands
/hlb listLists all of your created leaderboardshlb.commands
/hlb setup <leaderboard>Starts the setup utility for the selected leaderboardhlb.commands
/hlb enable <leaderboard>Enables or disables the selected leaderboardhlb.commands
/hlb reloadReloads the plugin config fileshlb.commands
/hlbupdateUpdates all enabled leaderboardshlb.update
Allows the user to create and destroy HLB signshlb.signs
Color Codesblack(0), dark blue(1), dark green(2), dark aqua(3), dark red(4), dark purple(5), gold(6), gray(7), dark gray(8), blue(9), green(a), aqua(b), red(c), light purple(d), yellow(e), white(f)You can use either the "color name" or the "Minecraft Color Code", but do not use the &

MySQL Leaderboard Sample (Enemy Kills from "Stats" by Lolmewn

Flat File Storage Leaderboard Sample

Flat File SQLite Database Leaderboard Sample

HLB Signs

signsPlace a sign, putting [hlb] on the first line, <the leaderboard name> on the second line, and the position you want to display on the sign on the third line. Optional: Place a Skull above the sign (either directly above or on top of the block the sign is on). Run /hlbupdate or wait for the leaderboard to update!!

To Do List

  1. Customizable colors for HLB signs.
  2. The ability to do reverse order leaderboards.
  3. The ability to set the length of the leaderboards.
  4. The ability to use databases that store player names in a separate table.

Compatible Plugins

The following plugins have been tested and work with HeadsLeaderBoards. In addition, any MySQL database created by a bukkit plugin should work. If you encounter a plugin/database that doesn't work, please create a ticket and I'll look into it.


This plugin now uses Metrics. This will help me keep track of how many servers are using the plugin. The plugins metrics can be view at the link below. To opt out of metrics, set opt-out: to "true" in the metrics config in your plugins directory.



  • To post a comment, please or register a new account.
Posts Quoted:
Clear All Quotes

About This Project



Recent Files