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!
Installation
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!
Usage
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.heads
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.
Configuration
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.
Spoiler: Standard messages.yml file
err-no_player : '&4Error&c : Only players can execute this command.'
err-no_perms : '&4Error&c : You do not have enough permissions to execute this command.'
err-no_head : '&4Error&c : Please hold a Playerhead in your hand.'
err-not_supported : '&4Error&c : Not yet supported.'
err-not_enough_arguments : '&4Error&c : Not enough arguments.'
err-unknown_subargument : '&4Error&c : Unknown subargument.'
err-head_not_existant : '&4Error&c : That head is not on the heads.yml file.'
err-category_not_existant : '&4Error&c : That category is not on the heads.yml file.'
misc-inventory_name : 'Playerheads'
misc-previous_page : '&rPrevious Page'
misc-next_page : '&rNext Page'
misc-main_page : '&rBack to Main Page'
succ-reload : '&2Success&a : Reloaded the playerheads and messages from the head.yml and messages.yml files.'
succ-added : '&2Success&a : Added head to the heads.yml file.'
succ-removed : '&2Success&a : Removed head from the heads.yml file.'
usage-heads : '&6Usage&e : /heads reload OR /heads add [ category ] [ description ] OR /heads remove [ category ] '
usage-heads_add : '&6Usage&e : /heads add [ category ] [ description ] '
usage-heads_remove : '&6Usage&e : /heads remove [ category ] '
Code (YAML):
err-no_player : '&4Error&c : Only players can execute this command.'
err-no_perms : '&4Error&c : You do not have enough permissions to execute this command.'
err-no_head : '&4Error&c : Please hold a Playerhead in your hand.'
err-not_supported : '&4Error&c : Not yet supported.'
err-not_enough_arguments : '&4Error&c : Not enough arguments.'
err-unknown_subargument : '&4Error&c : Unknown subargument.'
err-head_not_existant : '&4Error&c : That head is not on the heads.yml file.'
err-category_not_existant : '&4Error&c : That category is not on the heads.yml file.'
misc-inventory_name : 'Playerheads'
misc-previous_page : '&rPrevious Page'
misc-next_page : '&rNext Page'
misc-main_page : '&rBack to Main Page'
succ-reload : '&2Success&a : Reloaded the playerheads and messages from the head.yml and messages.yml files.'
succ-added : '&2Success&a : Added head to the heads.yml file.'
succ-removed : '&2Success&a : Removed head from the heads.yml file.'
usage-heads : '&6Usage&e : /heads reload OR /heads add [ category ] [ description ] OR /heads remove [ category ] '
usage-heads_add : '&6Usage&e : /heads add [ category ] [ description ] '
usage-heads_remove : '&6Usage&e : /heads remove [ category ] '
Images
Spoiler: Heads GUI
Spoiler: messages.yml
Spoiler: heads.yml
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 https://github.com/McJeffr/HeadGUI .
Terms of Use
http://creativecommons.org/licenses/by-nd/4.0/ . 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.
Quick facts
- Edition: Minecraft Java
- File type: .jar
- Minecraft versions listed: 1.8, 1.9, 1.10
- How to install: Install the matching mod loader (Forge, Fabric or NeoForge) for your Minecraft version. → Download the .jar. → Put it in the .minecraft/mods folder and launch that loader profile.
- Where to get it: Opens on Spigot — not every file is mirrored on our own servers.
Install steps are the general flow for this file type — How to install Minecraft Java mods & modpacks walks through it step by step.
Custom Playerheads GUI [1.8 / 1.9 / 1.10] is a free Minecraft Java mod. Compatible with Minecraft 1.8, 1.9, 1.10. Downloaded 2,271 times (via Spigot). Download it and open it directly in the game.