v5.21.0 alpha - allow loading in Spigot 1.21

- merge compatibility packages down to just 1.21

- drop support for everything under 1.21
- apply fixes to load in Java 21 and Spigot 1.21
- add code to block changes to heads with HeadDB/hdb username.

v5.20.4 alpha

missed a line

v5.20.1 - 1.20 heads, vanilla piglin head support

This is an alpha version undergoing more rigorous testing. The following changes have been included:

Adds 1.20 heads (sniffer, camel) [from dev build 5.20.0]
Fixes Piglin heads to use the new vanilla piglin head.

NOTE: these changes appear to work on 1.20.x but still need testing on 1.8-1.12 and 1.14-1.19 to ensure they spawn a playerhead correctly.
For best results, ensure your server is running at least Java 17 until compatibility with Java 8+ can be confirmed.

The PlayerHeads API increased in version to 5.20.1 to force build compatibility, but otherwise remains compatible with 5.2.17 (see previous Release)
The Compatibility API/Library added the Piglin Head to CompatibleSkullMaterial and the SkullType shim with 5.20.1 (TBA)

v5.2.19 - 1.19 heads

Changed: Wolf head texture was changed by request.
Added: Provisional heads for 1.19 mobs were added
Bugfix: fix for exception while using the new Behead Nearby experimental feature.

No API changes have occurred since 5.2.17 (for use in your plugin that integrates with PlayerHeads)
No Major compatibility changes have occurred since 5.2.14 (for head support functions in your own plugins)

v5.2.8-beta

provisional zoglin head support (1.16 preview)

5.2.3 alpha

added: configuration option "ignoredheadnames" which is a list of head names that PlayerHeads will avoid modifying, detecting, or otherwise interacting with. Slimefun heads ("CSCoreLib" heads) are now ignored by the plugin by default to avoid breaking custom items from that plugin.
added: configuration option "ignoredheaduuids" which is a list of head uuid strings that PlayerHeads will avoid modifying, detecting, or otherwise interacting with.
Note: at this time, the reload and config commands do not affect currently blocked heads - this requires a server reload. this will be resolved in a future version.

API: there are no significant API changes since 5.2.0

v3.10-2cc6552 (legacy 1.9.4 build - do not use)

legacy 1.9.4 build from past snapshot - do not use

4.2.3 stable

Updates the PlayerHeads plugin with support for all 1.13+ mobs, introduces more reliable head-texturing support, and expands upon the configurability and consistency of the plugin.

Backwards-compatbility notes:

• Recognizes older username-based heads and updates them when dropped as items
• Some configuration changes may be needed since 3.13, 3.12 and lower (see below)

---

Changes since 3.12:

• Changed: Adds code-shims that replace 1.12 behavior with 1.13-supported behavior
• Fixed: Fixes several cases where a NullPointerException can occur for unknown heads (since patch1)
• Changed: Corrected configuration and language settings for the Wither boss and Wither Skeleton to match their updated Entity name [Backwards-Incompatible Change]
  • lang entries WITHER changed toWITHER_SKELETON to match entity name
  • lang entries WITHER_BOSS changed to WITHER to match entity name
  • config entry witherdroprate changed to witherskeletondroprate to match entity name
  • config entry witherbossdroprate changed to witherdroprate to match entity name
• Fixed: Possible NullPointerException when user without clickinfo permission interacts with a head.
• Changed: Updated several head skins, leaving support for existing ones
• Fixed: Fixed mobhead name resolution when the owner name changes after owner is resolved. (name case changes)
• Fixed: Changes drop conditions to apply to skeletons properly for updated entity types (since patch2)
• Fixed: Fixed wither skeleton incorrectly reading drop rates from wither boss' configuration (since patch3)

Changes since 3.13:

