Ever PVP someone or PVE a mob and get no good loot? Feel like you deserve a trophy for your victory? Want a simpler alternative to bigger plugins that implement everything but the kitchen sink? Then PlayerHeads is right for you!  You can now lop off enemies heads in battle, and mount it on a pole for all to fear, wear your opponent's face as a mask like camouflage, or just collect all of the mob heads.

Installation

Place PlayerHeads.jar in your plugins folder, on server start the configuration will be generated.  Remember to remove any outdated playerheads jars when adding the new one.
If you can't be bothered to read the rest of this page, then just watch this video by Awesome_Soul:

Portuguese (Português) video: http://youtu.be/OqhI_oIGPWo
German (Deutsch) video: http://youtu.be/ijEws5yjo6Y

Try It

Server: aztecmc.org (rare drops are enabled for mob and player-heads)
Website: aztecmc.org

Documentation

• Changelog
• Configuration
• Commands
• Permissions
• Frequently Asked Questions (FAQ)

Notes

• PlayerHeads is now translatable! Edit "lang.properties" to whatever phrases you desire.
• lang files will change between releases, when updating be sure to delete the old file if you haven't edited it.
• If you've given people the * permission node, they will get 100% drop rates. If you don't want this to happen, deny (or add negative) nodes for the following: playerheads.alwaysbehead and playerheads.alwaysbeheadmob
• If you want to disable head drops in a specific world, use your permission plugin to deny (or add negative) nodes for the following in that world: playerheads.canbehead and playerheads.canbeheadmob
• If you have any problem using "lang_[language]_[country]_[variant].properties" for any reason, just use the file name "lang.properties" to override messages.
• Spawn mob heads with the following names: #creeper #zombie #skeleton #wither #spider #enderman #enderdragon ... (any many more!)

Known issues

• Renamed heads (with an anvil) don't stay renamed after placing, mining, dropping them.
• If for any reason your mob heads loose their name, you can get it back by placing and mining it.
• If you use the BountyHunters plugin and you have enabled head drops for bounties as well as player head drops from PlayerHeads, both will be dropped - for now, you should disable one or the other. Alternative solutions are being looked at.
• If you use JPerms, users with Op or playerheads.* permission will receive playerheads.alwaysbehead[mob] permissions and have 100% droprate since PlayerHeads permissions nodes are ignored.  It's recommended to use another permissions plugin if this is a concern (LuckPerms, PermissionsEX, GroupManager).

Dev Builds

Development builds of this project can be acquired at the provided continuous integration servers. These builds have not been approved by the BukkitDev staff. Use them at your own risk.

https://ci.meme.tips/job/PlayerHeads (upstream)/ (selected major changes only)

https://ci.meme.tips/job/PlayerHeads-5.x/ (rapid changes and work-in-progress)

Sourcecode / API documentation

We've included the entire sourcecode via github:
https://github.com/meiskam/PlayerHeads

Third-party plugin-developers can view the PlayerHeads API documentation at the following link: https://crashdemons.github.io/PlayerHeads/

Server Support

Current versions of the plugin have been tested as compatible on the following server environments:

• Spigot/Paper 1.8-1.18.2 (Use PlayerHeads 5.20.2 or lower; READ NOTE)
  
• Spigot/Paper 1.19-1.20.4

Server environments that are known to be incompatible:

• Glowstone 1.12 (only partial support is available in PlayerHeads 5.20.2 and lower)

Support should exist for any modern bukkit server with access to authlib which is needed to set textures.

Legacy version notes:

• 5.x drops support for older usernamed-based mobheads (3.x), fixing some longstanding issues with spawn commands; uses vanilla and texured heads exclusively (4.x)
• 4.x introduces new, more reliable support for head textures, more configuration options, updated mobs, and more consistent permission behavior and will continue to receive updates in the future - some older configurations may be incompatible (see the changelog and Configuration page). This version automatically upgrades 3.x heads to 4.x when breaking or dropping heads.
• 3.x maintains the original behavior of the plugin with username-based mobheads, but head skins may be less reliable over time and support has been discontinued.

Legacy version documentation: changelog, configuration, permissions.