Player Heads
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
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.
In reply to crashdemons:
where do i get the craftbukkit spigot orpaper server
In reply to king_adam3085:
You can find Paper at https://papermc.io/ (paper automatically patches into the minecraft server jar)
You can find Spigot at https://www.spigotmc.org/wiki/spigot-installation/ (spigot requires building the server jar with BuildTools before use).
CraftBukkit is now maintained internal to Spigot or Paper.
(Note: the reason you can't download the full spigot or paper server directly is for legal restrictions on Minecraft code. Paper is less steps though.)
Background: 'Bukkit plugins' (as found on this website) are not supported by the vanilla minecraft server, but require modifications to the server to allow changes. The benefit of 'Bukkit' servers is they allow users with the vanilla game to connect without mods to a server that easily allows changes.
Hello, I want to mention that with 1.16 approaching, development has begun to add the Piglin and Hoglin heads on schedule.
However, there is a concerning matter with the update: Zombie Pigmen are changing to Zombified Piglins in the update - aside from the name change, they also have a change in appearance in Minecraft.
While it's completely possible to change the name and texture of the ZombiePigman head, it would break stacking and trades that people rely on from previous versions. Another option is to make a separate head entirely for zombified piglins, but this introduces much of the same problem as well as creating heads only obtainable on older versions.
Currently, for the best compatibility with older versions and older worlds, the plan is to keep the current Zombie Pigman heads as the drop for Zombified Piglins.
Feel free to voice your feedback to these planned changes as a reply. Thank you.
Hi, I'm Spanish, so forgive any mistake, now my problem is that when I kill a mob or loose its head, it takes another texture called customheads, I don't know what it is.
gameplay 1.15.2
In reply to leoroll15:
Which version number of PlayerHeads do you use?
My first guess is that the problem is related to a additional plugin that you are using. Do you have a plugin that might be modifying head items or modifying dropped items?
Thank you.
I use paperMC 1.15.2 build 85.
PlayerHeads 5.2.5
I have not changed my config at all, but since updating to 1.15.2 players keep reporting that they are getting no where near as many mob heads as they were on 1.1.4.X
Please could you advise what the cause of this would be?
In reply to rangewonk:
I just tested using both the newest spigot 1.15.2 and with paper 85 with a set droprate on a mob and after killing a lot of them I got the expected droprate.
I can't reproduce the issue you report.
You might look into your other plugins which may change behavior with the update - anything that could modify/protect drops or death events could be a concern (enabling antideathchest may help if it is a drop modification). It may be useful also to verify user permissions are correct (playerheads.canbeheadmob) and whether the cause of mob death is unusual / plugin-related.
CraftBukkit version git-Spigot-b9baf71-e82b547 (MC: 1.15.2) (Implementing API version 1.15.2-R0.1-SNAPSHOT)
---
Paper version git-Paper-85 (MC: 1.15.2) (Implementing API version 1.15.2-R0.1-SNAPSHOT)
hi i have a question.
I'm using the default configuration, why is my head drop rate 100%
my version is 1.12.2
plugin version is 5.2.5
console no any error report
In reply to 1212march:
Ops and players with the playerheads.* permission have playerheads.alwaysbehead and playerheads.alwaysbeheadmob by default regular players will not. If you must have Op and normal drops for ops, then you will need to negate those permissions (see FAQ Entry #9 ).
Thanks for the help ^ ^
Hey, another question.
If you set the lootingrate to 0.1, would looting 3 give a 30% chance, and looting 1 give a 10% chance? Or is it a 10% chance for all looting levels?
In reply to vict0rylive:
each looting level would add 10% of the base droprate for that entity, not a flat 10% chance added.
the looting modification looks like this on a head roll:
newDropRate = oldDropRate * (1 + lootingrate * lootinglevel)
that is, the current droprate is added to the fractional-increase of the droprate. (so that the change to droprate is always proportional to the original droprate.)
Hey, I have 1 problem, and 1 question.
- "/ph config set mobdroprate" says (unset)
- If possible, can I get rid of the text saying "PlayerHeads MobDrop"
Thanks!
In reply to vict0rylive:
There is no setting mobdroprate. there is a setting for each individual mob. If you want to set all mobs easier, look at a few comments down where I supplied a sample config that can easily have 0.02 replaced with the desired rate (and do ph config reload after you save the config.yml) although you will need to add beedroprate.
Regarding the second question, you can change the setting addlore to false, but keep in mind heads with/without the loretext will not stack or be compatible in villager trades. (although dropping the head or placing/breaking it may update it to the desired appearance depending on your settings).
In reply to crashdemons:
Ah, alright. Thanks for the help
Hi, I want this plugin to only give me Player heads, I want to keep the traditional way of receiving mob heads. how would I go about doing this? Just set all the mob settings to 0? Would that affect the traditional way of Charged Creepers/Wither Skeletons from dropping them?
In reply to FireHiveRS:
if you use the newer versions, you can set all mobs droprates (and the player "droprate" if you want) to -1 and set the "behavior" settings to either vanilla or ignore. this will prevent PlayerHeads from adding any drops and force vanilla behavior.
Alternatively, you could instead deny (negate) the permission playerheads.canbehead and playerheads.canbeheadmob for players which disallows them from getting PlayerHeads beheading.
---
context:
in versions 5.1 and higher, a negative droprate forces PlayerHeads to stop processing the death event without further consideration or cancelling. Before 5.1 (since version 3.12), this only applied to witherskeletondroprate.
witherskeletonbehavior and chargedcreeperbehavior are overriding behavior settings (the default ignore setting deactivates them, vanilla forces processing to stop early). So ignore with a droprate of -1 should be the same as vanilla.
changing all the droprates to 0 except the vanilla mobs that drop heads (with those as behavior:ignore and _droprate:0 or -1, or behavior:vanilla) should function the same, but is not as future-proof in case a new server version adds old heads (albeit unlikely).
---
if you want to maintain vanilla heads you might want to read about a couple other configuration options to decide if you want to disable them - like convertvanillaheads and fixdroppedheads.
Let me know if you have any problems.
what command would i do to change player head spawn rate. when i do /ph config set i cannot find anything for players
In reply to Jmcbaa:
you're looking for the configuration setting called droprate. For backwards-compatibility reasons, the name of this setting wasn't changed to playerdroprate since that would break existing configurations from version 3.
So if you want player's heads to drop with a 1% chance, you would do:
/ph config set droprate 0.01
All of the configuration options and descriptions can be found at this link.
is there a way to set all of the droprates of all mobs, instead of doing them manually 1 by 1?