Skulls - The Ultimate Head Database icon

Skulls - The Ultimate Head Database -----

Skulls is a collection of 100k+ custom textured Minecraft heads. A free alternative to Head Database




+ 1.21.7 Support
- I'll get new heads added eventually, been busy with work
----------, Jul 3, 2025

+ 1.21.5 Support
+ If you had gotten this off Patreon no need to download this as its the same.
----------, Apr 26, 2025

+ Added drop chance override permission. (skulls.headdropchance.# (whole number 1 - 100)
+ Added option to ask for purchase confirmation
+ Fixed bug where having an full inventory doesn't give player heads.
+ Coins Engine support thanks to ( https://github.com/awdrgyj8)

If you like skulls, consider supporting me on Patreon for $1 a month
https://www.patreon.com/c/kiranhart
----------, Feb 14, 2025

+ Added a random head button to the main gui, it's disabled by default. But pretty much it'll give you a random head (default price is $1) from a random category you have permission to access.

https://prnt.sc/A8WcVSzB5Ers
If you like skulls, consider supporting me on Patreon for $1 a month
https://www.patreon.com/c/kiranhart
----------, Jan 8, 2025

+ Added 1.21.4 support
If you enjoy using this plugin consider joining my patreon for $1 as it helps me keep everything updated :)
https://patreon.com/kiranhart
----------, Dec 11, 2024

+ 1.21.3 Support
----------, Nov 4, 2024

+ Added option to specify custom data source ( done by xming-cn )
+ Fixed issue with favourites showing more heads than normal
+ Fixed issue with the database check not 'saving' after an update.
+ Slight performance improvements.
----------, Oct 23, 2024

upload_2024-10-19_21-57-42.png

I had some time to get all the updated heads from minecraft heads, Skulls should now have access to the current set of heads present as of Oct 19th 2024 on Minecraft Heads. No need to update the jar, during the next reload/restart skulls will fetch them automatically.

If you like skulls and would like to support it, consider joining my Patreon
https://www.patreon.com/kiranhart
----------, Oct 20, 2024

+ Fixed database table creation error if already exists
+ Fixed translations not generating / reading correct file when changed in config
+ When using the search feature, it will respect category permissions. Example if the player doesn't have permission for the food & drinks category they won't see any skulls that are from that category.
----------, Oct 3, 2024

+ Updated XSeries to resolve skull texture issues on 1.21.1
----------, Sep 19, 2024

+ Made the player head gui loading async. Added a separate to enabled it. By default its disabled
+ Added a claim delay option based on the permission defined in the config.
+ Added a reload command (finally ikr)
+ Fixed regex issue with searching

If you like skulls and would like to support it, consider joining my Patreon
https://www.patreon.com/kiranhart
----------, Sep 9, 2024

+ Support for 1.21.1
----------, Aug 14, 2024

(!) So uh since there is soo many people using this plugin now, it kinda caused my current lhosting limits to reach past its max, and I don't really feel like paying for more. So I moved all the skulls data file(s) to GitHub since that is probably more reliable anyway. I suggest updating to this jar as soon as you can since I'll be closing the old api routes sometime this month.

- Also with how I'm checking the skulls db to see if your install is missing any skulls (at least the ones I have in the data files currently), I completely removed the history section in the plugin and just replaced it with a "settings" menu which just contains the price sync button.

Also thanks to darksaid98 for the following changes:
+ Added PlayerPreSkullDropEvent
+ Added PlayerSkullDropEvent
+ Fixed duplication regarding skull drops w/towny
----------, Jul 15, 2024

+ Added Player Head GUI (perm: skulls.category.playerheads)
+ Skulls will now automatically do a background check to see if you are missing any heads and try to download them.
+ Slight changes when it comes to getting the skull player, it should no longer throw an error if it's not found.
+ Updated flight to use XSkull lenient()
+ Skull insertions are much faster, it will execute the batch every 1000 skulls now. So new installs if your not copying the db file will be a lot faster when inserting downloaded heads.
----------, Jul 10, 2024

+ Updated NBTAPI to fix issue with paper 1.21
----------, Jun 22, 2024

+ Updated NBTAPI
+ Updated Flight (My Dev Library)
----------, Jun 14, 2024

+ Added 1.20.6 Support
----------, May 1, 2024

+ Added option to disable skull tracking ( https://github.com/Tweetzy/Skulls/pull/25)
+ Added option to customize button names
+ Added option to disable favourites, search and custom category buttons
+ Upgraded flight
+ 1.20.4 support
----------, Dec 16, 2023

+ Fixed bug where when downloading new heads inserts it would broadcast to every player when it inserts them into the database file.
----------, Nov 18, 2023

+ Update NBTEditor
+ Update XSeries ReflectionUtils & SkullUtils
----------, Oct 4, 2023

+ Added support for 1.20.2
----------, Sep 29, 2023

+ Fixed colour & formatting for edit price admin option in config
+ Limit the give command to 36 skulls at a time.
+ Internal library updates
----------, Jul 2, 2023

+ Adjust how textures are set on skulls. (Some players have reported that skulls were just showing up as steve)
----------, Jun 23, 2023

+ Fixed NBTApi null/air/0 error when placing skulls.
+ Plug patreon link
----------, Jun 20, 2023

+ Added support for v1.20 (If anything is broken, open an issue on github or let me know on discord)

Consider supporting me on patreon ( https://patreon.com/kiranhart)
----------, Jun 16, 2023

+ Update internal dev dependencies
+ Slight code adjustment regarding has and withdraw economy methods.
----------, May 12, 2023

+ Fixed bug when skulls are placed against a block face that isn't the top, they won't be registered resulting in them losing their name on break.
----------, Mar 31, 2023

+ Fixed config generation issue
+ Added setting to disable permission checks for everything except admin actions
----------, Feb 19, 2023

+ Updated internal core
+ Changed language system, you can copy pretty much all your previous translations with the exception of just a couple misc ones.
+ Fixed bug where when the player didn't have permission, it would send the config entry key path rather than the message.
+ When a skull player can't be found or something goes wrong during the create&insert process, it will just make a temporary one to open the gui.
+ The history / new head download menu is far less annoying now, it doesn't refresh like crazy after you request the new heads. It will only refresh once the actual download and load is done.

Don't forget to join the Discord Server, important notices, sales, and update announcements are made there
https://discord.tweetzy.ca
----------, Jan 25, 2023

+ Reverted how textures were set on head
+ Slight adjustment on sql statement regarding insert conflicts
----------, Jan 7, 2023

+ 1.19.3 Support
+ Switched methods for applying skull texture
----------, Dec 16, 2022

+ Workaround regarding worldguard break permissions

hopefully this doesn't break anything, also API from jitpack is dead because jitpack is refusing to build my development lib which skulls sorta depends on... so yea
----------, Nov 12, 2022

+ Fixed issue where some players aren't able to place or break blocks.
----------, Nov 9, 2022

+ Bug fixes regarding skull user
+ Update internal core

... 69th update... noice
----------, Nov 5, 2022

+ Removed priority in the skull place and break events.
----------, Oct 18, 2022

+ Updated patreon link
+ Updated internal core version
(!) Reminder, even though I don't post new head updates, you can still fetch them in /skulls by clicking settings. You can get them roughly within an hour of them being released on minecraft heads.
----------, Aug 25, 2022

+ Fixed bug on 1.8.8 where the sqlite file would not be found.
+ (!) When using Minecraft versions below 1.16, it may take longer to insert heads during the first install/download.
----------, Aug 24, 2022

+ Fixed config generation bug
+ Generate data/fetch heads in flight rather than wake

there was a bunch of heads added to minecraft-heads that are available on skulls, my image fetcher is broken so uh, no cool image grid today.
----------, Aug 11, 2022

+ Added getRandomSkull() to api
+ Switched internal core and updated internal core version
+ Using the random option in the give command should no longer give heads from categories that are disabled.
----------, Jul 27, 2022

New Heads (there are more, but my image generator thing is broken and I don't wanna take more screenshots)

/skulls -> click the settings button to view any missed history inserts
Screenshot_1.png Screenshot_2.png
----------, Jul 27, 2022

+ Added permission: skulls.command.main which allows users to open /skulls using permission.
+ Re-added setting that let's anyone open the /skulls menu regardless if they have the permission
----------, Jul 12, 2022

+ You can force sync all default prices for skulls by clicking the setting button in /skulls (bottom left) then the gold ingot.

+ Added the following skulls, you can download the latest history insert from the history menu (accessed by using /skulls and clicking the bottom left icon).

[​IMG]
[​IMG]
----------, Jul 11, 2022

+ 214 Heads
You can download new heads in /skulls then going into settings/history and download the latest.
[​IMG]
----------, Jun 26, 2022

Skulls 3.0.0
This update was long planned, and to be honest quite delayed. But now it's finally out and here are some of the major things changed.

Important Note Before Updating
Due to changes on how data is stored in v3, all blocked, custom categories and favourited heads will be reset. There also have been permission changes so see the docs on the new ones.

It is recommended to completely stop the server before adding v3

Storage
Skulls v1 and v2 used a normal yaml format to store skulls and user data, but that proved to be a bit slow when dealing with 40k+ skulls. Load times would sometimes be over 10 seconds.

With Skulls v3, it now uses SQLite which proves to be much faster, initial download times may vary depending on the backend API load or your server's download speed. But after the initial download, most of the time Skulls will load on average within 1 second.

Histories
Behind the scene, my API which returns skull data is broken up into insert/history points which represent newly added heads. Now with v3 you can download individual history inserts (new heads) rather than all 45k+ skulls each time you want to update.

Player Heads
Yea... I know, finally. With v3 you can use /skulls phead to grab your head or the head of other players.

Skull Name Retains
When you used to place a skull block in v1 or v2, breaking it will reset the original skull name, but with v3, that has been fixed and skull ids are properly stored on the broken block so you can inspect it.

Inspection
You can now look at a skull block which was placed after updating to v3 and use /skulls inspect (when not holding a skull) to view it's id.

Better Editing
Skulls v3 introduces a completely new GUI for editing individual skull names, prices, their custom categories, and whether they are blocked.

Permissions & Commands
See https://docs.tweetzy.ca/official-plugins/skulls for the updated command and permissions.


Hope you guys enjoy the update, also my backend server has been having some issues, so you *may* have trouble downloading the skulls, if you join my discord server and let me know in the Skulls channel.

- Kiran
----------, Jun 18, 2022

+ 376 Skulls
Use /Skulls download to fetch new heads
(These technically were released a few days ago, I just didn't have time to post the update)
[​IMG] [​IMG]
----------, May 27, 2022

New Heads
Use /skulls download to fetch new heads

[​IMG]
----------, May 14, 2022

New Heads Available
Use /skulls download to fetch new heads
[​IMG]
----------, May 5, 2022

+ 180 Heads
Run /skulls download to fetch new heads

[​IMG]
----------, Apr 28, 2022

+ 129 New Heads
Use /skulls download to fetch new heads

[​IMG]
----------, Apr 23, 2022

New Heads Available
Use /Skulls download to fetch new heads in game

[​IMG]
----------, Apr 15, 2022

New Heads Available
Use
/skulls download to fetch new heads

[​IMG]

Vote For Next Free Plugin
https://forms.gle/zaUrW41SKNP7HJF57
----------, Apr 8, 2022

+ Updated internal image grid number, also updated api link

Vote For Next Free Plugin

https://forms.gle/zaUrW41SKNP7HJF57
----------, Apr 6, 2022

Use /skulls download to fetch new heads

[​IMG]
----------, Mar 30, 2022

+ Support for 1.18.2, base spigot might be a bit iffy still, use paper one of it's forks instead.
+ I originally was going to skip this update and go straight to the 3.0 update, but with the things coming to 3.0, it will be too long of a wait tbh.
----------, Mar 22, 2022

New Skulls
Use /skulls download to fetch new heads

[​IMG]
----------, Mar 3, 2022

New Heads
Btw, if you see new heads on minecraft-heads, skulls will automatically fetch them within an hour, so you just have to use the download command to get them. They'll be available even if I don't post an update.

/Skulls download
to fetch new heads

[​IMG] [​IMG]
----------, Feb 17, 2022

+ Fixed some issues with the SkullPlayer manager throwing addition errors
----------, Feb 8, 2022

Use /skulls dl to fetch to new heads
[​IMG]
----------, Feb 3, 2022

Use /skulls download to fetch new heads (My Server fetched these a few days ago, I just forgot to post the update)
[​IMG]
----------, Feb 2, 2022

Use /Skulls download to fetch new heads
(I forgot to post this update, these heads came out a few days ago)
[​IMG]
----------, Jan 24, 2022

+ Added a setting to drop a player's head on death
+ Removed extra space if the prefix is set to be empty
----------, Jan 19, 2022

Use /Skulls download to fetch new heads
[​IMG]
----------, Jan 18, 2022

+ Fixed issue where the navigation buttons in the menus won't apply translations made inside the settings.yml file.
----------, Jan 16, 2022

New Skulls
Use /skulls download to fetch new heads
[​IMG]
----------, Jan 13, 2022

+ Updated the image grid number to latest, will be removed in later versions to just use a soon to be /latest url
----------, Jan 11, 2022

+ 164 Heads
Use /skulls download to fetch new heads

[​IMG]
----------, Jan 6, 2022

+ Fixed serialization error
----------, Jan 5, 2022

+ Fixed issue with shift click price edits
----------, Dec 31, 2021

+ Fixed issue with blocked skulls not letting users take skull out of menu
----------, Dec 28, 2021

+ Checks if bStats is disabled, and asks the user to turn it on
----------, Dec 26, 2021

Merry Christmas
+ Added 182 new skulls (they were added on the 24th, but I kinda forgot to update)
Use /skulls download to fetch new heads
My server is sorta having some issues atm, so you might not be able to download the heads, just a heads up.

[​IMG]
----------, Dec 25, 2021

+ Added an option to blocked certain skulls from being taken / purchased, the documentation / wiki has updated permissions that will let you give users access to those blocked skulls.

+ Changed add to category action from middle click to shift left click
+ Remove custom category action changed from middle click to drop key
----------, Dec 22, 2021

+ 112 New Skulls
Use /skulls download to fetch new heads

[​IMG]
----------, Dec 17, 2021

+ Pagination Title Numbers are now fixed.
----------, Dec 14, 2021

+ No longer sending page numbers to chat as the temporary solution
+ {page} variable has been introduced for previous/next button item names and lores.
----------, Dec 10, 2021

+ Added support for 1.18
+ A bunch of new skulls
(!) There is an issue with updating inventory titles, so atm when navigating pages on 1.18 the page number will be sent in chat...

[​IMG]
[​IMG]
----------, Dec 10, 2021

+ 110 Skulls
Use /skulls dl to download the new heads.
[​IMG]
----------, Nov 30, 2021

109 New Skulls
Use /skulls download to fetch them in game.
[​IMG]
----------, Nov 18, 2021

+ Possible bug fix for economy issue
----------, Nov 16, 2021

+ You can now change the descriptions of the commands
+ You can disable the favourites & custom categories button(s)
----------, Nov 13, 2021

+ New heads, use /skulls download to download new heads

[​IMG]
----------, Nov 11, 2021

+ Added reload command
----------, Nov 7, 2021

+ Fixed an issue where it would try to charge for heads even if the setting was off
----------, Nov 6, 2021

92 more heads of have been added to the database. You can use /skulls download to fetch the new heads in game.

[​IMG]
----------, Nov 4, 2021

+ Fixed issue where non perm / opped players would have the insufficient perms message sent to them for each skull in an inventory upon clicking a category.
----------, Nov 2, 2021

+ Added a setting to allow users to use /skulls without needing permission, perms will be required for admin or favourite actions
----------, Oct 29, 2021

New Heads have been added.
Run /skulls download to download new heads
[​IMG]
----------, Oct 28, 2021

+ Re-added the item economy
+ Skulls will now delete the old (pre 2.0) heads folder if it finds it and download the new one.
+ Code clean up to improve code factor score to A+
----------, Oct 27, 2021

Skulls 2.0 Release
Now with 40K+ heads, updates now be posted every time new heads are available

[​IMG]
----------, Oct 27, 2021

+ New config editor system, new pages will be created for settings if there is no more room in the gui.
+ Config editor is now more organized, meaning sections, toggles, strings/materials/sounds, and lists are all grouped appropriately.
+ Updated to latest TweetyCore
----------, Jul 24, 2021

+ You can search minecraft-heads.com id's now just like head database.
+ /skulls search id:the head id
[​IMG]
----------, Jul 19, 2021

+ You can now give players random skulls from any base category.
+ The command is /skulls giverandom <all / player> <category> [#]
https://gyazo.com/7706012271bdf8a941629951aebbbfcb

@superzyr
----------, Jul 14, 2021

+ You can now disable / block the usage of /skulls within certain worlds.
----------, Jun 23, 2021

+ Fixed bug that caused the in game config editor to not properly show the item selection menu
----------, Jun 23, 2021

+ Fixed an issue regarding chat prompts for the search not translating color codes correctly.
+ Updated to the latest tweety core
----------, Jun 17, 2021

+ Updated to the latest Tweety Core
+ Redid the language system (your files will remain the same)
+ Added individual category permissions (you can toggle it off in /skulls settings) - ex permission: skulls.category.alphabet will allow the user to access the alphabet category from the main gui.
+ You can now switch to a single item economy in /skulls settings, if enabled it will use whatever material type you specify, by default it's a diamond. If the price is set to 5.0, it will become 5, if it's 5.4 it will also become 5, but if it's 5.6 it will become 6.

@JMCY26
----------, Jun 17, 2021

+ Added support for Spigot 1.17 R1
+ Updated to the latest TweetyCore
----------, Jun 16, 2021

+ Fixed shift click issue with core
----------, May 27, 2021

+ Updated to last core version
----------, May 25, 2021

+ Updated to latest Core version
+ Hex Support (when using hex values inside .lang files you must use the normal hex format = #FaFaFa)
----------, May 13, 2021

(!) Requires Vault Now
+ Added a price system for skulls
+ Each category can have a base price for every skull
+ You can edit the price of individual skulls by shift right clicking
+ The permission: skulls.editprice will allow the user to change skull prices && the permission skulls.freeheads will bypass the balance check and will give the head to the user for free, you can also disable the price system in /skulls settings. Here is a gif of the price editing:
https://gyazo.com/465000504766d28353674f8caefa942d
----------, May 3, 2021

Added an update checker
Fixed a bug where the download task checker wouldn't work on 1.12
----------, Apr 6, 2021

Resource Information
Author:
----------
Total Downloads: 146,140
First Release: Mar 13, 2021
Last Update: Jul 3, 2025
Category: ---------------
All-Time Rating:
49 ratings
Find more info at docs.tweetzy.ca...
Version -----
Released: --------------------
Downloads: ------
Version Rating:
----------------------
-- ratings