Custom Playerheads GUI [1.8 / 1.9 / 1.10] 1.3.2

Spawn custom playerheads with only 1 click! Easy to set up and highly configurable.

  1. McJeffr
    Tested Minecraft Versions:
    • 1.8
    • 1.9
    • 1.10

    Spawn custom playerheads with only one click!

    HeadGUI is a plugin that allows you to store playerheads in a custom GUI. This GUI, or inventory, is then saved and is accessable at any time to spawn the playerhead back in. You can put (almost) an infinite amount of playerheads into this GUI for you to use!

    1. Download the .jar file.
    2. Put the .jar file into your /plugins folder of your server.
    3. Launch the server.
    4. You're ready to go!

    HeadGUI is fairly simple to use. The plugin itsself comes with a small amount of playerheads, including the entire MHF collection. You are able to add more custom playerheads to the GUI by either:
    a) Holding a playerhead in your hand and typing /heads add [category] [description].
    b) Adding them directly into the heads.yml file.
    To open up the heads GUI, you simply type "/heads".
    To remove a head from the GUI, you simply type /heads remove [category] when holding the head.

    Commands and Permissions
    /heads: headgui.use
    This command opens up the heads GUI.

    /heads add [category] [description]: headgui.admin.add
    This command adds the playerhead that you are holding to the heads GUI. The [category] is the category name on the yml file that the head needs to be added to. The [description] will be put as the displayname of the head in the GUI.

    /heads remove [category]: headgui.admin.remove
    This command removes the playerhead with the [category] resembling the category the head is in.

    /heads reload: headgui.admin.reload
    This command reloads the heads.yml and messages.yml file and updates the heads GUI and the displayed messages.

    This plugin is fairly easy to configure. You can add and remove heads from the heads.yml file, which stores the heads that are put into the heads GUI. Make sure that you do not 'break' the layout of the .yml file, as .yml files do not like this. Use a program such as notepad++ to open up the .yml file correctly. After removing or adding heads to the heads.yml file, make sure to use /heads reload! NEW: You can now add color codes to the description of heads by using the "&" character followed by the color code. Do take note that the description will have to be surrounded by quotation marks to prevent some issues. Make sure that when you make a new category you include the little piece containing the information of the category as seen at the beginning of the other categories.

    This plugin also allows you to customize any messages that are in the plugin. These messages are stored in the messages.yml file in the plugin's folder. You are able to add color codes to the messages, but NOT to the elements starting with 'misc-', as these are items in the heads GUI.
    Code (YAML):

    : '&4Error&c: Only players can execute this command.'
    : '&4Error&c: You do not have enough permissions to execute this command.'
    : '&4Error&c: Please hold a Playerhead in your hand.'
    : '&4Error&c: Not yet supported.'
    : '&4Error&c: Not enough arguments.'
    : '&4Error&c: Unknown subargument.'
    : '&4Error&c: That head is not on the heads.yml file.'
    : '&4Error&c: That category is not on the heads.yml file.'
    : 'Playerheads'
    : '&rPrevious Page'
    : '&rNext Page'
    : '&rBack to Main Page'
    : '&2Success&a: Reloaded the playerheads and messages from the head.yml and messages.yml files.'
    : '&2Success&a: Added head to the heads.yml file.'
    : '&2Success&a: Removed head from the heads.yml file.'
    : '&6Usage&e: /heads reload OR /heads add [category] [description] OR /heads remove [category]'
    : '&6Usage&e: /heads add [category] [description]'
    : '&6Usage&e: /heads remove [category]'


    Planned Features
    - None as of now.
    Have a suggestion for a feature? Let me know!

    Current Issues
    - None as of now.
    Encountered an issue? Report it!

    Source code
    The source code of this plugin is available at

    Terms of Use This work is licensed under a Creative Commons Attribution-NoDerivatives 4.0 International License. You are not allowed to claim rights to this work nor sell it. You are allowed to use it on a server that is monetized.

