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

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
Resource Information
Author:
----------
Total Downloads: 66,442
First Release: Mar 7, 2016
Last Update: Dec 17, 2024
Category: ---------------
All-Time Rating:
18 ratings
Version -----
Released: --------------------
Downloads: ------
Version Rating:
----------------------
-- ratings