Heads Plugin API 3 [1.17 - 1.21.x]

Heads Plugin API 3 [1.17 - 1.21.x] -----

Make it easy to use or spawn custom created textured heads from your plugins.

Now compatible with the MineSkin database!

Today we release version 1.5.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.

For server owners
If you are creating a custom category in the categories.yml, you can select which database to use by specifying the loader to be either freshcoal or mineskin. Example:

Code (Text):

customcategories:
rwby:
id: 13
loader: freshcoal
urls:
- rwby
cat:
id: 14
loader: mineskin
urls:
- cat

Dependent plugins:
- HeadsInventory will need to be updated to version 1.4.0
- HeadSweeper 1.2.0 is still compatible with this new version of HeadsPlugin

The default config files have changed, so don't forget to check those if you have any problems upgrading to the new version

For plugin developers
The API remained mosly the same. The only thing that changed is that the HeadsUtils class has one extra method:

Code (Text):

public void setDatabaseLoader(DatabaseLoader loader)

With this method you can set to either use the MineSkinLoader or the FreshCoalLoader:

Code (Text):

HeadsUtils hu = HeadsUtils.getInstance();

// get heads from the MineSkin database
hu.setDatabaseLoader(new MineSkinLoader());
List<Head> mineSkinHeads = hu.getHeads("cat");

// get heads from the FreshCoal database
hu.setDatabaseLoader(new FreshCoalLoader());
List<Head> freshCoalHeads = hu.getHeads("cat");

// get heads from the default database (Freshcoal by default)
hu.setDatabaseLoader(HeadsPlugin.getDefaultDatabaseLoader());
List<Head> defaultDbHeads = hu.getHeads("cat");

For backwards compatibility, don't forget to set the loader back to freshcoal

Other than that the JavaDoc is included in the previous download (v 1.4.2)

----------, May 5, 2017

View on SpigotMC

Resource Information

Author:

----------

Total Downloads: 70,941

First Release: Mar 7, 2016

Last Update: Jul 5, 2025

Category: ---------------

All-Time Rating:

18 ratings

Version -----

Released: --------------------

Downloads: ------

Version Rating:

----------------------

-- ratings

Ask Questions / Get Support