Recent Reviews

  1. Godly
    Version: 1.3.2
    Anyway you can make it so you can have a head as the category icon ???!!!??????????????????????????????
    1. McJeffr
      Author's Response
      Yeah, should be possible. I will take a look at it in a bit.
  2. Fonzee9
    Version: 1.3.1
    I love this plugin and i just installed it thank you so much for this!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
  3. Matoku
    Version: 1.3.1
    Hey there! First of all, this is a awesome plugin. I only have one question: Would it be possible to add a per-head permission? For example, headgui.head.<playername>. That would be freaking awesome! But I love it anyways :)

    //edit: Now getting this error all the time:
    "[22:57:07 ERROR]: Could not pass event InventoryClickEvent to HeadGUI v1.2
    at$1.execute( ~[craftbukkit-1.8.8.jar:git-Bukkit-efe04b8]
    at org.bukkit.plugin.RegisteredListener.callEvent( ~[craftbukkit-1.8.8.jar:git-Bukkit-efe04b8]
    at org.bukkit.plugin.SimplePluginManager.fireEvent( [craftbukkit-1.8.8.jar:git-Bukkit-efe04b8]
    at org.bukkit.plugin.SimplePluginManager.callEvent( [craftbukkit-1.8.8.jar:git-Bukkit-efe04b8]
    at net.minecraft.server.v1_8_R3.PlayerConnection.a( [craftbukkit-1.8.8.jar:git-Bukkit-efe04b8]
    at net.minecraft.server.v1_8_R3.PacketPlayInWindowClick.a(SourceFile:31) [craftbukkit-1.8.8.jar:git-Bukkit-efe04b8]
    at net.minecraft.server.v1_8_R3.PacketPlayInWindowClick.a(SourceFile:9) [craftbukkit-1.8.8.jar:git-Bukkit-efe04b8]
    at net.minecraft.server.v1_8_R3.PlayerConnectionUtils$ [craftbukkit-1.8.8.jar:git-Bukkit-efe04b8]
    at java.util.concurrent.Executors$ Source) [?:1.8.0_101]
    at Source) [?:1.8.0_101]
    at net.minecraft.server.v1_8_R3.SystemUtils.a(SourceFile:44) [craftbukkit-1.8.8.jar:git-Bukkit-efe04b8]
    at net.minecraft.server.v1_8_R3.MinecraftServer.B( [craftbukkit-1.8.8.jar:git-Bukkit-efe04b8]
    at net.minecraft.server.v1_8_R3.DedicatedServer.B( [craftbukkit-1.8.8.jar:git-Bukkit-efe04b8]
    at net.minecraft.server.v1_8_R3.MinecraftServer.A( [craftbukkit-1.8.8.jar:git-Bukkit-efe04b8]
    at [craftbukkit-1.8.8.jar:git-Bukkit-efe04b8]
    at Source) [?:1.8.0_101]
    Caused by: java.lang.NoSuchMethodError: org.bukkit.event.inventory.InventoryClickEvent.getClickedInventory()Lorg/bukkit/inventory/Inventory;
    at com.mcjeffr.headgui.listener.InventoryClickListener.onInventoryClick( ~[?:?]
    at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method) ~[?:1.8.0_101]
    at sun.reflect.NativeMethodAccessorImpl.invoke(Unknown Source) ~[?:1.8.0_101]
    at sun.reflect.DelegatingMethodAccessorImpl.invoke(Unknown Source) ~[?:1.8.0_101]
    at java.lang.reflect.Method.invoke(Unknown Source) ~[?:1.8.0_101]
    at$1.execute( ~[craftbukkit-1.8.8.jar:git-Bukkit-efe04b8]
    ... 15 more"
    ~ Matoku
    1. McJeffr
      Author's Response
      Thanks for the review! I will take a look at the per-head permissions as I don't think that should be too hard to implement. The error that was thrown to you seems to be because of a version mismatch. "NoSuchMethodError". Make sure that you got the correct version of the plugin that matches your server version (1.9+ or 1.8).

      In this case, you are running a 1.8 Craftbukkit server. Sadly I no longer have the source code for the 1.8 version to assist you with this as the 1.8 version's code was lost.
  4. Mitch896
    Version: 1.3
    seems like a good idea but isnt working for me, Its says an internal error has occurred so idk whats wrong xD
    1. McJeffr
      Author's Response
      I don't have much with just "An internal error or something" because that could be almost every line of code crashing. If you have a crash report from the console that you could send me in a private chat, let me know so I can take a look at it and pinpoint what went wrong.
  5. freddy0425
    Version: 1.3
    Nice I love the Thx man (:;

    Can you add more Blocks (:


    :D :D :D :D :D :D :D :D
    1. McJeffr
      Author's Response
      Thanks for the review! I could add more blocks yes, although I don't know any more than these. You are able to add some blocks yourself as well by adding more heads in the "heads.yml" file that resides in the plugin folder in the HeadGUI folder.
  6. Hoppys
    Version: 1.2
    One of the best head plugins there is out there! Maybe in the future if there were some sort of item lore system that'd be great! Keep the great work up jeff. ^-^
    1. McJeffr
      Author's Response
      Thanks for the review! And what exactly do you mean with lore system? Adding lores to the heads?
  7. SherComp
    Version: 1.2
    Best head plugin ever. it would be nice if you add the option that you dont have to put it on by your self, and its locked so you cant move it to any inventory slot. i use it for my lobby server, thanks!
    1. McJeffr
      Author's Response
      Hmm it was originally made for building as playerheads are used quite a lot in building. I could however add this interesting idea that I did not think of and make it toggable in the config. Thanks for the review though!