You now get a better message when HeadsPluginAPI throws a LockingException, so that players are better informed.

This update makes HeadsInventory compatible with HeadsPluginAPI 3.0.0

Note: this will also make this version only compatible with mc 1.17+ and only works using Java 17.
If you need to support an older mc version or if you are using an older java version, you'll need to stay on HeadsInventory 1.10.1, which require you to use HeadsPluginAPI 2.x.

The categories overview won't be broken anymore if a category isn't loaded or if a category icon is missing.

At the moment FreshCoal seems to be down. This causes issues for first time users of the plugin.

Due to this, /headsinv cat doesn't work out of the box atm.

To fix this you can edit the config.yml file in HeadsInventory to only include categories other than those from freshcoal

Alternatively, you can use the data.zip file from the HeadsPluginAPI download page and unzip it in <server>/plugins/HeadsPluginAPI. make sure to remove the data folder that is already there before you unzip though

This update makes HeadsInventory compatible with HeadsPluginAPI 2.0.0

NOTE: minimum Bukkit/Spigot version is now 1.13!

Bugs and issues can be reported on my Discord channel and/or in my issue tracker: https://github.com/CC007/HeadsInventory/issues

Damn those missing return statements

This update is mainly for those who want to implement their own payment system for getting heads. With this update it is now possible to prevent someone from getting the head if they don't have the requirements that you specify (not enough funds or items, like diamonds to get the head).

Note: if you don't need any payment system for your heads, you can just ignore this update.

This version adds support for using the minecraft-heads.com categories. This was needed, because the custom search broke down after a change to that website.

Sadly this means that /headsinv mhsearch will no longer be available, but fortunately you get access to the following categories from minecraft-heads.com: mh-alphabet, mh-animals, mh-blocks, mh-decoration, mh-food-drinks, mh-humans, mh-humanoid, mh-miscellaneous, mh-monsters and mh-plants. These categories are now also available when doing /headsinv cat

For all previously mentioned changes I needed to make quite some changes to config.yml. While all changes are backwards compatible, it would have meant that the new minecraft-heads categories wouldn't be available through the UI of /headsinv cat.

For that reason I changed the plugin so that when a new version is released, it will change the config to the new default.This means that any changes you made to config.yml need to be backed up before updating the plugin and re-added what you need from the config file after the update! You most likely only changed config.yml if you changed the positions and head icons of the categories, or if you selected a different locale.

This update unifies the <=1.12 and 1.13 version.

It also fixes an issue that caused HeadsPluginAPI to be loaded twice.

While it might still work, I am dropping support for minecraft 1.7.10. If you want to continue using it and you run into problems in HeadsInventory 1.8.0, I suggest you use HeadsInventory 1.7.1 instead (With HeadsPluginAPI 1.7.1)

If you want to use these translations, don't forget to change the locale in the config.yml:
Major thanks go to classmate_potato for the Chinese translation and Rene98 for the Dutch translation.

This update contains an update to the tab completion. What made me decide to improve it was the new suggestions feature that is present in mc 1.13. The changes were also made to my <1.12.2 version of the plugin, so that those can also benefit more from tab completions.

The second change in this update is the ability to support translation/localization.

The locale can be changed in the config.yml file. If you add the line:
Eg, for french:
Or for Flemish:
At the moment only the English "translation" is present (en_US), but now it is also possible to add other languages without difficulty.
If a language is not supported, it will fall back to the English translation.

I NEED YOU
Yes you! I need people to help me translate my plugin. I have a translation file available on my Discord page ( discord.gg/pNuAnPs). It would be awesome if you could send me that file with the text in a different language. Make sure to only change the text on the right side of the equals sign in the file. Also, don't forget to mention the locale of the translation when you send your translated version to me.

Due to some people still downloading the 1.13 version for their older servers, I decided to make a download available where they can download both the version for 1.8-1.12.2 and the version for 1.13.

Warning! For this to work in 1.13 you need HeadPluginAPI 1.7.0-1.13 specifically. Otherwise the plugin will not work.

Warning! This version ONLY works in 1.13. Use HeadsInventory v1.6.0 if you want to use this plugin for version 1.12.2 or earlier (And use it with HeadsPluginAPI 1.7.0)

Other than that: have fun with using this plugin in version 1.13

As requested by a few of the users, this plugin now supports heads from minecraft-heads.com

IMPORTANT: Searching through this database is very slow! While it doesn't impact the performance of the server itself, it can take between 1 and 3 seconds per head to load. This means that trying to load 50 heads can take over 2.5 minutes! (for this reason a progress message was added for manual search). This is a limitation on the side of the database, not on the side of the plugin, so I have no control over this. While the search is in progress, you can still do everything in minecraft and it shouldn't cause any disconnects.

Users:
As an example, if you want to search for 'doge', in the minecraft-heads.com database, you can use the following command:

Server owners:
You can add a custom categories that use minecraft-heads.com in the following way to categories.yml of HeadsPluginAPI:

Release 1.5.1
- minor bugfixes

Release 1.5.0
- Added support to add the head of your current skin to the Mineskin.org database using this command:
Here <name> is the name that you want to give to this head so that you can find it with the command:
This update needs HeadsPlugin v1.6.1

Today we release version 1.4.0! This version includes support for searching through the MineSkin database, the website from Inventivetalent that has a skin/heads database just like Freshcoal. While this database has less heads than Freshcoal, searching through it is way faster than searching through Freshcoal's database.

To use this update you will need to update HeadsPlugin to version 1.5.0

Some commands have been changed / added:

• /headsinventory fsearch <searchTerm>: this command lets you search through the FreshCoal heads database
• /headsinventory msearch <searchTerm>: this command lets you search through the MineSkin heads database
• /headsinventory search <searchTerm>: this command lets you search through the default heads database (the default is Freshcoal, this will be customizable in a future version)
  
• /headsinventory searchfirst has been similarly altered with msearchfirst and fsearchfirst. Also instead of using searchfirst, you can use /headsinventory getfirst

Changes v1.3.0
- Added firing a HeadGivenEvent when giving a head to a player (added so that other plugins can listen for this event (think about economy plugins charging for getting the head or making permissions to only get certain kinds of heads).

Changes v1.2.0
- Added the Category UI: "/headsinv cat" no longer gives a list of all categories, but opens an inventory UI that shows categories. Clicking the category automatically opens that category's UI.