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.
The new version still doesn't fix the problem with mob heads always dropping. It's like the plugin ignores the config file. Can you please look into this? Or, at least, give us a permission to add in order to keep the heads from always dropping? I've tried adding the permission -playerheads.alwaysbeheadmob to fix the problem but it doesn't seem to work. I really like your plugin and appreciate the time you put into it.
I've uploaded the new version, but it must be "approved" before the link becomes publicly visible. Should be any time now.
@c0dejunkie
I received a PM from BukkitDev Staff, apparently me linking to the file before it's approved is against the rules, so I've removed it.
Update for 1.5.1 please.
There's no download link for the new version..
@c0dejunkie
I still can't find it
@VladasX
if you still haven't found it then take a look at the change log up above :)
Were is the update?
To everyone with drop rate problems:
It should be fixed with v3.0.0088. If you've added temporary permissions they should no longer be necessary.
@Yank33s0028
Please paste me a crash log, I can do no help without it.
@nanoymaster
Adding heads of custom mobs is possible, but it requires me to use a player account, and upload a skin of that player that looks like whichever mob. This means i need 1 new minecraft account for every new addition. I've already had 3 donations, which is why we have the spider, enderman, and blaze. Feel free to send me a MC giftcode and I'll add the mob of your choosing.
1.5.1 Update please.
@bestlike2
It is broken. I really want it to be updated.
Is this plugin broken?
I changed in the config that i want mobs drop heads. Then i changed the droprate to 0.00001 and it drops still 100%
How i fix that?
@joehot200
Or... Add an option in the config how many times a player can kill the same player in a row. This still may not stop the bot, but you/your server's staff must be idiots if you don't notice them botting (random accounts joining in and not saying a thing).
This would also prevent friends 'helping' each other to get tons of their masks (if they don't mind high death rates).
@Dsarver
Why not just make it so it only works if the person they are killing has armour on, or something like that?
I have been using this plugin on my server for a long time, then suddenly today it crashed my server, then my server wouldn't start again. When I uninstalled, my server started working. Is the plugin broken or is there a bug or something? I really want it fixed or something because I love this plugin, and so do my players.
Ok so this is a really great plugin I like it alot, I really do.
But on my server I use this in corelation with the shopkeepers plugin to encourage PvP so you can trade kills for items, make since? But a problem I have noticed is that if someone wanted to they could set up a bot with 2 accounts to spam kill the other and get heads while they are sleeping, litterally! So an idea I have to fix that would be is it possible you could add a new property to the config file in the next update?
headsperhour 0 - 99999
-> Determines the most heads a single player can drop per hourThanks in advance!
Update to 1.5?
Is this plugin broken?
I changed in the config that i want mobs drop heads. Then i changed the droprate to 0.00001 and it drops still 100%
How i fix that?
so an op by default has this bypass?
thus I need to give him this?: -playerheads.alwaysbeheadmob
@c0dejunkie
Sorry my suggestion did not work for you bud :(
Try this and see if this works. Give them this negative permission node and hopefully this nails it for you.
-playerheads.alwaysbeheadmob
@M3DDLER
these are the only perms that my default group has: - playerheads.canbehead - playerheads.canbeheadmob - playerheads.canloosehead
and they still get mob heads 100% of the time, even when drop rate is set to 0%. Right now I have the drop rates set to their default setting and they still get mob heads 100% of the time.