HeadsPlus
A heads plugin with advanced head drops, crafting, selling, challenges and much more!
- Загрузки
- 8K
- Подписчики
- 25
- Обновлён
- 23 марта 2026 г.
- Лицензия
- GPL-3.0-only
Опубликован 14 августа 2022 г.
Overview
HeadsPlus is one of the most ambitious heads plugin out there, achieving what other plugins have not, and picking up on the smallest details that developers have never thought of before to make one of Minecraft's most valuable items - skulls - bring a whole new world to servers.
The plugin was originally created to replace another heads plugin which was no longer updated and thus wouldn't work on newer versions - except now, HeadsPlus has brought classic concepts to life again with more interesting and exciting additions, and is constantly updated with more exciting features and has an active and committed developer.
Features
- Retrieval of player/custom heads via three different commands: /head, /heads and /myhead.
- A head blacklist/whitelist of which stops players placing heads that belong to specific players - these heads being considered inappropriate.
- Entities can drop their head upon death; and is 99% configurable!*
- A crafting feature, letting you craft heads from shapeless recipes - often consisting of an empty skull and a specific material - or shaped recipes that are completely configurable and incredibly flexible.
- The majority of messages in the plugin are completely configurable.
- A heads selector (/heads) - PLEASE note this is not a database!**
- The ability to sell heads with fully configurable prices.***
- Three different leaderboards for the hunting, selling and crafting skills to compare player scores of others!
- Hundreds of challenges pre-built into the plugin, all with configurable rewards!
- 1.15.2 to 1.19 support.
- A debugging mechanic to help identify the causes of errors easier when reporting an issue.
- The ability to "pick" up heads using the "pick block" button.
- Masks, of which when worn apply potion effects of your choice!
- MySQL support for storing leaderboard data.
- A levelling system, which is also 100% configurable.
* Multiple textures, display names, chances, lores, mask effects/amplifiers and "interact names" - of which are used when clicking on a head - are configurable.
** HeadsPlus is not an extensive or advanced database plugin. This has caused a lot of misunderstanding about it and has led to users of the plugin comparing this to other premium plugins, bullying people into making said plugins free - that is not the aim of this plugin. Only a limited range of heads are available (around 200), however, you can add your own. Rather than compare this plugin to the premium ones, why don't you just go and buy that plugin instead, or find an alternate one?
*** This will require Vault to work.
Requirements
- Vault as a soft dependency.
- Java 8
Knowledgebase
Issue Trackers and Support
Like every other plugin, HeadsPlus is not a perfectly coded plugin. Since starting my new year in school, I have no longer had time to put quantity over quality, and now make sure to extensively test each feature before it is released as a new version.
However, if you do have an issue or have a report to send, follow one of these links below:
Ченджлог
7.2.0Релиз1.21.11 · 23 марта 2026 г.
49582f5 fix: un-limit column updates in stats and chall... - Thatsmusic99
dda4569 chore(deps): update to 1.21.5 - Thatsmusic99
633dd20 fix: check if a next level is indexed - Thatsmusic99
2e2631b chore: formatting - Thatsmusic99
3cf5d32 chore(deps): update PAPI repository and version - Thatsmusic99
797f784 fix: wolf head drops not working - Thatsmusic99
b37ed20 feat: new heads and support for mobs - Thatsmusic99
89d459d chore: add new version checking mechanism - Thatsmusic99
f9afebd fix: set heads.yml version to 4.3 - Thatsmusic99
e669c7e fix: account for new GameProfile properties method - Thatsmusic99
7c0cb93 feat: noteblock sounds - Thatsmusic99
2672dd8 fix: use user_id in pinned challenge removal st... - Thatsmusic99
23d0dc1 fix: persist PAPI placeholders - Thatsmusic99
b59213b feat: uuid placeholders (primarily for bedrock ... - Thatsmusic99
7.1.6Релиз1.21.3, 1.21.4, 1.21.5 · 18 мая 2025 г.
Sorry for my sluggishness here and there - to say it's been a rough start to the year is an understatement, but if you want good news, it'll hopefully be over by July, and I'll have to look into modernising HeadsPlus regardless because of Paper and Spigot's divorce (otherwise known as the soft spoon).
IMPORTANT - DATABASE FAULT
Because of a bug I was not aware of until yesterday, there is a fault in HeadsPlus 7.1.5 that would duplicate statistic entries, despite there being checks in place to prevent it (I believe this was because of another error when trying to save stats to the database). Whilst this visually did nothing, it would result in the database not only being larger than intended, but following an update to another dev build that fixed the aforementioned error, all duplicated entries in the database would be updated, meaning when someone kills a mob that drops a head, it would count it multiple times instead of once.
This update fully reverses that effect, including the database entries being updated multiple times - thus, if you used 7.1.5 and updated to the dev build, you may find that your statistics get lowered - this is expected. It will not un-complete any challenges that would've otherwise been completed (this decision I will leave to server owners/admins). The plugin will automatically detect if the fault is present and reverse its impact, and should complete relatively quickly, but if you have a large server of 10000> players who have joined in the past, I would recommend putting the server in a whitelist temporarily to prevent any issues that may occur (a roughly 850~ player server took 0.2 seconds on SQLite and 1 second on an external MariaDB database to convert).
If you believe something went wrong with the conversion, the old stats are saved into a separate table in the database called headsplus_stats_old, which you can send over to me to check. This process has been thoroughly tested, but do make a backup of the database if you're worried.
I do apologise for the oversight on this - I've been able to add support for the new 1.21.5 mob variants to make up for this (which I have not been able to do already because of backbreaking assignments and exams). When I get back to HeadsPlus as well, do let me know what you'd like to see improved, whether it be in terms of new features, accessibility, etc. - I'd like to go back through the plugin again to make it a bit kinder and more flexible.
Now, onto the actual changelog.
CHANGELOG
664a469 fix: use try-resources with addToTotal - Thatsmusic99
f0a991e fix: make valid inventory checks before checkin... - Thatsmusic99
6b068f6 fix: set rabbit heads to lowercase - Thatsmusic99
f47b5d6 fix: outdated entity name for mooshrooms - Thatsmusic99
dd55697 fix: the uuid might be null, Citizens says politely - Thatsmusic99
ab3e7ed chore: add check for when /head may fail - Thatsmusic99
155108d chore: add debugging to indicate items that couldn't be added through /head - Thatsmusic99
e336cd1 fix: revert back to compiling with 1.20.4 - Thatsmusic99
0ff668d fix: result set closing in MySQL - Thatsmusic99
1f7e6b2 fix(deps): update CM repository - Thatsmusic99
e024024 feat: allow victim price penalty without a killer - Thatsmusic99
c7a6464 fix: limit column updates in stats and challenges to exactly 1 in the event of a strange duplication - Thatsmusic99
dc981e1 chore(version): bump to 7.1.6 - Thatsmusic99
e9d81b7 fix: correct headsplus_stats table fault - Thatsmusic99
49582f5 fix: un-limit column updates in stats and challenges to exactly 1 in the event of a strange duplication - Thatsmusic99
dda4569 chore(deps): update to 1.21.5 - Thatsmusic99
633dd20 fix: check if a next level is indexed - Thatsmusic99
2e2631b chore: formatting - Thatsmusic99
7.1.5Релиз1.20.5, 1.20.6, 1.21 · 22 июля 2024 г.
6e7fcd4 chore: remove usage of multiple DB connections - Thatsmusic99
b8676ab fix: add ratelimit protection from grabUUID - Thatsmusic99
4b5ea53 fix: startup error in 1.21 from recent API changes - Thatsmusic99
12229b1 fix: other changes to 1.21 - Thatsmusic99
b3f8674 fix: close statement early to avoid db locking - Thatsmusic99
7.1.4Релиз1.20.5, 1.20.6, 1.21 · 21 июня 2024 г.
Yeah, this version is literally just silencing that warning that tells you you're using an unsupported server version when on 1.21. Yeah, 7.1.3 works on 1.21.
That being said though, speaking of versions, HeadsPlus' current build system causes issues for testing, version updating and also CI/CD. Because of this, I'll be looking to change this build system to what its sister plugin, AdvancedTeleport, uses in v6. However, a consequence of that will be losing 1.15.2-1.17.1 support. This probably won't apply next update, but probably in the near future - after that point, it should be easier for me to maintain and work on the plugin, so it doesn't look like AT is my favourite child. Tchau.
7.1.3Релиз1.20.4, 1.20.5, 1.20.6 · 11 июня 2024 г.
7.1.2Релиз1.20.4, 1.20.5, 1.20.6 · 7 мая 2024 г.
whoop whoop, thank you for the patience on 1.20.6, it came out right before my exams started :))
Please note that Spigot 1.20.5/1.20.6 made changes to entity names. If you use a custom configuration for mobs.yml, keep a backup of the file to transfer any mob configuration made when updating to 1.20.6.
4ede9d9 fix: everything wrong with the Spigot profile handler - Thatsmusic99
311667f fix: you don't need to add a head multiple times - Thatsmusic99
a27692b fix: index out of bounds when price lore is removed - Thatsmusic99
dde4e3f fix: set heads to player names where necessary - Thatsmusic99
2ffa2eb chore(mc): update to 1.20.5 - Thatsmusic99
b40016e feat: add unique option - Thatsmusic99
016cd80 fix: wrong placeholder parsed in stats - Thatsmusic99
d460f24 chore: use the registry - Thatsmusic99
4ef10e9 feat: piglin heads (safe implementation) - Thatsmusic99
14debc7 chore(version): bump to 7.1.2 - Thatsmusic99
7.1.1Релиз1.20.2, 1.20.3, 1.20.4 · 11 февраля 2024 г.
6e4b923 fix: NPE when masks are disabled - Thatsmusic99
116334b fix: NPE with problematic head options - Thatsmusic99
1fe68cf fix: cheeky and sneaky, paper method in spigot handler - Thatsmusic99
dfd5b62 fix: regex sucks - Thatsmusic99
30eb8a3 fix: wrong group being fetched - Thatsmusic99
0a81a4b fix: how textures in player death listener is handled - Thatsmusic99
97c1793 fix: texture handling in /head and /myhead - Thatsmusic99
2c5ddfe fix: why did I do this again? - Thatsmusic99
2e6c8b9 chore: add breeze head - Thatsmusic99
74bd38f chore(paper-api & spigot-api): update to 1.20.4... - Thatsmusic99
7.1.0Релиз1.20, 1.20.1, 1.20.2 · 1 ноября 2023 г.
12513dd fix: 1.20.2 issues (#115) - Thatsmusic99
fb70194 chore: move sections to heads.yml (#113) - Thatsmusic99
e0a4065 feat: add ShopGUI+ support (#112) - Thatsmusic99
46be996 fix: reward multipliers not showing - Thatsmusic99
59b8ba9 fix: error when trying to drop entity heads - Thatsmusic99
ce7c270 chore: formatting - Thatsmusic99
ce9004a chore(deps): bump configurationmaster to 2.0.0-... - Thatsmusic99
c4e8912 fix: levels being restored after a restart - Thatsmusic99
61eea87 fix: don't enforce too-short limit on /head - Thatsmusic99
e00871c fix: blank messages on /head - Thatsmusic99
096b0a0 fix: heads.yml wrong section - Thatsmusic99
a4f6e9e fix: wrong section being saved to with /heads s... - Thatsmusic99
478f0b9 fix: add section access if headsplus.section.* ... - Thatsmusic99
In ShopGUI+, you can now configure a custom head item to be sold/bought, just like this in the plugin's config files:
item:
material: PLAYER_HEAD
headsPlus:
id: HP#bee_pollinated_angry
mob: BEE
conditions: ANGRY,NECTAR
Комментарии
Загружаем…