Bukkit

PlayerHeads 5.2.12 Compatibility Lib

• project organizational change: compatibility projects are now under their own PlayerHeads-compatibility project to further isolate/organize them
• project organizational change: 1.16 support has been rolled-into the "1.13" provider with proper checks to save space and duplicate code.
• internal fix: craftbukkit-support no longer will attempt to set a texture when using createProfile unless the texture parameter is non-null and non-empty
• abstraction additions: compatibility-api now provides a new CompatibleProfile class which relevant support libraries (ie: craftbukkit, paper) can complete to provide access to profile information in heads (user, uuid, texture) easier to developers.
• added: CompatibilityProvider:createCompatibleProfile creates a CompatibleProfile object for you, implemented by a support class, but exposing methods for you to access and change username,uuid,texture.
• added: CompatibilityProvider:getCompatibleProfile retrieves profile information from a Skull blockstate or SkullMeta wrapped in a CompatibleProfile support implementation.
• added: CompatibilityProvider:setCompatibleProfile sets profile information in a Skull blockstate or SkullMeta using a CompatibleProfile created or retrieved before
• added: CompatibilityProvider:getCompatibleHeadItem creates an ItemStack of the base head item used to implement a vanilla skull in the current version (from CompatibleSkullMaterial).
• security note: JUnit security issue GHSA-269g-pwp5-87pp was resolved in this release by updating junit - this issue would only be relevant to developers running internal PH project tests, if at all.

Aside: It is hoped that by adding the ability to create head types (incl. player-type heads) compatibly and providing the tools to directly modify profile details, third-party head support may be easier to implement.
Because of how much control you get from the CompatibleProfile APIs, these supercede and may eventually deprecate the OptionalProfile APIs from the previous release.

Note: This library is not a plugin - it is intended for developers wanting to add support for heads to their own plugins without reliance on PlayerHeads and this contains all of the version-specific support libraries from PlayerHeads for your use.  More information (and how to use) can be found on the page for the first compatibility-lib version released.

Compatibility Documentation: https://crashdemons.github.io/PlayerHeads/

This library is also available as a Maven dependency called "PlayerHeads-compatibility-lib" and can be added to your project in similar to how the PlayerHeads-API is added.  Just, don't forget to shade the classes into your project.