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 Falastar:
Hello, thank you for the report. I believe I know which part of code causes this warning (originally as a debug message) and I'll try to work on correcting this this weekend
[there are some concerns about information from early class init before the logger is available - but I should be able to defer that information until load]
This message or the cause should not impact plugin behavior but it definitely is poor form on my part and I'll strive to fix this in the next version
EDIT: Issue where you can track progress of this when there is progress to report. https://github.com/crashdemons/PlayerHeads/issues/87
Hi, even though I allowed permission for default players as well as the nodes I cannot get them to spawn their own heads. I want them to be able to /playerheads spawn (name)
It shows this error: "Im sorry, but you don't have permission to perform this command. Please contact the server administrators if you think this is a mistake." I set pkonly to false and allowed these permission nodes. What am I missing? Would love some help, thanks!
In reply to lapstle:
Well, if they have playerheads.canbehead and playerheads.canlosehead permissions, they should be able to drop a head.
I would check what the droprate (config option is just "droprate") is for your playerheads. (1.0 is 100%) - excluding any setting that would block it like requireitem.
Another consideration is whether you have any other plugins that would impact item drops or heads (incl custom items). If there is a plugin that could be blocking drops, you may want to change the "antideathchest" config option which will spawn the drop outside of the user's normal drops.
Remember to /ph config reload if you change the config file - otherwise please modify the config through the /ph config ___ set commands.
Can you post your config, which playerheads permissions you gave to users, and if there are other relevant plugins?
Also if it is not too much trouble, which permissions plugin do you use?
Thank you.
how can i make it so a player drop head only once
In reply to heybangsie:
Sorry, that feature is not supported by the plugin at this time. It is possible for someone to add this behavior through a third-party plugin though by intercepting head drops
Hi I wanna know how do i color the beheaded chat im using server hosting aternos so i can rely on console or on commands sorry begginer here tysm for answer
In reply to ravendefro:
If you have access to the config files, you will need to edit the lang.properties file in the PlayerHeads configuration folder (plugins/PlayerHeads/lang.properties)
The entries you're looking for are BEHEAD_GENERIC, BEHEAD_OTHER, and BEHEAD_SELF.
If you want to add colors to the messages, I think you can just type the formatting code for it, using an ampersand in front (like &c for light red).
You will need to save the file, and the changes will not be applied until a server restart, I believe.
Let me know if that works.
Hello there I've been using your plugin for like 3 days and I got a problem with the drop rate that is 100% on mobs, I have changed the drop rate from 0.001 0.1 0.00000001 and still drops non stop, the only way that I can stop it is set it to 0.0, is there a real way to decrease the mob rate? cuz any % that is not 0.0 drops the head
In reply to rw_loothill:
If heads are dropping 100% of the time, then the users receiving constant drops are most likely receiving the "playerheads.alwaysbeheadmob" permission. You will need to negate or deny this permission to the relevant user groups through your Permissions plugin (like LuckPerms).
These permissions are actually defined to be denied by the plugin by default but certain permissions plugins or selection of permissions can cause them to be received anyway)
Also, if you are using the "star" (* or playerheads.*) wildcard permissions, you could remove those and explicitly define which permissions you want to give instead.
If you happen to use JPerms and you have Op or a wildcard permission, there is an incompatibility because that plugin gives all subpermissions regardless of plugin-defined permissions and no further support will be provided for that plugin.
In reply to crashdemons:
Actually worked! Thank you so much Sir
hey! love this plugin. but im having problems with the heads i want it so the chances of a head spawning when u kill someone to be around 45% but idk how to do it. im very new to plugins so ik its probs something in the config but idk how to make it that way. hope u
respond
In reply to alplayz_everything:
Hi! you can change the droprate of a player's heads by using the command /ph config set droprate 0.45
(you can alternatively change this in the config.yml if you use the /ph config reload command.)
this will change the droprate for players, if you want to set the droprate for a mob, the names of the config (mobnameheredroprate) can be found here
https://dev.bukkit.org/projects/player-heads/pages/configuration-4x
Keep in mind if you have playerheads.* permission or are op you might receive 100% droprate until you deny the playerheads.alwaysbehead permission.
Let me know if you have any other issues.
Hello, good plugin! Only one question, how can I disable the interact with the heads? I mean, I dont want them to show who's the head when right clicked, that message that says "That's [Player]'s head¨¨" Thanks!
In reply to gonzalo20o0:
you would need to deny the playerheads.clickinfo permission in your permissions.yml or permissions plugin. In some plugins you can set the permission to Deny, some other you have to give the permission with a minus sign in front to negate it instead of denying
In reply to crashdemons:
Hello thanks for your answer. I don't have permissions plugin in my server and when I try to edit permissions.yml it seems that it is empty. I am quite new into plugins. What should I do?
In reply to gonzalo20o0:
I would recommend adding a plugin like LuckPerms (or at your preference: GroupManager or PermissionsEx). Then you can use /lp group default permission set playerheads.clickinfo false or the equivalent which sets the permission to deny for everyone (everyone is in the default group for LP). There are also user-specific permissions commands if necessary.
A permissions plugin will make it easier to manage permissions from plugins without needing to edit the YML and adds the ability to assign people to permission "groups" for users like staff or VIP.
Permissions are a fairly standard feature for modifying many different plugins behavior, so a permissions plugin is almost a must these days.
Its great but I'm op and I'm getting a 100% droprate on heads. But I am also using luckperms and made the group "owner" has playerheads.alwaysbehead and playerheads.alwaysbeheadmob set to false but yet I'm still getting 100%
In reply to LastChip:
I don't have this behavior on our server or tests.
I would recommend checking that you used /lp group groupname permission set playerheads.alwaysbehead deny - then you can look for possible other problems:
/lp check usernamehere playerheads.alwaysbehead will tell you if a player receives the permission (collectively from their personal permissions, their groups, etc).
/lp group groupname permission check playerheads.alwaysbehead will tell you if the group has the permission
/lp group groupname permission checkinherits playerheads.alwaysbehead will tell you if the group inherits that permission from elsewhere.
Luckperms groups also have "weights" which mean higher-weighted groups override permissions from lower-weighted ones, if you have any other groups.
Finally, using the star permission "playerheads.*" or "*" is strongly not recommended and instead you should give specific command permissions.
If you're still unable to identify the source of the permission, please send the groups the user has, the permissions for the groups, and your PlayerHeads config and I will try to identify/reproduce your problem. (pastebin.com is preferred for posting long text).
Great Plugin!!!!!
It seems that op have a 100% droprate on heads, is there a way to disable this to normal droprates?
In reply to Beaushangles:
If you scroll down you'll see I've answered this question a few times.
You need to deny the playerheads.alwaysbehead and playerheads.alwaysbeheadmob permission in your plugin or permissions.yml. How you do this depends on whether and which permissions plugin you use (I recommend LuckPerms).
Why does this happen? Well, it honestly shouldn't, because I have these permissions set to be denied by default, even for ops (in recent releases). So this is usually due to overzealous permissions plugins, the use of the playerheads.* permission, or an outdated version of PlayerHeads.
Some questions that will help reduce my own hair-pulling:
Which permissions plugin do you use, if any? which exact PlayerHeads version are you using? Which server /version are you using?
Thank you
EDIT: I'm unable to reproduce this issue on 1.8 or 1.16.5 servers with either v4.7.0 (three years old) up to v5.2.15 (newest alpha) without a permissions plugin - neither regular players nor ops received 100% droprates / alwaysbehead. So I'm thinking this must be either playerheads.* permission or the specific permissions plugin.