• Changed: Legacy (username-based) head support has been deprecated, but is still recognized as valid mobheads
• Added: New (texture-url-based) head support added as default for drops. these should be more maintainable and searchable than the old heads. (since 4.0-alpha)
• Added: Adds a mob-head drop for every living entity in 1.13 (aside from armor stands and giants)
• Fixed: Handled several null-head-owner bugs in 3.x
• Fixed: Corrected spacing in lang file entries that require it.
• Added: New config option: dropvanillaheads (default: true) - sets whether applicable mobs should drop their associated vanilla head item when killed. If this is false, the mob will drop a skinned playerhead instead. This also affects which head is dropped when breaking a plugin-recognized head. (since 4.1.1-alpha)
• Added: Lore for plugin-added heads.
• Added: New config option: convertvanillaheads (default: false) - When false, avoid converting the type of head of when its block is broken. When true (or pre-4.2), the head is automatically converted to vanilla or skinned depending on the state of dropvanillaheads setting. (since 4.2.1-alpha)
  • Setting this to false keeps heads as they were when placed and broken
  • Setting this to true forces items to convert to the desired drop type (vanilla or skinned) when broken.
• Changed: Behavior for player and mob-head drops now requires canbehead or canbeheadmob permission regardless of the state of pkonly, permitting more specific configuration of the plugin and more consistent permission behavior. You are still able to reproduce the old behavior by ensuring the default permissions group for players has the playerheads.canbehead and playerheads.canbeheadmob permission when you disable pkonly/mobpkonly. [Backwards-Incompatible Change]
• Added: New spam prevention when players hold down or spam right-click on placed heads. (for users with the playerheads.clickinfo permission).

Contains all changes from:

• 4.2.3-beta (current)
• 4.2.2-alpha
• 4.2.1-alpha
• 4.1.1-alpha
• 4.0.2-alpha
• 4.0-alpha
• 3.13
  • 3.12-shimmed1.13-patch3
  • 3.12-shimmed1.13-patch2
  • 3.12-shimmed1.13-patch1

3.13 stable

Updates the PlayerHeads plugin from version 1.12 support to 1.13+ with a focus on making minimal behavior changes to the existing plugin.

Changes since 3.12:

• Changed: Adds code-shims that replace 1.12 behavior with 1.13-supported behavior
• Fixed: Fixes several cases where a NullPointerException can occur for unknown heads (since patch1)
• Changed: Corrected configuration and language settings for the Wither boss and Wither Skeleton to match their updated Entity name [Backwards-Incompatible Change]
  • lang entries WITHER changed toWITHER_SKELETON to match entity name
  • lang entries WITHER_BOSS changed to WITHER to match entity name
  • config entry witherdroprate changed to witherskeletondroprate to match entity name
  • config entry witherbossdroprate changed to witherdroprate to match entity name
• Fixed: Possible NullPointerException when user without clickinfo permission interacts with a head.
• Changed: Updated several head skins, leaving support for existing ones
• Fixed: Fixed mobhead name resolution when the owner name changes after owner is resolved. (name case changes)
• Fixed: Changes drop conditions to apply to skeletons properly for updated entity types (since patch2)
• Fixed: Fixed wither skeleton incorrectly reading drop rates from wither boss' configuration (since patch3)

Contains all changes from:

• 3.12-shimmed1.13-patch3 (current)
• 3.12-shimmed1.13-patch2
• 3.12-shimmed1.13-patch1

4.2.2-alpha

NOTE: This build introduces breaking changes to permissions. Be sure to read carefully!

Changes:

• When pkonly is disabled for player-skull drops, canbehead permission is now enforced for player-kills, whereas it was not in 3.12 and is not my current 3.x branch.

  • Old behavior: canbehead permission is not checked when pkonly is disabled. (original plugin behavior)
  • New behavior: canbehead permission is now required for player-kills nomatter if pkonly is disabled or enabled.

• When mobpkonly is disabled for mob-skull drops, canbeheadmob permission is now enforced for mob-kills, whereas it was not in 3.12 and is not on my current 3.x branch.

  • Old behavior: canbeheadmob permission is not checked when mobpkonly is disabled. (original plugin behavior)
  • New behavior: canbeheadmob permission is now required for player-on-mob-kills nomatter if mobpkonly is disabled or enabled.

You are still able to reproduce the old behavior by ensuring the default permissions group for players has the playerheads.canbehead and playerheads.canbeheadmob permission when you disable pkonly/mobpkonly.

Not Changed: pkonly still prevents the player from beheading themselves, mobpkonly skill prevents mobs from beheading themselves.

In addition to making sure the permission is functional, this also permits some more specific configurations like mob-only player-skull drops, or mob-only mob-skull drops.

See #6 (comment) for detailed information on this change

(changelog is since 4.2.1 release)